OpenClaw Slash 指令完整參考手冊
根據官方文檔 (docs.openclaw.ai) 整理，適用於 v2026.3.x
所有指令由 Gateway 處理，不經過 AI 模型，即時生效。
指令 vs Directive 的區別
OpenClaw 有兩套系統：
- 指令 (Commands)：獨立的
/...訊息，由 Gateway 即時處理。 - Directive：
/think、/fast、/verbose、/reasoning、/elevated、/exec、/model、/queue。- 嵌入在普通聊天訊息中時，作為「一次性提示」，不會持久保存到 session。
- 單獨發送（訊息只有 directive）時，會持久保存到 session，並回覆確認。
一、資訊查詢類
| 指令 | 用途 |
|---|---|
/help |
顯示常用指令摘要（按類別分組）。可嵌入普通訊息使用。 |
/commands |
列出所有可用的 slash 指令。Telegram 上每頁 8 個指令分頁顯示。 |
/status |
顯示當前狀態：正在使用的模型、context 用量、queue 設定、runtime 模式，以及當前模型供應商的 usage/quota。 |
/whoami |
顯示你的 sender ID。別名：/id。可嵌入普通訊息使用。 |
/context |
查看 context window 的使用情況。/context list 或 /context detail 顯示每個檔案、工具、skill 和 system prompt 的大小。/context json 輸出 JSON 格式。 |
二、Session 管理類
| 指令 | 用途 |
|---|---|
/reset 或 /new [model] |
重置 session / 開始新對話。可選擇附帶模型名稱（支持 alias、provider/model、或 provider 名稱模糊匹配）。 |
/stop |
立即中止當前正在運行的 agent 回覆。 |
/compact [instructions] |
手動觸發 context 壓縮，可附帶自定義指示告訴壓縮器要保留哪些內容。（僅支持文字指令） |
/export-session [path] |
匯出當前 session 為 HTML（包含完整 system prompt）。別名：/export。 |
/session idle <duration|off> |
設定閒置多久後自動解除 thread 綁定（用於 Discord thread binding）。 |
/session max-age <duration|off> |
設定 session 最大存活時間，超過後自動解除 thread 綁定。 |
三、模型控制類
| 指令 | 用途 |
|---|---|
/model |
顯示模型選擇器（帶編號列表）。Discord 上會顯示互動式下拉選單。 |
/model list |
列出所有可用模型（含 provider 資訊）。 |
/model <數字> |
按編號快速選擇模型。 |
/model <provider/model> |
切換到指定模型，例如 /model openai/gpt-5.2。 |
/model <alias> |
用別名切換，例如 /model opus（需先在 config 中設定 alias）。 |
/model status |
顯示詳細資訊：auth 狀態、provider endpoint（baseUrl）、API 模式等。 |
/think <level> |
設定思考深度。可選：off、minimal、low、medium、high、xhigh（依模型/provider 而定）。別名：/thinking、/t。 |
/fast status|on|off |
快速模式（Anthropic/OpenAI）。省略參數顯示當前狀態。on/off 持久保存到 session。 |
四、使用量與費用類
| 指令 | 用途 |
|---|---|
/usage off |
關閉每條回覆的 usage footer。 |
/usage tokens |
每條回覆末尾顯示 token 用量。 |
/usage full |
每條回覆末尾顯示完整用量資訊（含模型名稱、token 數）。想知道每次用了哪個模型，用這個。 |
/usage cost |
從本地 session 日誌中顯示費用摘要。 |
五、輸出控制類
| 指令 | 用途 |
|---|---|
/verbose on |
開啟詳細模式，顯示工具執行細節。 |
/verbose full |
完整詳細模式，顯示所有工具輸出。在群組中慎用，可能洩露敏感資訊。 |
/verbose off |
關閉詳細模式。別名：/v。 |
/reasoning on |
開啟推理可見性，以獨立訊息（前綴 Reasoning:）顯示模型的推理過程。 |
/reasoning stream |
以 Telegram draft 形式串流顯示推理過程（僅限 Telegram）。 |
/reasoning off |
關閉推理顯示。別名：/reason。 |
/send on|off|inherit |
控制是否發送回覆。Owner-only。 |
六、語音與 TTS 類
| 指令 | 用途 |
|---|---|
/tts off |
關閉文字轉語音。 |
/tts always |
所有回覆都轉語音。 |
/tts inbound |
僅對語音輸入回覆語音。 |
/tts tagged |
僅標記的回覆轉語音。 |
/tts status |
查看當前 TTS 設定。 |
/tts provider |
查看/切換 TTS provider。 |
/tts limit |
設定語音長度限制。 |
/tts summary |
顯示 TTS 用量摘要。 |
/tts audio |
音頻相關設定。 |
Discord 上原生指令為
/voice（Discord 保留了/tts），但文字輸入的/tts仍然有效。
Discord 專屬：/vc join|leave|status控制語音頻道。
七、執行與安全類
| 指令 | 用途 |
|---|---|
/elevated on |
開啟提權模式，允許執行需要更高權限的操作。 |
/elevated off |
關閉提權模式。 |
/elevated ask |
每次提權操作前詢問。 |
/elevated full |
完全提權，跳過 exec 批准流程。別名：/elev。 |
/exec |
顯示當前 exec 設定。 |
/exec host=<sandbox|gateway|node> |
設定命令執行環境。 |
/exec security=<deny|allowlist|full> |
設定安全級別。 |
/exec ask=<off|on-miss|always> |
設定批准策略。 |
/exec node=<id> |
指定執行節點。 |
/approve <id> allow-once|allow-always|deny |
回應 exec 批准提示。 |
/bash <command> |
在主機上直接執行 shell 命令。別名：! <command>。需要 commands.bash: true 且配置 tools.elevated allowlist。 |
!poll |
查看正在運行的 bash 任務的輸出/狀態。 |
!stop |
停止正在運行的 bash 任務。 |
八、佇列控制類
| 指令 | 用途 |
|---|---|
/queue |
顯示當前 queue 設定。 |
/queue <mode> |
設定 queue 模式，可附帶選項如 debounce:2s cap:25 drop:summarize。 |
九、群組與頻道類
| 指令 | 用途 |
|---|---|
/activation mention|always |
設定群組中的觸發模式：需要 @mention 還是回覆所有訊息。 |
/allowlist |
列出當前 allowlist 條目。 |
/allowlist add|remove |
新增/移除 allowlist 條目。需要 commands.config=true。 |
/dock-telegram |
將回覆切換到 Telegram 頻道。 |
/dock-discord |
將回覆切換到 Discord 頻道。 |
/dock-slack |
將回覆切換到 Slack 頻道。 |
十、Sub-Agent 與多代理類
| 指令 | 用途 |
|---|---|
/subagents list |
列出當前 session 的所有 sub-agent。 |
/subagents kill |
終止 sub-agent。 |
/subagents log |
查看 sub-agent 日誌。 |
/subagents info |
查看 sub-agent 詳細資訊。 |
/subagents send |
向 sub-agent 發送訊息。 |
/subagents steer |
引導 sub-agent 方向。 |
/subagents spawn |
手動生成新的 sub-agent。 |
/kill <id|#|all> |
立即終止一個或所有正在運行的 sub-agent（無確認訊息）。 |
/steer <id|#> <message> |
立即引導 sub-agent：如果正在運行中就注入指令，否則中止並以新指令重啟。別名：/tell。 |
/agents |
列出當前 session 的 thread-bound agents。 |
/focus <target> |
（Discord）將 thread 綁定到指定的 session/subagent。 |
/unfocus |
（Discord）解除 thread 綁定。 |
十一、ACP Agent 類
| 指令 | 用途 |
|---|---|
/acp spawn |
生成 ACP runtime session。 |
/acp cancel |
取消 ACP session。 |
/acp steer |
引導 ACP session。 |
/acp close |
關閉 ACP session。 |
/acp status |
查看 ACP 狀態。 |
/acp set-mode |
設定 ACP 模式。 |
/acp set |
設定 ACP 參數。 |
/acp cwd |
設定工作目錄。 |
/acp permissions |
管理權限。 |
/acp timeout |
設定超時。 |
/acp model |
設定 ACP 使用的模型。 |
/acp reset-options |
重置選項。 |
/acp doctor |
診斷 ACP 問題。 |
/acp install |
安裝 ACP。 |
/acp sessions |
管理 ACP sessions。 |
十二、配置管理類
| 指令 | 用途 |
|---|---|
/config show |
顯示完整配置。 |
/config show <path> |
顯示指定路徑的配置，如 /config show messages.responsePrefix。 |
/config get <path> |
取得指定配置值。 |
/config set <path>=<value> |
設定配置值（寫入磁碟，需 commands.config: true）。 |
/config unset <path> |
移除指定配置（需 commands.config: true）。 |
/debug show |
顯示當前 runtime override。 |
/debug set <path>=<value> |
設定 runtime-only override（僅存在記憶體，不寫入磁碟）。需 commands.debug: true。 |
/debug unset <path> |
移除 runtime override。 |
/debug reset |
清除所有 override，恢復為磁碟上的配置。 |
十三、Skill 相關類
| 指令 | 用途 |
|---|---|
/skill <name> [input] |
按名稱執行 skill。當原生指令數量限制無法為每個 skill 建立獨立指令時特別有用。 |
/<skill_alias> |
如果 skill 已註冊為原生指令，可直接用其名稱呼叫（例如 /prose）。 |
Skill 名稱會被清理為
a-z0-9_（最多 32 字元），衝突時加數字後綴（如_2）。
Skill 可宣告command-dispatch: tool直接路由到工具（不經模型），實現確定性執行。
十四、BTW 側問題
| 指令 | 用途 |
|---|---|
/btw <question> |
在不干擾主任務的情況下，對當前 session 提出快速側面問題。 |
特點：
- 使用當前 session 作為背景 context
- 以獨立的無工具一次性呼叫運行
- 不改變未來 session 的 context
- 不寫入 transcript 歷史
- 作為 live side result 而非正常 assistant 訊息送達
十五、系統管理類
| 指令 | 用途 |
|---|---|
/restart |
重啟 OpenClaw Gateway。預設啟用，設 commands.restart: false 可停用。 |
Inline Directive 速記語法
在普通訊息中可嵌入 directive（前綴 :），模型看到的訊息不會包含這些 directive：
| Directive | 用途 |
|---|---|
:think high |
設定思考深度 |
:model opus |
覆蓋模型 |
:fast |
快速模式 |
:send off |
不發送回覆 |
:verbose |
詳細模式 |
:reasoning on |
顯示推理 |
:elevated ask |
Exec 批准模式 |
自然語言中止
除了 /stop，你也可以用自然語言中止 agent：
"stop openclaw"、"stop action"、"please stop"、"STOP!"、"do not do that"
支援多國語言：英、西、法、中、印地、阿拉伯、日、德、葡、俄。
重要備註
- 指令支持在指令名和參數之間加
:，例如/think: high、/send: on。 - 所有指令對已授權的使用者即時生效（繞過 queue 和模型）。
- 群組中，已授權使用者的純指令訊息繞過 @mention 要求。
/config和/debug預設關閉，需在openclaw.json中手動啟用。- Slack 上
/status被 Slack 保留，需註冊為/agentstatus。
