跳转到内容
AI 工具文档

Hermes Agent

适合谁

Section titled “适合谁”

想要带持久记忆、可沉淀 Skills 的本地 Agent，并希望模型流量走自己网关的用户。

官网参考：https://hermes-agent.org/

安装

Section titled “安装”

常见方式之一是用 npm 全局安装。若还没有 Node.js / npm，先完成 安装 Node.js 与 npm。

npm install -g hermes-agent

或以官方安装脚本为准（推荐以官网当前文档为准）：

# 示例：按官网最新 install 脚本执行
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

初始化：

hermes setup
# 或
hermes model

前置条件

Section titled “前置条件”
  • API Key、{{API_BASE_URL}}、{{MODEL_NAME}}
  • 建议配合 AI Toolbox

方式一：AI Toolbox（推荐）

Section titled “方式一：AI Toolbox（推荐）”

进入 Hermes 页面添加供应商，Base URL 填 {{API_BASE_URL}}。模型不在添加时填写，保存后到卡片 模型列表 里拉取并设为默认，再 应用。详见 AI Toolbox。

也可以用 CC Switch：

  1. CC Switch → 添加供应商
  2. 勾选 Hermes
  3. 填写 Key 与 {{API_BASE_URL}}
  4. 设置默认模型
  5. 启用后新开终端，运行 hermes

CC Switch 通常维护用户级配置：

文件 macOS / Linux Windows
主配置 ~/.hermes/config.yaml %USERPROFILE%\.hermes\config.yaml
密钥 ~/.hermes/.env %USERPROFILE%\.hermes\.env

方式二：手动配置

Section titled “方式二：手动配置”

在 config.yaml / .env 中配置 custom provider：

  • provider endpoint：{{API_BASE_URL}}
  • api key：写入 .env，避免明文提交到 Git
  • default model：{{MODEL_NAME}}

改认证类配置后，按官方说明重启（例如 gateway restart，若你启用了网关模式）。

验证

Section titled “验证”
hermes
# 或
hermes chat -q "请只回复：配置成功"

常见问题

Section titled “常见问题”
  • 找不到命令：检查 npm 全局 bin 是否在 PATH
  • provider 无效：确认 Base URL 与协议匹配
  • Skills / MCP 丢失：切换供应商后检查 AI Toolbox 或 CC Switch 是否应用了通用配置片段