斜杠命令参考

Hermes 有两个斜杠命令表面，均由 hermes_cli/commands.py 中的中央 COMMAND_REGISTRY 驱动：

• 交互式 CLI 斜杠命令 — 由 cli.py 调度，通过注册表实现自动补全
• 消息斜杠命令 — 由 gateway/run.py 调度，从注册表生成帮助文本和平台菜单

已安装的技能也会作为动态斜杠命令暴露在两个表面上。这包括诸如 /plan 之类的捆绑技能，它会打开规划模式并将 Markdown 计划保存在活动工作区/后端工作目录下的 .hermes/plans/ 中。

权限与管理员/用户分离

每个支持按用户允许列表的消息平台（Telegram、Discord、Slack、Matrix、Mattermost、Signal 等）都支持两级斜杠命令分离：管理员可以访问所有已注册的命令，普通用户只能访问你在 user_allowed_commands 中列出的命令（加上始终允许的基础命令 /help 和 /whoami）。在 ~/.hermes/gateway-config.yaml 的平台 extra: 块中配置 allow_admin_from 和 user_allowed_commands（以及对应的按群组设置 group_allow_admin_from / group_user_allowed_commands）。

各平台的详细文档请参见——结构在所有平台中一致：

• Telegram
• Discord
• Slack
• Matrix
• Mattermost
• Signal

如果某个作用域的 allow_admin_from 未设置，则该作用域保持无限制的向后兼容模式——每个被允许的用户都可以运行所有命令。

交互式 CLI 斜杠命令

在 CLI 中输入 / 可打开自动补全菜单。内置命令不区分大小写。

会话

命令	描述
/new [name]（别名：/reset）	开始新会话（新的会话 ID + 清空历史）。可选的 [name] 设置初始会话标题——例如 /new my-experiment 打开一个已命名为 my-experiment 的新会话，便于后续通过 /resume 或 /sessions 找到。
/clear	清屏并开始新会话
/history	显示对话历史
/save	保存当前对话
/retry	重试最后一条消息（重新发送给代理）
/undo	移除最后一条用户/助手的交互记录
/title	为当前会话设置标题（用法：/title My Session Name）
/compress [focus topic]	手动压缩对话上下文（刷新记忆 + 摘要）。可选的焦点主题限定摘要保留的内容范围。
/rollback	列出或恢复文件系统检查点（用法：/rollback [number]）
/snapshot [create|restore <id>|prune]（别名：/snap）	创建或恢复 Hermes 配置/状态快照。create [label] 保存快照，restore <id> 恢复到该快照，prune [N] 删除旧快照，不带参数则列出所有快照。
/stop	终止所有正在运行的后台进程
/queue <prompt>（别名：/q）	为下一轮排队一个提示（不中断当前代理响应）。
/steer <prompt>	注入一条中间运行笔记，在下一次工具调用之后到达代理——不中断，不产生新的用户轮次。文本会在当前工具完成后追加到最后一个工具结果的内容中，在不破坏当前工具调用循环的情况下为代理提供新上下文。在任务中间引导方向时使用（例如代理运行测试时说”聚焦在 auth 模块上”）。
/goal <text>	设置一个持续的、跨轮次的目标让 Hermes 努力完成——我们实现了 Ralph 循环。每轮之后，一个辅助评审模型判断目标是否完成；如果未完成，Hermes 自动继续。子命令：/goal status、/goal pause、/goal resume、/goal clear。轮次预算默认为 20 轮（goals.max_turns）；任何真实的用户消息会抢占继续循环，状态在 /resume 后仍然保持。请参阅 持久化目标 获取完整教程。
/subgoal <text>	在循环进行中向活动目标追加用户提供的标准。继续提示会向代理逐字呈现所有子目标，评审模型将其纳入 DONE/CONTINUE 判定——因此目标直到原始目标和所有子目标都满足后才算完成。子命令：/subgoal（列出）、/subgoal remove <N>、/subgoal clear。需要激活中的 /goal。
/resume [name]	恢复之前命名的会话
/sessions	在交互式选择器中浏览和恢复之前的会话
/redraw	强制完全重新绘制 UI（从 tmux 调整大小、鼠标选择伪影等导致的终端偏移后恢复）
/status	显示会话信息——模型、提供商、配置文件、会话 ID、工作目录、标题、创建/更新时间戳、Token 总数、代理运行状态——后跟本地会话回顾区块（最近的用户/助手轮次计数、工具结果计数、使用最多的工具、最后触碰的少数文件、最新的用户提示和最新的助手回复）。回顾从内存中的对话本地计算；无需 LLM 调用，不影响提示缓存。
/agents（别名：/tasks）	显示当前会话中的活动代理和正在运行的任务。
/background <prompt>（别名：/bg、/btw）	在单独的后台会话中运行提示。代理独立处理你的提示——你当前的会话仍可自由处理其他工作。任务完成时结果显示在面板中。请参阅 CLI 后台会话。
/branch [name]（别名：/fork）	分支当前会话（探索不同路径）
/handoff <platform>	仅 CLI。 将当前会话移交给消息平台（Telegram、Discord、Slack、WhatsApp、Signal、Matrix）。网关立即接管，在支持线程的平台（Telegram 话题、Discord 文本频道线程、Slack 消息锚定线程）上创建新线程，将目标重新绑定到你的 CLI session_id 以便完整的角色感知转录得以回放，并伪造一个用户轮次让代理确认它在新位置工作。成功时你的 CLI 干净退出，并显示 /resume 提示；随时通过 /resume <title> 在本地恢复。在代理响应中间被拒绝。需要网关正在运行且为目标平台配置了主频道（从目标聊天中运行 /sethome）。请参阅 跨平台移交。

配置

命令	描述
/config	显示当前配置
/model [model-name]	显示或更改当前模型。支持：/model claude-sonnet-4、/model provider:model（切换提供商）、/model custom:model（自定义端点）、/model custom:name:model（命名自定义提供商）、/model custom（从端点自动检测）和用户定义的别名（/model fav、/model grok——请参阅 自定义模型别名）。使用 --global 将更改持久化到 config.yaml。注意： /model 只能在已配置的提供商之间切换。要添加新提供商，请退出会话并在终端中运行 hermes model。
/codex-runtime [auto|codex_app_server|on|off]	切换可选的 Codex 应用服务器运行时，适用于 OpenAI/Codex 模型。auto（默认）使用 Hermes 的标准聊天补全；codex_app_server 将轮次交给 codex app-server 子进程，以获得原生 shell、apply_patch、ChatGPT 订阅认证和迁移的 Codex 插件。下次会话生效。
/personality	设置预定义的角色人格
/verbose	循环切换工具进度显示：关闭 → 新 → 全部 → 详细。可通过配置为 消息平台启用。
/fast [normal|fast|status]	切换快速模式——OpenAI Priority Processing / Anthropic Fast Mode。选项：normal、fast、status。
/reasoning	管理推理努力程度和显示（用法：/reasoning [level|show|hide]）
/skin	显示或更改显示皮肤/主题
/statusbar（别名：/sb）	切换上下文/模型状态栏的显示或隐藏
/voice [on|off|tts|status]	切换 CLI 语音模式和语音播放。录音使用 voice.record_key（默认：Ctrl+B）。
/yolo	切换 YOLO 模式——跳过所有危险命令审批提示。
/footer [on|off|status]	切换最终回复上的网关运行时元数据页脚（显示模型、工具数量、耗时）。
/busy [queue|steer|interrupt|status]	仅 CLI：控制 Hermes 工作时按下 Enter 键的行为——排队新消息、中间引导或立即中断。
/indicator [kaomoji|emoji|unicode|ascii]	仅 CLI：选择 TUI 忙碌指示器样式。

工具与技能

命令	描述
/tools [list|disable|enable] [name...]	管理工具：列出可用工具，或为当前会话禁用/启用特定工具。禁用某个工具会将其从代理的工具集中移除并触发会话重置。
/toolsets	列出可用的工具集
/browser [connect|disconnect|status]	管理本地 Chromium 系列 CDP 连接。connect 将浏览器工具附加到正在运行的 Chrome、Brave、Chromium 或 Edge 实例（默认：http://127.0.0.1:9222）。disconnect 断开。status 显示当前连接。如果未检测到调试器，自动启动支持的 Chromium 系列浏览器。
/skills	从在线注册表搜索、安装、检查或管理技能
/cron	管理定时任务（列出、添加/创建、编辑、暂停、恢复、运行、移除）
/curator	后台技能维护——status、run、pin、archive。请参阅 Curator。
/kanban <action>	在聊天中驱动多配置文件、多项目协作看板。完整的 hermes kanban 功能可用：/kanban list、/kanban show t_abc、/kanban create "title" --assignee X、/kanban comment t_abc "text"、/kanban unblock t_abc、/kanban dispatch 等。支持多看板：/kanban boards list、/kanban boards create <slug>、/kanban boards switch <slug>、/kanban --board <slug> <action>。请参阅 Kanban 斜杠命令。
/reload-mcp（别名：/reload_mcp）	从 config.yaml 重新加载 MCP 服务器
/reload-skills（别名：/reload_skills）	重新扫描 ~/.hermes/skills/ 中新安装或移除的技能
/reload	将 .env 变量重新加载到正在运行的会话中（无需重启即可获取新的 API 密钥）
/plugins	列出已安装的插件及其状态

信息

命令	描述
/help	显示此帮助信息
/usage	显示 Token 用量、成本明细、会话时长，以及——当活动提供商支持时——账户限制部分，显示从提供商 API 实时拉取的剩余配额/积分/套餐使用情况。
/insights	显示使用洞察和分析（最近 30 天）
/platforms（别名：/gateway）	显示网关/消息平台状态（仅 CLI 摘要视图）。
/platform <list|pause|resume> [name]	操作正在运行的网关平台。/platform list 列出所有适配器及其状态（运行中、熔断暂停、手动暂停）；/platform pause <name> 停止向该适配器调度新消息但不卸载；/platform resume <name> 重新启用。网关还会在适配器因重复可重试错误（网络/速率限制/5xx）触发熔断器时自动暂停——上游恢复健康后使用 /platform resume <name> 清除熔断器。在网关可到达的任何地方可用（CLI 会话、Telegram、Discord 等）。
/paste	附加剪贴板图片
/copy [number]	复制最后一条助手响应到剪贴板（或带数字时复制倒数第 N 条）。仅 CLI。
/image <path>	为下次提示附加本地图片文件。
/debug	上传调试报告（系统信息 + 日志）并获取可分享链接。消息平台也可用。
/profile	显示活动配置文件名称和主目录
/gquota	显示 Google Gemini Code Assist 配额使用情况及进度条（仅在 google-gemini-cli 提供商激活时可用）。

退出

命令	描述
/quit	退出 CLI（也可用：/exit）。关于 /q 的说明请参见上面的 /queue。传递 --delete（或 -d）——例如 /exit --delete——可以在退出前同时永久删除当前会话的 SQLite 历史记录和磁盘上的转录。适用于隐私敏感或一次性任务。

动态 CLI 斜杠命令

命令	描述
/<skill-name>	将任何已安装的技能作为按需命令加载。示例：/gif-search、/github-pr-workflow、/excalidraw。
/skills ...	从注册表和官方可选技能目录搜索、浏览、检查、安装、审计、发布和配置技能。

快速命令

用户定义的快速命令将简短的斜杠命令映射到 shell 命令或另一个斜杠命令。在 ~/.hermes/config.yaml 中配置：

quick_commands:
  status:
    type: exec
    command: systemctl status hermes-agent
  deploy:
    type: exec
    command: scripts/deploy.sh
  inbox:
    type: alias
    target: /gmail unread

然后在 CLI 或消息平台中输入 /status、/deploy 或 /inbox。快速命令在调度时解析，可能不会出现在每个内置的自动补全/帮助表中。

纯字符串的提示快捷方式不支持作为快速命令。将较长的可重用提示放在技能中，或使用 type: alias 指向现有的斜杠命令。

自定义模型别名

为你经常使用的模型定义自己的短名称，然后通过 CLI 或任何消息平台使用 /model <alias> 访问。别名在两者中工作方式相同，支持仅会话（默认）和 --global 开关。

支持两种配置格式：

完整格式——固定确切的模型、提供商以及可选的 base URL。放在 ~/.hermes/config.yaml 中：

model_aliases:
  fav:
    model: claude-sonnet-4.6
    provider: anthropic
  grok:
    model: grok-4
    provider: x-ai
  ollama-qwen:
    model: qwen3-coder:30b
    provider: custom
    base_url: http://localhost:11434/v1

简短格式——将 provider/model 放在一个字符串中。无需编辑 YAML，直接从 shell 设置：

hermes config set model.aliases.fav anthropic/claude-opus-4.6
hermes config set model.aliases.grok x-ai/grok-4

然后在聊天中：

/model fav            # 仅会话
/model grok --global  # 同时将当前模型更改持久化到 config.yaml

用户别名优先于内置短名称，因此将别名命名为 sonnet、kimi、opus 等会覆盖内置名称。别名名称不区分大小写。

别名解析

命令支持前缀匹配：输入 /h 解析为 /help，/mod 解析为 /model。当前缀有歧义时（匹配多个命令），按注册表顺序第一个匹配获胜。完整命令名称和已注册的别名始终优先于前缀匹配。

消息斜杠命令

消息网关在 Telegram、Discord、Slack、WhatsApp、Signal、Email、Home Assistant 和 Teams 聊天中支持以下内置命令：

命令	描述
/new	开始新对话。
/reset	重置对话历史。
/status	显示会话信息，后跟本地会话回顾区块（最近轮次计数、使用最多的工具、触碰的文件、最新提示 + 回复）。
/stop	终止所有正在运行的后台进程并中断正在运行的代理。
/model [provider:model]	显示或更改模型。支持提供商切换（/model zai:glm-5）、自定义端点（/model custom:model）、命名自定义提供商（/model custom:local:qwen）、自动检测（/model custom）和用户定义别名（/model fav、/model grok——请参阅 自定义模型别名）。使用 --global 将更改持久化到 config.yaml。注意： /model 只能在已配置的提供商之间切换。要添加新提供商或设置 API 密钥，请在终端中（在聊天会话之外）使用 hermes model。
/codex-runtime [auto|codex_app_server|on|off]	切换可选的 Codex 应用服务器运行时。持久化到 config.yaml 中的 model.openai_runtime，并驱逐缓存的代理，以便下一条消息使用新的运行时。下次会话生效。
/personality [name]	为会话设置角色人格覆盖。
/fast [normal|fast|status]	切换快速模式——OpenAI Priority Processing / Anthropic Fast Mode。
/retry	重试最后一条消息。
/undo	移除最后一条交互记录。
/sethome（别名：/set-home）	将当前聊天标记为平台的投递主频道。
/compress [focus topic]	手动压缩对话上下文。可选的焦点主题限定摘要保留的内容范围。
/topic [off|help|session-id]	仅 Telegram 私信。 管理用户管理的多会话话题模式。/topic 启用它或显示状态；/topic off 禁用它并清除绑定；/topic help 显示用法；/topic <session-id> 在话题内恢复之前的会话。请参阅 多会话私信模式。
/title [name]	设置或显示会话标题。
/resume [name]	恢复之前命名的会话。
/usage	显示 Token 用量、估算成本明细（输入/输出）、上下文窗口状态、会话时长，以及——当活动提供商支持时——账户限制部分，显示从提供商 API 实时拉取的剩余配额/积分。
/insights [days]	显示使用分析。
/reasoning [level|show|hide]	更改推理努力程度或切换推理显示。
/voice [on|off|tts|join|channel|leave|status]	控制聊天中的语音回复。join/channel/leave 管理 Discord 语音频道模式。
/rollback [number]	列出或恢复文件系统检查点。
/background <prompt>	在单独的后台会话中运行提示。任务完成后结果会投递回同一聊天。请参阅 消息后台会话。
/queue <prompt>（别名：/q）	为下一轮排队一个提示，不中断当前轮次。
/steer <prompt>	在下一次工具调用后注入一条消息而不中断——模型在其下一次迭代中获取该消息，而非作为新用户轮次。
/goal <text>	设置一个持续的、跨轮次的目标让 Hermes 努力完成——我们实现了 Ralph 循环。一个评审模型每轮后检查；如果未完成，Hermes 自动继续，直到完成、你暂停/清除它，或达到轮次预算（默认 20）。子命令：/goal status、/goal pause、/goal resume、/goal clear。可在代理运行时安全地用于 status/pause/clear；设置新目标需要先 /stop。请参阅 持久化目标。
/footer [on|off|status]	切换最终回复上的运行时元数据页脚（显示模型、工具数量、耗时）。
/curator [status|run|pin|archive]	后台技能维护控制。
/kanban <action>	从聊天中驱动多配置文件、多项目协作看板——参数表面与 CLI 相同。绕过运行代理保护，因此 /kanban unblock t_abc、/kanban comment t_abc "…"、/kanban list --mine、/kanban boards switch <slug> 等可以在代理运行中使用。/kanban create … 自动将发起聊天订阅新任务的终端事件。请参阅 Kanban 斜杠命令。
/reload-mcp（别名：/reload_mcp）	从配置重新加载 MCP 服务器。
/yolo	切换 YOLO 模式——跳过所有危险命令审批提示。
/commands [page]	浏览所有命令和技能（分页）。
/approve [session|always]	批准并执行待处理的危险命令。session 仅本次会话批准；always 添加到永久允许列表。
/deny	拒绝待处理的危险命令。
/update	将 Hermes Agent 更新到最新版本。
/restart	在耗尽活动运行后优雅重启网关。当网关重新上线时，会向请求者的聊天/线程发送确认。
/debug	上传调试报告（系统信息 + 日志）并获取可分享链接。
/help	显示消息帮助。
/<skill-name>	按名称调用任何已安装的技能。

注意事项

• /skin、/snapshot、/gquota、/reload、/tools、/toolsets、/browser、/config、/cron、/skills、/platforms、/paste、/image、/statusbar、/plugins、/busy、/indicator、/redraw、/clear、/history、/save、/copy、/handoff 和 /quit 是仅 CLI 的命令。
• /verbose 默认仅 CLI，但可以通过在 config.yaml 中设置 display.tool_progress_command: true 为消息平台启用。启用后，它会循环切换 display.tool_progress 模式并保存到配置。
• /sethome、/update、/restart、/approve、/deny、/topic 和 /commands 是仅消息的命令。
• /status、/background、/queue、/steer、/voice、/reload-mcp、/reload-skills、/rollback、/debug、/fast、/footer、/curator、/kanban、/sessions 和 /yolo 在 CLI 和消息网关中均可用。
• /voice join、/voice channel 和 /voice leave 仅在 Discord 中有意义。

破坏性命令的确认提示

CLI 在运行会丢弃未保存会话状态的斜杠命令之前会提示确认。当前的破坏性命令集为：

命令	它会破坏什么
/clear	清屏并开始新会话——当前会话 ID 和内存中的历史记录消失。
/new / /reset	开始新会话（新会话 ID + 空历史）。
/undo	从历史中移除最后一条用户/助手的交互记录。
/exit --delete / /quit --delete	退出并永久删除当前会话的 SQLite 历史记录和磁盘上的转录。

对于以上每个命令，CLI 会打开一个三选一模态框：批准一次（本次继续）、始终批准（继续并将 approvals.destructive_slash_confirm: false 持久化，以便未来的破坏性命令无需提示直接运行）或取消。

在 ~/.hermes/config.yaml 中设置 approvals.destructive_slash_confirm: false 可全局禁用提示；将其设置回 true 可重新启用。请参阅 安全 — 破坏性斜杠命令确认 了解背景信息。