Skills
斜線命令
閘道會處理以 / 開頭、以獨立訊息傳送的命令。
僅限主機的 bash 命令使用 ! <cmd>(/bash <cmd> 為其別名)。
當對話繫結至 ACP 工作階段時,一般文字會路由至 ACP
控制框架。閘道管理命令仍在本機處理:/acp ... 一律會傳送至
OpenClaw 命令處理常式;只要該介面已啟用命令處理,/status 和 /unfocus 也會留在本機處理。
三種命令類型
由閘道處理、以獨立訊息傳送的 /... 訊息。必須是訊息中的
唯一內容。
/think、/fast、/verbose、/trace、/reasoning、/elevated、
/exec、/model、/queue — 會在模型看到訊息前從中移除。單獨傳送時會保留
工作階段設定;與其他文字一同傳送時則作為行內提示。
/help、/commands、/status、/whoami — 會立即執行,並在模型看到其餘文字前
從訊息中移除。僅限已授權的傳送者。
指令行為詳細資訊
- 指令會在模型看到訊息前從中移除。
- 在僅含指令的訊息中(訊息內容只有指令),指令會 保留至工作階段,並回覆確認訊息。
- 在包含其他文字的一般聊天訊息中,指令會作為行內提示, 且不會保留工作階段設定。
- 指令僅適用於已授權的傳送者。若已設定
commands.allowFrom, 它會是唯一使用的允許清單;否則,授權會來自 頻道允許清單、配對,以及持續啟用的存取群組強制執行。未授權的 傳送者所輸入的指令會被視為純文字。
設定
{ 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, },}commands.textbooleandefault: true啟用對聊天訊息中 /... 的剖析。在沒有原生命令的介面
(WhatsApp、WebChat、Signal、iMessage、Google Chat、Microsoft Teams)上,即使設為 false,
文字命令仍可運作。
commands.nativeboolean | "auto"default: "auto"註冊原生命令。自動模式:Discord/Telegram 為開啟;Slack 為關閉;
對不支援原生命令的提供者則忽略。可透過
channels.<provider>.commands.native 依頻道覆寫。在 Discord 上,false 會略過斜線命令
註冊;先前註冊的命令在移除前可能仍會顯示。
commands.nativeSkillsboolean | "auto"default: "auto"在支援時將技能命令註冊為原生命令。自動模式:
Discord/Telegram 為開啟;Slack 為關閉。可透過
channels.<provider>.commands.nativeSkills 覆寫。
commands.bashbooleandefault: false啟用 ! <cmd> 以執行主機 shell 命令(/bash <cmd> 為其別名)。需要
tools.elevated 允許清單。
commands.bashForegroundMsnumberdefault: 2000bash 在切換至背景模式前的等待時間(0 會
立即切換至背景)。
commands.configbooleandefault: false啟用 /config(讀取/寫入 openclaw.json)。僅限擁有者。
commands.mcpbooleandefault: false啟用 /mcp(讀取/寫入位於 mcp.servers 下、由 OpenClaw 管理的 MCP 設定)。僅限擁有者。
commands.pluginsbooleandefault: false啟用 /plugins(外掛探索/狀態,以及安裝與啟用/停用)。寫入操作僅限擁有者。
commands.debugbooleandefault: false啟用 /debug(僅限執行階段的設定覆寫)。僅限擁有者。
commands.restartbooleandefault: true啟用 /restart 和外部 SIGUSR1 重新啟動要求。
commands.ownerAllowFromstring[]擁有者專用命令介面的明確擁有者允許清單。與
commands.allowFrom 和私訊配對存取分開。
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs
.commands.enforceOwnerForCommands" type="boolean" default="false">
依頻道設定:擁有者專用命令需要擁有者身分。當 true 時,
傳送者必須符合 commands.ownerAllowFrom,或擁有內部 operator.admin
範圍。萬用字元 allowFrom 項目並不足夠。
commands.ownerDisplay"raw" | "hash"控制擁有者 ID 在系統提示詞中的顯示方式。
commands.ownerDisplaySecretstring當 commands.ownerDisplay: "hash" 時使用的 HMAC 密鑰。
commands.allowFromobject依提供者設定的命令授權允許清單。設定後,它會成為命令與指令的
唯一授權來源。使用 "*" 作為
全域預設值;提供者專用的鍵會覆寫它。
命令清單
命令來自三個來源:
- 核心內建命令:
src/auto-reply/commands-registry.shared.ts - 產生的 dock 命令:
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 |
明確指定的 /export-session 路徑會取代工作區內的現有檔案。
省略路徑則會產生可避免衝突的檔案名稱。
模型與執行控制
| 命令 | 說明 |
|---|---|
/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 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 核准 |
/openclaw <request> |
從擁有者私訊執行 OpenClaw 設定與修復輔助工具 |
/tasks |
列出目前工作階段進行中/最近的背景工作 |
/context [list|detail|map|json] |
說明上下文的組合方式 |
/whoami |
顯示你的傳送者 ID。別名:/id |
/usage off|tokens|full|reset|cost |
控制每次回覆的用量頁尾(reset/inherit/clear/default 會清除工作階段覆寫,以重新繼承已設定的預設值),或輸出本機成本摘要 |
Skills、允許清單、核准
子代理程式與 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 |
owner | 設定傳送政策 |
語音、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-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 控制框架(狀態、討論串、繼續、模型、快速、權限、壓縮、審查、MCP、Skills 等)。請參閱 Codex 控制框架 |
僅限 QQ Bot:/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 命令會以一般請求的方式路由至模型。
Skills 可宣告 command-dispatch: tool,以直接路由至工具
(具確定性,不涉及模型)。範例:/prose(OpenProse 外掛)
— 請參閱 OpenProse。
原生命令引數
若省略必要引數,Discord 會對動態選項使用自動完成與按鈕選單。
Telegram 與 Slack 會針對具有選項的命令顯示按鈕選單。
動態選項會依據目標工作階段模型解析,因此 /think 層級等模型
特定選項會遵循工作階段的 /model 覆寫。
/tools:代理程式目前可使用的項目
/tools 回答的是執行階段問題:此代理程式目前在這段
對話中可以使用什麼,而非靜態設定目錄。
/tools # 精簡檢視/tools verbose # 包含簡短說明結果以工作階段為範圍。變更代理程式、頻道、討論串、傳送者 授權或模型,都可能改變輸出。如需編輯設定檔與覆寫, 請使用 Control UI 的 Tools 面板或設定介面。
/model:模型選擇
/model # 顯示模型選擇器/model list # 相同功能/model 3 # 依選擇器中的編號選取/model openai/gpt-5.4/model opus@anthropic:default/model default # 清除工作階段模型選擇/model status # 包含端點與 API 模式的詳細檢視在 Discord 上,/model 與 /models 會開啟具有供應商與
模型下拉式選單的互動式選擇器。選擇器會遵循 agents.defaults.modelPolicy.allow,
包括 provider/* 項目。若沒有明確的允許清單,模型項目與
別名不會限制選擇。
/config:寫入磁碟設定
/config show/config show channels.whatsapp.responsePrefix/config get channels.whatsapp.responsePrefix/config set channels.whatsapp.responsePrefix="[openclaw]"/config unset channels.whatsapp.responsePrefix寫入前會驗證設定。無效的變更會遭到拒絕。/config
更新在重新啟動後仍會保留。
/mcp:MCP 伺服器設定
/mcp show/mcp show context7/mcp set context7={"command":"uvx","args":["context7-mcp"]}/mcp unset context7/mcp 會將設定儲存在 OpenClaw 設定中,而非嵌入式代理程式專案設定。
/mcp show 會遮蔽包含認證資訊的欄位、已辨識的認證資訊旗標
值,以及已知具有機密資訊格式的引數。從群組中執行時,
設定會私下傳送給擁有者;若沒有可用的擁有者私人路由,
命令會採取封閉式失敗,並要求擁有者從私訊中重試。
/debug:僅限執行階段的覆寫
/debug show/debug set channels.whatsapp.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset channels.whatsapp.responsePrefix/debug reset/plugins:外掛管理
/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install clawhub:<package>/plugins install npm:@openclaw/<official-package>/plugins install npm:<package> --force/plugins install git:<repository>@<ref> --force/plugins enable|disable 會更新外掛設定,並熱重新載入閘道
外掛執行階段,以供新的代理程式回合使用。由於外掛原始碼模組已變更,/plugins install 會自動重新啟動受管理的
閘道。受信任的 ClawHub
與官方目錄安裝不需要額外確認。任意 npm、
git、封存檔、npm-pack: 與本機路徑來源會顯示來源警告,並在你檢閱來源後
要求尾隨的 --force。此旗標表示已確認
來源,並允許取代現有安裝;它不會略過
security.installPolicy 或安裝程式安全性檢查。帶有
風險警告的 ClawHub 發行版本仍需要獨立且僅限 Shell 的
--acknowledge-clawhub-risk 旗標。市集、連結與鎖定版本的安裝也
仍僅限 Shell。
/trace:外掛追蹤輸出
/trace # 顯示目前的追蹤狀態/trace on/trace off/trace 無須啟用完整詳細模式,即可顯示以工作階段為範圍的外掛追蹤/偵錯行。
它不會取代 /debug(執行階段覆寫)或 /verbose(一般
工具輸出)。
/btw:支線問題
/btw 是關於目前工作階段脈絡的快速支線問題。別名:/side。
/btw 我們目前正在做什麼?/side 主執行流程持續進行期間發生了哪些變更?與一般訊息不同:
- 使用目前工作階段作為背景脈絡。
- 在 Codex 控制框架工作階段中,會以暫時性 Codex 支線討論串執行。
- 不會變更未來的工作階段脈絡。
- 不會寫入逐字稿歷程。
完整行為請參閱 BTW 支線問題。
介面注意事項
各介面的工作階段範圍
- **文字命令:**在一般聊天工作階段中執行(私訊共用
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 群組/主題叫用時,會改為要求擁有者私訊機器人。/stop會指向使用中的聊天工作階段,以中止目前的執行。
Slack 特定事項
channels.slack.slashCommand 支援單一 /openclaw 樣式的命令。
使用 commands.native: true 時,請為每個內建命令建立一個 Slack 斜線命令。
請註冊 /agentstatus(而非 /status),因為 Slack 保留了
/status。文字 /status 在 Slack 訊息中仍然有效。
快速路徑與行內捷徑
- 來自允許清單中傳送者的純命令訊息會立即處理(略過佇列與模型)。
- 行內捷徑(
/help、/commands、/status、/whoami)也可嵌入一般訊息中,並會在模型看到其餘文字前移除。 - 未經授權的純命令訊息會被靜默忽略;行內
/...權杖會視為純文字。
引數注意事項
- 命令與引數之間可接受選用的
:(/think: high、/send: on)。 /new <model>接受模型別名、provider/model或提供者名稱(模糊比對);若沒有相符項目,該文字會視為訊息本文。/allowlist add|remove需要commands.config: true,並遵循頻道的configWrites。
提供者用量與狀態
- 目前模型提供者的提供者用量/配額(例如「Claude 剩餘 80%」)會在啟用用量追蹤時顯示於
/status。 - 當即時工作階段快照中的資訊不足時,
/status中的權杖/快取行可改用最新的對話記錄用量項目。 - 執行與執行階段:
/status會透過Execution回報有效的沙箱路徑,並透過Runtime回報工作階段的執行者:OpenClaw Default、OpenAI Codex、命令列介面後端或 ACP 後端。 - **每次回應的權杖數/成本:**由
/usage off|tokens|full控制。 /model status涉及模型/驗證/端點,而非用量。