一、安装 Hermes Agent
1.1 一键安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装过程会自动：
- 克隆代码到
~/.hermes/hermes-agent/ - 创建 Python 虚拟环境
- 安装所有依赖
1.2 验证安装
hermes --version
输出类似：
Hermes Agent v0.10.0 (2026.4.16)
Project: ~/.hermes/hermes-agent
Python: 3.11.15
1.3 检查目录
ls ~/.hermes/
# hermes-agent/ profiles/
ls ~/.hermes/profiles/hermes-bot/
# config.yaml .env skills/ sessions/ logs/
二、配置 API 密钥
2.1 编辑密钥文件
nano ~/.hermes/profiles/hermes-bot/.env
添加你的 API 密钥（选一个即可）：
# 方案一：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 设置模型
hermes model
交互式选择，例如选 DeepSeek → deepseek-chat。
或者直接写配置：
cat > ~/.hermes/profiles/hermes-bot/config.yaml << 'EOF'
model:
default: deepseek-chat
provider: deepseek
EOF
2.3 验证配置
hermes config
检查 Model 行是否正确显示你选的模型。
hermes doctor
检查依赖和配置是否有问题。
三、使用 Hermes CLI
3.1 启动交互式聊天
hermes
进入后直接打字对话，输入 /help 查看命令。
3.2 单次查询（不进入交互）
hermes chat -q "什么是 Docker？简短回答"
3.3 常用斜杠命令
在 hermes 交互界面中输入：
# 新建会话
/new
# 查看/切换模型
/model deepseek-chat
# 查看配置
/config
# 查看已安装技能
/skills
# 加载某个技能
/skill hermes-agent
# 查看帮助
/help
# 退出
/quit
3.4 管理工具
# 列出所有工具
hermes tools list
# 启用浏览器工具
hermes tools enable browser
# 禁用某个工具
hermes tools disable vision
3.5 安装技能
# 浏览可用技能
hermes skills browse
# 搜索技能
hermes skills search docker
# 安装技能
hermes skills install <skill-id>
# 查看已安装
hermes skills list
四、安装 Gateway（后台服务）
Gateway 让 Hermes 跑在飞书/Telegram 等平台上，24 小时不间断。
4.1 前台测试
hermes gateway run
看到 Gateway started 表示成功，Ctrl+C 停止。
4.2 安装为 macOS 后台服务
hermes gateway install
这会创建 LaunchAgent，开机自动启动。
4.3 管理服务
# 启动
hermes gateway start
# 停止
hermes gateway stop
# 重启（修改配置后需要重启）
hermes gateway restart
# 查看状态
hermes gateway status
4.4 配置飞书 Bot
第一步：创建飞书应用
- 打开 https://open.feishu.cn/
- 创建企业自建应用
- 添加「机器人」能力
- 记下 App ID 和 App Secret
第二步：配置权限
在「权限管理」中开通：
im:message— 获取与发送单聊、群组消息im:message.group_at_msg— 接收群聊 @ 消息im:resource— 获取消息中的资源文件
第三步：添加密钥
nano ~/.hermes/profiles/hermes-bot/.env
添加：
FEISHU_APP_ID=cli_xxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxx
FEISHU_VERIFICATION_TOKEN=xxxxxxxxxx
第四步：配置平台
hermes gateway setup
选择 Feishu，按提示填写。
第五步：重启生效
hermes gateway restart
4.5 配置 Telegram Bot
第一步：创建 Bot
在 Telegram 找 @BotFather：
/newbot
# 按提示输入名称
# 记下 Token
第二步：添加密钥
nano ~/.hermes/profiles/hermes-bot/.env
添加：
TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
第三步：重启
hermes gateway restart
4.6 查看日志
# 实时查看日志
tail -f ~/.hermes/profiles/hermes-bot/logs/gateway.log
# 查看错误
tail -f ~/.hermes/profiles/hermes-bot/logs/gateway.error.log
五、安装 OpenClaw
5.1 安装
npm install -g openclaw
5.2 验证
openclaw --version
# OpenClaw 2026.4.29 (a448042)
5.3 使用
# 交互式
openclaw
# 单次查询
openclaw -q "写一个 Python 快速排序"
# 指定容器运行
openclaw --container myapp -q "检查代码"
5.4 Hermes vs OpenClaw
# Hermes：全功能，适合复杂任务
hermes chat -q "帮我写一个完整的 REST API，包含数据库、认证、测试"
# OpenClaw：轻量快速，适合简单任务
openclaw -q "这段代码有什么 bug？"
六、日常使用技巧
6.1 会话管理
# 列出最近会话
hermes sessions list
# 恢复上次会话
hermes --continue
# 恢复指定会话
hermes --resume 20260503_120000_abc123
6.2 定时任务
# 创建：每天早上 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）：
nano ~/.hermes/profiles/hermes-bot/.env
添加：
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890
6.4 Profile 多实例
# 列出 profiles
hermes profile list
# 创建新 profile
hermes profile create work
# 使用新 profile
hermes -p work
# 或者切换默认
hermes profile use work
七、常见问题
Q1: hermes 命令找不到？
# 检查 PATH
echo $PATH
# 手动添加（zsh）
echo 'export PATH="$HOME/.hermes/hermes-agent/venv/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Q2: Gateway 断开？
# macOS 检查服务状态
hermes gateway status
# 重新安装服务
hermes gateway install
hermes gateway start
Q3: 工具不生效？
# 检查工具状态
hermes tools list
# 在会话中重置（工具修改后需要）
/new
Q4: API 报错？
# 检查密钥
cat ~/.hermes/profiles/hermes-bot/.env
# 检查配置
hermes config
# 全面检查
hermes doctor
Q5: 日志在哪？
# Gateway 日志
~/.hermes/profiles/hermes-bot/logs/gateway.log
# 错误日志
~/.hermes/profiles/hermes-bot/logs/gateway.error.log
八、命令速查表
# === 安装 ===
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 列表