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.useAccessGroups。對未授權的傳送者，指令會被視為純文字。

設定

json5

{  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"

在支援時，以原生方式註冊 Skills 命令。自動模式： Discord／Telegram 啟用；Slack 停用。可透過 channels.<provider>.commands.nativeSkills 覆寫。

commands.bashbooleandefault: false

啟用 ! <cmd> 以執行主機殼層命令（別名為 /bash <cmd>）。需要 tools.elevated 允許清單。

commands.bashForegroundMsnumberdefault: 2000

bash 在切換至背景模式前的等待時間（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 與閘道重新啟動工具動作。

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

用於命令授權的各提供者允許清單。設定後，它會成為命令與指令的唯一授權來源。使用 "*" 作為全域預設值；提供者專屬鍵會覆寫該預設值。

commands.useAccessGroupsbooleandefault: true

未設定 commands.allowFrom 時，對命令強制套用允許清單／政策。

命令清單

命令來自三個來源：

核心內建命令： 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`

模型與執行控制

命令	說明
`/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>`	顯示或設定執行預設值
`/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]`	僅限擁有者的支援報告流程。每次都會要求執行核准
`/crestodian <request>`	從擁有者的私訊執行 Crestodian 設定與修復輔助工具
`/tasks`	列出目前工作階段中作用中／近期的背景工作
`/context [list\|detail\|map\|json]`	說明上下文的組合方式
`/whoami`	顯示您的傳送者 ID。別名：`/id`
`/usage off\|tokens\|full\|reset\|cost`	控制每則回應的用量頁尾（`reset`／`inherit`／`clear`／`default` 會清除工作階段覆寫，以重新繼承已設定的預設值），或輸出本機成本摘要

Skills、允許清單與核准

命令	說明
`/skill <name> [input]`	依名稱執行 Skill
`/learn [request]`	透過 Skill Workshop，根據目前對話或指定來源草擬一個可供審查的 Skill
`/allowlist [list\|add\|remove] ...`	管理允許清單項目。僅限文字
`/approve <id> <decision>`	處理執行或外掛核准提示
`/btw <question>`	在不變更工作階段上下文的情況下提出附帶問題。別名：`/side`。請參閱附帶問題

子代理與 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 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 應用程式伺服器測試框架（狀態、討論串、繼續、模型、快速模式、權限、壓縮、審查、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 回答的是執行階段問題：此代理目前在這段對話中可使用什麼，而非靜態設定目錄。

text

/tools         # 精簡檢視/tools verbose # 包含簡短說明

結果以工作階段為範圍。變更代理、頻道、討論串、傳送者授權或模型都可能改變輸出。如要編輯設定檔與覆寫，請使用控制介面的工具面板或設定介面。

`/model`：模型選擇

text

/model             # 顯示模型選擇器/model list        # 相同功能/model 3           # 依選擇器中的編號選取/model openai/gpt-5.4/model opus@anthropic:default/model default     # 清除工作階段模型選擇/model status      # 顯示包含端點與 API 模式的詳細檢視

在 Discord 上，/model 與 /models 會開啟含有供應商和模型下拉式選單的互動式選擇器。選擇器會遵循 agents.defaults.models，包括 provider/* 項目。

`/config`：寫入磁碟設定

text

/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefix

設定會在寫入前進行驗證。無效的變更會遭拒。/config 更新會在重新啟動後保留。

`/mcp`：MCP 伺服器設定

text

/mcp show/mcp show context7/mcp set context7={"command":"uvx","args":["context7-mcp"]}/mcp unset context7

/mcp 會將設定儲存在 OpenClaw 設定中，而非內嵌代理的專案設定中。 /mcp show 會遮蔽含憑證的欄位、可辨識的憑證旗標值，以及已知呈現機密格式的引數。從群組執行時，設定會私下傳送給擁有者；若沒有可用的擁有者私人路由，命令會採取封閉式失敗，並要求擁有者從直接聊天重試。

`/debug`：僅限執行階段的覆寫

text

/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset

`/plugins`：外掛管理

text

/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install ./path/to/plugin

/plugins enable|disable 會更新外掛設定，並熱重新載入閘道外掛執行階段，以供新的代理回合使用。由於外掛原始碼模組已變更， /plugins install 會自動重新啟動受管理的閘道。

`/trace`：外掛追蹤輸出

text

/trace          # 顯示目前的追蹤狀態/trace on/trace off

/trace 可顯示工作階段範圍的外掛追蹤／除錯行，而無須啟用完整的詳細模式。它無法取代 /debug（執行階段覆寫）或 /verbose（一般工具輸出）。

`/btw`：附帶問題

/btw 是針對目前工作階段內容提出的快速附帶問題。別名：/side。

text

/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 顯示的是模型／驗證／端點資訊，而非用量。

斜線命令

三種命令類型

設定

命令清單

核心命令

停靠命令

內建外掛命令

Skill 命令

`/tools`：代理目前可使用的工具

`/model`：模型選擇

`/config`：寫入磁碟設定

`/mcp`：MCP 伺服器設定

`/debug`：僅限執行階段的覆寫

`/plugins`：外掛管理

`/trace`：外掛追蹤輸出

`/btw`：附帶問題

介面注意事項

供應商用量與狀態

相關內容

On this page

Molty

三種命令類型

設定

命令清單

核心命令

停靠命令

內建外掛命令

Skill 命令

/tools：代理目前可使用的工具

/model：模型選擇

/config：寫入磁碟設定

/mcp：MCP 伺服器設定

/debug：僅限執行階段的覆寫

/plugins：外掛管理

/trace：外掛追蹤輸出

/btw：附帶問題

介面注意事項

供應商用量與狀態

相關內容

On this page

`/tools`：代理目前可使用的工具

`/model`：模型選擇

`/config`：寫入磁碟設定

`/mcp`：MCP 伺服器設定

`/debug`：僅限執行階段的覆寫

`/plugins`：外掛管理

`/trace`：外掛追蹤輸出

`/btw`：附帶問題