Hermes Agent 常用命令速查：setup、doctor、model、skills、gateway

为什么要有命令速查

很多新手不是卡在概念，而是卡在下一步该敲什么命令。命令速查的目标不是替代完整文档，而是让你在安装、模型、Skills 和 Gateway 出问题时能快速回到最小可用状态。

安装后先跑这几条

hermes setup
hermes doctor
hermes config check
hermes model

setup 负责引导配置，doctor 负责查环境和依赖，config check 检查配置有没有缺项或过期，model 负责选 Provider 和模型。

Skills 常用命令

hermes skills browse
hermes skills search github
hermes skills install official/creative/baoyu-comic
hermes skills list
hermes skills update

skills list 看本机已经装了哪些，browse 和 search 只是逛技能源。旧教程里的 github-pr-workflow、github-code-review 在 v0.21 合并成了内置的 github 技能，会话里直接用 /github 调用。安装 Skill 后不要立刻接高风险任务。先让它做只读总结、标签建议或草稿输出，确认触发条件和边界稳定。

Gateway 排错命令

hermes gateway setup
hermes gateway status
hermes logs gateway
hermes doctor

如果 CLI 能正常对话，但消息平台不回复，优先看 Gateway 配置、允许名单、Chat ID 和进程日志。

工作流调试顺序

先短问答，再跑模板；先只读，再写入；先本地，再定时；先测试群，再正式群。不要在一个失败工作流里同时改模型、Prompt、权限和消息平台。

运维四件套：status、logs、sessions、backup

速查表通常只收安装和配置命令，但跑了几周之后，真正高频的是运维这一组。

hermes status
hermes logs
hermes sessions list
hermes sessions prune
hermes backup
hermes checkpoints

区分前两条的口诀：想知道"现在是什么状态"用 hermes status，它一屏列出所有组件；想知道"刚才发生了什么"用 hermes logs，它负责查看和过滤日志文件。顺序别反，先看总览再翻日志，能避免在正常组件上浪费时间。半夜定时任务挂掉这种没人在场的故障，第二天上来也是同样两步：status 看现在还坏不坏，logs 回放当时发生了什么。

会话全部落在本地 SQLite 里：sessions list 看现存会话，单删某一个用 sessions delete，成批清理交给 sessions prune；值得长期保留的会话先用 sessions rename 改个可读名字，之后 --resume 接续时一眼能找到。hermes backup 把 Hermes home 里的配置、会话、技能和记忆打成一个 zip（不含 Hermes 代码本身和检查点），换机或大改配置前跑一次，恢复用 hermes import <zip 路径>。注意它只管数据，退不回版本：升级后想回到旧版本，要按官方文档进安装目录 git checkout 旧版本的 tag，再 uv pip install -e ".[all]" 重装依赖。检查点是另一套东西，存放在 ~/.hermes/checkpoints/，用 hermes checkpoints 查看和清理，两者互不替代。

隔离实验与求助：profile、update、dump

hermes profile list
hermes update
hermes doctor
hermes dump

想试一套激进配置又怕弄脏主环境，不必备份后硬改，hermes profile 直接开隔离实例：create 新建、use 切换、delete 丢弃，每个实例独立互不影响。它还有 export 和 import 一对子命令，调好的实例可以整套发给同事；团队甚至能把统一配置做成 profile 发行版，放在 git 仓库里供大家从 URL 安装。判断标准：临时试验开 profile，长期迁移才动 backup。

hermes update 升级本体；升级后如果浏览器、ripgrep、ffmpeg、node 这类非 Python 依赖缺失，先跑 hermes doctor，它会逐项列出缺什么并给出安装命令。新版安装脚本也能只补依赖、不重装：curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --ensure node,browser,ripgrep,ffmpeg。旧教程里的 hermes postinstall 已在新版删除。最后是求助场景：hermes dump 导出一份给支持用的环境摘要，发问题报告时直接附上，比逐条口述系统、版本和配置完整得多。

一句话收个尾：日常巡检 status、问题回放 logs、空间治理 sessions、灾难兜底 backup、试验隔离 profile、求助带 dump，六个位置各司其职，记住分工比背全参数有用。

还没有真实场景？可以先领取 Free Starter 模板包，从低风险只读任务开始试跑。