本文章没有找到对应的语言版本

一、安装 Hermes Agent

1.1 一键安装 

1

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装过程会自动：

  • 克隆代码到 ~/.hermes/hermes-agent/
  • 创建 Python 虚拟环境
  • 安装所有依赖

1.2 验证安装 

1

hermes --version

输出类似：

1
2
3

Hermes Agent v0.10.0 (2026.4.16)
Project: ~/.hermes/hermes-agent
Python: 3.11.15

1.3 检查目录 

1
2
3
4
5

ls ~/.hermes/
# hermes-agent/  profiles/

ls ~/.hermes/profiles/hermes-bot/
# config.yaml  .env  skills/  sessions/  logs/

二、配置 API 密钥

2.1 编辑密钥文件 

1

nano ~/.hermes/profiles/hermes-bot/.env

添加你的 API 密钥（选一个即可）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 方案一：DeepSeek（推荐，便宜好用）
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx

# 方案二：OpenRouter（聚合多模型）
OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxxxxxx

# 方案三：Anthropic Claude
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# 方案四：小米 MiMo
XIAOMI_API_KEY=sk-xxxxxxxxxxxxxxxx

2.2 设置模型 

1

hermes model

交互式选择，例如选 DeepSeek → deepseek-chat。

或者直接写配置：

1
2
3
4
5

cat > ~/.hermes/profiles/hermes-bot/config.yaml << 'EOF'
model:
  default: deepseek-chat
  provider: deepseek
EOF

2.3 验证配置 

1

hermes config

检查 Model 行是否正确显示你选的模型。

1

hermes doctor

检查依赖和配置是否有问题。

三、使用 Hermes CLI

3.1 启动交互式聊天 

1

hermes

进入后直接打字对话，输入 /help 查看命令。

3.2 单次查询（不进入交互） 

1

hermes chat -q "什么是 Docker？简短回答"

3.3 常用斜杠命令

在 hermes 交互界面中输入：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

# 新建会话
/new

# 查看/切换模型
/model deepseek-chat

# 查看配置
/config

# 查看已安装技能
/skills

# 加载某个技能
/skill hermes-agent

# 查看帮助
/help

# 退出
/quit

3.4 管理工具 

1
2
3
4
5
6
7
8

# 列出所有工具
hermes tools list

# 启用浏览器工具
hermes tools enable browser

# 禁用某个工具
hermes tools disable vision

3.5 安装技能 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 浏览可用技能
hermes skills browse

# 搜索技能
hermes skills search docker

# 安装技能
hermes skills install <skill-id>

# 查看已安装
hermes skills list

四、安装 Gateway（后台服务）

Gateway 让 Hermes 跑在飞书/Telegram 等平台上，24 小时不间断。

4.1 前台测试 

1

hermes gateway run

看到 Gateway started 表示成功，Ctrl+C 停止。

4.2 安装为 macOS 后台服务 

1

hermes gateway install

这会创建 LaunchAgent，开机自动启动。

4.3 管理服务 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 启动
hermes gateway start

# 停止
hermes gateway stop

# 重启（修改配置后需要重启）
hermes gateway restart

# 查看状态
hermes gateway status

4.4 配置飞书 Bot

第一步：创建飞书应用

  1. 打开 https://open.feishu.cn/
  2. 创建企业自建应用
  3. 添加「机器人」能力
  4. 记下 App ID 和 App Secret

第二步：配置权限

在「权限管理」中开通：

  • im:message — 获取与发送单聊、群组消息
  • im:message.group_at_msg — 接收群聊 @ 消息
  • im:resource — 获取消息中的资源文件

第三步：添加密钥

1

nano ~/.hermes/profiles/hermes-bot/.env

添加：

1
2
3

FEISHU_APP_ID=cli_xxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxx
FEISHU_VERIFICATION_TOKEN=xxxxxxxxxx

第四步：配置平台

1

hermes gateway setup

选择 Feishu，按提示填写。

第五步：重启生效

1

hermes gateway restart

4.5 配置 Telegram Bot

第一步：创建 Bot

在 Telegram 找 @BotFather：

1
2
3

/newbot
# 按提示输入名称
# 记下 Token

第二步：添加密钥

1

nano ~/.hermes/profiles/hermes-bot/.env

添加：

1

TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

第三步：重启

1

hermes gateway restart

4.6 查看日志 

1
2
3
4
5

# 实时查看日志
tail -f ~/.hermes/profiles/hermes-bot/logs/gateway.log

# 查看错误
tail -f ~/.hermes/profiles/hermes-bot/logs/gateway.error.log

五、安装 OpenClaw

5.1 安装 

1

npm install -g openclaw

5.2 验证 

1
2

openclaw --version
# OpenClaw 2026.4.29 (a448042)

5.3 使用 

1
2
3
4
5
6
7
8

# 交互式
openclaw

# 单次查询
openclaw -q "写一个 Python 快速排序"

# 指定容器运行
openclaw --container myapp -q "检查代码"

5.4 Hermes vs OpenClaw 

1
2
3
4
5

# Hermes：全功能，适合复杂任务
hermes chat -q "帮我写一个完整的 REST API，包含数据库、认证、测试"

# OpenClaw：轻量快速，适合简单任务
openclaw -q "这段代码有什么 bug？"

六、日常使用技巧

6.1 会话管理 

1
2
3
4
5
6
7
8

# 列出最近会话
hermes sessions list

# 恢复上次会话
hermes --continue

# 恢复指定会话
hermes --resume 20260503_120000_abc123

6.2 定时任务 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 创建：每天早上 9 点
hermes cron create "0 9 * * *" -n "早安" -p "给我一个今天的待办清单"

# 查看所有任务
hermes cron list

# 手动触发
hermes cron run <job-id>

# 暂停任务
hermes cron pause <job-id>

# 删除任务
hermes cron remove <job-id>

6.3 使用代理

如果你有代理（如 mihomo）：

1

nano ~/.hermes/profiles/hermes-bot/.env

添加：

1
2

HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890

6.4 Profile 多实例 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 列出 profiles
hermes profile list

# 创建新 profile
hermes profile create work

# 使用新 profile
hermes -p work

# 或者切换默认
hermes profile use work

七、常见问题

Q1: hermes 命令找不到？ 

1
2
3
4
5
6

# 检查 PATH
echo $PATH

# 手动添加（zsh）
echo 'export PATH="$HOME/.hermes/hermes-agent/venv/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Q2: Gateway 断开？ 

1
2
3
4
5
6

# macOS 检查服务状态
hermes gateway status

# 重新安装服务
hermes gateway install
hermes gateway start

Q3: 工具不生效？ 

1
2
3
4
5

# 检查工具状态
hermes tools list

# 在会话中重置（工具修改后需要）
/new

Q4: API 报错？ 

1
2
3
4
5
6
7
8

# 检查密钥
cat ~/.hermes/profiles/hermes-bot/.env

# 检查配置
hermes config

# 全面检查
hermes doctor

Q5: 日志在哪？ 

1
2
3
4
5

# Gateway 日志
~/.hermes/profiles/hermes-bot/logs/gateway.log

# 错误日志
~/.hermes/profiles/hermes-bot/logs/gateway.error.log

八、命令速查表 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

# === 安装 ===
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
npm install -g openclaw

# === 配置 ===
hermes setup                    # 交互式配置
hermes model                    # 选择模型
hermes config                   # 查看配置
hermes doctor                   # 检查问题
nano ~/.hermes/profiles/hermes-bot/.env    # 编辑密钥

# === 使用 ===
hermes                          # 交互式聊天
hermes chat -q "问题"           # 单次查询
openclaw                        # OpenClaw 交互
openclaw -q "问题"              # OpenClaw 单次

# === Gateway ===
hermes gateway install          # 安装服务
hermes gateway start/stop       # 启停
hermes gateway restart          # 重启
hermes gateway status           # 状态
hermes gateway setup            # 配置平台

# === 管理 ===
hermes sessions list            # 会话列表
hermes skills list              # 技能列表
hermes tools list               # 工具列表
hermes cron list                # 定时任务
hermes profile list             # Profile 列表