Hermes Agent 配置

Hermes Agent 是面向 本地终端、自动化任务和长期助手工作流 的 AI Agent。它更像一个可以持续使用的个人助理，而不是只面向单次代码补全的 CLI。

适合这些场景

• 想在终端里直接和 Agent 对话
• 想让 Agent 调用工具、读写文件或执行命令
• 想把同一个助手接入更多平台或长期任务
• 想使用自定义 OpenAI 兼容接口接入第三方模型

:::danger 安全提醒 Hermes Agent 可以调用终端和本地工具。第一次配置时建议先在普通测试目录里验证，不要直接把重要项目目录作为高权限工作区。 :::

安装前说明

要求	说明
Python	3.11+
网络	可正常访问 GitHub 或 PyPI
系统	macOS / Linux / WSL2
凭据	可用的 187API 账号和 API Key
模型	该分组下当前可用的模型名称

:::tip Windows 用户 如果会长期用 Hermes Agent 处理代码、终端命令和项目依赖，建议优先安装 WSL2，然后在 WSL2 的 Ubuntu 终端里按 Linux 方式安装。 :::

第一步：安装

有多种安装方式，选一种即可，不要混用。

方式一：pip

已经有可用 Python 环境时：

pip install hermes-agent
hermes postinstall

权限不足时：

python -m pip install --user hermes-agent

方式二：官方安装脚本

希望一次性补齐依赖时：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc   # zsh 用 source ~/.zshrc

方式三：pipx（与其他 Python 项目隔离）

python -m pip install --user pipx
python -m pipx ensurepath
# 重新打开终端后
pipx install hermes-agent

第二步：验证安装

重新打开终端，依次运行：

hermes --version
hermes doctor

能输出版本号、且 hermes doctor 没提示关键依赖缺失，就算装好了。

:::tip 提示找不到 hermes 命令 说明当前终端还没加载新 PATH。先关掉终端重开；仍不行就按系统重新加载 shell 配置（source ~/.zshrc 或 source ~/.bashrc）。 :::

第三步：接入 187API

Hermes Agent 支持通过自定义 OpenAI 兼容端点接入第三方 API。

项	值
Base URL	https://187api.com/v1
API Key	对应分组的令牌
Model	该分组下当前可用的模型名称

使用 Hermes 自带的模型配置向导：

hermes model

在 Select provider 中选择 custom (direct API)。

:::tip 菜单编号会随版本变化 请按选项名称选择，不要只依赖文档截图里的编号。 :::

按分组配置

如果要同时接入不同协议/分组的场景（如 Codex、Claude Code、Gemini），请分别运行 hermes model 添加或切换对应配置。

场景	协议	Base URL
OpenAI 兼容（Codex 等）	OpenAI	https://187api.com/v1
Anthropic（Claude Code 等）	Anthropic	https://187api.com

创建令牌的注意事项

创建令牌时建议将 模型可用列表留空。填了之后，若列表中不包含当前使用的模型，请求会返回 403。

第四步：验证

在 Hermes 里发一条 你好，然后到控制台 日志 页确认有调用记录。

排错

现象	优先检查
找不到 hermes 命令	PATH 未刷新，重开终端
403	令牌「模型可用列表」限制了当前模型 → 留空
404	Base URL 协议选错（OpenAI 要带 /v1）
模型不支持	模型名与模型广场不一致

---

相关：客户端接入总览 · Agent 客户端配置大全 · [常见问题]../reference/faq/overview