Hermes Agent 中文 FAQ

Hermes Agent 是 Nous Research 开源的自托管 AI Agent（MIT 协议）。和 ChatGPT / Claude 这类聊天产品最大的区别是：它是一个持续运行在你服务器上的 Agent 本体，拥有持久记忆和 Skills 系统。普通聊天 AI 每次对话都从零开始；Hermes 能记住你昨天说过的话，能把多步任务封装成可复用的 Skill，越用越懂你。

不是官方站点。本站是社区作者维护的中文学习指南，不隶属 Nous Research。官方文档在 hermes-agent.nousresearch.com。本站所有教程都基于官方 API 亲测复现，遇到与官方文档不一致的地方，以官方为准。

是的，MIT 协议开源，代码在 GitHub / NousResearch / hermes-agent。商用、修改、二次分发都允许，只需保留原始许可证声明。工具本身免费，你只为选用的 LLM API（OpenAI、Anthropic、OpenRouter、DeepSeek 等）付费——用本地模型则完全零成本。

两者基因相似，哲学不同。OpenClaw 是"围绕消息网关的 Agent"，强调广度集成；Hermes 是"围绕学习 Agent 的网关"，强调深度学习。最大差异在两点：

• Skills 系统——OpenClaw 的 skills 是人写的静态模板；Hermes 能从你完成的任务中自动提炼可复用的 skill，越用越强。
• 记忆系统——OpenClaw 用 Markdown 文件；Hermes 用 SQLite + FTS5 全文检索 + LLM 压缩的四层记忆，能精确调起几周前的对话。

官方提供一键迁移命令 hermes claw migrate，可自动导入 SOUL.md / MEMORY.md / skills / API Keys。详见 迁移指南。

原生 Windows 不支持，必须通过 WSL2。官方支持的环境是 Linux / macOS / WSL2 / Android（Termux）。一条命令装好依赖：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
不要加 sudo——安装器默认装到 ~/.local/bin，加 sudo 反而会把脚本装到 /usr/local/bin 导致路径混乱。如果你之前误用 sudo 装过，先 sudo rm /usr/local/bin/hermes 清掉再重装。Android 用户把 .[all] 改成 .[termux]。装机完整流程见 Day 1 · 安装 Hermes，说出第一句话。

取决于你用云端 LLM 还是本地 LLM：

• 云端 API（OpenAI / OpenRouter / DeepSeek）——5 美元的小 VPS 就够，所有算力都在云端，本地只做编排。
• 完全本地跑——建议 32B+ 参数的模型，至少 24 GB 显存。

其他硬性要求：Python ≥ 3.11，所选模型的上下文窗口必须 ≥ 64K tokens——小于这个数的模型在启动时会被直接拒绝（因为多步工具调用装不下）。模型选型与本地推理实战见 Day 2 · 挑个大脑。

全部支持。Hermes 接任何 OpenAI 兼容 API —— DeepSeek、Kimi（Moonshot）、智谱 AI（z.ai / GLM）、MiniMax、小米 MiMo、Qwen、NVIDIA NIM、OpenRouter（200+ 模型聚合）、OpenAI、Anthropic、Google 全都可以。只要目标服务实现了 /v1/chat/completions，用 hermes model 命令就能切过去。切换不需要重启，记忆和 Skills 跨模型保留。

可以。先起一个本地推理服务（Ollama / vLLM / llama.cpp / SGLang 都行），然后运行 hermes model → 选 "Custom endpoint" → 填 http://localhost:11434/v1（Ollama 默认端口），就彻底离线了，不再访问任何公网 API。注意本地模型要选 32B+ 的、且原生支持 64K 上下文的。

工具本身免费，费用只来自你调用的 LLM：

• 纯本地模型——0 元/月
• 国产 API（DeepSeek、Kimi、智谱）——轻度使用 5–30 元/月
• Claude / GPT——轻度使用 20–100 元/月；日常深度使用 100–500 元/月
• OpenRouter 路由——按实际模型价格，可随时切换成便宜模型

省钱建议：日常用 DeepSeek / Kimi，重要任务切到 Claude。hermes model 随时切，历史记忆不丢。多模型路由配置见 Day 2 · 挑个大脑。

Hermes 自带 Messaging Gateway，同时支持：

• 个人微信——itchat 协议，QR 扫码登录，适合个人助理
• 企业微信（WeCom）——企业级 webhook，适合团队助理

基础 3 步：

1. 在 ~/.hermes/config.yaml 里开 messaging.weixin.enabled: true
2. 配好 allowlist（只响应指定微信号 / 群，防止误触）
3. 运行 hermes gateway run，扫码登录

完整 step-by-step（含 .env 配置、群策略、常见踩坑）见 Day 3 · 入驻聊天室。注意：每个 profile 必须绑独立微信号，不能多 profile 共用一个账号。

两者都是 Hermes 的"持久状态"，职责分明：

• Memory（事实记忆）——关于你和你项目的事实：你的名字、偏好、正在做的项目、过去对话里提过的任何内容。按相关度自动检索。
• Skills（程序记忆）——完成某类任务的操作步骤，例如"部署 Next.js 到 Vercel"、"生成周报"、"排查 nginx 502"。遇到相似任务时 Hermes 会自动调用。

一句话：Memory 回答"你知道什么"，Skills 回答"你会做什么"。两者跨会话、跨模型都保留。Memory 实战见 Day 6 · 记忆与状态，Skills 实战见 Day 5 · 教它新本事。

API 请求只发到你配置的 LLM 提供商——Nous Research 不收集任何遥测数据。对话记录、记忆、Skills 全部存在本地 ~/.hermes/ 目录下的 SQLite 数据库。

• 完全不想联网？配本地模型即可（见上一组 Q8）
• 想要加密备份？直接打包 ~/.hermes/ 就行
• 企业合规场景？搭私有 OpenAI-compatible endpoint（比如自部署 vLLM），公司数据不出内网

内置工具与 endpoint 配置详见 Day 4 · 调用内置工具。

安装器把 hermes 装到 ~/.local/bin/，但这个路径不在所有 shell 的默认 PATH 里。两步解决：

1. source ~/.zshrc（或 ~/.bashrc）重新加载 shell 配置；或干脆关掉终端开一个新的。
2. 还不行就 echo $PATH 确认是否包含 ~/.local/bin。没有就手动把 export PATH="$HOME/.local/bin:$PATH" 加到 profile 文件末尾。

装机踩坑合集见 Day 1 · 安装 Hermes。

三板斧：

• hermes doctor——官方自带诊断命令，会逐项检查依赖、配置、模型连通性，告诉你缺什么、哪里错了、怎么修。
• ~/.hermes/logs/——所有运行日志，按日期滚动，排查网关连接问题首先看这里。
• 官方 FAQ & Troubleshooting——覆盖 WSL systemd 不稳定、WhatsApp 断连、MCP 工具不显示、Telegram 日志过载等常见场景。

最常见的 429 限流错误：等几秒重试、升级套餐，或 hermes chat --provider <备用> 临时切到其他提供商。全自动化运行与诊断流程见 Day 7 · 全自动化与诊断。