命令由 Gateway 處理。大多數命令必須以獨立訊息傳送,並以Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
/ 開頭。僅限主機的 bash 聊天命令使用 ! <cmd>(/bash <cmd> 是其別名)。
當對話或執行緒繫結到 ACP 工作階段時,一般後續文字會路由到該 ACP harness。Gateway 管理命令仍會保留在本機:/acp ... 一律會送達 OpenClaw ACP 命令處理器,而 /status 加上 /unfocus 只要該介面已啟用命令處理,就會保留在本機。
有兩個相關系統:
命令
命令
獨立的
/... 訊息。控制指示
控制指示
/think、/fast、/verbose、/trace、/reasoning、/elevated、/exec、/model、/queue。- 控制指示會在模型看到訊息前從訊息中移除。
- 在一般聊天訊息中(不是僅含控制指示的訊息),它們會被視為「行內提示」,且不會保留工作階段設定。
- 在僅含控制指示的訊息中(訊息只包含控制指示),它們會保留到工作階段,並回覆確認訊息。
- 控制指示只會套用於已授權的傳送者。如果設定了
commands.allowFrom,它就是唯一使用的允許清單;否則授權會來自頻道允許清單/配對,加上commands.useAccessGroups。未授權傳送者的控制指示會被視為純文字。
行內捷徑
行內捷徑
僅限允許清單中/已授權的傳送者:
/help、/commands、/status、/whoami(/id)。它們會立即執行,在模型看到訊息前被移除,剩餘文字會繼續走一般流程。設定
啟用在聊天訊息中解析
/...。在沒有原生命令的介面(WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams)上,即使你將此值設為 false,文字命令仍可運作。註冊原生命令。自動:Discord/Telegram 開啟;Slack 關閉(直到你新增斜線命令);不支援原生命令的提供者會忽略。設定
channels.discord.commands.native、channels.telegram.commands.native 或 channels.slack.commands.native 可依提供者覆寫(布林值或 "auto")。false 會在啟動時清除 Discord/Telegram 上先前註冊的命令。Slack 命令在 Slack app 中管理,不會自動移除。支援時以原生方式註冊 skill 命令。自動:Discord/Telegram 開啟;Slack 關閉(Slack 需要為每個 skill 建立斜線命令)。設定
channels.discord.commands.nativeSkills、channels.telegram.commands.nativeSkills 或 channels.slack.commands.nativeSkills 可依提供者覆寫(布林值或 "auto")。啟用
! <cmd> 以執行主機 shell 命令(/bash <cmd> 是別名;需要 tools.elevated 允許清單)。控制 bash 在切換到背景模式前等待多久(
0 會立即背景執行)。啟用
/config(讀取/寫入 openclaw.json)。啟用
/mcp(讀取/寫入 mcp.servers 下由 OpenClaw 管理的 MCP 設定)。啟用
/plugins(Plugin 探索/狀態,加上安裝與啟用/停用控制)。啟用
/debug(僅限執行階段的覆寫)。啟用
/restart 加上 gateway 重新啟動工具動作。設定僅限擁有者的命令/工具介面的明確擁有者允許清單。這是可核准危險動作並執行
/diagnostics、/export-trajectory、/config 等命令的人類操作員帳號。它與 commands.allowFrom 以及 DM 配對存取不同。依頻道設定:讓僅限擁有者的命令在該介面上執行時必須具備擁有者身分。當為
true 時,傳送者必須符合已解析的擁有者候選項目(例如 commands.ownerAllowFrom 中的項目或提供者原生擁有者中繼資料),或在內部訊息頻道上持有內部 operator.admin scope。頻道 allowFrom 中的萬用字元項目,或空白/未解析的擁有者候選清單,不足以通過;僅限擁有者的命令會在該頻道上以失敗關閉模式處理。如果你希望僅限擁有者的命令只由 ownerAllowFrom 和標準命令允許清單控管,請保持此項關閉。控制擁有者 ID 在系統提示中如何顯示。
可選擇設定
commands.ownerDisplay="hash" 時使用的 HMAC secret。依提供者設定命令授權允許清單。設定後,它會成為命令與控制指示唯一的授權來源(頻道允許清單/配對與
commands.useAccessGroups 會被忽略)。使用 "*" 作為全域預設;提供者專屬 key 會覆寫它。當未設定
commands.allowFrom 時,對命令強制套用允許清單/政策。命令清單
目前的真實來源:- 核心內建項目來自
src/auto-reply/commands-registry.shared.ts - 產生的 dock 命令來自
src/auto-reply/commands-registry.data.ts - Plugin 命令來自 Plugin
registerCommand()呼叫 - 你的 gateway 上的實際可用性仍取決於設定旗標、頻道介面,以及已安裝/啟用的 Plugin
核心內建命令
工作階段與執行
工作階段與執行
/new [model]會啟動新的工作階段;/reset是重設別名。/reset soft [message]會保留目前 transcript、捨棄重用的 CLI 後端工作階段 ID,並在原處重新執行啟動/系統提示載入。/compact [instructions]會壓縮工作階段情境。請參閱 Compaction。/stop會中止目前執行。/session idle <duration|off>和/session max-age <duration|off>管理執行緒繫結到期。/export-session [path]會將目前工作階段匯出為 HTML。別名:/export。/export-trajectory [path]會要求 exec 核准,然後為目前工作階段匯出 JSONL trajectory bundle。當你需要某個 OpenClaw 工作階段的提示、工具與 transcript 時間軸時使用它。在群組聊天中,核准提示與匯出結果會私下傳送給擁有者。別名:/trajectory。
模型與執行控制
模型與執行控制
/think <level>設定思考等級。選項來自作用中模型的提供者 profile;常見等級為off、minimal、low、medium和high,自訂等級如xhigh、adaptive、max,或二元on只在支援處可用。別名:/thinking、/t。/verbose on|off|full切換詳細輸出。別名:/v。/trace on|off切換目前工作階段的 Plugin trace 輸出。/fast [status|on|off]顯示或設定快速模式。/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 預設值。/model [name|#|status]顯示或設定模型。/models [provider] [page] [limit=<n>|size=<n>|all]列出已設定/可用驗證的提供者,或某提供者的模型;加入all可瀏覽該提供者的完整目錄。/queue <mode>管理佇列行為(steer、舊版queue、followup、collect、steer-backlog、interrupt),以及debounce:0.5s cap:25 drop:summarize等選項;/queue default或/queue reset會清除工作階段覆寫。請參閱 Command queue 和 Steering queue。
探索與狀態
探索與狀態
/help顯示簡短說明摘要。/commands顯示產生的命令目錄。/tools [compact|verbose]顯示目前 agent 現在可使用的項目。/status顯示執行/執行階段狀態,包含Execution/Runtime標籤,以及可用時的提供者用量/配額。/diagnostics [note]是 Gateway bug 和 Codex harness 執行的僅限擁有者支援報告流程。它每次在執行openclaw gateway diagnostics export --json前都會要求明確 exec 核准;請勿用允許全部的規則核准 diagnostics。核准後,它會傳送可貼上的報告,包含本機 bundle 路徑、manifest 摘要、隱私注意事項,以及相關工作階段 ID。在群組聊天中,核准提示與報告會私下傳送給擁有者。當作用中工作階段使用 OpenAI Codex harness 時,同一個核准也會將相關 Codex feedback 傳送到 OpenAI 伺服器,且完成的回覆會列出 OpenClaw 工作階段 ID、Codex 執行緒 ID,以及codex resume <thread-id>命令。請參閱 Diagnostics Export。/crestodian <request>會從擁有者 DM 執行 Crestodian 設定與修復 helper。/tasks列出目前工作階段的作用中/近期背景工作。/context [list|detail|json]說明情境如何組裝。/whoami顯示你的傳送者 ID。別名:/id。/usage off|tokens|full|cost控制每則回應的用量頁尾,或列印本機成本摘要。
Skills、允許清單、核准
Skills、允許清單、核准
/skill <name> [input]依名稱執行 skill。/allowlist [list|add|remove] ...管理允許清單項目。僅限文字。/approve <id> <decision>解決 exec 核准提示。/btw <question>提出旁支問題,而不變更未來工作階段情境。請參閱 BTW。
子 agent 與 ACP
子 agent 與 ACP
/subagents list|kill|log|info|send|steer|spawn管理目前工作階段的子 agent 執行。/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列出目前工作階段的執行緒繫結 agent。/kill <id|#|all>中止一個或所有執行中的子 agent。/steer <id|#> <message>將 steering 傳送給執行中的子 agent。別名:/tell。
僅限擁有者寫入與管理
僅限擁有者寫入與管理
/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 狀態。/plugin是別名。寫入僅限擁有者。需要commands.plugins: true。/debug show|set|unset|reset管理僅限執行階段的設定覆寫。僅限擁有者。需要commands.debug: true。/restart在啟用時重新啟動 OpenClaw。預設:已啟用;設定commands.restart: false可停用。/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加上tools.elevated允許清單。!poll [sessionId]檢查背景 bash 作業。!stop [sessionId]停止背景 bash 作業。
產生的 dock 命令
Dock 命令會將目前工作階段的回覆路由切換到另一個已連結的頻道。設定、範例與疑難排解請參閱 頻道 docking。 Dock 命令由支援原生命令的頻道 Plugin 產生。目前內建集合:/dock-discord(別名:/dock_discord)/dock-mattermost(別名:/dock_mattermost)/dock-slack(別名:/dock_slack)/dock-telegram(別名:/dock_telegram)
session.identityLinks。來源傳送者與目標對象必須位於相同身分群組中,例如 ["telegram:123", "discord:456"]。如果 id 為 123 的 Telegram 使用者傳送 /dock_discord,OpenClaw 會在作用中工作階段上儲存 lastChannel: "discord" 與 lastTo: "456"。如果傳送者未連結到 Discord 對象,命令會回覆設定提示,而不是落入一般聊天流程。
Docking 只會變更作用中工作階段路由。它不會建立頻道帳號、授予存取權、繞過頻道允許清單,或將逐字稿歷史移到另一個工作階段。使用 /dock-telegram、/dock-slack、/dock-mattermost 或其他產生的 dock 命令,可再次切換路由。
內建 Plugin 命令
內建 Plugin 可以新增更多斜線命令。此 repo 目前的內建命令:/dreaming [on|off|status|help]切換記憶體 Dreaming。請參閱 Dreaming。/pair [qr|status|pending|approve|cleanup|notify]管理裝置配對/設定流程。請參閱 配對。/phone status|arm <camera|screen|writes|all> [duration]|disarm暫時啟用高風險手機 Node 命令。/voice status|list [limit]|set <voiceId|name>管理 Talk 語音設定。在 Discord 上,原生命令名稱是/talkvoice。/card ...傳送 LINE rich card 預設。請參閱 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
動態 Skill 命令
使用者可呼叫的 Skills 也會作為斜線命令公開:/skill <name> [input]一律可作為通用進入點使用。- 當 Skill/Plugin 註冊時,Skills 也可能以
/prose這類直接命令出現。 - 原生 Skill 命令註冊由
commands.nativeSkills和channels.<provider>.commands.nativeSkills控制。
引數與剖析器注意事項
引數與剖析器注意事項
- 命令接受命令與引數之間可選的
:(例如/think: high、/send: on、/help:)。 /new <model>接受模型別名、provider/model或提供者名稱(模糊比對);若沒有相符項目,文字會被視為訊息本文。- 如需完整提供者使用量細目,請使用
openclaw status --usage。 /allowlist add|remove需要commands.config=true,並遵循頻道configWrites。- 在多帳號頻道中,針對設定的
/allowlist --account <id>和/config set channels.<provider>.accounts.<id>...也會遵循目標帳號的configWrites。 /usage控制每則回覆的使用量頁尾;/usage cost會從 OpenClaw 工作階段記錄列印本機成本摘要。/restart預設為啟用;設定commands.restart: false可停用。/plugins install <spec>接受與openclaw plugins install相同的 Plugin 規格:本機路徑/封存檔、npm 套件,或clawhub:<pkg>。/plugins enable|disable會更新 Plugin 設定,並可能提示重新啟動。
頻道特定行為
頻道特定行為
- 僅限 Discord 的原生命令:
/vc join|leave|status控制語音頻道(不可作為文字使用)。join需要 guild 及選取的語音/舞台頻道。需要channels.discord.voice和原生命令。 - Discord thread-binding 命令(
/focus、/unfocus、/agents、/session idle、/session max-age)需要啟用有效 thread binding(session.threadBindings.enabled和/或channels.discord.threadBindings.enabled)。 - ACP 命令參考與執行階段行為:ACP 代理。
詳細 / trace / fast / reasoning 安全性
詳細 / trace / fast / reasoning 安全性
/verbose用於除錯與額外可見性;一般使用時請保持關閉。/trace比/verbose更窄:它只會揭露 Plugin 擁有的追蹤/除錯行,並保持一般詳細工具雜訊關閉。/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在群組設定中有風險:它們可能揭露你不打算公開的內部 reasoning、工具輸出或 Plugin 診斷。建議保持關閉,尤其是在群組聊天中。
模型切換
模型切換
/model會立即保留新的工作階段模型。- 如果代理閒置,下一次執行會立刻使用它。
- 如果已有執行正在進行中,OpenClaw 會將即時切換標記為擱置,並只在乾淨的重試點重新啟動到新模型。
- 如果工具活動或回覆輸出已經開始,擱置的切換可能會持續排隊,直到之後的重試機會或下一次使用者回合。
- 在本機 TUI 中,
/crestodian [request]會從一般代理 TUI 返回 Crestodian。這與訊息頻道救援模式分開,且不會授予遠端設定權限。
快速路徑與內嵌捷徑
快速路徑與內嵌捷徑
- **快速路徑:**來自允許清單傳送者的僅命令訊息會立即處理(繞過佇列 + 模型)。
- **群組提及閘控:**來自允許清單傳送者的僅命令訊息會繞過提及需求。
- **內嵌捷徑(僅限允許清單傳送者):**某些命令在嵌入一般訊息時也可運作,並會在模型看到其餘文字前被移除。
- 範例:
hey /status會觸發狀態回覆,而其餘文字會繼續通過一般流程。
- 範例:
- 目前:
/help、/commands、/status、/whoami(/id)。 - 未授權的僅命令訊息會被靜默忽略,而內嵌的
/...token 會被視為純文字。
Skill 命令與原生引數
Skill 命令與原生引數
- Skill 命令:
user-invocableSkills 會作為斜線命令公開。名稱會清理為a-z0-9_(最多 32 個字元);衝突會取得數字後綴(例如_2)。/skill <name> [input]依名稱執行 Skill(在原生命令限制阻止每個 Skill 各自建立命令時很有用)。- 預設情況下,Skill 命令會作為一般請求轉發給模型。
- Skills 可選擇宣告
command-dispatch: tool,將命令直接路由到工具(確定性,無模型)。 - 範例:
/prose(OpenProse Plugin)— 請參閱 OpenProse。
- **原生命令引數:**Discord 會對動態選項使用自動完成(當你省略必要引數時也會使用按鈕選單)。Telegram 和 Slack 會在命令支援選項且你省略引數時顯示按鈕選單。動態選項會根據目標工作階段模型解析,因此像
/think等模型特定選項層級會遵循該工作階段的/model覆寫。
/tools
/tools 回答的是執行階段問題,而不是設定問題:此代理現在在此對話中可以使用什麼。
- 預設
/tools精簡且針對快速掃描最佳化。 /tools verbose會加入簡短描述。- 支援引數的原生命令介面會公開同樣的模式切換
compact|verbose。 - 結果以工作階段為範圍,因此變更代理、頻道、thread、傳送者授權或模型都可能改變輸出。
/tools包含執行階段實際可達的工具,包括核心工具、已連接的 Plugin 工具,以及頻道擁有的工具。
/tools 視為靜態目錄。
使用量介面(何處顯示什麼)
- 提供者使用量/配額(範例:「Claude 剩餘 80%」)會在啟用使用量追蹤時,顯示於目前模型提供者的
/status中。OpenClaw 會將提供者視窗正規化為% left;對 MiniMax 而言,僅剩餘百分比欄位會在顯示前反轉,且model_remains回應會優先使用聊天模型項目加上帶有模型標籤的方案標籤。 - Token/cache 行在即時工作階段快照稀疏時,可回退到最新逐字稿使用量項目。既有非零即時值仍會優先,而逐字稿回退也能復原作用中的執行階段模型標籤,以及在儲存總量遺失或較小時復原更大的 prompt 導向總量。
- 執行 vs 執行階段:
/status會針對有效 sandbox 路徑回報Execution,並針對實際執行工作階段的對象回報Runtime:OpenClaw Pi Default、OpenAI Codex、CLI 後端或 ACP 後端。 - 每則回覆 token/成本由
/usage off|tokens|full控制(附加到一般回覆)。 /model status是關於模型/驗證/端點,不是使用量。
模型選擇(/model)
/model 以 directive 實作。
範例:
/model和/model list會顯示精簡的編號選擇器(模型家族 + 可用提供者)。- 在 Discord 上,
/model和/models會開啟互動式選擇器,包含提供者與模型下拉選單,以及 Submit 步驟。 /model <#>會從該選擇器中選取(並在可能時優先使用目前提供者)。/model status會顯示詳細檢視,包括已設定的提供者端點(baseUrl)和可用時的 API 模式(api)。
除錯覆寫
/debug 可讓你設定僅限執行階段的設定覆寫(記憶體,不寫入磁碟)。僅限擁有者。預設停用;透過 commands.debug: true 啟用。
範例:
覆寫會立即套用到新的設定讀取,但不會寫入
openclaw.json。使用 /debug reset 清除所有覆寫並回到磁碟上的設定。Plugin 追蹤輸出
/trace 可讓你切換工作階段範圍的 Plugin 追蹤/除錯行,不需要開啟完整詳細模式。
範例:
- 沒有引數的
/trace會顯示目前工作階段的追蹤狀態。 /trace on會為目前工作階段啟用 Plugin 追蹤行。/trace off會再次停用它們。- Plugin 追蹤行可能會出現在
/status中,並在一般助理回覆後作為後續診斷訊息出現。 /trace不會取代/debug;/debug仍會管理僅限執行階段的設定覆寫。/trace不會取代/verbose;一般詳細工具/狀態輸出仍屬於/verbose。
設定更新
/config 會寫入磁碟上的設定(openclaw.json)。僅限擁有者。預設停用;透過 commands.config: true 啟用。
範例:
設定會在寫入前驗證;無效的變更會被拒絕。
/config 更新會在重新啟動後保留。MCP 更新
/mcp 會在 mcp.servers 下寫入由 OpenClaw 管理的 MCP 伺服器定義。僅限擁有者。預設停用;透過 commands.mcp: true 啟用。
範例:
/mcp 會將設定儲存在 OpenClaw 設定中,而不是 Pi 擁有的專案設定。執行階段配接器會決定哪些傳輸實際可執行。Plugin 更新
/plugins 可讓操作員檢查已探索到的 Plugin,並在設定中切換啟用狀態。唯讀流程可以使用 /plugin 作為別名。預設停用;透過 commands.plugins: true 啟用。
範例:
/plugins list和/plugins show會使用目前工作區加上磁碟設定來執行真實的 Plugin 探索。/plugins enable|disable只會更新 Plugin 設定;它不會安裝或解除安裝 Plugin。- 啟用/停用變更後,請重新啟動 Gateway 以套用。
介面注意事項
每個介面的工作階段
每個介面的工作階段
- 文字命令會在一般聊天工作階段中執行(DM 共用
main,群組有自己的工作階段)。 - 原生命令使用隔離的工作階段:
- Discord:
agent:<agentId>:discord:slash:<userId> - Slack:
agent:<agentId>:slack:slash:<userId>(前置字可透過channels.slack.slashCommand.sessionPrefix設定) - Telegram:
telegram:slash:<userId>(透過CommandTargetSessionKey指向聊天工作階段)
- Discord:
/stop會指向作用中的聊天工作階段,因此可以中止目前執行。
Slack 特定事項
Slack 特定事項
channels.slack.slashCommand 仍支援單一 /openclaw 風格命令。如果你啟用 commands.native,必須為每個內建命令建立一個 Slack 斜線命令(名稱與 /help 相同)。Slack 的命令引數選單會以臨時 Block Kit 按鈕傳送。Slack 原生例外:請註冊 /agentstatus(不是 /status),因為 Slack 保留 /status。文字 /status 在 Slack 訊息中仍可使用。BTW 附帶問題
/btw 是關於目前工作階段的快速附帶問題。
不同於一般聊天:
- 它會使用目前工作階段作為背景脈絡,
- 它會作為獨立的無工具一次性呼叫執行,
- 它不會改變未來的工作階段脈絡,
- 它不會寫入逐字稿歷史記錄,
- 它會以即時附帶結果傳遞,而不是一般助理訊息。
/btw 會很有用。
範例: