Slash commands
指令由 Gateway 處理。大多數指令必須作為以 / 開頭的獨立訊息發送。僅限主機的 bash 聊天指令使用 ! <cmd>(別名為 /bash <cmd>)。
當對話或執行緒綁定到 ACP 工作階段時,正常的後續文字會路由至該 ACP 接線程式。Gateway 管理指令仍保持在本機:/acp ... 總是到達 OpenClaw ACP 指令處理程序,而只要該表面啟用了指令處理,/status 和 /unfocus 就會保持在本機。
有兩個相關的系統:
Commands
獨立的 /... 訊息。
Directives
/think、/fast、/verbose、/trace、/reasoning、/elevated、/exec、/model、/queue。
- 指示詞會在模型看到訊息之前從訊息中移除。
- 在一般聊天訊息中(非僅指示詞),它們被視為「內嵌提示」,並不會持續保存工作階段設定。
- 在僅指示詞訊息中(訊息僅包含指示詞),它們會持續保存到工作階段並回覆確認。
- 指示詞僅套用於經授權的發送者。如果設定了
commands.allowFrom,它是唯一使用的允許清單;否則授權來自頻道允許清單/配對加上commands.useAccessGroups。未經授權的發送者會看到指示詞被視為純文字。
Inline shortcuts
僅限允許清單/已授權的發送者:/help、/commands、/status、/whoami (/id)。
它們會立即執行,並在模型看到訊息前被移除,剩餘的文字則會繼續正常流程。
{ commands: { native: "auto", nativeSkills: "auto", text: true, bash: false, bashForegroundMs: 2000, config: false, mcp: false, plugins: false, debug: false, restart: true, ownerAllowFrom: ["discord:123456789012345678"], ownerDisplay: "raw", ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}", allowFrom: { "*": ["user1"], discord: ["user:123"], }, useAccessGroups: true, },}當前權威來源:
- 核心內建指令來自
src/auto-reply/commands-registry.shared.ts - 生成的 Dock 指令來自
src/auto-reply/commands-registry.data.ts - 外掛指令來自外掛
registerCommand()呼叫 - 您的 Gateway 上實際可用的命令仍取決於配置標誌、頻道介面以及已安裝/已啟用的插件
核心內置命令
Section titled “核心內置命令”Sessions and runs
/new [model]將歸檔當前會話並啟動一個新會話;/reset會就地清除當前會話。它們不是別名。- Control UI 會攔截輸入的
/new以建立並切換到一個新的儀表板會話,除非已設定session.dmScope: "main"且當前的父會話是代理的主會話;在這種情況下,/new會就地重設主會話。輸入/reset仍會執行 Gateway 的就地重設。 /reset soft [message]保留當前的逐字稿,捨棄重複使用的 CLI 後端會話 ID,並就地重新執行啟動/系統提示的載入。/compact [instructions]壓縮會話上下文。請參閱 壓縮。/stop中止當前的運行。- `/session idle
和/session max-age
管理執行緒綁定的過期時間。 -/export-session [path] 將當前會話匯出為 HTML。別名:/export。 - /export-trajectory [path] 請求執行核准,然後將當前會話匯出為 JSONL [trajectory bundle](/zh-Hant/tools/trajectory)。當您需要某個 OpenClaw 會話的提示、工具和逐字稿時間軸時,請使用它。在群組聊天中,核准提示和匯出結果將私下傳送給擁有者。別名:/trajectory`。
Model and run controls
- `/think
設定思考等級或清除階段覆寫。選項來自於使用中模型的提供者設定檔;常見的等級有off、minimal、low、medium和high,以及僅在支援時可使用的自訂等級,如 xhigh、adaptive、max或二進位on。別名:/thinking、/t。 - /verbose on|off|full 切換詳細輸出。別名:/v。 - /trace on|off切換目前階段的外掛追蹤輸出。 -/fast [status|on|off|default]顯示、設定或清除快速模式。 -/reasoning [on|off|stream] 切換推理可見性。別名:/reason。 - /elevated [on|off|ask|full] 切換提昇模式。別名:/elev。 - /exec host=
security=
ask=
node=
顯示或設定 exec 預設值。 -/model [name|#|status]顯示或設定模型。 -/models [provider] [page] [limit=
|size=
|all]列出已設定/已驗證可用的提供者或某個提供者的模型;新增all 以瀏覽該提供者的完整目錄。agents.defaults.models中的provider/*項目會讓/model和/models僅顯示這些提供者的探索模型。 -/queue
管理活動執行佇列行為 (steer、followup、collect、interrupt) 以及像是 debounce:0.5s cap:25 drop:summarize 的選項;/queue default或/queue reset會清除階段覆寫。執行中的提示預設會在沒有佇列指令的情況下進行導引。參閱 [Command queue](/zh-Hant/concepts/queue) 和 [Steering queue](/zh-Hant/concepts/queue-steering)。 -/steer
將指引注入目前階段的活動執行中,獨立於/queue 模式。如果無法使用導引或階段處於閒置狀態,
將會繼續作為一般提示。別名:/tell`。參閱 Steer。
發現與狀態
/help顯示簡短說明摘要。/commands顯示生成的指令目錄。/tools [compact|verbose]顯示目前代理程式現正可使用的項目。/status顯示執行時狀態、Gateway 與系統運作時間,以及在可用時顯示提供者使用量/配額。/diagnostics [note]是僅限擁有者使用的支援報表流程,用於 Gateway 錯誤與 Codex harness 執行。它每次都會在執行openclaw gateway diagnostics export --json前要求明確的執行核准;請勿使用允許全部的規則來核准診斷。核准後,它會發送包含本地套件路徑、清單摘要、隱私注意事項及相關工作階段 ID 的可貼上報表。在群組聊天中,核准提示與報表會私下傳送給擁有者。當使用中的工作階段使用 OpenAI Codex harness 時,相同的核准也會將相關的 Codex 回饋發送到 OpenAI 伺服器,且完成的回覆會列出 OpenClaw 工作階段 ID、Codex 執行緒 ID 以及 `codex resume
指令。請參閱 [診斷匯出](/zh-Hant/gateway/diagnostics)。 -/crestodian
從擁有者的 DM 執行 Crestodian 設定與修復小幫手。 -/tasks列出目前工作階段的作用中/最近背景工作。 -/context [list|detail|map|json] 說明如何組合情境。map會發送目前工作階段情境的矩形樹圖圖片。 -/whoami 顯示您的傳送者 ID。別名:/id。 - /usage off|tokens|full|cost` 控制每次回應的使用量頁尾,或列印本地成本摘要。
技能、允許清單、核准
- `/skill
[input]` 依名稱執行技能。
/allowlist [list|add|remove] ...管理允許清單項目。僅限文字。- `/approve
解決執行核准提示。 -/btw
提出一個側面問題,而不改變未來的工作階段內容。別名:/side`。請參閱 BTW。
子代理和 ACP
/subagents list|kill|log|info|send|steer|spawn管理目前會話的子代理執行。/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help管理目前會話的子代理運作。- `/focus
將目前的 Discord 執行緒或 Telegram 主題/對話綁定到會話目標。 -/unfocus移除目前的綁定。 -/agents列出目前會話中執行緒綁定的代理。 -/kill
中止一個或所有正在執行的子代理。 -/subagents steer
` 向正在執行的子代理發送導向。請參閱 Steer。
僅限擁有者的寫入和管理
/config show|get|set|unset讀取或寫入openclaw.json。僅限擁有者。需要commands.config: true。/mcp show|get|set|unset讀取或寫入mcp.servers下由 OpenClaw 管理的 MCP 伺服器設定。僅限擁有者。需要commands.mcp: true。/plugins list|inspect|show|get|install|enable|disable檢查或修改外掛狀態。/plugin是一個別名。寫入僅限擁有者。需要commands.plugins: true。/debug show|set|unset|reset管理僅限執行時的設定覆寫。僅限擁有者。需要commands.debug: true。/restart啟用時重新啟動 OpenClaw。預設:啟用;設定commands.restart: false以停用它。/send on|off|inherit設定傳送原則。僅限擁有者。
語音、TTS、頻道控制
/tts on|off|status|chat|latest|provider|limit|summary|audio|help控制 TTS。請參閱 TTS。/activation mention|always設定群組啟用模式。- `/bash
執行主機 Shell 指令。僅限文字。別名:!
。需要 commands.bash: true加上tools.elevated允許清單。 -!poll [sessionId]檢查背景 bash 工作。 -!stop [sessionId]` 停止背景 bash 工作。
生成的 Dock 指令
Section titled “生成的 Dock 指令”Dock 指令會將目前階段的回覆路由切換到另一個連結頻道。請參閱 頻道對接 以了解設定、範例與疑難排解。
Dock 指令是由支援原生指令的頻道外掛程式所產生。目前內建的集合包括:
/dock-discord(別名:/dock_discord)/dock-mattermost(別名:/dock_mattermost)/dock-slack(別名:/dock_slack)/dock-telegram(別名:/dock_telegram)
從直接聊天中使用 Dock 指令,將目前階段的回覆路由切換到另一個連結頻道。代理程式會維持相同的階段內容,但該階段之後的回覆將會傳送到選定的頻道端點。
Dock 指令需要 session.identityLinks。來源發送者和目標端點必須位於同一個身分群組中,例如 ["telegram:123", "discord:456"]。如果 ID 為 123 的 Telegram 使用者傳送 /dock_discord,OpenClaw 會將 lastChannel: "discord" 和 lastTo: "456" 儲存在作用中的階段上。如果發送者未連結到 Discord 端點,指令會回覆設定提示,而不是轉交到一般聊天。
停靠僅更改目前的工作階段路由。它不會建立頻道帳戶、授予存取權限、繞過頻道允許清單,或將對話紀錄移至另一個工作階段。請使用 /dock-telegram、/dock-slack、/dock-mattermost 或其他產生的停靠指令再次切換路由。
內建外掛指令
Section titled “內建外掛指令”內建外掛可以新增更多斜線指令。此儲存庫中目前的內建指令:
/dreaming [on|off|status|help]切換記憶夢境功能。請參閱 Dreaming。/pair [qr|status|pending|approve|cleanup|notify]管理裝置配對/設定流程。請參閱 Pairing。/phone status|arm <camera|screen|writes|all> [duration]|disarm暫時啟用高風險的手機節點指令。/voice status|list [limit]|set <voiceId|name>管理 Talk 語音設定。在 Discord 上,原生指令名稱為/talkvoice。/card ...發送 LINE 豐富卡片預設集。請參閱 LINE。/codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skills檢查並控制內建的 Codex app-server harness。請參閱 Codex harness。- 僅限 QQBot 的指令:
/bot-ping/bot-version/bot-help/bot-upgrade/bot-logs
動態技能指令
Section titled “動態技能指令”使用者可呼叫的技能也會以斜線指令形式呈現:
/skill <name> [input]始終作為通用進入點。- 當技能/外掛註冊時,技能也可能會以
/prose這類直接指令的形式出現。 - 原生技能指令註冊是由
commands.nativeSkills和channels.<provider>.commands.nativeSkills控制的。 - 指令規格可以為支援本地化描述的原生介面(包括 Discord)提供
descriptionLocalizations。
引數與解析器說明
- 指令在指令與參數之間接受一個可選的
:(例如/think: high、/send: on、/help:)。 - `/new
接受模型別名、provider/model或提供者名稱(模糊匹配);如果沒有匹配項,文字將被視為訊息主體。 - 如需完整的提供者使用詳細資訊,請使用openclaw status —usage。 - /allowlist add|remove需要commands.config=true並遵守頻道configWrites。 - 在多帳號頻道中,目標為設定的 /allowlist —account
和/config set channels.
.accounts.
…也會遵守目標帳號的configWrites。 - /usage 控制每次回應的使用頁尾;/usage cost會從 OpenClaw 會話日誌列印本地成本摘要。 -/restart預設為啟用;設定commands.restart: false以停用它。 -/plugins install
接受與openclaw plugins install 相同的外掛規格:本地路徑/存檔、npm 套件、git:
或clawhub:
。由於外掛來源模組已變更,受控的 Gateway 會自動重新啟動。 - /plugins enable|disable` 會更新外掛設定並為新的 Agent 週期觸發 Gateway 外掛重新載入。
特定頻道行為
- Discord 專用原生指令:
/vc join|leave|status控制語音頻道(不提供文字形式)。join需要一個伺服器並選取語音/舞台頻道。需要channels.discord.voice和原生指令。 - Discord 執行緒綁定指令(
/focus、/unfocus、/agents、/session idle、/session max-age)需要啟用有效的執行緒綁定(session.threadBindings.enabled和/或channels.discord.threadBindings.enabled)。 - ACP 指令參考和執行時行為:ACP agents。
詳細資訊 / 追蹤 / 快速 / 推理安全
/verbose適用於偵錯和額外的可見性;在正常使用中請保持關閉。/trace比/verbose更狹窄:它僅顯示外掛擁有的追蹤/偵錯行,並保持正常的詳細工具對話關閉。/fast on|off會持續保存工作階段覆寫。使用 Sessions UI 的inherit選項來清除它並還原為配置預設值。/fast是特定於供應商的:OpenAI/OpenAI Codex 在原生 Responses 端點上將其對應至service_tier=priority,而直接公開的 Anthropic 請求(包括傳送到api.anthropic.com的 OAuth 驗證流量)則將其對應至service_tier=auto或standard_only。請參閱 OpenAI 和 Anthropic。- 相關的時候仍會顯示工具失敗摘要,但只有當
/verbose為on或full時,才會包含詳細的失敗文字。 /reasoning、/verbose和/trace在群組設定中具有風險:它們可能會揭露您不打算暴露的內部推理、工具輸出或外掛診斷資訊。建議保持關閉,特別是在群組聊天中。
模型切換
/model會立即持續保存新的工作階段模型。- 如果代理處於閒置狀態,下次執行會立即使用它。
- 如果執行已經啟動,OpenClaw 會將即時切換標記為待處理,並且只在乾淨的重試點重新啟動進入新模型。
- 如果工具活動或回覆輸出已經開始,待處理的切換可以保持排隊,直到稍後的重試機會或下一個使用者輪次。
- 在本地 TUI 中,
/crestodian [request]會從正常的代理 TUI 返回到 Crestodian。這與訊息通道救援模式分開,並不授予遠端配置權限。
快速路徑與內聯快捷方式
- 快速路徑: 來自白名單發送者的純指令訊息會立即被處理(繞過佇列 + 模型)。
- 群組提及閘控: 來自白名單發送者的純指令訊息可繞過提及要求。
- 內聯快捷方式(僅限白名單發送者): 某些指令在嵌入一般訊息時也有效,並且會在模型看到剩餘文字之前被剝離。
- 範例:
hey /status會觸發狀態回覆,而剩餘的文字會繼續透過正常流程處理。
- 範例:
- 目前支援:
/help、/commands、/status、/whoami(/id)。 - 未授權的純指令訊息會被無聲忽略,而內聯的
/...標記會被視為純文字。
技能指令與原生參數
- 技能指令:
user-invocable技能會以斜線指令的形式公開。名稱會被正規化為a-z0-9_(最多 32 個字元);名稱衝突會加上數字後綴(例如_2)。- `/skill
[input]會依名稱執行技能(當原生指令限制無法建立個別技能指令時很有用)。 - 預設情況下,技能指令會作為一般請求轉發給模型。 - 技能可以選擇宣告command-dispatch: tool,以將指令直接路由至工具(具確定性,不經過模型)。 - 範例:/prose` (OpenProse 外掛) — 請參閱 OpenProse。
- 原生指令參數: Discord 會對動態選項使用自動完成功能(當您省略必要參數時會顯示按鈕選單)。當指令支援選項且您省略該參數時,Telegram 和 Slack 會顯示按鈕選單。動態選項會根據目標工作階段模型解析,因此針對模型的特定選項(例如
/think層級)會遵循該工作階段的/model覆寫設定。
/tools
Section titled “/tools”/tools 回答的是運行時問題,而非配置問題:此代理目前在此次對話中可以使用什麼。
- 預設的
/tools格式緊湊並經過優化,適合快速掃描。 /tools verbose會加入簡短描述。- 支援參數的原生命令介面會暴露與
compact|verbose相同的模式切換開關。 - 結果是基於會話範圍的,因此變更代理、頻道、執行緒、發送者授權或模型可能會改變輸出。
/tools包含在執行時實際可存取的工具,包括核心工具、已連線的外掛工具以及頻道擁有的工具。
若要編輯設定檔或覆蓋值,請使用控制 UI 工具面板或配置/目錄介面,而不是將 /tools 視為靜態目錄。
使用介面(顯示位置)
Section titled “使用介面(顯示位置)”- 當啟用使用量追蹤時,供應商使用量/配額(例如:「Claude 剩餘 80%」)會顯示在目前模型供應商的
/status中。OpenClaw 會將供應商視窗正規化為% left;對於 MiniMax,僅顯示剩餘百分比欄位會在顯示前反轉,而model_remains回應會偏好聊天模型條目加上帶有模型標籤的計劃標籤。 - 當即時會話快照稀疏時,
/status中的 Token/快取行 可以退回到最新的逐字稿使用量條目。現有的非零即時值仍然優先,當儲存的總數遺失或較小時,逐字稿退回機制也可以還原作用中的執行時模型標籤以及較大的以提示為導向的總數。 - 執行與執行時:
/status回報有效沙箱路徑的Execution以及實際執行會話的主體的Runtime:OpenClaw Pi Default、OpenAI Codex、CLI 後端或 ACP 後端。 - 每次回應的 Token/成本 由
/usage off|tokens|full控制(附加於正常回應)。 /model status關乎 模型/授權/端點,而非使用量。
模型選擇 (/model)
Section titled “模型選擇 (/model)”/model 是以指令的方式實作。
範例:
/model/model list/model 3/model openai/gpt-5.4/model opus@anthropic:default/model status備註:
/model和/model list會顯示一個精簡的編號選擇器(模型系列 + 可用的提供者)。- 在 Discord 上,
/model和/models會開啟一個互動式選擇器,其中包含提供者和模型下拉選單以及提交步驟。該選擇器會遵守agents.defaults.models,包括provider/*項目,因此提供者範圍的探索可以讓選擇器保持在 Discord 的 25 個選項元件限制以下。 /model <#>從該選擇器中進行選擇(並在可能時偏好目前的提供者)。/model status顯示詳細資訊檢視,包括已設定的提供者端點 (baseUrl) 和 API 模式 (api)(如有提供)。
/debug 讓您設定 僅限執行時期 的設定覆寫(記憶體,非磁碟)。僅限擁有者使用。預設為停用;請使用 commands.debug: true 啟用。
範例:
/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset外掛程式追蹤輸出
Section titled “外掛程式追蹤輸出”/trace 讓您切換 工作階段範圍的外掛程式追蹤/偵錯行,而無需開啟完整詳細模式。
範例:
/trace/trace on/trace off備註:
/trace不帶參數會顯示目前工作階段的追蹤狀態。/trace on會啟用目前工作階段的外掛程式追蹤行。/trace off會再次停用它們。- 外掛程式追蹤行可以出現在
/status中,以及作為正常助理回覆後的後續診斷訊息。 /trace不會取代/debug;/debug仍然管理僅限執行時期的設定覆寫。/trace不會取代/verbose;正常的詳細工具/狀態輸出仍然屬於/verbose。
/config 會寫入您的磁碟配置 (openclaw.json)。�限擁有者使用。預設停用;請使用 commands.config: true 啟用。
範例:
/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefixMCP 更新
Section titled “MCP 更新”/mcp 會將 OpenClaw 管理的 MCP 伺服器定義寫入 mcp.servers 之下。僅限擁有者使用。預設停用;請使用 commands.mcp: true 啟用。
範例:
/mcp show/mcp show context7/mcp set context7={"command":"uvx","args":["context7-mcp"]}/mcp unset context7/plugins 允許操作員檢視已發現的外掛並在配置中切換啟用狀態。唯讀流程可以使用 /plugin 作為別名。預設停用;請使用 commands.plugins: true 啟用。
範例:
/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7各介面的會話
- 文字指令 在正常聊天會話中執行 (DM 共用
main,群組則有自己的會話)。 - 原生指令 使用隔離的會話:
- Discord:`agent:
:discord:slash:
- Slack:agent:
:slack:slash:
(前綴可透過channels.slack.slashCommand.sessionPrefix 設定) - Telegram:telegram:slash:
(透過CommandTargetSessionKey 目標鎖定聊天會話) - **/stop`** 目標鎖定作用中的聊天會話,以便它中止目前的執行。
Slack 詳情
channels.slack.slashCommand 仍支援單一 /openclaw 風格的指令。如果您啟用 commands.native,必須為每個內建指令建立一個 Slack 斜線指令(名稱與 /help 相同)。Slack 的指令參數選單會以暫時性 Block Kit 按鈕的形式提供。
Slack 原生例外:註冊 /agentstatus(而非 /status),因為 Slack 保留了 /status。文字 /status 在 Slack 訊息中仍然有效。
BTW 側邊問題
Section titled “BTW 側邊問題”/btw 是關於當前會話的快速側邊問題。/side 是一個別名。
與一般聊天不同:
- 它將當前會話作為背景內容,
- 在 Codex harness 工作階段中,它會以暫時性的 Codex 側面執行緒執行,並具備目前的 Codex 權限和原生工具介面,
- 在非 Codex 工作階段中,它會保持較舊的直接一次性側面呼叫行為,
- 它不會改變未來的工作階段語境,
- 它不會寫入逐字稿歷史,
- 它會以即時側面結果的形式傳送,而不是一般的助理訊息。
這使得 /btw 在您希望獲得臨時澄清但讓主要任務繼續進行時非常有用。
範例:
/btw what are we doing right now?/side what changed while the main run continued?請參閱 BTW Side Questions 以了解完整行為和客戶端 UX 細節。