Hermes Agent 接入
Hermes Agent 是一款功能强大的 AI 代理框架,支持工具调用、浏览器自动化、代码执行、文件操作等能力。通过将 Hermes Agent 接入 UniGateway,你可以通过单一统一端点访问主流厂商的多种模型,实现集中密钥管理、自动回退,且无需修改任何上游 SDK。
前置条件
- 操作系统:Linux / macOS / WSL2 / Android (Termux)
- 已安装 Git
- 有效的 UniGateway API Key
Python 3.11、Node.js v22、ripgrep、ffmpeg 等依赖由安装脚本自动处理,无需预先安装。
配置
第 1 步:安装 Hermes Agent
在终端中执行以下命令安装 Hermes Agent:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装完成后重新加载 shell 配置:
source ~/.bashrc # zsh 用户请运行 source ~/.zshrc
第 2 步:配置 UniGateway 连接
运行命令进入配置向导:
hermes model
在向导中选择 Custom endpoint (enter URL manually),然后依次输入以下字段:
| 字段 | 值 |
|---|---|
| API Base URL | https://api.unigateway.ai |
| API Key | 你的 UniGateway API Key |
| 模型名称 | 例如 gpt-5.5、claude-sonnet-4-6(使用 GET /v1/models 返回的精确 ID) |
配置会自动写入 ~/.hermes/config.yaml,无需手动编辑。
最后验证
启动 Hermes Agent 并发送一条测试消息:
hermes
随便发一句话(例如 你好,请只回复"嗨!"),如能正常收到回复则配置成功。