Skip to main content

斜杠命令参考

Hermes 具有两个由中心配置项 COMMAND_REGISTRY 驱动的斜杠命令界面:

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

已安装的技能也会在两个界面上以动态斜杠命令形式暴露。这包括内置技能如 /plan,该命令可打开计划模式,并将 Markdown 计划保存至相对于当前工作区/后端工作目录的 .hermes/plans/ 路径下。

交互式 CLI 斜杠命令

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

会话(Session)

命令描述
/new(别名:/reset启动新会话(生成新的会话 ID 和历史记录)
/clear清屏并开始新会话
/history显示对话历史
/save保存当前对话
/retry重试上一条消息(重新发送给代理)
/undo删除最近一次用户/助手的交互
/title为当前会话设置标题(用法:/title 我的会话名称
/compress [focus topic]手动压缩对话上下文(清除记忆并总结)。可选聚焦主题可限定摘要保留的内容。
/rollback列出或恢复文件系统检查点(用法:/rollback [数字]
/snapshot [create|restore <id>|prune](别名:/snap创建或恢复 Hermes 配置/状态快照。create [label] 保存快照,restore <id> 恢复到该快照,prune [N] 删除旧快照,或不带参数列出所有快照。
/stop终止所有正在运行的后台进程
/queue <prompt>(别名:/q将提示排队等待下一轮处理(不会中断当前代理响应)。注意: /q/queue/quit 共享;最后注册者胜出,因此实践中 /q 解析为 /quit。请显式使用 /queue
/resume [name]恢复之前命名的会话
/status显示会话信息
/background <prompt>(别名:/bg在独立后台会话中运行提示。代理会独立处理你的提示——你当前的会话仍可用于其他工作。任务完成后结果将以面板形式出现。详见 CLI 后台会话
/btw <question>使用会话上下文进行临时旁问(无工具、不持久化)。适用于快速澄清问题,不影响对话历史。
/plan [request]加载内置的 plan 技能,用于编写 Markdown 计划而非执行任务。计划将保存至相对于当前工作区/后端工作目录的 .hermes/plans/ 路径下。
/branch [name](别名:/fork分支当前会话(探索不同路径)

配置(Configuration)

命令描述
/config显示当前配置
/model [model-name]显示或更改当前模型。支持:/model claude-sonnet-4/model provider:model(切换提供商)、/model custom:model(自定义端点)、/model custom:name:model(命名自定义提供商)、/model custom(自动检测端点中的模型)。使用 --global 可将更改永久保存至 config.yaml
/provider显示可用服务商及当前服务商
/personality设置预设人格
/verbose切换工具进度显示:关闭 → 新增 → 全部 → 详细。可通过配置在消息平台启用。
/reasoning管理推理强度与显示(用法:/reasoning [level|show|hide]
/fast [normal|fast|status]切换快速模式 — OpenAI 优先处理 / Anthropic 快速模式。选项:normalfaststatusonoff
/skin显示或更改显示皮肤/主题
/statusbar(别名:/sb开启或关闭上下文/模型状态栏
/voice [on|off|tts|status]切换 CLI 语音模式及语音播放。录音使用 voice.record_key(默认值:Ctrl+B)。
/yolo切换 YOLO 模式 — 跳过所有危险命令的确认提示。

工具与技能(Tools & Skills)

命令描述
/tools [list|disable|enable] [name...]管理工具:列出可用工具,或禁用/启用特定工具用于当前会话。禁用工具将从代理工具集中移除,并触发会话重置。
/toolsets列出可用工具集
/browser [connect|disconnect|status]管理本地 Chrome CDP 连接。connect 将浏览器工具连接到正在运行的 Chrome 实例(默认:ws://localhost:9222)。disconnect 断开连接。status 显示当前连接状态。若未检测到调试器,则自动启动 Chrome。
/skills从在线注册表搜索、安装、检查或管理技能
/cron管理定时任务(列出、添加/创建、编辑、暂停、恢复、运行、删除)
/reload-mcp(别名:/reload_mcpconfig.yaml 重新加载 MCP 服务器
/reload.env 变量重新加载到运行中的会话(无需重启即可获取新 API 密钥)
/plugins列出已安装插件及其状态

信息(Info)

命令描述
/help显示此帮助信息
/usage显示令牌使用情况、费用明细及会话时长
/insights显示使用洞察与分析(最近 30 天)
/platforms(别名:/gateway显示网关/消息平台状态
/paste检查剪贴板中是否有图片并附加
/image <path>附加本地图像文件供下一条提示使用。
/debug上传调试报告(系统信息 + 日志)并获取可分享链接。消息平台同样支持。
/profile显示当前活动配置文件名称及主目录路径

退出(Exit)

命令描述
/quit退出 CLI(也可使用 /exit)。参见上方 /q 的说明。

动态 CLI 斜杠命令

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

快捷命令(Quick Commands)

用户自定义的快捷命令将短别名映射到较长的提示。可在 ~/.hermes/config.yaml 中配置:

quick_commands:
review: "Review my latest git diff and suggest improvements"
deploy: "Run the deployment script at scripts/deploy.sh and verify the output"
morning: "Check my calendar, unread emails, and summarize today's priorities"

然后在 CLI 中输入 /review/deploy/morning。快捷命令在分派时解析,不会出现在内置自动补全/帮助表格中。

别名解析(Alias Resolution)

命令支持前缀匹配:输入 /h 会解析为 /help/mod 会解析为 /model。当某个前缀存在歧义(匹配多个命令)时,以注册顺序中的第一个匹配项为准。完整命令名称和已注册的别名始终优先于前缀匹配。

消息系统斜杠命令

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

命令描述
/new启动新对话。
/reset重置对话历史。
/status显示会话信息。
/stop终止所有正在运行的后台进程,并中断当前运行的代理。
/model [provider:model]查看或更改模型。支持切换提供商(/model zai:glm-5)、自定义端点(/model custom:model)、命名自定义提供商(/model custom:local:qwen)以及自动检测(/model custom)。使用 --global 可将更改持久化保存至 config.yaml
/provider显示提供商可用性及认证状态。
/personality [name]为当前会话设置个性叠加层。
/retry重试上一条消息。
/undo移除最近一次交互。
/sethome(别名:/set-home将当前聊天标记为平台主频道,用于接收交付消息。
/compress [focus topic]手动压缩对话上下文。可选的关注主题可缩小摘要保留的内容范围。
/title [name]设置或显示会话标题。
/resume [name]恢复之前命名的会话。
/usage显示 token 使用情况、估算成本明细(输入/输出)、上下文窗口状态及会话持续时间。
/insights [days]显示使用分析数据。
/reasoning [level|show|hide]更改推理强度或切换推理显示状态。
/voice [on|off|tts|join|channel|leave|status]控制聊天中的语音回复。join/channel/leave 用于管理 Discord 语音频道模式。
/rollback [number]列出或恢复文件系统检查点。
/snapshot [create|restore <id>|prune](别名:/snap创建或恢复 Hermes 配置/状态的快照。
/background <prompt>在独立后台会话中运行一个提示。任务完成后,结果将返回到同一聊天中。详见 消息后台会话
/plan [request]加载内建的 plan 技能,用于编写 Markdown 计划而非执行任务。计划将保存在相对于当前工作区/后端工作目录的 .hermes/plans/ 下。
/reload-mcp(别名:/reload_mcp从配置重新加载 MCP 服务器。
/reload.env 变量重新加载到运行会话中。
/yolo切换 YOLO 模式 — 跳过所有危险命令的确认提示。
/commands [page]浏览所有命令与技能(分页显示)。
/approve [session|always]批准并执行待处理的危险命令。session 仅对本次会话生效;always 则添加至永久允许列表。
/deny拒绝待处理的危险命令。
/update将 Hermes Agent 更新至最新版本。
/restart在耗尽正在进行的任务后优雅重启网关。网关恢复上线后,会向请求者所在聊天/线程发送确认通知。
/debug上传调试报告(系统信息 + 日志),并获取可分享链接。
/help显示消息帮助信息。
/<skill-name>通过名称调用任意已安装的技能。

注意事项

  • /skin/tools/toolsets/browser/config/cron/skills/platforms/paste/image/statusbar/plugins仅 CLI 命令
  • /verbose 默认为 仅 CLI 命令,但可通过在 config.yaml 中设置 display.tool_progress_command: true 来启用其在消息平台上的功能。启用后,该命令将循环切换 display.tool_progress 模式,并保存至配置文件。
  • /sethome/update/restart/approve/deny/commands仅消息平台命令
  • /status/background/voice/reload-mcp/rollback/snapshot/debug/fast/yoloCLI 和消息网关 中均可用。
  • /voice join/voice channel/voice leave 仅在 Discord 平台上有意义。