Hermes Agent

一、产品简介

Hermes Agent 是 Nous Research 构建的自进化 AI Agent，强调长期记忆、Skills 自动沉淀、跨会话经验复用、消息平台接入和多后端运行。通过 yunzhuai，Hermes Agent 可以使用统一的 OpenAI-compatible 模型入口，把 GPT、Claude、Gemini、DeepSeek、Kimi 等模型放到同一套 Agent 工作流里。适合以下场景：

需要一个可长期运行的个人或团队 Agent
希望 Agent 能记住经验、复用 Skills、处理定时任务
想把 Agent 部署在本机、VPS、Docker、SSH 或云端环境
希望用 yunzhuai 统一模型、密钥、账单和供应商切换

二、安装 Hermes Agent

macOS / Linux / WSL2

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

Homebrew

brew install hermes-agent

安装后检查版本：

hermes --version

三、配置 yunzhuai 模型

Hermes Agent 支持自定义 OpenAI-compatible endpoint。推荐把 yunzhuai 作为 custom provider 使用。

1. 写入 API Key

hermes config set OPENAI_API_KEY sk-xxxxxxxxxxxxxxxx

API Key 会写入 Hermes 的 .env，避免直接散落在多个项目目录。

2. 设置模型入口

hermes config set model.provider custom
hermes config set model.base_url https://api.gzyzhuai.com/v1
hermes config set model.default kimi-k2.7-code
hermes config set model.api_mode chat_completions

也可以手动编辑：

~/.hermes/config.yaml

示例：

model:
  provider: custom
  default: kimi-k2.7-code
  base_url: https://api.gzyzhuai.com/v1
  api_mode: chat_completions

如果要切换模型，只需要把 model.default 改成 yunzhuai 模型列表中的其他模型 ID，例如 claude-opus-4-8、gpt-5.5、deepseek-v4-pro、glm-5.2 或 MiniMax-M3。也可以使用 hermes model 进入交互式模型选择流程。

四、启动与验证

1. 启动 CLI 对话

hermes chat

发送测试问题：

请说明你当前的模型配置，并给出一个适合长期记忆的使用建议。

2. 使用 TUI

hermes --tui

3. 检查配置

hermes config get model.provider
hermes config get model.base_url
hermes config get model.default

如果能正常返回，并且 yunzhuai 控制台出现请求记录，说明模型入口配置成功。

五、推荐模型策略

场景	推荐模型	说明
长期个人 Agent	`kimi-k2.7-code`	长上下文任务、资料整理、连续对话和代码协作
复杂编程和工具调用	`claude-opus-4-8`	复杂代码任务、重构、审查和长链路代理任务
OpenAI 兼容编程	`gpt-5.5`、`gpt-5.4`	通用编程、代码分析和开发者工具链场景
中文 Coding Agent	`deepseek-v4-pro`、`glm-5.2`	工具调用、环境交互和中文工程上下文
快速低成本辅助	`MiniMax-M3`、`glm-5.2`	摘要、分类、批处理和低延迟辅助任务

具体可用模型以 yunzhuai 模型列表为准。

六、与 Skills 和记忆配合

Hermes Agent 的优势不只是调用模型，而是把长期经验沉淀为可复用能力。接入 yunzhuai 后，建议按以下方式使用：

能力	建议
Skills	把稳定流程沉淀为 Skills，减少重复提示词
Memory	让 Hermes 记录长期偏好、项目背景和常用约束
Subagents	复杂任务拆给独立子任务并行处理
Messaging Gateway	接入 Telegram、Discord、Slack 等平台后远程触发任务
Fallback	关键工作流可配置备用模型，降低单模型失败影响

七、常见问题

Hermes 仍然尝试走其他供应商

确认 model.provider 已设置为 custom
检查 ~/.hermes/config.yaml 中是否有旧的 provider 配置覆盖
重启 Hermes 会话后再验证

模型返回 401 或 invalid api key

确认 OPENAI_API_KEY 是 yunzhuai API Key
重新执行 hermes config set OPENAI_API_KEY sk-...
检查 yunzhuai 控制台中该 Key 是否有效

请求地址错误

Hermes 的 OpenAI-compatible 自定义入口应使用 https://api.gzyzhuai.com/v1
不要使用 Claude Code 的 ANTHROPIC_BASE_URL 配置方式
如果手动编辑 YAML，注意缩进和字段名

八、参考链接

Hermes Agent 文档：https://hermes-agent.nousresearch.com/docs/
Hermes Agent GitHub：https://github.com/NousResearch/hermes-agent
Homebrew hermes-agent：https://formulae.brew.sh/formula/hermes-agent

对话型 AI

编程开发

技术工程

翻译场景

一、产品简介

二、安装 Hermes Agent

macOS / Linux / WSL2

Homebrew

三、配置 yunzhuai 模型

1. 写入 API Key

2. 设置模型入口

四、启动与验证

1. 启动 CLI 对话

2. 使用 TUI

3. 检查配置

五、推荐模型策略

六、与 Skills 和记忆配合

七、常见问题

八、参考链接

​一、产品简介

​二、安装 Hermes Agent

​macOS / Linux / WSL2

​Homebrew

​三、配置 yunzhuai 模型

​1. 写入 API Key

​2. 设置模型入口

​四、启动与验证

​1. 启动 CLI 对话

​2. 使用 TUI

​3. 检查配置

​五、推荐模型策略

​六、与 Skills 和记忆配合

​七、常见问题

​八、参考链接

一、产品简介

二、安装 Hermes Agent

macOS / Linux / WSL2

Homebrew

三、配置 yunzhuai 模型

1. 写入 API Key

2. 设置模型入口

四、启动与验证

1. 启动 CLI 对话

2. 使用 TUI

3. 检查配置

五、推荐模型策略

六、与 Skills 和记忆配合

七、常见问题

八、参考链接