<!-- Source: https://hermesbible.com/docs/reference/slash-commands -->

Hermes 有兩套斜線命令介面，皆由 hermes_cli/commands.py 中的中央 COMMAND_REGISTRY 驅動：

• 互動式 CLI 斜線命令 — 由 cli.py 分派，支援從 registry 自動補全
• 訊息平台斜線命令 — 由 gateway/run.py 分派，說明文字與平台選單從 registry 產生

已安裝的 Skills 也會在兩套介面上以動態斜線命令的形式暴露，包含內建 skill 如 /plan，它會開啟 plan mode 並將 markdown 計畫儲存在 .hermes/plans/（相對於工作空間/後端工作目錄）。

權限與 admin/user 分離

每個支援逐用戶允許名單的訊息平台（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 中輸入 / 可開啟自動補全選單。內建命令不區分大小寫。

Session

Configuration

Tools & Skills

Info

Exit

Dynamic CLI slash commands

Quick Commands

使用者定義的快速命令將短斜線命令對應到 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。快速命令在分派時解析，可能不會出現在每個內建自動補全/說明表中。

不支援純字串提示捷徑作為快速命令。將較長的可重複使用提示放在 skill 中，或使用 type: alias 指向現有斜線命令。

Custom model aliases

為你常用的模型定義自己的短名稱，然後在 CLI 或任何訊息平台中透過 /model <alias> 使用它們。別名在兩者中行為一致，支援僅限 session（預設）和 --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。從 shell 設定，無需編輯 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
/model grok --global  # 同時將當前模型變更持久化到 config.yaml

使用者別名優先於內建短名稱，因此將別名命名為 sonnet、kimi、opus 等會遮蔽內建名稱。別名名稱不區分大小寫。

Alias Resolution

命令支援前綴匹配：輸入 /h 會解析為 /help，/mod 會解析為 /model。當前綴模糊（匹配多個命令）時，registry 順序中的第一個匹配勝出。完整命令名稱和已註冊別名始終優先於前綴匹配。

Messaging slash commands

訊息 gateway 支援以下內建命令，可在 Telegram、Discord、Slack、WhatsApp、Signal、Email、Home Assistant 和 Teams 聊天中使用：

Notes

• /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 在 search/browse/install 方面僅限 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 和訊息 gateway 中都可使用。
• /voice join、/voice channel 和 /voice leave 僅在 Discord 上有意義。
• 在 TUI 中，/sessions 顯示當前 TUI 程序中的即時 session。使用 /resume [name] 或 hermes --tui --resume <id-or-title> 來恢復已儲存或已關閉的對話記錄。

破壞性命令的確認提示

CLI 在執行會丟棄未儲存 session 狀態的斜線命令前會提示確認。目前的破壞性命令集如下：

對每個命令，CLI 會開啟一個三選一對話框：批准一次（本次繼續）、永遠批准（繼續並持久化 approvals.destructive_slash_confirm: false，以便未來的破壞性命令無需提示即可執行）或取消。

內聯跳過： 加上 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 可重新啟用。參見 安全性 — 破壞性斜線命令確認 了解更多背景。

---

---

Profile Commands Reference