要让hermes agent成为长期运行的数字员工，必须走四条主干路径：一读对官方文档（docs.hermes.dev）；二运行/new、/model、/skills、/cron四条命令验证核心能力；三编写soul.md和agents.md规则文件；四按实际需求补装pdf-extract、github-repo-sync等专用工具。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
装完 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。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
第三步：写两份规则文件，让行为可沉淀
SOUL.md 和 AGENTS.md 不是装饰品，是 Hermes 区别于普通聊天机器人的分水岭。它们决定 Agent 记住什么、怎么思考、在哪个项目里用什么规则。
第一步：创建 SOUL.md
在 ~/.hermes/ 目录下新建 SOUL.md，用纯文本写入你真正需要的行为约束。删掉所有“请”“谢谢”“视情况而定”，只保留硬性指令。例如：
你说话像一个有十年工程经验的远程同事。<br>禁止输出 markdown 格式代码块以外的任何代码块。<br>当用户命令含“检查”“验证”“审计”时，必须先列出检查项清单再执行。<br>所有日期必须用 ISO 8601 格式（如 2026-06-16）。
第二步：初始化 AGENTS.md
进入你正在推进的项目根目录，比如 ~/my-fastapi-app，执行 touch AGENTS.md。在里面写明该项目专属规则：
这是 FastAPI + SQLAlchemy 项目。<br>数据库迁移必须用 alembic revision --autogenerate。<br>所有 HTTP 响应必须包含 X-Processed-By: Hermes-v0.13.2。<br>测试覆盖率低于 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——这才是“长期工作流”的真实形态。
