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。