← 返回主页
Win / Mac · 一键启动

# Hermes Agent 一键启动器

Nous Research 开源 AI Agent，双击即开即用。
支持 OpenRouter / OpenAI / Anthropic 等多种模型后端。

### ⬇ 下载启动器（Windows）

右键另存为，放到你的工作目录，双击即可

📥 下载 hermes-start.bat

### ⬇ 下载启动器（macOS）

右键另存为，放到你的工作目录，双击即可

📥 下载 hermes-desktop.command

### 📌 macOS 程序坞 .app（可固定到 Dock）

复制以下命令到终端运行，自动创建 .app 并加入程序坞

mkdir -p ~/Applications/hermes.app/Contents/MacOS ~/Applications/hermes.app/Contents/Resources && cat > ~/Applications/hermes.app/Contents/Info.plist << 'PLIST' <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>CFBundleExecutable</key><string>hermes-launcher</string> <key>CFBundleIconFile</key><string>hermes</string> <key>CFBundleIdentifier</key><string>com.lihongwei.hermes-agent</string> <key>CFBundleName</key><string>Hermes Agent</string> <key>CFBundleDisplayName</key><string>Hermes Agent</string> <key>CFBundleVersion</key><string>0.16.0</string> <key>CFBundlePackageType</key><string>APPL</string> </dict> </plist> PLIST cat > ~/Applications/hermes.app/Contents/MacOS/hermes-launcher << 'SH' #!/bin/bash H="$HOME/.local/bin/hermes" [ ! -f "$H" ] && osascript -e 'display dialog "Hermes Agent 未安装" buttons {"好"} with icon stop' && exit 1 [ ! -f "$HOME/.hermes/.env" ] && osascript -e 'display dialog "请先运行：hermes setup" buttons {"好"} with icon caution' && exit 1 osascript -e 'tell app "Terminal" to activate' -e "tell app "Terminal" to do script \"clear; $H chat; exit\"" SH chmod +x ~/Applications/hermes.app/Contents/MacOS/hermes-launcher

运行后打开 Finder → 前往 ~/Applications → 将 hermes.app 拖入程序坞即可固定

## 1 工作原理

hermes-start → 检测 hermes 命令 → 检查 API Key 配置 → 打开 Hermes Agent 对话

脚本自动完成 2 步检查：hermes 已安装 → API Key 已配置 → 启动对话。
任一步失败都有明确的中文提示。
Windows 用 `.bat`，macOS 用 `.command`，功能完全一致。

## 2 前置条件

还没安装 Hermes Agent？请先看 Hermes Agent 完整指南 的「安装」章节，安装完成后再回来这里下载启动器。
已经安装过了？跳过下面，直接下载启动器即可。

### 确认 Hermes Agent 已安装

打开终端运行：

hermes --version

输出版本号（如 `hermes 0.16.0`）说明已安装。

### 确认 API Key 已配置

打开终端运行：

hermes chat

能正常对话说明已配置。如果提示未配置，运行 `hermes setup`。

## 3 使用方式

### 下载并放到工作目录

点击上方下载按钮，将启动脚本保存到桌面或任意工作目录。

### 创建桌面快捷方式（可选）

Windows：右键 `hermes-start.bat` → 发送到 → 桌面快捷方式。

macOS：右键 `hermes-desktop.command` → 制作替身 → 拖到桌面。

### 双击启动

Windows：双击 `.bat` 文件，自动检查并在终端中打开 Hermes Agent 对话界面。

macOS：首次使用需右键 `.command` → 打开（仅一次），之后可直接双击。

## 4 Hermes Agent 是什么

### 自我进化的 AI Agent

由 Nous Research 开发的开源 AI Agent（MIT 协议）。内置学习循环，能从经验中创建技能、在使用中改进、跨会话建立用户模型。

### 多模型后端

支持 OpenRouter（200+ 模型）、OpenAI、Anthropic、DeepSeek、HuggingFace、Google 等。可随时切换模型。

### 丰富的工具生态

内置 60+ 个技能：浏览器自动化、GitHub 管理、论文写作、代码审查、音乐创作、Notion/Linear 集成、MCP 协议支持等。

### 消息平台接入

通过 Gateway 接入 Telegram、Discord、Slack、WhatsApp、Signal 等，随时随地对话。

Hermes Agent 和 Claude Code 互补使用：Claude Code 专注代码工程，Hermes Agent 覆盖更广泛的日常 AI 任务。

## 5 自定义配置

用文本编辑器打开启动脚本，可按需修改以下内容：

# macOS (.command) — 指定模型和提供商 hermes chat --model "openai/gpt-5" --provider openrouter # 或在启动前设置环境变量 export OPENROUTER_API_KEY="sk-or-你的密钥" :: Windows (.bat) — 指定模型和提供商 hermes chat --model "openai/gpt-5" --provider openrouter
Hermes Agent 也支持 TUI 模式（`hermes --tui`），界面更美观。可将脚本中的 `hermes chat` 替换为 `hermes --tui`。

## 6 常见问题

#### 双击后窗口一闪而过

脚本检测到错误后退出了。打开终端手动运行启动脚本，就能看到完整错误信息。

#### 提示 hermes 命令未找到

Hermes Agent 未安装或 PATH 未生效。重新加载 shell 配置：

# macOS / Linux source ~/.zshrc # 或 source ~/.bashrc # Windows — 重新打开终端即可

如果仍未解决，重新运行安装脚本。

#### 提示未检测到 API Key 配置

运行 `hermes setup` 进入交互式配置向导，至少配置一个模型提供商。

# 也可以手动配置（以 OpenRouter 为例） hermes config set model.provider openrouter hermes config set model.default "openai/gpt-5"

#### macOS 提示"无法打开，因为无法验证开发者"

右键（或 Control+点击）`.command` 文件 → 打开 → 点"打开"。只需操作一次。

#### 如何更新 Hermes Agent

hermes update

或手动更新：`cd ~/.hermes/hermes-agent && git pull && uv sync --extra all`

#### 如何卸载

hermes uninstall

或手动删除：`rm -rf ~/.hermes` 并移除 `~/.local/bin/hermes` 软链接。

本页被阅读 ... 次