hermes-agent/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/slash-commands.md

sidebar_position	title	description
2	斜杠命令参考	交互式 CLI 和消息平台斜杠命令完整参考

斜杠命令参考

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

• 交互式 CLI 斜杠命令 — 由 cli.py 分发，支持从注册表自动补全
• 消息平台斜杠命令 — 由 gateway/run.py 分发，帮助文本和平台菜单均从注册表生成

已安装的 skill（技能）也会在两个入口以动态斜杠命令的形式暴露。这包括内置 skill，如 /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 查找。追加 now、--yes 或 -y 可跳过确认弹窗——例如 /reset now、/new --yes my-experiment。
/clear	清屏并开始新会话
/history	显示对话历史
/save	保存当前对话
/retry	重试最后一条消息（重新发送给 agent）
/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）	将 prompt（提示词）加入队列等待下一轮处理（不会中断当前 agent 响应）。
/steer <prompt>	在下一次工具调用之后向 agent 注入一条中途说明——不中断、不产生新的用户轮次。当前工具完成后，该文本会追加到最后一条工具结果的内容中，在不打断当前工具调用循环的情况下为 agent 提供新上下文。可用于在任务进行中调整方向（例如在 agent 运行测试时说"专注于 auth 模块"）。
/goal <text>	设置一个持续目标，Hermes 将跨轮次持续推进——这是我们对 Ralph loop 的实现。每轮结束后，辅助裁判模型会判断目标是否完成；若未完成，Hermes 自动继续。子命令：/goal status、/goal pause、/goal resume、/goal clear。预算默认为 20 轮（goals.max_turns）；任何真实用户消息都会抢占继续循环，状态在 /resume 后保留。完整说明见 持续目标。
/subgoal <text>	在循环进行中向活动目标追加一个用户自定义条件。继续 prompt 会将所有子目标原文呈现给 agent，裁判也会将其纳入 DONE/CONTINUE 判断——因此只有原始目标和所有子目标都满足时，目标才会被标记为完成。子命令：/subgoal（列出）、/subgoal remove <N>、/subgoal clear。需要有活动的 /goal。
/resume [name]	恢复之前命名的会话
/sessions	在交互式选择器中浏览并恢复历史会话
/redraw	强制完整重绘 UI（在 tmux 调整大小、鼠标选择产生残影等导致终端错位后恢复）。
/status	显示会话信息——模型、提供商、profile、会话 ID、工作目录、标题、创建/更新时间戳、token 总量、agent 运行状态——随后显示本地会话摘要块（近期用户/助手轮次数、工具结果数、最常用工具、最近访问的文件、最新用户 prompt 和最新助手回复）。摘要从内存中的对话本地计算，不调用 LLM，不影响 prompt 缓存。
/agents（别名：/tasks）	显示当前会话中的活动 agent 和运行中的任务。
/background <prompt>（别名：/bg、/btw）	在独立的后台会话中运行 prompt。agent 独立处理你的 prompt——当前会话保持空闲可继续其他工作。任务完成后结果以面板形式显示。见 CLI 后台会话。
/branch [name]（别名：/fork）	分支当前会话（探索不同路径）
/handoff <platform>	仅限 CLI。 将当前会话移交给消息平台（Telegram、Discord、Slack、WhatsApp、Signal、Matrix）。gateway 立即接管，在支持线程的平台上创建新线程（Telegram 话题、Discord 文字频道线程、Slack 消息锚定线程），将目标重新绑定到你的 CLI session_id 以重放完整的角色感知转录，并伪造一条合成用户轮次让 agent 确认已在新位置工作。成功后 CLI 干净退出并提示 /resume；随时可用 /resume <title> 在本地恢复。轮次进行中拒绝执行。需要 gateway 正在运行且目标平台已配置 home 频道（从目标聊天中执行 /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]	切换 OpenAI/Codex 模型的可选 Codex app-server runtime。auto（默认）使用 Hermes 标准 chat completions；codex_app_server 将轮次交给 codex app-server 子进程，支持原生 shell、apply_patch、ChatGPT 订阅认证和迁移的 Codex 插件。下次会话生效。
/personality	设置预定义的 personality（人格）
/verbose	循环切换工具进度显示：off → new → all → 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]	切换最终回复中的 gateway 运行时元数据页脚（显示模型、工具调用次数、耗时）。
/busy [queue|steer|interrupt|status]	仅限 CLI：控制 Hermes 工作时按下 Enter 的行为——将新消息加入队列、中途引导，或立即中断。
/indicator [kaomoji|emoji|unicode|ascii]	仅限 CLI：选择 TUI 忙碌指示器样式。

工具与 Skill

命令	描述
/tools [list|disable|enable] [name...]	管理工具：列出可用工具，或为当前会话禁用/启用特定工具。禁用工具会将其从 agent 工具集中移除并触发会话重置。
/toolsets	列出可用工具集
/browser [connect|disconnect|status]	管理本地 Chromium 系浏览器的 CDP 连接。connect 将浏览器工具附加到正在运行的 Chrome、Brave、Chromium 或 Edge 实例（默认：http://127.0.0.1:9222）。disconnect 断开连接。status 显示当前连接状态。若未检测到调试器，则自动启动支持的 Chromium 系浏览器。
/skills	从在线注册表搜索、安装、检查或管理 skill
/cron	管理定时任务（列出、添加/创建、编辑、暂停、恢复、运行、删除）
/curator	后台 skill 维护——status、run、pin、archive。见 Curator。
/kanban <action>	无需离开聊天即可操作多 profile、多项目协作看板。完整的 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/ 以发现新安装或已删除的 skill
/reload	将 .env 变量重新加载到运行中的会话（无需重启即可获取新 API 密钥）
/plugins	列出已安装的插件及其状态

信息

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

退出

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

动态 CLI 斜杠命令

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

快捷命令

用户自定义快捷命令将一个短斜杠命令映射到 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。快捷命令在分发时解析，可能不会出现在所有内置自动补全/帮助表中。

不支持将纯字符串 prompt 快捷方式作为快捷命令。较长的可复用 prompt 请放入 skill，或使用 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。当前缀有歧义（匹配多个命令）时，注册表顺序中的第一个匹配项优先。完整命令名和已注册别名始终优先于前缀匹配。

消息平台斜杠命令

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

命令	描述
/new	开始新对话。
/reset	重置对话历史。
/status	显示会话信息，随后显示本地会话摘要块（近期轮次数、最常用工具、访问的文件、最新 prompt + 回复）。
/stop	终止所有正在运行的后台进程并中断运行中的 agent。
/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 app-server runtime。持久化到 config.yaml 中的 model.openai_runtime 并驱逐缓存的 agent，使下一条消息使用新 runtime。下次会话生效。
/personality [name]	为会话设置 personality 覆盖层。
/fast [normal|fast|status]	切换快速模式——OpenAI Priority Processing / Anthropic Fast Mode。
/retry	重试最后一条消息。
/undo	移除最后一轮对话。
/sethome（别名：/set-home）	将当前聊天标记为该平台的 home 频道，用于消息投递。
/compress [focus topic]	手动压缩对话上下文。可选的焦点主题可缩小摘要保留的范围。
/topic [off|help|session-id]	仅限 Telegram DM。 管理用户自主的多会话话题模式。/topic 启用或显示状态；/topic off 禁用并清除绑定；/topic help 显示用法；在话题中执行 /topic <session-id> 可恢复之前的会话。见 多会话 DM 模式。
/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>	在独立的后台会话中运行 prompt。任务完成后结果投递回同一聊天。见 消息平台后台会话。
/queue <prompt>（别名：/q）	将 prompt 加入队列等待下一轮处理，不中断当前轮次。
/steer <prompt>	在下一次工具调用后注入一条消息，不中断——模型在下一次迭代时获取，而非作为新轮次。
/goal <text>	设置一个持续目标，Hermes 将跨轮次持续推进——这是我们对 Ralph loop 的实现。裁判模型在每轮后检查；若未完成，Hermes 自动继续，直到完成、你暂停/清除，或达到轮次预算（默认 20）。子命令：/goal status、/goal pause、/goal resume、/goal clear。agent 运行中可安全执行 status/pause/clear；设置新目标需先执行 /stop。见 持续目标。
/footer [on|off|status]	切换最终回复中的运行时元数据页脚（显示模型、工具调用次数、耗时）。
/curator [status|run|pin|archive]	后台 skill 维护控制。
/kanban <action>	从聊天中操作多 profile、多项目协作看板——参数与 CLI 完全一致。绕过运行中 agent 的保护，因此 /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]	浏览所有命令和 skill（分页）。
/approve [session|always]	审批并执行待处理的危险命令。session 仅为本次会话审批；always 添加到永久白名单。
/deny	拒绝待处理的危险命令。
/update	将 Hermes Agent 更新到最新版本。
/restart	在排空活动运行后优雅重启 gateway。gateway 重新上线后，会向请求者的聊天/线程发送确认消息。
/debug	上传调试报告（系统信息 + 日志）并获取可分享链接。
/help	显示消息平台帮助。
/<skill-name>	按名称调用任意已安装的 skill。

注意事项

• /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 和消息 gateway 中均可使用。
• /voice join、/voice channel 和 /voice leave 仅在 Discord 上有意义。

破坏性命令的确认提示

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

命令	销毁的内容
/clear	清屏并开始新会话——当前会话 ID 和内存中的历史记录将丢失。
/new / /reset	开始新会话（新会话 ID + 空历史记录）。
/undo	从历史记录中移除最后一轮用户/助手对话。
/exit --delete / /quit --delete	退出并永久删除当前会话的 SQLite 历史记录和磁盘上的转录文件。

对于上述每个命令，CLI 会打开一个三选项弹窗：Approve Once（本次执行）、Always Approve（执行并持久化 approvals.destructive_slash_confirm: false，使未来的破坏性命令无需提示直接运行），或 Cancel。

内联跳过： 追加 now、--yes 或 -y 可为单次调用绕过弹窗——例如 /reset now、/new --yes my-session、/clear -y、/undo -y。适用于弹窗在你的终端无法正常渲染的情况（见 issue #30768，原生 Windows PowerShell）或对 CLI 进行脚本化操作时。

在 ~/.hermes/config.yaml 中设置 approvals.destructive_slash_confirm: false 可全局禁用提示；设置回 true 可重新启用。背景说明见 安全——破坏性斜杠命令确认。