Hermes Deploy

0. 网络问题（中国大陆）

问题: GitHub 连接超时或失败

解决:

# 使用 ZIP 下载而非 git clone
cd /tmp
curl -fsSL https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip -o hermes.zip
unzip -q hermes.zip
mv hermes-agent-main ~/.hermes/hermes-agent

或者使用代理:

export https_proxy=http://your-proxy:port
git clone https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent

1. GitHub 克隆失败

问题: fatal: unable to access 'https://github.com/...'

解决: 使用 ZIP 下载方式：

cd /tmp
curl -fsSL https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip -o hermes.zip
unzip -q hermes.zip
mv hermes-agent-main ~/.hermes/hermes-agent

2. 飞书连接失败

问题: No messaging platforms enabled

解决: 检查 .env 配置：

cat ~/.hermes/.env | grep FEISHU
确认 FEISHU_APP_ID 和 FEISHU_APP_SECRET 已配置

3. 401 认证错误

问题: Error code: 401 - Missing Authentication header

解决: 在 config.yaml 中添加 api_key：

model:
  default: "qwen3.5-plus"
  base_url: "https://coding.dashscope.aliyuncs.com/v1"
  api_key: "sk-YOUR_API_KEY"  # 添加这行

5. Gateway 启动失败

问题: Failed to connect to bus: No medium found

解决: 直接运行，不使用 systemd：

hermes gateway run &

6. 权限问题

问题: Permission denied

解决:

# 确保使用正确的用户
whoami
如果是 root，确保路径权限正确
chmod 700 ~/.hermes
chown -R $USER:$USER ~/.hermes

7. 日志查看

# 实时查看日志
tail -f ~/.hermes/logs/gateway.log
查看最近 50 行
tail -50 ~/.hermes/logs/gateway.log
查看错误日志
grep -i error ~/.hermes/logs/gateway.log

8. 配置检查

# 检查 Hermes 配置
hermes config
检查 .env 文件
cat ~/.hermes/.env
检查配置有效性
hermes config check

9. 自动迁移失败

问题: hermes claw migrate 命令失败

解决: 1. 确保 Hermes 已正确安装 2. 检查 OpenClaw 配置路径是否正确