🐎 Hermes Agent 完全配置优化指南

⚡ curl 一键安装（Linux/macOS/WSL2 推荐）#

1
# 官方安装方式：pip install hermes-agent（要求 Python 3.11+）
2
# 或使用官方托管安装器 / 官方桌面版
3
pip install hermes-agent
4

5
hermes setup   # 运行初始配置向导

支持：Ubuntu 22.04+ / Debian 12+ / macOS 13+ / WSL2 (Ubuntu) / Fedora / Arch

☁️ 官方云托管版（最省心，60 秒上线）#

1. 访问 hermes.nousresearch.com
2. 注册账号，选择云托管实例
3. 配置 API Key（DeepSeek/OpenAI 等）
4. 60 秒内自动部署完成，获得 Web UI 访问地址
5. 无需自己维护服务器，自动更新

适合： 不想折腾服务器的用户、需要公网访问（微信/钉钉 webhook）的场景、团队共享使用。

🐳 Docker 部署（服务器推荐）#

1
docker run -d \
2

3
--name hermes \
4

5
-p 3000:3000 \
6

7
-v ~/.hermes:/root/.hermes \
8

9
-v /var/run/docker.sock:/var/run/docker.sock \
10

11
--restart unless-stopped \
12

13
nousresearch/hermes-agent:latest

访问 http://localhost:3000 打开 Web UI，首次进入会引导配置。

🪟 Windows 安装#

1
# PowerShell 中启用 WSL2
2

3
wsl --install -d Ubuntu
4

5
# 进入 Ubuntu 后
6

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

1
# 下载 Windows 安装包
2

3
# 访问 hermes-agent.nousresearch.com/docs/install
4

5
# 或使用 npm（需 Node.js 18+）
6

7
# 原「npm install -g @nous/hermes-agent」不存在——Hermes Agent 是 Python 项目，没有 npm 包
8
pip install hermes-agent
9

10
hermes setup

🖥️ 桌面版优势场景#

• 日常对话和配置（GUI 可视化）
• Context Meter 实时监控上下文用量
• Projects 项目管理（多项目隔离）
• Remote Agents 远程实例管理
• 记忆可视化浏览和管理
• 非技术用户和日常使用首选

💻 终端版优势场景#

• 服务器/SSH 远程管理（无 GUI）
• TUI 界面（hermes —tui），终端里也能鼠标操作
• 自动化脚本和 CI/CD 集成
• 批量配置（config set 管道）
• 查看原始日志和调试
• 开发者和运维首选

下载地址： 官方桌面版 hermes-agent.nousresearch.com/desktop/（macOS/Win/Linux）；中文社区桌面版 desktop.hermesagent.org.cn（v0.6.3，支持 Linux）。Web UI 启动后访问 http://localhost:3000。

▍步骤 1：选择模型提供商#

• 支持 470+ 种模型（OpenRouter 对 Hermes App 的计数快照，随日期变化；官方口径为「模型无关、可接数十家 provider」）
• 国内推荐：DeepSeek（性价比最高）、Kimi、GLM、通义千问
• 输入 API Key，选择默认模型

▍步骤 2：配置记忆系统（Hermes 核心）#

• 启用持久化跨会话记忆（默认开启）
• 选择记忆后端：SQLite（本地）/ PostgreSQL（服务器）
• 配置记忆整理频率（建议：每天一次，不要太频繁）

▍步骤 3：选择终端后端#

• local：直接在本机执行命令（最简单）
• docker：在 Docker 容器中执行（安全隔离，推荐）
• ssh：通过 SSH 在远程服务器执行
• modal：Modal 云函数执行
• Daytona / Singularity / serverless：其他隔离执行后端（官方列出的后端为 local / Docker / SSH / Singularity / Modal / Daytona 共 6 类）

▍步骤 4：添加消息渠道#

• 微信：选择微信，扫码登录（官方 iLink，原生支持）
• 钉钉：选择钉钉，按提示创建机器人
• 飞书：选择飞书，填入 App ID / Secret
• Telegram：填入 Bot Token

验证安装： 运行 hermes status 查看运行状态，hermes doctor 诊断配置问题。Web UI 访问 http://localhost:3000。

▍添加模型提供商#

1
hermes config set model.provider deepseek
2

3
hermes config set DEEPSEEK_API_KEY "sk-你的key"  # UPPER_SNAKE 名称自动写入 ~/.hermes/.env
4

5
hermes config set model deepseek/deepseek-v4-pro   # 官方键名是 model，值是 provider/model

1
hermes config set model.provider openrouter
2

3
hermes config set OPENROUTER_API_KEY "sk-or-你的key"
4

5
hermes model   # 列出所有可用模型

1
hermes config set model.provider ollama
2

3
hermes config set terminal.backend docker
4
hermes config set model ollama/llama3       # 本地模型按 provider/model 形式填写

▍模型路由策略（省 Token 核心）#

1
# 主对话用强模型
2

3
hermes config set model.default "deepseek-v4-pro"
4

5
# 辅助任务模型：官方键名形如 auxiliary.<任务>.provider / auxiliary.<任务>.model
6
hermes config set auxiliary.compression.model deepseek-flash
7

8
# 上下文压缩用便宜模型
9

10
auxiliary.compression.model
11

12
# 记忆整理用便宜模型（Hermes特有，很重要！）
13

14
# 记忆整理属辅助任务，键名请以 hermes config 实际 schema 为准
15
hermes config set auxiliary.compression.model deepseek-flash

▍记忆系统工作原理#

1. 记忆提取： 每次对话中，Hermes 会自动识别值得记住的信息（偏好、事实、决策等）
2. 记忆存储： 存入 SQLite/PostgreSQL 数据库，带时间戳和来源会话
3. 记忆检索： 新对话开始时，用 FTS 检索相关记忆注入上下文
4. 记忆整理： 定期（默认每天）用 LLM 合并、去重、总结记忆，保持简洁

▍省 Token 的记忆配置#

1
# 1. 记忆整理不要太频繁（每天一次足够）
2

3
# （无此键）定时整理用 hermes cron，hermes curator run 可手动触发
4

5
# 2. 整理用最便宜的模型
6

7
# （无此键）整理模型随主模型
8

9
# 3. 限制单会话记忆条数，防止上下文爆炸
10

11
# （无此键）记忆规模用 hermes curator status 查看
12

13
# 4. 记忆注入时限制条数（只取最相关的N条）
14

15
# （无此键）记忆检索由 FTS+LLM 自动管理
16

17
# 5. 如果不需要跨会话记忆，可以关闭（最省）
18

19
hermes memory off                     # 真实命令（无 memory.enabled 键）

记忆管理命令： hermes curator status 查看所有记忆 · hermes curator usage 搜索记忆 · hermes curator pin 删除记忆 · hermes curator run 手动整理 · hermes memory clear 清空所有记忆（谨慎！）

▍技能系统配置#

1
# 启用自主技能创建
2

3
hermes curator pause                  # 暂停技能自动整理/创建（无 hermes curator（技能自动整理，无此键） 键）
4

5
# 重复N次类似任务才创建（设高一点省token）
6

7
# （无此键）
8

9
# 保存前让你确认（防止乱建技能浪费空间）
10

11
# （无此键）技能审查由 hermes curator 负责
12

13
# 技能创建用便宜模型
14

15
# （无此键）技能创建使用主模型；hermes curator pin 可保护技能

▍技能管理命令#

1
hermes skills list                    # 列出已安装技能
2

3
hermes skills search "关键词"          # 搜索技能
4

5
hermes skills install <名称>           # 安装技能
6

7
hermes skills uninstall <名称>         # 卸载技能
8

9
hermes skills create "描述"            # 手动创建技能
10

11
hermes skills update                   # 更新所有技能
12

13
hermes skills search "关键词" # 官方技能命令族：search / install / inspect / tap add
14
hermes tools            # 交互式启停工具集：hermes tools enable|disable <名称>

🔴 优化 1：控制记忆整理频率和模型（Hermes 特有，省 20-30%）#

记忆整理是 Hermes 独有的隐形 Token 消耗大户。每次整理 = 读取所有记忆 + LLM 总结 + 写回。如果频率太高或用了强模型，一天可能烧几十万 Token。

1
# 每天凌晨3点整理一次（不要每小时！）
2

3
# （无此键）定时整理用 hermes cron，hermes curator run 可手动触发
4

5
# 用最便宜的模型整理
6

7
# （无此键）整理模型随主模型
8

9
# 限制记忆条数，减少整理时的输入量
10

11
# （无此键）记忆规模用 hermes curator status 查看

🟠 优化 2：启用上下文压缩 + 限制自主行为（省 30-40%）#

1
# 启用上下文压缩
2

3
compression.enabled
4

5
compression.threshold_tokens
6

7
auxiliary.compression.model
8

9
# 自主技能创建设高阈值（重复5次才创建）
10

11
# （无此键）
12

13
# （无此键）技能审查由 hermes curator 负责
14

15
# 限制后台任务并发
16

17
# （无此键）定时任务用 hermes cron 管理

🟡 优化 3：子任务用便宜模型（省 20-30%）#

1
delegation.model
2

3
auxiliary.compression.model
4

5
# （无此键）整理模型随主模型
6

7
# （无此键）技能创建使用主模型；hermes curator pin 可保护技能

原则：只有主对话用 Pro 模型，其他所有辅助任务（子 Agent、压缩、记忆整理、技能创建）全部用 Flash。

🟢 优化 4：精简插件和技能（省 5-10%）#

每个已启用的插件和技能的描述都会进入系统提示词。Hermes 默认启用 40+ 工具，系统提示词本身就很长。卸载不用的可以明显减少每次调用的 input token。

1
hermes skills list             # 查看已安装技能
2

3
hermes skills list           # 查看已安装技能
4

5
hermes tools disable <名称>    # 禁用不用的工具集
6

7
hermes skills uninstall <名称> # 卸载不用的技能

▍使用习惯（占 70% 效果）#

▍值得留意的社区优化插件#

下列第三方插件的效果宣传普遍缺少公开基准，安装前请先评估来源可信度与权限范围，再用自己的用量面板验证是否真的省下来了。

在 Hermes Atlas（hermesatlas.com，社区维护，自述收录 252+ 工具 / 12 分类）浏览，或用 hermes skills search “token” 检索。第三方插件的效果宣传请自行核验，安装前注意来源与权限风险。

💬 微信（官方原生 iLink，Hermes 优势渠道）#

1. 运行 自建桥接（Hermes 无 channels 命令；官方 CLI 仅 hermes slack / hermes whatsapp / hermes whatsapp-cloud / hermes gateway）
2. 选择 iLink 模式（官方协议，非逆向）
3. 用微信扫码登录（个人微信，无需公众号）
4. 支持私聊，消息实时推送
5. 可以在微信里直接跟 Hermes 对话，调用所有能力

💡 Hermes 微信优势： 走腾讯官方 iLink Bot 接口，合法、无封号风险，稳定性远高于逆向协议方案。需要知道的限制：iLink Bot 仅支持私聊、不支持群聊；只能回复用户先发来的消息，不能主动发起对话；用户超过 24 小时未发消息需重新建立会话。另外 OpenClaw 侧同样有基于 iLink 的官方 SDK 插件——微信 iLink 并非 Hermes 独有。

📌 钉钉（官方原生，OpenClaw 不支持）#

1. 访问钉钉开放平台（open-dev.dingtalk.com），创建企业内部应用
2. 获取 AppKey 和 AppSecret
3. 运行 自建桥接（官方无钉钉 CLI），填入 AppKey/AppSecret
4. 配置事件订阅（使用 Hermes 提供的 WebSocket 或 Webhook URL）
5. 发布应用，在钉钉中 @机器人 开始对话

📘 飞书（官方适配器）#

1. 访问飞书开放平台（open.feishu.cn），创建企业自建应用
2. 获取 App ID 和 App Secret，开通机器人能力
3. 运行 自建桥接（官方无飞书 CLI），填入信息
4. 配置事件订阅（WebSocket 模式无需公网）
5. 发布版本，在飞书中 @机器人 对话

📋 其他渠道一览（官方与第三方口径为 15+ 平台；下列命令请以官方文档为准）#

查看所有渠道：hermes gateway list

🗺️ Hermes Atlas（社区地图）#

Hermes 生态的社区工具地图，收录约 252+ 开源工具，分 12 个类别（站点自述，2026-09 抓取，社区维护、非官方）。

• 网址： hermesatlas.com
• 规模： 250+ 开源工具，12 个分类
• 分类： 效率工具、搜索研究、内容创作、通信协作、开发工具等
• 特点： 社区维护，每个工具都有评分和使用说明

📦 官方插件目录#

内置在 Hermes 仓库中的官方插件目录，可直接通过命令浏览和安装。

• 浏览： hermes skills search
• 搜索： hermes skills search “关键词”
• 安装： hermes skills install <名称>
• 来源： 官方 optional-skills / well-known / url / ClawHub / LobeHub / GitHub tap

🛒 Hermes Marketplace（付费技能市场）#

• 入口： 在 Hermes Atlas 等社区生态目录中检索
• 内容： 付费高级技能，由社区开发者提交
• 特点： 质量较高，有审核机制，支持付费购买

📚 文档与社区#

• 官方文档（中文）： hermes-agent.nousresearch.com/docs/zh-Hans/
• 官方文档（英文）： hermes-agent.nousresearch.com/docs
• GitHub： github.com/NousResearch/hermes-agent
• Discord： Nous Research 官方 Discord
• 云托管： hermes.nousresearch.com

▍常用插件/技能推荐#

▍常见问题#