Hermes Agent 怎么用

01先读这一屏：读完你能拿它做什么

一句话价值主张：Hermes Agent 是一个装在你自己电脑或服务器上的 AI 助手——它不只是"你问它答"，它会记住你、把干过的活沉成技能、还能到点主动找你。读完本文，你能把它跑到能干活的水平，并且知道哪些事该交给它、哪些千万别。

你现在的处境 → 先看哪一节

按你打开这篇文章的原因对号入座。不用从头读。

最短上手路径（照着敲就行）

这是本文推荐给完全新手的一条路。每一步都有对应的详细小节，卡住了再跳过去看。

读完你应该能（拿这张清单对账）

02最小例子：亲手验证它"到底特别在哪"

如果只看一句介绍就装，你会把它当"又一个聊天框"。所以这一节不追求讲全功能，只带你做一次能证明它确实与众不同的最小实验。做完你会直观理解"跨会话记忆"和"能动手干活"到底是什么意思。

第 1 步：装好并进入一次对话

装的部分在 §03 讲全，这里先给你三条命令：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc              # 让当前终端认识刚装好的 hermes 命令
hermes setup --portal        # 浏览器 OAuth 登录一次，模型和工具全配好

然后敲 hermes 进对话。你会看到一个带模型名、可用工具和技能的欢迎横幅，接着出现输入光标。先问一个能立刻验证"大脑通了"的问题：

你：用一句话介绍你自己，并列出你现在启用的 3 类主要能力。

如果它答得像模像样，说明模型和工具都通了。答不出来或报错，先看 §13 排错。

第 2 步：让它做一件"真的要动手"的事

普通聊天机器人只能回答；它应该能自己找文件、写文件。先在终端里造一个测试文件：

cd ~/Desktop && printf 'apple\nbanana\nApple\ncherry\nbanana\n' > 测试词汇.txt

回到 Hermes 对话里，下发一个多步任务：

你：读一下桌面的"测试词汇.txt"，把单词去重并忽略大小写，按字母排序后存成一个新文件 结果.txt，然后告诉我路径和内容。

它会自己走完 read_file（读文件）→ 处理 → write_file（写文件），最后汇报。这个"读 → 想 → 写 → 验"的连续过程，就是 agent 与聊天机器人的分水岭。

第 3 步：让它记住一条关于你的偏好

这是它的招牌能力。在对话里直接说：

你：记住：以后所有回复都用简体中文，控制篇幅，先给结论再给细节。

它会把这条偏好写进长期记忆——具体落在 ~/.hermes/memories/ 目录下的两个纯文本文件里（机制见 §07）。

第 4 步：开新会话，验证它"还记得你"

在会话内敲 /new 开一个全新会话（历史清空），然后只问一句：

你：你对我有什么了解？请基于你的记忆回答。

如果它答出"你希望回复简洁、用简体中文、先结论后细节"——恭喜，最小闭环跑通了：上一个会话的收获，被带到了下一个会话。这一步才是它和网页版聊天框真正的区别。

第 5 步（可选）：试试"不占会话"的一次性问答

你可以在终端脚本里直接调用它，一条提示词进、纯文本答案出：

hermes -z "法国首都是哪？"

-z 模式会抑制横幅和进度动画，只输出最终答案，非常适合写进你自己的脚本（§11 有完整用法）。

03怎么装、怎么开：从零到能对话

Hermes 官方提供一行命令安装，安装器会自动检测并补装全部依赖：uv（一个装 Python 工具的命令行程序）、Python 3.11、Node.js、ripgrep（一个极快的文本搜索工具，它搜自己的历史会话要用）、ffmpeg（处理音视频，语音功能要用）。整个过程不需要 sudo——sudo 是"以管理员身份执行"的意思，也就是能改整台电脑的最高权限；安装器会把 Python 装进你自己的用户目录，不碰系统。

一条命令安装（macOS / Linux / WSL2）

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

这条命令做两件事：curl 把官方安装脚本下载下来，| bash 把它交给终端执行。安装完，先让当前这个已经开着的终端认识新命令：

source ~/.zshrc   # zsh（macOS 默认）；如果你用 bash，则是 source ~/.bashrc

Windows 怎么办

Windows 原生已完整支持（不需要装 WSL）。在 PowerShell 里执行：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装器会额外给你一个便携版 Git Bash（约 45MB，解到 %LOCALAPPDATA%\hermes\git），同样不需要管理员权限，也不会干扰你系统里已有的 Git。Hermes 就用这个内置的 Bash 来跑 shell 命令。

还有哪些安装方式

第一次配置：三种模式怎么选

敲 hermes setup 会进入配置向导，它给你三个模式：

官方"最快路径"：hermes setup --portal

如果你只想最快跑起来、又不想面对一堆 API key，这是官方推荐的入口。一条命令自动做五件事：

hermes setup --portal

验证配置成功

用一条命令确认登录状态、模型与各工具的路由：

hermes portal info

正常情况下它会打印你的登录状态块，并显示网页搜索 / 图片 / 语音 / 浏览器等工具都路由 via Nous Portal。确认无误后正式开聊：

hermes        # 经典聊天界面（classic CLI）
hermes --tui  # 更现代的终端界面（官方推荐，支持鼠标选择、弹层）

以后怎么更新、怎么体检

hermes update         # 一键升级到最新版（会先自动备份，再重启网关）
hermes update --check  # 只看落后多少，先不改任何文件
hermes doctor          # 体检：配置/依赖/服务是否健康
hermes doctor --fix    # 体检并自动修
hermes --version       # 看当前版本号

想彻底卸载：先 hermes gateway stop 停掉后台进程，再 hermes uninstall——它会问你要不要保留配置目录 ~/.hermes/，想以后重装就选保留。

04装好之后每天怎么用：终端里的两种入口、一套命令

Hermes 的日常使用分两层：终端里用（本节的 CLI / TUI），和聊天软件里用（走网关，见 §10）。先掌握终端这半边。

五种"启动姿势"

hermes chat 常用选项（照抄就能用）

# 指定模型聊一次（临时覆盖，不改默认配置）
hermes chat --model "anthropic/claude-sonnet-4"

# 带一个问题进交互会话；给 OS 启动器 / 桌面快捷方式用最合适
hermes chat -q "帮我看看这个 bug"

# 问完就退出——写脚本用这个，而不是 -q
hermes chat --oneshot -q "总结一下最近的 PR"

# 程序化模式：抑制横幅、转圈、工具预览
hermes chat -Q -q "只给我结论"

区别值得记牢：-q 在真实终端里是正常会话的第一句话，问完会话还开着；加上 --oneshot（或 -Q、或输出被管道接走时）才是"答完就走"。

一次"典型会话"长什么样

先把预期摆正：它回你的通常不是"一段话就完"，而是一串带着工具的干活过程。像这样（示意）：

你：桌面上有个 销售.xlsx，帮我按产品线统计总销售额，做成表格存成 report.md。

Hermes（可见的多步过程）：
 · 调用 terminal：确认文件存在、可读
 · 调用 file/代码工具：用脚本读取 xlsx、按"产品线"分组求和
 · 调用 write_file：生成 ~/Desktop/report.md
 · 自查：报告文件行数与原始数据是否对得上

Hermes 最终回复：
已生成 ~/Desktop/report.md ✅
A 产品线  ¥ 123,000
B 产品线  ¥  86,500
…（详见文件；如需我导出成图表也可以说一声）

注意它把"读、算、写、验"四步都走完并汇报——这就是 agentic（自主干活）与"问答"的差别。你随时可以用 /stop 打断，或用 /undo 撤掉刚才的一个来回。

会话内最常用的斜杠命令

在对话输入框里以 / 开头输入；支持前缀匹配（比如敲 /h 能命中 /help）。桌面端 / TUI 里按 Ctrl+P 还能打开模糊命令面板，输入几个字筛选所有命令和技能。

终端里的一等命令（管 agent 本身）

下面这些都在终端里执行（不是在对话里）。它们负责"管这个 agent"，不是"让它干活"。

05它把东西都放在哪：一个目录看懂全部配置

Hermes 的所有配置、记忆、技能、会话记录都放在一个目录里——默认 ~/.hermes/（~ 是你的用户主目录，比如 /Users/你的名字）。官方管它叫 HERMES_HOME。知道这个目录，你就能"亲眼看见"它到底记了什么，改配置也再不用瞎猜。

目录速览

常用配置命令

hermes config get model.default                  # 读某一项配置
hermes config set model anthropic/claude-opus-4   # 写某一项配置
hermes config set terminal.backend docker         # 例：把命令执行后端切到 Docker 沙箱（§12）
hermes config show                              # 查看全部配置
hermes config check                             # 校验配置有没有问题
hermes config migrate                           # 更新后缺了新配置项？交互式补上

两条规则值得记：① hermes config set 会自动分流——API key 进 .env，其余进 config.yaml，你不用自己记；② 优先级从高到低是命令行参数 > config.yaml > .env > 内置默认值。所以"我明明配了却没用"的时候，先想一下是不是命令行参数覆盖了它。

人格文件 SOUL.md：agent 的"嗓音"

• 它是什么：~/.hermes/SOUL.md 定义 agent 的身份、语气与风格，是系统提示（system prompt——每次对话开始前，程序自动塞给模型的那段"你是谁、你能用什么工具、有什么规矩"的隐藏说明）里第一顺位的内容——它会完全替换掉内置的默认身份。文件不存在或读不到时，它回落到内置默认人格。
• 一句话区别：SOUL.md 写"我是谁、我怎么说话"（跟着你走，跨项目生效）；AGENTS.md 写"这个项目怎么组织、有什么约定"（只属于某个代码仓库）。
• 怎么临时换人格（只影响当前会话）：

/personality concise      # 说话精炼
/personality technical    # 技术口吻
/personality teacher      # 讲道理讲得细
/personality none         # 恢复默认

项目上下文文件：让它在你项目里"懂规矩"

把项目跑在 Hermes 里时，它会在项目目录自动识别并加载上下文文件。关键是"只加载一个"——多种类型同时存在时，按下面顺序取第一个匹配到的；只有 SOUL.md 永远独立加载。

所有被加载的上下文文件都有字数上限（默认 20000 字符），超了会智能截断。它还会对这些文件做提示注入扫描——可疑内容会被标记成 [BLOCKED: ...] 拦下来。

Profiles：想要多个"分身"就靠它

一个 profile 相当于一个相互隔离的 Hermes 实例——各自有独立的记忆、技能、配置、会话。平时不用管；如果以后想区分"工作用 agent"和"私人用 agent"，用 hermes profile 创建，再以 -p 名字 启动：

hermes -p work                # 用名为 work 的 profile 启动
hermes -p work chat           # 这个 -p 别名对每个子命令都有效
hermes -p work gateway start  # 连网关也能按 profile 分开跑

06给它选个"大脑"：模型与提供商怎么选

Hermes Agent 是"身体"，模型是"大脑"。它不绑定任何一家：Nous Portal、OpenRouter、OpenAI、Anthropic、Google、你自己的端点、本地模型都行。但选错大脑会显著变笨，本节给新手一个可以直接照抄的决策。

最重要的一条提醒：别用 Hermes-4 当大脑

名字都带 Hermes，很容易顺手选成自家模型。但官方文档写得非常直白：

四条接入路径（由易到难）

新手"速选大脑"清单

配置动作一览

• 换默认"大脑"（终端，一次性）：

  hermes model

  流程是：选 provider → 认证（OAuth 会开浏览器，或让你填 API key）→ 从该提供商的精选目录里选模型 → 写入 ~/.hermes/config.yaml。它只影响之后新开的会话。
• 会话中途想换（不动默认）：在对话里 /model anthropic/claude-sonnet-4；加 --global 才持久化到配置。
• 命令行临时覆盖：

  hermes chat --model "anthropic/claude-sonnet-4" -q "帮我看看这个 bug"

• 不想开对话，直接写配置：

  hermes config set model anthropic/claude-opus-4

配置文件长什么样（照抄改一处就能用）

主模型写在 config.yaml。下面这份是走 OpenRouter 的完整样子：

# ~/.hermes/config.yaml
model:
  provider: openrouter
  default: anthropic/claude-opus-4.7   # OpenRouter 上的模型标识符（provider/模型名）
  base_url: ''                          # 切 provider 时会被清空
  api_mode: chat_completions

"副手"模型（比如让更便宜的模型单独负责压缩上下文或看图）有独立槽位，默认 auto 表示复用主模型：

# ~/.hermes/config.yaml —— 例：让视觉任务走更便宜的模型
auxiliary:
  vision:
    provider: openrouter
    model: google/gemini-2.5-flash
    timeout: 120

API key 一律放 ~/.hermes/.env（安全、不进配置文件）。两个官方明确列出的标准变量名：

# ~/.hermes/.env
OLLAMA_API_KEY=...
DEEPSEEK_API_KEY=...

OpenRouter、Anthropic 等一般通过 hermes model 的 Keys 面板或向导接线，不必手写。想接本地自定义的 OpenAI 兼容端点，可在 config.yaml 的 providers: 下写 api + api_key（细节以官方 configuring-models 页为准）。

07它凭什么"越用越懂你"：三层记忆拆开看

这是 Hermes Agent 区别于大多数工具的核心。官方反复强调一个词：closed learning loop（闭环学习）——"闭环"的意思不是玄学，而是"上一次干活的收获，会变成下一次的起点"。这一节把这句话拆成三层你能亲眼看见的记忆。

先破一个误解

"它记住你" ≠ "它把你所有聊天都塞进上下文"。 如果把每句话都带着走，token（模型的计费与容量单位）早就爆了，而且模型会变笨。Hermes 用的是"该记的记成小文件 + 需要时再翻历史"的策略：文件是精选摘要，历史是可以按需搜索的仓库。这两件事不是一回事。

三层记忆结构

# ~/.hermes/config.yaml —— 记忆写入要先经你同意
memory:
  write_approval: true     # true = 任何记忆写入都要审批

你可以怎么主动用它

亲手看一眼"它记住了什么"

这两个文件就是纯文本，你随时可以打开看、也可以手改：

open ~/.hermes/memories    # macOS 用 open 打开文件夹
cat ~/.hermes/memories/MEMORY.md ~/.hermes/memories/USER.md

看到两个 .md 文件里躺着它写给你的小结，就说明记忆系统在工作。

08技能（Skills）：让重复劳动变成"肌肉记忆"

如果记忆是它"记得你"，那 Skills（技能）就是它"记得怎么做"——官方称之为 agent 的 procedural memory（程序性记忆），就是"手脚怎么动"的那部分记忆，和"记得事实"相对。理解这套机制，是看懂 Hermes"自我改进"的关键。

一个 Skill 到底是什么

官方定义：技能是"按需加载的知识文档"（on-demand knowledge documents），教会 Hermes 怎么处理某一类具体任务。关键在于"按需"——不加载时几乎不占上下文（官方原话 "Zero tokens until loaded"）。一个技能 = 一个带说明的 SKILL.md 文件。它兼容 agentskills.io 这个开放标准，理论上可以跨 agent 工具复用。

它什么时候"自学成才"？

不是每次对话都会生成技能。系统提示要求它在三种时刻沉淀：

沉淀原则是 "lessons, not logs"（要教训，不要流水账）：把坑写成可推广的规则加一句为什么；聊天原文、某个 PR 号、日期这类只对当时有意义的碎片，不算技能内容。

技能的"长相"：一个最小的 SKILL.md

技能都放在 ~/.hermes/skills/，结构是 分类/技能名/SKILL.md——上面是 YAML 头（用缩进表达的数据格式，夹在两个 --- 之间），下面是 Markdown 正文：

# ~/.hermes/skills/daily/tidy-csv/SKILL.md
---
name: tidy-csv
description: 读取一个 CSV，做清洗(去重/去空/统一编码)，另存为新文件
version: 1.0.0
---

# Tidy CSV

## When to Use（什么时候用）
用户给了一个脏 CSV，想要干净版。

## Procedure（步骤）
1. read_file 读取并探测编码；
2. 用脚本去重空行、合并重复列；
3. write_file 输出为 原名_clean.csv；
4. 打印行数前后对比。

## Pitfalls（坑）
不要直接覆盖原文件——先备份。

## Verification（怎么验证）
让模型确认输出行数 = 输入行数 - 去重行数。

手写一个技能只要三步，不需要注册，丢进去就生效：

mkdir -p ~/.hermes/skills/my-cat/my-skill
# 然后把上面那份 SKILL.md 内容写进 my-cat/my-skill/SKILL.md
/skills   # 在会话里确认它被认出来了（需先开新会话，见下）

常用操作：查 / 装 / 审批 / 自建

谁来防止技能"越攒越乱"：Curator 策展器

技能会自己长出来，久了必然堆积。Hermes 内置一个后台维护进程 Curator：统计每个技能被查看 / 使用 / 修补的频率，长期不用的按 active → stale → archived 推进归档。官方强调两点：

• 它绝不自动删除——最坏结果只是归档到 ~/.hermes/skills/.archive/，可恢复（官方原话："never auto-deletes — the worst outcome is archival"）；
• 它由空闲检查触发，不是常驻定时任务——默认在你闲置一段时间后、且距上次运行够久，才在后台跑，不打扰对话。

hermes curator status         # 上次运行时间、计数、置顶列表
hermes curator run --dry-run  # 先看它"打算"归档哪些，不真动手
hermes curator pause          # 暂停；resume 恢复

09定时任务（Cron）：让 agent 到点自己干活

想让它"每天早上 9 点自动总结新闻发我"？这就是 cron 干的活。Cron 原本是 Unix 系统里"按时间表自动跑任务"的老牌机制，Hermes 内置了一个同样的调度器，而且跑完能把结果投递到任意已接入的平台——投递能力正是它区别于"只能你问它答"的关键。

三种创建方式（挑顺手的）

时间怎么表达（重要）

• 间隔 / 相对时间：in 30m（30 分钟后跑一次）、every 2h（每 2 小时）、every hour、30m；
• 标准 cron 表达式：5 段式，从左到右分别是"分 时 日 月 星期"。例如 0 9 * * *（每天 9:00）、0 9 * * 1-5（工作日 9:00）、0 */6 * * *（每 6 小时）；也认 MON-FRI 这种名字；
• 一次性的 ISO 时间：2026-09-15T09:00:00。

给 cron 写提示词的黄金法则：自包含

cron 任务跑在全新会话里，官方原文："Cron jobs run in fresh agent sessions with no memory of your current chat."——它对你刚才聊了什么一无所知。所以提示词必须自包含：搜什么、取几条、什么格式、多长、什么语气，全写清楚。

/cron add "0 9 * * *" "按老样子做每日简报"

/cron add "0 9 * * *" "搜索过去 24 小时的 AI agent 与开源 LLM 新闻，至少 5 篇，按来源分组给出要点并附链接，控制在 500 字以内" --deliver telegram

投递到哪：--deliver 的写法

• origin：回到创建它的那个聊天（默认）；
• local：只存本地文件 ~/.hermes/cron/output/；
• telegram / discord / slack：投到该平台的 home channel（"家庭频道"，用 /sethome 指定，见 §10）；
• 更精确的群 / 话题：telegram:-1001234567890（群）、telegram:-1001234567890:17585（群里的某个话题）；
• 可以组合多个目标：--deliver bot-chat,telegram。

管理命令 + 一个完整可抄的流程

hermes cron list             # 看所有任务
hermes cron run <job_id>     # 立即手动跑一次（测试用）
hermes cron edit <job_id>     # 改这个任务（可换模型 / 提示词 / 时间）
hermes cron pause <job_id>    # 暂停
hermes cron resume <job_id>   # 恢复
hermes cron remove <job_id>   # 删除

最实用的"先测后挂"流程——先手动确认效果满意，再挂成定时，能省掉大量返工：

# ① 先在终端手动验证效果（把要求一次说清）
hermes -z "搜索最近 24 小时 AI 编程工具新闻，总结 3 条要点并附链接，简体中文"

# ② 确认回答满意后，挂成每周一 9 点的定时任务，投到 Telegram
/cron add "0 9 * * 1" "搜索最近 24 小时 AI 编程工具新闻，总结 3 条要点并附链接，简体中文" --name "周一 AI 简报" --deliver telegram

让它"安静地监控"，只在有变化时发声

/cron add "every 1h" "If the script output says CHANGE DETECTED, summarize what changed and why it might matter. If it says NO_CHANGE, respond with just [SILENT]." --script ~/.hermes/scripts/watch-site.py --name "Pricing monitor" --deliver telegram

不需要 AI 的定时任务：--no-agent

如果任务只是"跑个脚本、把输出发给我"，根本不需要模型参与——这样不花一分钱 token：

hermes cron create "every 5m" \
  --no-agent \
  --script memory-watchdog.sh \
  --deliver telegram \
  --name "memory-watchdog"

语义值得记住：脚本输出（去掉首尾空白）原样投递；输出为空 = 静默跳过（这就是"只在出问题时说话"的看门狗模式）；非零退出码或超时 = 会发错误告警（所以坏掉的看门狗不会静默失效）。脚本必须放在 $HERMES_HOME/scripts/ 里，且进程环境会被清洗——你的 API key 之类机密不会被这个脚本继承。

10手机远程：把它接进 Telegram / 微信 / 飞书

前面都在终端里跟它说话。接上消息网关（gateway）之后，它就成了一个"你随叫随到、也能主动找你"的聊天机器人——而且跑在你自己的机器上，不在别人的云里。

Gateway 是什么

官方一句话：gateway 是 Hermes 里唯一常驻后台的进程——它负责连上你配置的各种聊天平台、维持会话、并按点触发 cron 定时任务。官方称网关连接 20+ 个外部消息平台（共 21+ 个平台接入，其中 19 个原生在网关里，IRC 和 Microsoft Teams 走插件），包括 Telegram、Discord、Slack、WhatsApp、Signal、短信（SMS）、Matrix、邮件、钉钉、飞书、企业微信、微信、iMessage（经 BlueBubbles）、QQ、Microsoft Teams、LINE 等。

原理是：每个平台适配器收到消息 → 路由给同一个 agent 处理 → 回复回到对应聊天。也就是说，你在 Telegram 里聊天，和你在终端里聊，背后是同一个 Hermes、共享同一套记忆和技能。

安全默认：先看懂"白名单"

所以配置任何平台，都要显式声明"谁可以用"。白名单写在 ~/.hermes/.env 里，格式是逗号分隔的用户 ID。

动手：把 Hermes 接进 Telegram（4 步）

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=你的数字ID

hermes gateway          # 前台跑，先确认能连上
hermes gateway status   # 看状态

嫌手写麻烦？官方推荐直接跑交互向导，它会问你 bot token 和允许的 user ID，然后替你写好配置：

hermes gateway setup

在聊天软件里怎么用

• 发消息即对话：直接私聊就是正常对话；群聊需要额外配置才响应（回复 bot 的消息 / @bot用户名 / 配置唤醒词——群里只有消息里带了这个词，bot 才会搭理）；
• 斜杠命令照样能用：官方明确列出 /status、/new、/model、/skills、/cron、/rollback、/learn 等一批命令在 CLI 和消息平台上都有效；装好的技能也会自动注册成该平台的原生斜杠命令。反过来，/history、/tools、/config 这类是只在 CLI 里能用的；
• 危险操作怎么确认：聊天里没法弹终端那种选择框，agent 会问你 Reply 'yes' to approve，你回 yes 或 no；
• 让它"认得你家"：在常用群里对它说 /sethome，之后 cron 的定时结果默认投到这里。

没 Telegram？WhatsApp 其实更省事

接 WhatsApp 不需要 Meta 开发者账号——官方内置桥用扫码配对（本质是模拟一次"WhatsApp 网页版"登录）。跑 hermes whatsapp 会生成一个二维码（约 20 秒刷新一次，超时重跑即可），手机扫码就连上了。然后在 .env 写：

WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot
WHATSAPP_ALLOWED_USERS=15551234567   # 带国家码、不要 + 号；填 * = 放行所有人（别这么干）

11进阶：让它当你的"虚拟小团队"

熟练之后，你不需要只会"一问一答"。Hermes 有一组让你把复杂任务拆开、并行、接进流水线的能力。本节不展开到开发者级，只把每个能力"是什么 / 怎么触发"讲明白——足够你读懂它自己怎么干活、以及知道往哪查。

子代理委派（delegation）：把一件大事拆成几件并行做

官方工具 delegate_task 会派生相互隔离的子 agent，每个有独立的上下文和终端会话，可以同时处理各自的子任务。关键点：

• 不用你手动"叫"——agent 会根据任务复杂度自己决定要不要委派（官方："The agent handles delegation automatically based on the task complexity"）；
• 并发上限可配：delegation.max_concurrent_children，默认 3 个，下限 1、没有硬上限；超过上限的批量会返回工具错误，而不是被静默截断；
• 子 agent 是全新会话、零父级记忆，你只能通过 goal（目标）和 context（背景）喂给它——所以给父级一条清晰的委派指令，等于给每个子代理发一份清晰的工单；
• 批量任务可一次派多个：delegate_task(tasks=[...])，完成一个回报一个；
• 默认深度是 1（扁平），子 agent 不能再派孙代理；把 max_spawn_depth 调到 2 或 3 才有多层结构——代价是成本按层数相乘（3 层 × 每层 3 个 = 最多 27 个并发子 agent）。

你不需要手写这个工具；但理解了它，你就明白为什么"把大任务说清楚、拆成几件事"能让它干得更快。典型触发话术：

帮我并行调研这三件事，每件单独出一份结论：
1. A 主题
2. B 主题
3. C 主题

execute_code 和子代理：机械活 vs 动脑活

MCP：给它接第三方工具（GitHub、数据库、n8n…）

MCP（Model Context Protocol，模型上下文协议）是一个"让 AI 连外部系统"的开放协议——你可以把它理解成一个统一的插座标准：外部系统按这个标准做成"服务器"，AI 只要会插，就能用任何一家的能力。Hermes 两种角色都当：它既是 MCP 客户端（能连别人的 server），也能把自己当 MCP server 暴露给别的工具。

hermes mcp                # 交互式管理 MCP server 配置
hermes mcp install n8n    # 从官方目录安装某个 server
hermes mcp add my-oauth-server --url https://mcp.example.com/mcp --auth oauth
hermes mcp serve          # 把 Hermes 自己作为 MCP server 暴露给 Claude Code / Cursor / Codex

接入的 server 工具会以 mcp_<服务器名>_<工具名> 注册，可以用 include / exclude 控制放行哪些。新手只需记住一句：以后想让它操作你的 GitHub / 数据库 / 自动化平台，路径就是 MCP（详见官方 "Use MCP with Hermes" 指南）。

Hooks：在关键节点"插一脚"（给想折腾的人）

Hooks 允许你在"消息到达、工具被调用、模型开始推理"等生命周期节点运行你自己的脚本——比如拦截危险工具调用、自动格式化文件、往提示里注入上下文。在 config.yaml 的 hooks: 下声明即可；回调出错会被隔离记录，不会拖垮 agent。查看：hermes hooks list。对新手：先知道有这么一层"保险丝"就够，不必现在配。

Checkpoints 回滚：改坏了能"反悔"

hermes config set checkpoints.enabled true
# 或单次会话临时开：
hermes chat --checkpoints

把 Hermes 塞进你自己的脚本

用 -z 一次性调用 + hermes send 通知，它就成了你自动化流水线的一环：

# 例：让 Hermes 总结一个文件，把结果存进变量
answer=$(hermes -z "用三点总结这份报告" < 报告.txt)

# 例：脚本跑完，往 Telegram 发一条通知（不走 agent，几乎零开销）
hermes send --to telegram "构建完成 ✅ $(date)"

# 例：想看这次调用花了多少 token，并拿到机器可读的报告
hermes -z "..." --usage-file usage.json

# 例：临时换 provider / 模型跑一次（不改配置）
hermes -z "..." --provider openrouter --model openai/gpt-5.5

-z 只输出最终答案、没有横幅动画，非常适合管道调用；需要保留工具过程记录就改用 hermes chat --oneshot -q "…"。--usage-file 写出的 JSON 里含 estimated_cost_usd、输入 / 输出 / 缓存 token 数、api_calls、模型、provider、session id 等字段，而且即使这次运行失败也会写——所以批量流水线总能对账。

12安全边界：权限很大，请当回事

Hermes 默认跑在你自己的电脑上、以你的用户权限执行命令——这既是它能干实事的原因，也是你唯一要警惕的地方。一句话类比：你雇了一个"会动手的员工"，并且把家里的钥匙给了他。好消息是它的安全设计是"先问再动"，但需要你配合。

默认权限模型

# ~/.hermes/config.yaml —— 允许 agent 干任何事，除了这些
approvals:
  deny:
    - "rm -rf /*"
    - "curl * | bash"

你该养成的 5 个习惯

别做这几件事

• 别在聊天软件里用 sudo——网关没有交互终端，危险命令的确认会退化成"回一句 yes"；官方 FAQ 明确不建议在聊天软件（IM，即即时通讯工具）里 sudo；
• 别把"能删库 / 动生产环境"的任务丢给全自动 cron——定时任务无人盯着的时候更危险；
• 别无脑同意它的每一步——每次确认前扫一眼它要干什么（rm、curl | bash、连陌生服务器都要警惕）；
• 别以为它"全知"——模型会幻觉（一本正经地编错事实）；重要结论让它给出来源（网页工具会带链接），重要改动自己复核。

它值不值得装？和同类工具对照

先说它不适合谁：只想"开箱即答"、完全不碰配置的人；重度依赖云服务、不想在自己电脑跑常驻进程的人；想要"大厂保修式稳定"的人——这是开源项目，迭代很快，文档偶有漂移。

隐私：数据到底去了哪

• 官方称工具无遥测：对话、记忆、技能默认都留在本地 ~/.hermes/，没有行为回传；
• 但只要用了云模型 API，你的对话就会发给对应模型厂商（Nous Portal / Anthropic / OpenAI / OpenRouter 等），受它们各自的隐私政策约束；
• 要绝对本地：用本地模型（Ollama 或内置 llama.cpp），完全不把你的内容发到网上——代价是模型能力弱一些。

13出问题了去哪看：先看症状，再对号入座

下面是新手最高频的坑，按"症状 → 原因 → 解法"整理。遇到问题先查这张表；查不到再看日志 ~/.hermes/logs/errors.log 和 ~/.hermes/logs/gateway.log，最后跑 hermes doctor --fix。别急着卸载重装。

报错全是英文、看不懂怎么办

三个动作，按顺序来：

1. 把红色报错原文整段贴回对话，让它自己解释（或贴给别的 AI）——它对自己的报错最熟；
2. 看日志定位：网关问题看 tail -f ~/.hermes/logs/gateway.log，其他错误看 ~/.hermes/logs/errors.log；
3. 先跑体检：hermes doctor --fix + hermes config check——多数"启动不起来 / 配置失效"的问题它能自动修。

14速查表：平时照着敲

把全文最重要的命令压缩成几张表，读到第二遍时直接查这里，不用重读全文。

安装 / 更新 / 维护

首次配置与模型

会话内斜杠命令

能力命令（终端）

15术语表：遇到不认识的词回来查

第三列回答的是"为什么重要 / 何时用 / 别当什么用"——不是翻译。

16你大概还会问这些

99一句话总结

17参考来源与时效说明

本文在 2026-09-13 逐条核对了以下官方源。命令与配置取自官方文档与仓库 README 的当日快照。

仓库与官网

• GitHub 仓库（定位、特性表、Quick Install）：https://github.com/NousResearch/hermes-agent
• 官方文档站根：https://hermes-agent.nousresearch.com/docs/
• 官网 / 安装脚本：https://hermes-agent.nousresearch.com/ · /install.sh · /install.ps1
• 机器可读文档索引与全文：/docs/llms.txt · /docs/llms-full.txt（本文核对所用的全文快照，约 4.3MB）

入门与安装

• 安装：docs/getting-started/installation（含 Windows 原生、Termux、Nix）
• 快速开始：docs/getting-started/quickstart（64K 上下文最低要求、三种 setup 模式）
• 更新与卸载：docs/getting-started/updating
• 平台支持：docs/getting-started/platform-support

使用与参考

• CLI 命令参考：docs/reference/cli-commands；斜杠命令：docs/reference/slash-commands
• 配置：docs/user-guide/configuration；模型配置：docs/user-guide/configuring-models；本地模型：docs/user-guide/local-models
• Nous Portal 指南：docs/integrations/nous-portal；Tool Gateway：docs/user-guide/features/tool-gateway
• 会话：docs/user-guide/sessions；Profiles：docs/user-guide/profiles

核心特性

• Skills：docs/user-guide/features/skills；记忆：docs/user-guide/features/memory；Honcho：docs/user-guide/features/honcho；Curator：docs/user-guide/features/curator
• Cron：docs/user-guide/features/cron + docs/guides/automate-with-cron
• 委派：docs/user-guide/features/delegation（并发默认值的两处不同口径就出在这里与配置参考页）
• 检查点与回滚：docs/user-guide/checkpoints-and-rollback
• Hooks / Personality / Context Files / MCP：docs/user-guide/features/hooks、…/personality、…/context-files、…/mcp
• 安全：docs/user-guide/security（危险命令审批、YOLO 模式、用户授权）

消息网关

• 消息总览：docs/user-guide/messaging；Telegram：docs/user-guide/messaging/telegram；WhatsApp：docs/user-guide/messaging/whatsapp
• 用户授权与配对：docs/user-guide/messaging 的 user authorization 一节（GATEWAY_ALLOW_ALL_USERS 警告的出处）
• 脚本输出直发平台：docs/guides/pipe-script-output