sidebar_position: 2 title: “Slash Commands Reference” description: “Complete reference for interactive CLI and messaging slash commands”

斜杠命令参考

Hermes 提供两种斜杠命令接口，二者均通过 hermes_cli/commands.py 中的中央 COMMAND_REGISTRY 来驱动：

• 交互式 CLI 斜杠命令——由 cli.py 调用，并从注册表中获取自动补全功能；
• 消息平台斜杠命令——由 gateway/run.py 调用，其帮助文本和平台菜单也由注册表生成。

已安装的技能同样会作为动态斜杠命令在这两种接口中呈现。（/plan 曾属于此类命令，但现在已成为内置命令——详见下方的会话表格。）

权限与管理员/用户区分

所有支持按用户设置允许列表的消息平台（Telegram、Discord、Slack、Matrix、Mattermost、Signal 等）都支持两级斜杠命令权限划分：管理员可以使用所有已注册的命令，而普通用户仅能使用在 user_allowed_commands 中列出的命令名称（此外还可以使用始终允许的 /help 和 /whoami 命令）。你可以在 ~/.hermes/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 中输入 / 即可打开自动补全菜单。内置命令不区分大小写。

会话

配置

工具与技能

信息

退出

动态 CLI 斜杠命令

快速命令

用户自定义的快速命令可将简短的斜杠命令映射到 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 指向现有的斜杠命令。

自定义模型别名

为您经常使用的模型定义自定义简称，之后便可通过运行中的会话中使用 /model <alias>、启动时使用 hermes chat --model <alias>，或在任何消息平台中调用这些别名。无论是在仅限当前会话（默认）模式还是 --global 模式下，这些别名的使用方式都完全一致。

系统支持两种配置格式：

完整格式 — 指定具体的模型、提供方，以及可选的基础 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
  theta:
    model: theta-1
    provider: custom
    base_url: https://theta.example.com/v1
    key_env: THETA_API_KEY        # or: api_key: "${THETA_API_KEY}"

拥有独立 base_url 的别名可通过 api_key（字面值或 "${VAR}" 引用形式）或 key_env（环境变量名称）来携带该端点的凭证；若两者均被设置，则以 api_key 为准。若两者均未设置，凭证将从别名的 host 字段中获取，而不会继承自切换前正在使用的提供方。

简写形式——将 provider/model 合并为一个字符串。无需编辑 YAML 即可在命令行中直接设置：

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

随后在聊天界面中：

/model fav            # session-only
/model grok --global  # also persists current-model change to config.yaml

用户自定义别名会优先于内置的简写名称，因此将别名命名为 sonnet、kimi、opus 等将会覆盖那些内置名称。别名名称不区分大小写。

别名解析

命令支持前缀匹配：输入 /h 会对应到 /help，输入 /mod 会对应到 /model。当某个前缀存在歧义（可匹配多个命令）时，注册顺序中最先出现的匹配项将优先生效。完整的命令名称以及已注册的别名始终比前缀匹配具有更高优先级。

消息类斜杠命令

Slack 线程命令（以 ! 为前缀）： Slack 本身会阻止在消息线程中使用原生斜杠命令（“线程中不支持 /queue 功能，很抱歉！”），并且不会将这些命令传递给 Hermes。在 Slack 线程中，应使用 ! 前缀——如 !stop、!new、!status——此时网关会像处理斜杠命令一样将其转发。在线程中，@Hermes !stop 和 @Hermes /stop 也同样有效。系统仅会检查第一个单词是否在已知命令列表中，因此像 !nice work 这样的消息会原封不动地传递给智能体。详情请参阅在线程中使用命令。

该消息网关支持在 Telegram、Discord、Slack、WhatsApp、Signal、电子邮件、Home Assistant 以及 Teams 聊天中使用以下内置命令：

备注

• /skin、/snapshot、/export、/import、/reload、/tools、/toolsets、/browser、/config、/cron、/platforms、/paste、/image、/statusbar、/battery、/focus、/plugins、/indicator、/wake、/journey、/redraw、/clear、/history、/save、/copy、/handoff、/prompt、/pet、/hatch、/timestamps、/subscription 以及 /quit 均为仅适用于 CLI 的命令。

• /skills 命令在搜索/浏览/安装功能上仅支持 CLI 使用；其用于审核写入权限的子命令（如 pending、approve、reject、diff、approval）在启用了 skills.write_approval 选项后，也可在消息平台中使用。而 /memory 命令则在两种平台上均可用。

• /verbose 默认为仅适用于 CLI 的命令，但可通过在 config.yaml 中设置 display.tool_progress_command: true 来使其在消息平台上启用。启用后，该命令会循环切换 display.tool_progress 模式，并将当前模式保存至配置文件中。

• /focus 与 /verbose 共享同一个抑制路径（display.tool_progress），因此二者不会产生冲突：执行 /focus on 会将工具进度显示状态设置为“关闭”，并将当前模式存储在 display.focus_saved_tool_progress 下；执行 /focus off 则可恢复原有设置。在处于聚焦状态时切换 /verbose 的启用状态，会同时恢复工具进度显示并清除聚焦标识。聚焦视图仅用于显示——它不会更改对话历史、系统提示词或发送给模型的任何内容，因此对提示词缓存毫无影响。

• /sethome、/restart、/approve、/deny、/topic、/platform 以及 /commands 均为仅适用于消息平台的命令。

• /status、/egress、/version、/whoami、/bg、/btw、/queue、/steer、/voice、/reload-mcp、/reload-skills、/rollback、/diff、/debug、/fast、/approvals、/busy、/footer、/curator、/kanban、/topup、/suggestions、/blueprint、/learn、/init、/sessions 以及 /yolo 命令在 CLI 和消息网关中均可用。

• /voice join、/voice channel 以及 /voice leave 命令仅在 Discord 环境下才有意义。

• 在 TUI 模式中，/sessions 用于显示当前 TUI 进程中的实时会话；若需查看已保存或已关闭的会话记录，则可使用 /resume [name] 或 hermes --tui --resume <id-or-title> 命令。

破坏性命令的确认提示

在运行会清除未保存会话状态的斜杠命令之前，CLI 会给出确认提示。目前属于破坏性命令的包括以下几类：

对于上述每一类命令，CLI 都会弹出三选一的确认模态框：仅本次确认（本次执行该命令），始终确认（允许该命令执行，并将 approvals.destructive_slash_confirm 的值设为 false，从而让后续的破坏性命令无需再次提示即可运行），或 取消。

直接跳过： 在命令后添加 now、--yes 或 -y，即可绕过单次调用的确认弹窗——例如 /reset now、/new --yes my-session、/clear -y、/undo -y。当终端无法正确显示该确认弹窗时（关于 Windows PowerShell 的相关问题可参见 issue #30768），或在通过脚本调用 CLI 时，此方法十分有用。

如需全局禁用这些确认提示，可在 ~/.hermes/config.yaml 中将 approvals.destructive_slash_confirm 的值设置为 false；若要重新启用该功能，则将其值改回 true。相关背景信息请参阅 安全性——破坏性斜杠命令的确认机制。