/ 開頭、作為獨立訊息傳送的命令。
僅限主機的 bash 命令使用 ! <cmd>（/bash <cmd> 為別名）。
當對話繫結至 ACP 工作階段時，一般文字會路由至 ACP
測試框架。閘道管理命令仍維持本機處理：/acp ... 一律會送達
OpenClaw 命令處理器，而只要該介面已啟用命令處理，
/status 與 /unfocus 就會維持本機處理。
三種命令類型
Commands
由閘道處理的獨立
/... 訊息。必須作為訊息中的
唯一內容傳送。Directives
/think、/fast、/verbose、/trace、/reasoning、/elevated、
/exec、/model、/queue — 會在模型看到訊息前從訊息中移除。
單獨傳送時會保留工作階段設定；與其他文字一併傳送時則作為行內提示。Inline shortcuts
/help、/commands、/status、/whoami — 會立即執行，並在模型
看到剩餘文字前被移除。僅限已授權的傳送者。Directive behavior details
Directive behavior details
- 指令會在模型看到訊息前從訊息中移除。
- 在僅含指令的訊息中（訊息只有指令），它們會保留到工作階段， 並回覆確認訊息。
- 在包含其他文字的一般聊天訊息中，它們會作為行內提示， 且不會保留工作階段設定。
- 指令只適用於已授權的傳送者。如果已設定
commands.allowFrom， 它就是唯一使用的允許清單；否則授權會來自頻道允許清單/配對加上commands.useAccessGroups。未授權的傳送者會看到指令被視為純文字。
設定
啟用在聊天訊息中剖析
/...。在沒有原生命令的介面
（WhatsApp、WebChat、Signal、iMessage、Google Chat、Microsoft Teams）上，
即使設定為 false，文字命令仍可運作。註冊原生命令。自動：Discord/Telegram 開啟；Slack 關閉；
不支援原生命令的提供者會忽略此設定。可用
channels.<provider>.commands.native 依頻道覆寫。在 Discord 上，false
會略過斜線命令註冊；先前註冊的命令可能會持續可見，直到被移除。支援時以原生方式註冊 Skills 命令。自動：Discord/Telegram 開啟；
Slack 關閉。可用
channels.<provider>.commands.nativeSkills 覆寫。啟用
! <cmd> 以執行主機 shell 命令（/bash <cmd> 別名）。需要
tools.elevated 允許清單。bash 在切換到背景模式前等待的時間長度（
0 代表立即背景執行）。啟用
/config（讀取/寫入 openclaw.json）。僅限擁有者。啟用
/mcp（讀取/寫入 mcp.servers 下由 OpenClaw 管理的 MCP 設定）。僅限擁有者。啟用
/plugins（外掛探索/狀態，以及安裝 + 啟用/停用）。寫入僅限擁有者。啟用
/debug（僅限執行階段的設定覆寫）。僅限擁有者。啟用
/restart 與閘道重新啟動工具動作。擁有者專用命令介面的明確擁有者允許清單。與
commands.allowFrom 及 DM 配對存取分開。依頻道設定：擁有者專用命令需要擁有者身分。當為
true 時，
傳送者必須符合 commands.ownerAllowFrom，或持有內部 operator.admin
範圍。萬用字元 allowFrom 項目不足以授權。控制擁有者 ID 在系統提示中如何顯示。
使用
commands.ownerDisplay: "hash" 時使用的 HMAC 密鑰。用於命令授權的逐提供者允許清單。設定後，它會是命令與指令的
唯一授權來源。使用
"*" 作為全域預設；提供者專屬鍵會覆寫它。未設定
commands.allowFrom 時，對命令強制執行允許清單/政策。命令清單
命令來自三個來源：- 核心內建：
src/auto-reply/commands-registry.shared.ts - 產生的停靠命令：
src/auto-reply/commands-registry.data.ts - 外掛命令： 外掛
registerCommand()呼叫
核心命令
工作階段與執行
工作階段與執行
| 命令 | 說明 |
|---|---|
/new [model] | 封存目前工作階段並開始新的工作階段 |
/reset [soft [message]] | 就地重設目前工作階段。soft 會保留逐字稿、捨棄重用的命令列介面後端工作階段 ID，並重新執行啟動流程 |
/name <title> | 命名或重新命名目前工作階段。省略標題可查看目前名稱與建議 |
/compact [instructions] | 壓縮工作階段脈絡。請參閱壓縮 |
/stop | 中止目前執行 |
/session idle <duration|off> | 管理討論串繫結的閒置到期 |
/session max-age <duration|off> | 管理討論串繫結的最長存續時間到期 |
/export-session [path] | 將目前工作階段匯出為 HTML。別名：/export |
/export-trajectory [path] | 匯出目前工作階段的 JSONL 軌跡套件。別名：/trajectory |
Control UI 會攔截輸入的
/new，以建立並切換到新的
儀表板工作階段，除非已設定 session.dmScope: "main"
且目前父層是代理程式的主工作階段；在該情況下，/new
會就地重設主工作階段。輸入的 /reset 仍會執行閘道的
就地重設。當你想清除釘選的工作階段模型選擇時，請使用 /model default。模型與執行控制
模型與執行控制
| 命令 | 說明 |
|---|---|
/think <level|default> | 設定思考層級或清除工作階段覆寫。別名：/thinking、/t |
/verbose on|off|full | 切換詳細輸出。別名：/v |
/trace on|off | 切換目前工作階段的外掛追蹤輸出 |
/fast [status|auto|on|off|default] | 顯示、設定或清除快速模式 |
/reasoning [on|off|stream] | 切換推理可見性。別名：/reason |
/elevated [on|off|ask|full] | 切換提升模式。別名：/elev |
/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id> | 顯示或設定 exec 預設值 |
/login [codex|openai|openai-codex] | 從私人聊天或 Web UI 工作階段配對 Codex/OpenAI 登入。僅限擁有者/管理員 |
/model [name|#|status] | 顯示或設定模型 |
/models [provider] [page] [limit=<n>|all] | 列出已設定/可用授權的提供者或模型 |
/queue <mode> | 管理作用中執行佇列行為。請參閱佇列與佇列導引 |
/steer <message> | 將指引注入作用中執行。別名：/tell。請參閱導引 |
verbose / trace / fast / reasoning 安全性
verbose / trace / fast / reasoning 安全性
/verbose用於偵錯，在一般使用時請保持關閉。/trace只會揭露外掛擁有的追蹤/偵錯行；一般詳細雜訊會保持關閉。/fast auto|on|off會保存工作階段覆寫；使用工作階段 UI 的inherit選項來清除它。/fast依提供者而異：OpenAI/Codex 會將其對應到service_tier=priority；直接 Anthropic 請求會將其對應到service_tier=auto或standard_only。/reasoning、/verbose和/trace在群組環境中有風險，可能揭露內部推理或外掛診斷資訊。請在群組聊天中保持關閉。
模型切換詳細資訊
模型切換詳細資訊
/model會立即將新模型保存到工作階段。- 如果代理程式閒置，下一次執行會立即使用它。
- 如果有執行正在作用中，切換會標記為待處理，並在下一個乾淨的重試點套用。
探索與狀態
探索與狀態
| 命令 | 說明 |
|---|---|
/help | 顯示簡短說明摘要 |
/commands | 顯示產生的命令目錄 |
/tools [compact|verbose] | 顯示目前代理程式現在可以使用的項目 |
/status | 顯示執行/執行階段狀態、閘道與系統正常運作時間、外掛健康狀態，以及提供者用量/配額 |
/status plugins | 顯示詳細外掛健康狀態：載入錯誤、隔離、頻道外掛失敗、相依性問題、相容性通知。需要 commands.plugins: true |
/goal [status|start|edit|pause|resume|complete|block|clear] ... | 管理目前工作階段的持久目標 |
/diagnostics [note] | 僅限擁有者的支援報告流程。每次都會要求 exec 核准 |
/crestodian <request> | 從擁有者私訊執行 Crestodian 設定與修復輔助工具 |
/tasks | 列出目前工作階段的作用中/近期背景工作 |
/context [list|detail|map|json] | 說明脈絡如何組裝 |
/whoami | 顯示你的傳送者 ID。別名：/id |
/usage off|tokens|full|reset|cost | 控制逐回應用量頁尾（reset/inherit/clear/default 會清除工作階段覆寫，以重新繼承已設定的預設值）或列印本機成本摘要 |
Skills、允許清單、核准
Skills、允許清單、核准
| 命令 | 說明 |
|---|---|
/skill <name> [input] | 依名稱執行技能 |
/learn [request] | 透過 Skill Workshop，從目前對話或具名來源草擬一個可審查的技能 |
/allowlist [list|add|remove] ... | 管理允許清單項目。僅文字 |
/approve <id> <decision> | 解決 exec 或外掛核准提示 |
/btw <question> | 在不變更工作階段脈絡的情況下詢問旁支問題。別名：/side。請參閱 BTW |
子代理與 ACP
子代理與 ACP
| 命令 | 描述 |
|---|---|
/subagents list|log|info | 檢查目前工作階段的子代理執行 |
/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help | 管理 ACP 工作階段與執行階段選項。執行階段控制需要外部擁有者或內部閘道管理員身分 |
/focus <target> | 將目前的 Discord 執行緒或 Telegram 主題繫結到工作階段目標 |
/unfocus | 移除目前的執行緒繫結 |
/agents | 列出目前工作階段中繫結到執行緒的代理 |
僅限擁有者的寫入與管理
僅限擁有者的寫入與管理
| 命令 | 需要 | 描述 |
|---|---|---|
/config show|get|set|unset | commands.config: true | 讀取或寫入 openclaw.json。僅限擁有者 |
/mcp show|get|set|unset | commands.mcp: true | 讀取或寫入由 OpenClaw 管理的 MCP 伺服器設定。僅限擁有者 |
/plugins list|inspect|show|get|install|enable|disable | commands.plugins: true | 檢查或變更外掛狀態。寫入僅限擁有者。別名：/plugin |
/debug show|set|unset|reset | commands.debug: true | 僅限執行階段的設定覆寫。僅限擁有者 |
/restart | commands.restart: true（預設） | 重新啟動 OpenClaw |
/send on|off|inherit | 擁有者 | 設定傳送策略 |
語音、TTS、頻道控制
語音、TTS、頻道控制
| 命令 | 描述 |
|---|---|
/tts on|off|status|chat|latest|provider|limit|summary|audio|help | 控制 TTS。請參閱 TTS |
/activation mention|always | 設定群組啟用模式 |
/bash <command> | 執行主機 shell 命令。別名：! <command>。需要 commands.bash: true |
!poll [sessionId] | 檢查背景 bash 工作 |
!stop [sessionId] | 停止背景 bash 工作 |
Dock 命令
Dock 命令會將作用中工作階段的回覆路由切換到另一個已連結頻道。 如需設定與疑難排解，請參閱頻道 docking。 由支援原生命令的頻道外掛產生：/dock-discord（別名：/dock_discord）/dock-mattermost（別名：/dock_mattermost）/dock-slack（別名：/dock_slack）/dock-telegram（別名：/dock_telegram）
session.identityLinks。來源傳送者與目標對等端
必須位於同一個身分群組。
隨附外掛命令
| 命令 | 描述 |
|---|---|
/dreaming [on|off|status|help] | 切換記憶夢境整理（擁有者或閘道管理員）。請參閱夢境整理 |
/pair [qr|status|pending|approve|cleanup|notify] | 管理裝置配對。請參閱配對 |
/phone status|arm ...|disarm | 暫時啟用高風險電話節點命令 |
/voice status|list|set <voiceId> | 管理 Talk 語音設定。Discord 原生名稱：/talkvoice |
/card ... | 傳送 LINE 豐富卡片預設集。請參閱 LINE |
/codex <action> ... | 繫結、引導並檢查 Codex app-server harness（狀態、執行緒、恢復、模型、快速模式、權限、壓縮、review、mcp、skills 等）。請參閱 Codex harness |
/bot-ping、/bot-version、/bot-help、/bot-upgrade、/bot-logs
Skill 命令
使用者可呼叫的 Skills 會公開為斜線命令：/skill <name> [input]一律可作為通用進入點使用。- Skills 可以註冊為直接命令（例如 OpenProse 的
/prose）。 - 原生 Skill 命令註冊由
commands.nativeSkills和channels.<provider>.commands.nativeSkills控制。 - 名稱會清理為
a-z0-9_（最多 32 個字元）；衝突時會加上數字後綴。
Skill 命令分派
Skill 命令分派
預設情況下，Skill 命令會像一般請求一樣路由到模型。Skills 可以宣告
command-dispatch: tool，直接路由到工具
（確定性、無模型參與）。範例：/prose（OpenProse 外掛）
— 請參閱 OpenProse。原生命令引數
原生命令引數
Discord 會在需要的引數省略時，對動態選項與按鈕選單使用自動完成。
Telegram 和 Slack 會針對有選項的命令顯示按鈕選單。動態選項會依目標工作階段模型解析，因此像
/think 等級這類模型
特定選項會遵循工作階段的 /model 覆寫。/tools：代理現在可以使用什麼
/tools 回答的是執行階段問題：這個代理現在在這段
對話中可以使用什麼，而不是靜態設定目錄。
/model：模型選擇
/model 和 /models 會開啟具有提供者與
模型下拉選單的互動式選擇器。選擇器會遵循 agents.defaults.models，包括
provider/* 項目。
/config：磁碟上的設定寫入
僅限擁有者。預設停用 — 使用
commands.config: true 啟用。/config
更新會在重新啟動後保留。
/mcp：MCP 伺服器設定
僅限擁有者。預設停用 — 使用
commands.mcp: true 啟用。/mcp 會將設定儲存在 OpenClaw 設定中，而不是嵌入式代理專案設定。
/debug：僅限執行階段的覆寫
僅限擁有者。預設停用 — 使用
commands.debug: true 啟用。
覆寫會立即套用到新的設定讀取，但不會寫入磁碟。/plugins：外掛管理
寫入僅限擁有者。預設停用 — 使用
commands.plugins: true 啟用。/plugins enable|disable 會更新外掛設定，並熱重新載入閘道
外掛執行階段，以供新的代理回合使用。/plugins install 會自動重新啟動受管理的
閘道，因為外掛來源模組已變更。
/trace：外掛 trace 輸出
/trace 會顯示工作階段範圍的外掛 trace/debug 行，而不需要完整 verbose
模式。它不會取代 /debug（執行階段覆寫）或 /verbose（一般
工具輸出）。
/btw：旁支問題
/btw 是關於目前工作階段脈絡的快速旁支問題。別名：/side。
- 使用目前工作階段作為背景脈絡。
- 在 Codex harness 工作階段中，會作為暫時性的 Codex 旁支執行緒執行。
- 不會改變未來的工作階段脈絡。
- 不會寫入 transcript 歷史。
介面備註
每個介面的工作階段範圍
每個介面的工作階段範圍
- 文字命令： 在一般聊天工作階段中執行（DM 共用
main，群組有自己的工作階段）。 - 原生 Discord 命令：
agent:<agentId>:discord:slash:<userId> - 原生 Slack 命令：
agent:<agentId>:slack:slash:<userId>（前綴可透過channels.slack.slashCommand.sessionPrefix設定） - 原生 Telegram 命令：
telegram:slash:<userId>（透過CommandTargetSessionKey指向聊天工作階段） /login codex只會透過私人聊天或 Web UI 回應路徑傳送裝置配對碼。Telegram 群組/主題呼叫會要求擁有者改為私訊 bot。/stop會指向作用中的聊天工作階段，以中止目前執行。
Slack 細節
Slack 細節
channels.slack.slashCommand 支援單一 /openclaw 風格命令。
搭配 commands.native: true 時，為每個內建
命令建立一個 Slack 斜線命令。註冊 /agentstatus（不是 /status），因為 Slack 保留
/status。文字 /status 仍可在 Slack 訊息中使用。快速路徑與行內捷徑
快速路徑與行內捷徑
- 來自允許清單傳送者的純命令訊息會立即處理（略過佇列 + 模型）。
- 行內捷徑（
/help、/commands、/status、/whoami）也可以嵌入一般訊息中使用，並會在模型看到剩餘文字前被移除。 - 未授權的純命令訊息會被靜默忽略；行內
/...token 會被視為純文字。
引數備註
引數備註
- 命令與引數之間可接受選用的
:（/think: high、/send: on）。 /new <model>接受模型別名、provider/model或提供者名稱（模糊比對）；若沒有相符項，文字會被視為訊息本文。/allowlist add|remove需要commands.config: true，並遵循頻道configWrites。
提供者用量與狀態
- 提供者用量/配額（例如「Claude 剩餘 80%」）會在啟用用量追蹤時，於目前模型提供者的
/status中顯示。 /status中的token/cache 行，在即時工作階段快照資料不足時，可以回退到最新的 transcript 用量項目。- 執行與執行階段：
/status會以Execution回報有效沙箱路徑，並以Runtime回報誰正在執行工作階段：OpenClaw Default、OpenAI Codex、命令列介面後端或 ACP 後端。 - 每次回應的 token/成本： 由
/usage off|tokens|full控制。 /model status是關於模型/驗證/端點，而不是用量。
相關
Skills
技能斜線命令的註冊與門控方式。
建立技能
建立會註冊自身斜線命令的技能。
BTW
不變更工作階段脈絡的附帶問題。
Steer
使用
/steer 在代理程式執行途中引導它。