Hermes Agent

Hermes Agent 是 Nous Research 构建的终端原生自治编程代理，支持持久记忆、技能创建、消息网关和多种运行后端。通过自定义 OpenAI 兼容端点，可以将 Hermes Agent 接入 WisGate。

一、安装 Hermes Agent

请先按照 Hermes Agent 官方文档完成安装。安装完成后确认命令可用：

hermes --version

二、使用交互式模型选择器

Hermes 推荐使用交互式模型选择器配置模型：

hermes model

在模型配置流程中选择自定义 OpenAI-compatible endpoint，并填写：

• Base URL：https://api.wisgate.cn/v1
• API Key：您的 WisGate API Key
• Model：例如 gpt-5.5

三、手动配置

Hermes 的密钥通常放在 ~/.hermes/.env，模型与非密钥配置放在 ~/.hermes/config.yaml。

在 ~/.hermes/.env 中写入：

OPENAI_API_KEY=your_wisgate_api_key
OPENAI_BASE_URL=https://api.wisgate.cn/v1

在 ~/.hermes/config.yaml 中配置模型：

model:
  provider: custom
  default: gpt-5.5
  base_url: https://api.wisgate.cn/v1

如果您的 Hermes 版本使用 model.default 以外的字段名，请优先以 hermes model 生成的配置为准。

四、开始使用

hermes

或使用 TUI：

hermes --tui

使用场景

• 自治开发任务：让 Hermes 在本地、Docker、SSH 或远程后端执行多步骤开发任务。
• 持久记忆：跨会话保留项目偏好、经验和技能。
• 消息网关：通过 Telegram、Discord、Slack 等平台触发 Agent 工作流。
• 辅助模型：为压缩、视觉、标题等轻量任务单独配置更便宜的 WisGate 模型。

常见问题

找不到 API Key

请确认 ~/.hermes/.env 中有 OPENAI_API_KEY，并重启 Hermes。

模型或上下文报错

请确认模型 ID 为 WisGate 支持的模型，并优先选择上下文窗口足够大的模型。OpenAI 兼容 Base URL 使用 https://api.wisgate.cn/v1。