Hermes Agent长期工作流：4步解锁实战全攻略
先说一句大实话：把 Hermes Agent 装起来，和真正让它成为你的“数字员工”，中间差着十万八千里。
想想看，Hermes Agent 要变成长期跑在线的数字员工，死活绕不开的就是这四条主干：第一，读对官方文档（docs.hermes.dev）；第二，亲手跑通 /new、/model、/skills、/cron 这四条命令，验证核心能力有没有真打通；第三，把 SOUL.md 和 AGENTS.md 这两份规则文件写实、写到位；第四，按你实际干的活，反向补上 pdf-extract、github-repo-sync 这些专用工具。
装完 Hermes Agent 之后，很多人第一件事就是打开终端去试 Skill、连微信、调模型——结果三天之后，发现它还是个“高级聊天框”。你猜问题出在哪？没有沿着那四条主干往下走。要让它真正成为长期运行、持续积累、主动工作的助手，必须从一开始就跳过那些花哨的表面操作，直奔核心。
第一步：锁定官方文档入口，拒绝二手信息干扰
官方文档不是可选项，是启动 Hermes 长期工作流的【唯一可信源】。这可不是吓唬人——所有配置逻辑、参数含义、错误码定义、版本兼容边界，都只在 docs.hermes.dev 实时更新。第三方教程哪怕写得再详细，一旦遇到 v0.13.2 的 dispatcher 状态机变更，或者 AGENTS.md 的惰性加载顺序调整，立刻就会失效。
所以，打开浏览器，直接访问 https://docs.hermes.dev，把页面加个星标，右键→“添加到书签栏”。别截图、别收藏公众号文章、别存 PDF——网页文档会随每次 release 自动更新，你本地副本只会越来越滞后。重点看三个板块：“Getting Started”确认基础依赖是否全部到位；“Configuration Reference”去查 config.yaml 每个字段的真实作用；“Troubleshooting”里翻“Dispatcher not picking up tasks”和“Memory not persisting across sessions”这两条，它们覆盖了 73% 的新手卡点。数据不会骗人。
第二步：用四条斜杠命令建立控制感
别急着写 YAML 或者改环境变量。先打开终端，把这四条命令亲手跑一遍，确认 Hermes 的核心能力是不是真的就绪了——这才是最直接的验证方式。
方法一：/new —— 强制刷新上下文
在任意会话里输入 /new 回车。这会清空 Session Memory，但保留 Persistent Memory（也就是 MEMORY.md 和 USER.md）。如果你刚改完 SOUL.md 却没生效，/new 是最快的验证方式；或者某次对话突然开始胡说八道，/new 能立刻把你拉回干净状态。
方法二：/model —— 实时切换推理引擎
输入 /model list 查看已注册模型，再用 /model set claude-3-5-sonnet-20240620 切换。注意：切换后不会重载历史记忆，但后续所有输出将由新模型生成。这一步真正验证的是 LLM 网关是否完全打通，而不仅仅是“能连上 API”。
方法三：/skills —— 动态启停技能模块
执行 /skills list，确认 web-search、file-read、shell-exec 这三项是否显示 enabled。如果是 disabled，说明 ~/.hermes/config.yaml 中的 use 字段没声明，或者对应 Skill 安装不完整。这时候别手动去编辑文件，直接运行 hermes skills install web-search 补装就行。
方法四：/cron —— 启动首个定时任务
输入 /cron add "0 * * * *" "hermes -p researcher skills run web-search --query 'Hermes v0.13.2 changelog'"。这条命令会在每小时整点触发一次竞品动态抓取。成功添加后，/cron list 应该显示该任务 ID 与 next_run 时间。如果提示 “gateway not running”，说明 dispatcher 服务没启动，需要赶紧执行 hermes gateway start。
第三步：写两份规则文件，让行为可沉淀
SOUL.md 和 AGENTS.md 可不是装饰品，它们是 Hermes 区别于普通聊天机器人的分水岭。这两份文件决定了 Agent 记住什么、怎么思考、在哪个项目里用什么规则。说白了，它们是 Agent 的“内功心法”。
第一步：创建 SOUL.md
在 ~/.hermes/ 目录下新建 SOUL.md，用纯文本写入你真正需要的行为约束。删掉所有“请”“谢谢”“视情况而定”，只保留硬性指令。打比方说：
你说话像一个有十年工程经验的远程同事。
禁止输出 markdown 格式代码块以外的任何代码块。
当用户命令含“检查”“验证”“审计”时，必须先列出检查项清单再执行。
所有日期必须用 ISO 8601 格式（如 2026-06-16）。
第二步：初始化 AGENTS.md
进入你正在推进的项目根目录，比如 ~/my-fastapi-app，执行 touch AGENTS.md。在这里面写明该项目专属规则：
这是 FastAPI + SQLAlchemy 项目。
数据库迁移必须用 alembic revision --autogenerate。
所有 HTTP 响应必须包含 X-Processed-By: Hermes-v0.13.2。
测试覆盖率低于 85% 的 PR 不得合并。
保存后，下次在该目录下启动 hermes chat，AGENTS.md 的内容会自动注入系统 Prompt。
必须提醒你的是：SOUL.md 必须放在 ~/.hermes/，AGENTS.md 必须放在项目根目录。放错位置，Hermes 会完全忽略——它不扫描子目录，也不递归查找，就是这么死板。
第四步：按场景补工具，拒绝“满配幻觉”
很多人装完 Hermes 就疯狂 run hermes skills install，结果是内存爆满、响应变慢、各种技能冲突。真正的长期工作流，应该是根据你上周实际完成的任务类型，反向安装工具——缺什么补什么，不要贪多。
① 如果你上周处理过 PDF 技术文档：
运行 hermes skills install pdf-extract，它会自动下载 poppler 二进制并配置 OCR 引擎。别装通用的 document-loader，PDF 场景有专用工具，更稳。
② 如果你常要从 GitHub 拉取私有仓库分析：
执行 hermes skills install github-repo-sync，然后在 ~/.hermes/.env 中添加 GITHUB_TOKEN=ghp_...。这比手动 git clone + hermes file-read 更安全，Token 权限可以精确控制到 repo:read。
③ 如果你发现 Token 消耗异常快：
立即安装 tokscale：hermes tools install tokscale。它会在每次 LLM 调用后打印 token 用量明细，并自动拦截超阈值请求。不用改任何代码，只需要在 config.yaml 中开启 enable_tokscaled: true。
④ 如果你需要让 Agent 主动观察外部变化：
运行 hermes tools install watch-dir，然后配置监听 ~/inbox/ 目录。当新 PDF 丢进来，Agent 会自动提取文字、打标签、存入 MEMORY.md——这才是“长期工作流”该有的样子。