按用途分组的 Hermes CLI 命令全览
Hermes CLI 的接口面很广 —— 顶层命令超过 25 条，每条都有自己的子命令树。本课按用途分组，让你不用翻完整列表就能找到想要的那一条。每条命令都带一句说明和最有用的几个 flag。
主要来源：命令权威参考 https://hermes-agent.nousresearch.com/docs/reference/cli-commands。以该页为准；命令和 flag 会在版本之间演进。
聊天与模型
hermes chat—— 交互式或一次性聊天。Flags：-q非交互、-m覆盖模型、-t指定工具集、--provider强制提供商、-s预加载技能。hermes model—— 提供商与模型选择器。在终端外运行用于新增提供商；会话内用/model切换已配置的选项。
配置与初始化
hermes setup—— 交互式向导，涵盖 model、TTS、terminal、gateway、tools、agent。Flags：--non-interactive、--reset。hermes config—— 管理配置文件。子命令：show、edit、set、path、check、migrate。hermes whatsapp—— WhatsApp 配对与二维码流程，被单独拎出来是因为流程较特殊。
认证与状态
hermes auth—— 凭证池管理。子命令：add、list、remove、reset。处理 OAuth 与 API key。hermes status—— 智能体 + 认证 + 平台状态。Flags：--all输出可分享版本、--deep扩展检查。
会话、日志与记忆
hermes sessions—— 浏览、导出、管理。子命令：list、browse、export、delete、prune、stats、rename。hermes logs—— 查看日志。Flags：-n行数、-f实时跟踪、--level、--session、--since。hermes memory—— 配置外部记忆提供商（Honcho、Mem0、OpenViking、Hindsight 等）。子命令：setup、status、off。hermes honcho—— Honcho 专属：peer 身份、会话映射、召回模式。
技能与工具
hermes skills—— 浏览、搜索、安装、检查、审计、更新、发布。Flags：--source、--force绕过策略拦截。hermes tools—— 按平台交互式配置工具。Flag：--summary打印当前启用的工具配置。
定时任务与 Webhook
hermes cron—— 定时任务。子命令：list、create、edit、pause、resume、run、remove、status、tick。支持--skill挂技能。hermes webhook—— 事件驱动订阅。子命令：subscribe（带--prompt、--events、--skills、--deliver）、list、remove、test。
Profile 与集成
hermes profile—— 在一台机器上管理多个隔离的 Hermes 实例。子命令：list、use、create（带--clone）、delete、show、alias、rename、export、import。hermes acp—— 作为 ACP stdio 服务器启动，供编辑器集成（VS Code、Zed、JetBrains）。hermes mcp—— 管理 MCP 服务器。子命令：serve、add、remove、list、test、configure。hermes plugins—— 统一插件管理。子命令：install、update、remove、enable、disable、list。
消息网关
hermes gateway—— 消息守护进程。子命令：run、start、stop、restart、status、install、uninstall、setup。hermes pairing—— 批准 / 撤销消息配对码。子命令：list、approve、revoke、clear-pending。
诊断与维护
hermes doctor—— 诊断配置与依赖问题。Flag：--fix自动修复。hermes dump—— 给支持用的配置摘要。Flag：--show-keys带脱敏后的 API key 前缀。hermes debug share—— 把调试报告上传到 paste 服务。Flags：--lines、--expire、--local。hermes backup/hermes import—— 对配置、技能、会话打 zip 包；用 SQLite backup API 保证并发安全。hermes insights—— Token、成本、活动分析。Flags：--days、--source。hermes claw migrate—— 从 OpenClaw 迁移到 Hermes。Flags：--dry-run、--preset、--overwrite。hermes dashboard—— 在--port启动 Web UI。
杂项
hermes completion—— 打印 bash/zsh 补全脚本。hermes version—— 打印版本。hermes update—— 拉最新改动并重新安装依赖。hermes uninstall—— 卸载 Hermes。Flag：--full连配置与数据一并删除。
如何用这份参考
把这页加书签。需要哪条命令就 Ctrl+F。一条命令的行为让你意外时，回上游权威参考 —— 上方链接的 Hermes 官方页永远是最终来源。
从 OpenClaw 迁过来、想做一份两边命令的对照表：hermes claw migrate --dry-run 是个有用的起点 —— 它会打印出它打算做什么但不真的执行，安全地给你一份翻译预览。