Hermes Agent

Hermes Agent 是可扩展的智能代理，支持终端、消息平台、Skills 和 MCP。它可以通过自定义 OpenAI 兼容端点使用猫咖啡 API。

安装

macOS / Linux / WSL

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows PowerShell

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

重新打开终端后检查：

hermes doctor

配置模型

Hermes 配置通常位于 ~/.hermes/config.yaml。将主模型配置为自定义提供商：

model:
  provider: custom
  default: 控制台中的模型 ID
  base_url: https://coffeecatbox.cc/v1
  api_mode: chat_completions

在 ~/.hermes/.env 中保存令牌：

OPENAI_API_KEY=sk-你的令牌

Responses 模型

如果你明确选择支持 Responses 的 Codex 类模型，可以尝试把 api_mode 改为 codex_responses。普通 OpenAI 兼容模型保持 chat_completions。

启动

hermes

也可用设置向导和模型选择器：

hermes setup
hermes model

先执行一个不涉及文件写入的简单任务，确认模型、地址和令牌正确。

安全配置

Hermes 能执行终端命令并连接消息平台。建议：

• 初次使用保留命令审批；
• 为 Hermes 单独创建限额令牌；
• 不向机器人开放未经认证的公共消息入口；
• 检查 Skills 和 MCP 来源；
• 不在工作目录中放置可被读取的明文密钥。

常见问题

仍使用其他提供商

运行 hermes model 检查当前 provider，并确认 config.yaml 顶级 model.provider 是 custom。

401 未授权

确认 ~/.hermes/.env 中变量名为 OPENAI_API_KEY，重新启动 Hermes。

工具调用失败

选择支持 OpenAI 原生工具调用的模型。普通对话模型可能可以回答问题，但无法完成代理任务。

Responses 配置失败

改回 api_mode: chat_completions 验证基础连接，再确认模型渠道是否支持 /v1/responses。