Hermes Agent所有命令一张表搞定，打印下来贴墙上
摘要： Hermes Agent的命令体系由4个层级构成：Top-level CLI（38个）、Global Options、Session Slash命令、Dynamic Slash（技能调用）。本文把所有命令整理成速查表，按场景分组，附实战用法和注意事项，打印贴墙随时查阅。
背不下来没关系，贴在墙上就行。
命令体系总览：4层结构
理解Hermes的命令体系，先搞清楚4个层级：
| 层级 | 入口 | 用途 | 典型例子 |
|---|---|---|---|
| Top-level CLI | hermes <command> |
配置、运维、生命周期管理 | hermes setup、hermes gateway start |
| Global Options | hermes [options] |
全局开关 | --profile、--worktree、--yolo |
| Session Slash | /<command> |
会话内动作、显示控制 | /model、/compress、/usage |
| Dynamic Slash | /<skill-name> |
调用已安装Skill | /github-pr-workflow |
CLI vs Slash的区别：CLI命令在终端运行，能添加新提供商、跑OAuth流程、录入API Key；Slash命令在会话内使用，控制当前对话行为。简单说，CLI管"Hermes这个工具"，Slash管"当前这次对话"。
一个容易搞混的地方：hermes model和/model不是一回事。前者是CLI命令，可以添加新的提供商、跑OAuth、录入API Key；后者是Slash命令，只在当前会话内切换模型，不影响全局配置。如果你发现切了模型下次启动又变回去了，说明用了Slash的/model而不是CLI的hermes model。
一、Top-level CLI命令（38个，按场景分组）
1.1 启动与对话（5个）
| 命令 | 用途 | 备注 |
|---|---|---|
hermes |
启动交互式CLI | 最常用 |
hermes chat |
同上，显式形式 | 等价于hermes |
hermes chat -q "问题" |
一次性非交互模式 | 保留banner、工具预览 |
hermes -z "问题" |
纯净一次性模式 | 仅返回最终答案文本，适合cron/CI/脚本 |
hermes --tui |
启动现代TUI界面 | 推荐用这个，体验更好 |
实战用法：脚本化场景用hermes -z，交互开发用hermes --tui。-z模式stdout只输出纯文本，方便管道处理。
1.2 配置与诊断（6个）
| 命令 | 用途 | 备注 |
|---|---|---|
hermes setup |
交互式完整设置向导 | 首次使用必跑 |
hermes model |
配置/切换LLM提供商和模型 | 首次运行推荐 |
hermes doctor |
诊断配置和依赖问题 | 出问题先跑这个 |
hermes status |
查看Agent、认证、平台状态 | 一眼看全局 |
hermes config |
查看/编辑配置文件 | 进阶使用 |
hermes update |
更新Hermes到最新版 | 定期更新 |
踩坑提醒：hermes doctor能检测到80%的常见问题，包括Python版本不对、API Key过期、网络不通等。遇到问题先跑这个，比手动排查快10倍。
还有一个容易被忽视的命令：hermes status。它能一眼看到当前所有平台的连接状态——Agent是否在线、哪个平台的认证快过期了、Gateway是否正常。我自己的习惯是每天早上先跑一遍hermes status，确认一切正常再开始工作。
1.3 认证管理（4个）
| 命令 | 用途 | 备注 |
|---|---|---|
hermes auth |
管理凭证（添加/列出/删除/重置/策略） | 统一入口 |
hermes login |
已弃用 | 用hermes auth代替 |
hermes logout |
已弃用 | 用hermes auth代替 |
hermes auth add <provider> |
添加新提供商认证 | 支持OAuth流程 |
1.4 网关管理（5个）
| 命令 | 用途 | 备注 |
|---|---|---|
hermes gateway start |
启动消息网关服务 | Telegram/Discord等 |
hermes gateway stop |
停止网关 | — |
hermes gateway status |
查看网关状态 | 确认连接是否正常 |
hermes gateway restart |
重启网关 | 改配置后需要 |
hermes gateway logs |
查看网关日志 | 排错必备 |
实战用法：配置Telegram Bot时，先hermes gateway start再绑定Token。如果Bot没响应，hermes gateway logs看日志，90%是网络超时或Token过期。
1.5 WhatsApp桥接（3个）
| 命令 | 用途 | 备注 |
|---|---|---|
hermes whatsapp |
配置和配对WhatsApp桥接 | 需要扫描二维码 |
hermes whatsapp status |
查看WhatsApp连接状态 | — |
hermes whatsapp reset |
重置WhatsApp连接 | 连接异常时使用 |
1.6 技能与工具（5个）
| 命令 | 用途 | 备注 |
|---|---|---|
hermes skills |
列出/管理已安装技能 | 查看技能库 |
hermes skills add <url> |
从URL安装技能 | 社区技能安装 |
hermes skills remove <name> |
卸载技能 | — |
hermes tools |
查看/管理工具集 | 20+工具按需启用 |
hermes tools enable <tool> |
启用指定工具 | 细粒度权限控制 |
关键工具集：terminal（核心中的核心，执行Shell命令）、file（读写搜索编辑文件）、web/browser（网页搜索和自动化）、memory（跨会话持久记忆）、skills（技能管理和自动加载）、delegation（子代理任务委派）、cronjob（定时任务调度）、session_search（回顾历史会话）。
每个工具集都可以按平台单独启用/禁用。这在Telegram/Discord等消息平台上尤其重要——比如在Telegram里你可能不想启用terminal（避免误操作），但在CLI里这是最核心的工具。
1.7 其他（10个）
| 命令 | 用途 |
|---|---|
hermes history |
查看历史会话列表 |
hermes session <id> |
恢复指定会话 |
hermes export <id> |
导出会话记录 |
hermes mcp |
MCP服务器管理 |
hermes sandbox |
沙箱环境管理 |
hermes version / -V |
查看版本 |
hermes help |
帮助信息 |
hermes rl |
RL训练轨迹导出 |
hermes profile |
管理多配置文件 |
hermes worktree |
Git worktree管理 |
二、Global Options（全局选项）
| 选项 | 简写 | 用途 | 典型场景 |
|---|---|---|---|
--profile <name> |
-p |
指定配置文件 | 多实例隔离 |
--resume <session> |
-r |
恢复指定会话 | 继续之前的工作 |
--continue [name] |
-c |
恢复最近会话 | 快速恢复 |
--worktree |
-w |
使用隔离git worktree | 并行代理工作流 |
--yolo |
— | 跳过危险命令确认 | ⚠️ 慎用！信任环境才开 |
--tui |
— | 强制TUI界面 | 偏好现代UI |
--quiet |
-Q |
安静模式 | 脚本/CI环境 |
--pass-session-id |
— | 在系统提示中包含会话ID | 调试用 |
--dev |
— | 用tsx直接运行TS源码 | TUI贡献者使用 |
⚠️ --yolo的警告：这个选项会跳过所有危险命令的审批确认，意味着Hermes可以不经你同意执行rm -rf等破坏性操作。只在完全信任的环境（如容器内）使用，生产环境绝对不要开。
三、Session Slash命令（会话内使用）
3.1 模型与配置（4个）
| 命令 | 用途 | 备注 |
|---|---|---|
/model |
会话内切换模型 | 不影响全局配置 |
/model <name> |
直接切换到指定模型 | 快捷方式 |
/config |
查看当前配置 | — |
/profile |
切换配置文件 | — |
3.2 会话控制（6个）
| 命令 | 用途 | 备注 |
|---|---|---|
/compress |
压缩当前上下文 | 上下文太长时用 |
/clear |
清空当前会话 | 重新开始 |
/usage |
查看Token使用量 | 算账必备 |
/cost |
查看本次会话费用 | 预算控制 |
/session |
查看会话信息 | — |
/save |
保存当前会话 | 防丢失 |
3.3 记忆与技能（4个）
| 命令 | 用途 | 备注 |
|---|---|---|
/memory |
查看当前记忆状态 | 三层记忆总览 |
/memory search <query> |
搜索历史记忆 | 找之前的内容 |
/skills |
列出可用技能 | 会话内查看 |
/skill <name> |
加载指定技能 | 快速调用 |
3.4 工具与网关（4个）
| 命令 | 用途 | 备注 |
|---|---|---|
/tools |
查看已启用工具 | — |
/tools enable <name> |
会话内启用工具 | — |
/tools disable <name> |
会话内禁用工具 | 安全控制 |
/gateway |
查看网关状态 | — |
3.5 其他（3个）
| 命令 | 用途 |
|---|---|
/help |
查看帮助 |
/exit / /quit |
退出会话 |
/feedback <text> |
提交反馈 |
四、Dynamic Slash（技能动态调用）
格式：/<skill-name> [参数]
例如：
- /github-pr-workflow — 调用GitHub PR工作流技能
- /deploy-prod — 调用生产部署技能
- /daily-report — 调用日报生成技能
技能名称来自你的技能库，安装什么技能就有什么命令。用hermes skills或/skills查看完整列表。
技能命名规范建议：用小写+连线符，如github-pr-workflow、deploy-prod、daily-report。避免空格和特殊字符，否则Slash调用时可能解析错误。
技能创建的两种方式：一是Hermes自动创建——当你完成一个复杂工作流（调用工具5次以上），它会自动生成技能文件；二是手动创建——在技能目录下直接写Markdown。两种方式各有优势：自动创建省事但可能不够精确，手动创建精确但需要时间。推荐先用自动创建，再手动微调。
五、实战场景速查
以下7个场景覆盖了Hermes日常使用的90%需求。每个场景都经过实测验证，直接复制粘贴即可。
场景1：首次安装配置
hermes setup # 交互式设置向导
hermes model # 选择LLM提供商和模型
hermes doctor # 确认一切正常
hermes --tui # 启动TUI开始使用
场景2：配置Telegram Bot
hermes auth add telegram # 添加Telegram认证
hermes gateway start # 启动网关
hermes gateway status # 确认连接
hermes gateway logs # 排错看日志
场景3：脚本化批量任务
hermes -z "检查所有PR状态并生成摘要" > report.txt
# 纯文本输出，适合cron定时调用
场景4：并行工作流
hermes -w -p project-a chat # 窗口1：项目A
hermes -w -p project-b chat # 窗口2：项目B
# worktree隔离，互不干扰
场景5：模型切换省钱
/model deepseek-chat # 日常用便宜的
/model claude-sonnet # 复杂推理切强的
# 会话内随时切，不影响全局
场景6：记忆搜索找之前的内容
/memory search "数据库优化" # 搜索历史记忆
# 找到之前讨论过的相关内容，自动加载上下文
场景7：查看费用避免超支
/usage # 看Token用量
/cost # 看本次会话花了多少钱
# 每天/每周定期查看，控制API费用
六、与铠盒A1的配合：7×24命令行助手
Hermes Agent命令体系的设计，天然适配铠盒A1这种7×24小时运行的智能体计算机。
hermes -z模式 + cron = 定时任务引擎。在铠盒A1上设置crontab，每早8点跑hermes -z "生成昨日工作总结"，纯文本输出到文件，你早上打开就能看到摘要。不需要开电脑，不需要人工触发，A1永远在跑。
hermes gateway + Telegram = 移动端控制台。A1上跑着gateway，你用手机Telegram随时@HermesBot下指令。在外面开会时让Agent帮你查资料、改代码、发通知，回来就都搞定了。
--worktree + --profile = 多任务并行。A1的低功耗ARM架构适合跑多个轻量级Agent实例。用不同profile隔离不同项目，worktree确保代码不冲突，一台A1同时服务3-5个并行任务毫无压力。
实操建议：A1出厂建议配置为——默认启动gateway（Telegram/Discord）+ cron定时任务 + 一个常驻CLI会话。SSH进去后直接hermes --tui，立刻进入工作状态。不需要每次重新配置，记忆系统会自动恢复上下文。
进阶玩法：用--profile在A1上创建多个配置文件。比如一个profile用于"开发"（启用terminal+file+web），一个profile用于"监控"（只启用cronjob+memory）。用systemd管理多个实例，一个A1同时服务不同用途，效率最大化。
七、注意事项
--yolo慎用：跳过所有安全确认，只在容器等隔离环境使用hermes -z不保留上下文：每次都是全新会话，需要上下文用-r恢复/compress会丢失细节：压缩后信息量减少，重要内容先/savehermes doctor是第一排错工具：80%的问题都能诊断出来- 技能命名要规范：用小写+连字符（如
github-pr-workflow），避免特殊字符 - Gateway日志是排错利器：Telegram/Discord没响应，先看
gateway logs hermes -z配合cron最爽：定时任务输出纯文本，方便后续处理/compress和/save搭配用：压缩前先保存，防止重要信息丢失- 技能文件可以手动编辑：技能存在本地Markdown文件里，觉得不完美可以直接改
hermes history找旧会话：忘了之前哪个会话讨论过某问题，用history翻记录--model可以临时切模型：如果默认模型响应慢，用hermes --model gpt-4o临时切换，不改变默认配置/compact比/compress更温和：只压缩较旧的上下文，保留最近对话细节
铠盒智能 | 小白也可以使用的7×24小时工作的智能体计算机 · Hermes专区追踪