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 codex
/skills install github-pr-workflow
hermes skills update

安装 Skill 后不要立刻接高风险任务。先让它做只读总结、标签建议或草稿输出，确认触发条件和边界稳定。

Gateway 排错命令

hermes gateway setup
hermes gateway status
hermes gateway logs
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 import`——这一对组合也是 `hermes update` 的后悔药：升级前留好 zip，新版本不对劲就能整体退回去。检查点是另一套东西，存放在 `~/.hermes/checkpoints/`，用 `hermes checkpoints` 查看和清理，两者互不替代。

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

hermes profile list
hermes update
hermes postinstall
hermes dump

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

`hermes update` 升级本体；升级后如果浏览器、ripgrep、ffmpeg、node 这类非 Python 依赖缺失，跑一次 `hermes postinstall` 补装即可，不需要整体重装。最后是求助场景：`hermes dump` 导出一份给支持用的环境摘要，发问题报告时直接附上，比逐条口述系统、版本和配置完整得多。

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

还没有真实场景？可以先领取 [Free Starter 模板包](/free-template-pack)，从低风险只读任务开始试跑。