Hermes Agent 安装教程（macOS）

0. 前置：安装 Python

Hermes Agent 需要 Python 3.8+，建议使用 3.10+。

检查是否已安装：

python3 --version

如果看到版本号且 >= 3.8，可以跳过安装。

安装 Python（推荐用 Homebrew）：

brew install python

1. 安装 Hermes Agent

推荐方式：pipx（隔离安装，不污染全局环境）

pip install pipx
pipx ensurepath

重新打开终端后，执行：

pipx install hermes-agent

备选方式：pip

pip3 install hermes-agent

验证安装：

hermes --version

如果看到版本号，说明安装成功了。

2. 配置 Hermes（接入闪电API）

2.1 配置文件在哪里？

Hermes 配置文件路径：~/.hermes/config.yaml

2.2 创建配置目录

mkdir -p ~/.hermes

2.3 写入配置文件

根据你要使用的模型类型，选择下面其中一种写法。

Claude / Anthropic（不带 /v1）：

cat > ~/.hermes/config.yaml << 'EOF'
models:
  default: flashapi-claude/claude-opus-4-6

providers:
  flashapi-claude:
    type: anthropic
    base_url: https://ai.flashapi.top
    api_key: 你的闪电API Key
    api_key_env: ANTHROPIC_API_KEY
    default_model: claude-opus-4-6
    models:
      - claude-opus-4-6
EOF

GPT / OpenAI（必须带 /v1）：

cat > ~/.hermes/config.yaml << 'EOF'
models:
  default: flashapi-codex/gpt-5.5

providers:
  flashapi-codex:
    type: openai
    base_url: https://ai.flashapi.top/v1
    api_key: 你的闪电API Key
    api_key_env: OPENAI_API_KEY
    default_model: gpt-5.5
    models:
      - gpt-5.5
EOF

必须替换：把 你的闪电API Key 替换成你从闪电API官网复制的真实 Key。

2.4 验证配置文件

cat ~/.hermes/config.yaml

3. 启动并验证

hermes

常见问题

1. 提示找不到 hermes 命令

原因：pipx 安装路径没有加到 PATH。

解决方法：

pipx ensurepath

然后重新打开终端。

2. npm install -g 报权限错误

Hermes 是 Python 工具，不走 npm。如果遇到权限问题，推荐用 pipx 而不是 pip3 install --user。

3. API 调用失败

1. 检查配置文件：cat ~/.hermes/config.yaml
2. 确认 API Key 正确，令牌分组已创建
3. 确认 Claude 接口不带 /v1，GPT 接口带 /v1