hermes教程-斜杠命令参考

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）。

请参阅各平台文档中的示例——结构在所有平台上相同：

如果某个作用域的 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`	重试最后一条消息（重新发送给代理）
`/undo`	移除最后一次用户/助手交换
`/title`	为当前会话设置标题（用法：/title My Session Name）
`/compress [here [N] \| focus topic]`	手动压缩对话上下文（刷新记忆 + 总结）。`/compress here [N]` 总结除最近 N 次交换（默认 2）之外的所有内容，最近 N 次保持原样——选择你自己的压缩边界。焦点主题会缩小完整总结保留的内容范围。
`/rollback`	列出或恢复文件系统检查点（用法：/rollback [number]）
`/snapshot [create\|restore <id>\|prune]`（别名：`/snap`）	创建或恢复 Hermes 配置/状态的状态快照。`create [label]` 保存快照，`restore <id>` 恢复到该快照，`prune [N]` 移除旧快照，无参数则列出所有快照。
`/stop`	终止所有正在运行的后台进程
`/queue <prompt>`（别名：`/q`）	为下一轮排队一个提示（不中断当前代理响应）。
`/steer <prompt>`	注入一条运行中笔记，该笔记在下一次工具调用之后到达代理——不中断，不产生新的用户轮次。当前工具完成后，文本会附加到最后一条工具结果的内容中，为代理提供新上下文而不破坏当前工具调用循环。用于在任务进行中调整方向（例如，当代理正在运行测试时“专注于认证模块”）。
`/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`（TUI 别名：`/switch`）	经典 CLI：在交互式选择器中浏览和恢复之前的会话。TUI：打开当前 TUI 会话的实时会话切换器。在 TUI 中使用 `/sessions new` 立即启动另一个实时会话。
`/redraw`	强制完全重绘 UI（从 tmux 调整大小、鼠标选择伪影等导致的终端漂移中恢复）
`/status`	显示会话信息——模型、提供商、配置文件、会话 ID、工作目录、标题、创建/更新时间戳、令牌总数、代理运行状态——后跟本地会话摘要块（最近用户/助手轮次计数、工具结果计数、最常用工具、最近接触的文件、最新用户提示和最新助手回复）。摘要是从内存中的对话本地计算的；无需 LLM 调用，不影响提示缓存。
`/agents`（别名：`/tasks`）	显示当前会话中的活动代理和正在运行的任务。
`/background <prompt>`（别名：`/bg`、`/btw`）	在单独的后台会话中运行提示。代理独立处理你的提示——你的当前会话保持空闲，可进行其他工作。任务完成时结果以面板形式显示。参见CLI 后台会话。
`/branch [name]`（别名：`/fork`）	分支当前会话（探索不同路径）
`/handoff <platform>`	仅 CLI。将当前会话移交给消息平台（Telegram、Discord、Slack、WhatsApp、Signal、Matrix）。网关立即接管，在支持线程的平台（Telegram 话题、Discord 文本频道线程、Slack 消息锚定线程）上创建新线程，将目标重新绑定到你的 CLI 会话 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 优先处理 / Anthropic 快速模式。选项：`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]`	切换最终回复上的网关运行时元数据页脚（显示模型、上下文百分比和 cwd）。
`/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`	从在线注册表搜索、安装、检查或管理技能。也是技能写入批准门的审查界面：`/skills pending`、`/skills diff <id>`、`/skills approve <id>`、`/skills reject <id>`、`/skills approval on\|off`。参见门控代理技能写入。
`/memory [pending\|approve\|reject\|approval]`	审查由写入批准门（`memory.write_approval`）暂存的待处理记忆写入，并切换门控。参见控制记忆写入。
`/bundles`	列出已配置的技能捆绑包——`/<name>` 斜杠别名，可一次预加载多个技能。在 `~/.hermes/config.yaml` 的 `bundles:` 下配置。参见技能捆绑包。
`/cron`	管理计划任务（列出、添加/创建、编辑、暂停、恢复、运行、移除）
`/curator`	后台技能维护——`status`、`run`、`pin`、`archive`。参见策展人。
`/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>`。参见看板斜杠命令。
`/reload-mcp`（别名：`/reload_mcp`）	从 config.yaml 重新加载 MCP 服务器
`/reload-skills`（别名：`/reload_skills`）	重新扫描 `~/.hermes/skills/` 以查找新安装或移除的技能
`/reload`	将 `.env` 变量重新加载到运行中的会话（无需重启即可获取新的 API 密钥）
`/plugins`	列出已安装的插件及其状态

信息

命令	描述
`/help`	显示此帮助消息
`/version`	显示 Hermes Agent 版本、构建和环境信息。
`/usage`	显示令牌使用量、成本明细、会话持续时间，以及——当活动提供商可用时——账户限制部分，包含从提供商 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`）。

动态 CLI 斜杠命令

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

快速命令

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

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：

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 在一个字符串中。从 shell 设置，无需编辑 YAML：

bash

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

然后在聊天中：

text

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

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

别名解析

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

消息斜杠命令

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

命令	描述
`/start`	平台协议命令。许多聊天平台（Telegram、Discord 等）在用户首次打开机器人对话时自动发送 `/start`。Hermes 静默确认 ping——无代理回复，不消耗会话——因此首次接触握手不会浪费一轮。你也可以显式发送它以确认网关可达。
`/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 优先处理 / Anthropic 快速模式。
`/retry`	重试最后一条消息。
`/undo`	移除最后一次交换。
`/sethome`（别名：`/set-home`）	将当前聊天标记为平台主频道，用于投递。
`/compress [here [N] \| focus topic]`	手动压缩对话上下文。`/compress here [N]` 保持最近 N 次交换（默认 2）原样，并总结其余部分。焦点主题缩小完整总结保留的内容范围。
`/topic [off\|help\|session-id]`	仅 Telegram 私信。管理用户管理的多会话话题模式。`/topic` 启用它或显示状态；`/topic off` 禁用它并清除绑定；`/topic help` 显示用法；`/topic <session-id>` 在话题内恢复之前的会话。参见多会话私信模式。
`/title [name]`	设置或显示会话标题。
`/resume [name]`	恢复之前命名的会话。
`/usage`	显示令牌使用量、估计成本明细（输入/输出）、上下文窗口状态、会话持续时间，以及——当活动提供商可用时——账户限制部分，包含从提供商 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`。在代理运行中安全使用以获取状态/暂停/清除；设置新目标需要先 `/stop`。参见持续目标。
`/footer [on\|off\|status]`	切换最终回复上的运行时元数据页脚（显示模型、上下文百分比和 cwd）。
`/curator [status\|run\|pin\|archive]`	后台技能维护控制。
`/memory [pending\|approve\|reject\|approval]`	审查由写入批准门（`memory.write_approval`）暂存的待处理记忆写入——直接在聊天中批准或拒绝它们——并使用 `/memory approval on\|off` 切换门控。参见控制记忆写入。
`/skills [pending\|approve\|reject\|diff\|approval]`	审查由写入批准门（`skills.write_approval`）暂存的待处理技能写入。每个暂存写入显示一行摘要；`/skills diff <id>` 为聊天截断——在 CLI 或 `~/.hermes/pending/skills/<id>.json` 中阅读完整差异。仅当门控开启（或暂存写入仍存在）时出现；搜索/安装仍仅限 CLI。
`/kanban <action>`	从聊天驱动多配置文件、多项目协作看板——参数界面与 CLI 相同。绕过运行中代理守卫，因此 `/kanban unblock t_abc`、`/kanban comment t_abc "…"`、`/kanban list --mine`、`/kanban boards switch <slug>` 等可在轮次中工作。`/kanban create …` 自动将发起聊天订阅到新任务的终端事件。参见看板斜杠命令。
`/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、/platforms、/paste、/image、/statusbar、/plugins、/busy、/indicator、/redraw、/clear、/history、/save、/copy、/handoff 和 /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 模式并保存到配置。
/sethome、/update、/restart、/approve、/deny、/topic 和 /commands 是仅消息命令。
/status、/version、/background、/queue、/steer、/voice、/reload-mcp、/reload-skills、/rollback、/debug、/fast、/footer、/curator、/kanban、/sessions 和 /yolo 在CLI 和消息网关中都有效。
/voice join、/voice channel 和 /voice leave 仅在 Discord 上有意义。
在 TUI 中，/sessions 显示当前 TUI 进程中的实时会话。对于已保存或已关闭的转录，使用 /resume [name] 或 hermes --tui --resume <id-or-title>。

破坏性命令的确认提示

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

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

对于这些命令中的每一个，CLI 都会打开一个三选项弹窗：批准一次（本次继续）、始终批准（继续并持久化 approvals.destructive_slash_confirm: false，以便将来破坏性命令运行时无需提示）或取消。

内联跳过： 附加 now、--yes 或 -y 以绕过单次调用的弹窗——例如 /reset now、/new --yes my-session、/clear -y、/undo -y。当弹窗在你的终端上无法正确渲染时（参见问题 #30768 关于原生 Windows PowerShell）或在对 CLI 进行脚本化时很有用。

在 ~/.hermes/config.yaml 中设置 approvals.destructive_slash_confirm: false 以全局禁用提示；将其设置回 true 以重新启用。参见安全——破坏性斜杠命令确认以获取上下文。