Skills
スラッシュコマンド
Gateway は、/ で始まる単独メッセージとして送信されたコマンドを処理します。
ホスト専用の bash コマンドは ! <cmd> を使用します(/bash <cmd> はエイリアス)。
会話が ACP セッションにバインドされている場合、通常のテキストは ACP
ハーネスにルーティングされます。Gateway 管理コマンドはローカルのままです。/acp ... は常に
OpenClaw コマンドハンドラーに届き、サーフェスでコマンド処理が有効な場合は
/status と /unfocus もローカルにとどまります。
3 種類のコマンド
Gateway によって処理される単独の /... メッセージです。メッセージ内の
唯一の内容として送信する必要があります。
/think、/fast、/verbose、/trace、/reasoning、/elevated、
/exec、/model、/queue — モデルが見る前にメッセージから削除されます。
単独で送信された場合はセッション設定を永続化し、他のテキストと一緒に
送信された場合はインラインヒントとして機能します。
/help、/commands、/status、/whoami — すぐに実行され、
モデルが残りのテキストを見る前に削除されます。許可された送信者のみ。
ディレクティブ動作の詳細
- ディレクティブは、モデルが見る前にメッセージから削除されます。
- ディレクティブのみのメッセージ(メッセージがディレクティブだけの場合)では、 セッションに永続化され、確認応答で返信します。
- 他のテキストを含む通常チャットメッセージでは、インラインヒントとして機能し、 セッション設定は永続化されません。
- ディレクティブは許可された送信者にのみ適用されます。
commands.allowFromが設定されている場合、それが使用される唯一の許可リストです。それ以外の場合、 認可はチャンネルの許可リスト/ペアリングとcommands.useAccessGroupsに由来します。許可されていない 送信者のディレクティブはプレーンテキストとして扱われます。
設定
{ 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"ネイティブコマンドを登録します。Auto: Discord/Telegram ではオン、Slack ではオフ、
ネイティブ対応のないプロバイダーでは無視されます。チャンネルごとに
channels.<provider>.commands.native で上書きします。Discord では、false はスラッシュコマンドの
登録をスキップします。以前登録されたコマンドは削除されるまで表示されたままになる場合があります。
commands.nativeSkillsboolean | "auto"default: "auto"対応している場合、Skills コマンドをネイティブに登録します。Auto:
Discord/Telegram ではオン、Slack ではオフ。channels.<provider>.commands.nativeSkills
で上書きします。
commands.bashbooleandefault: false! <cmd> によるホストシェルコマンドの実行を有効にします(/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 を有効にします(Plugin の検出/状態に加え、インストールと有効化/無効化)。書き込みはオーナー専用。
commands.debugbooleandefault: false/debug を有効にします(ランタイム専用の設定上書き)。オーナー専用。
commands.restartbooleandefault: true/restart と Gateway 再起動ツールアクションを有効にします。
commands.ownerAllowFromstring[]オーナー専用コマンドサーフェスの明示的なオーナー許可リストです。
commands.allowFrom および DM ペアリングアクセスとは別です。
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs
.commands.enforceOwnerForCommands" type="boolean" default="false">
チャンネルごとの設定: オーナー専用コマンドにオーナー ID を要求します。true の場合、
送信者は commands.ownerAllowFrom に一致するか、内部 operator.admin
スコープを保持している必要があります。ワイルドカードの allowFrom エントリだけでは不十分です。
commands.ownerDisplay"raw" | "hash"システムプロンプト内でオーナー ID がどのように表示されるかを制御します。
commands.ownerDisplaySecretstringcommands.ownerDisplay: "hash" の場合に使用される HMAC シークレットです。
commands.allowFromobjectコマンド認可のプロバイダーごとの許可リストです。設定されている場合、コマンドとディレクティブの
唯一の認可ソースになります。グローバルデフォルトには "*" を使用し、
プロバイダー固有のキーがそれを上書きします。
commands.useAccessGroupsbooleandefault: truecommands.allowFrom が設定されていない場合、コマンドに対して許可リスト/ポリシーを適用します。
コマンド一覧
コマンドは 3 つのソースから来ます。
- コア組み込み:
src/auto-reply/commands-registry.shared.ts - 生成済み dock コマンド:
src/auto-reply/commands-registry.data.ts - Plugin コマンド: Plugin の
registerCommand()呼び出し
利用可否は、設定フラグ、チャンネルサーフェス、インストール済み/有効化済みの Plugin によって異なります。
コアコマンド
セッションと実行
| コマンド | 説明 |
|---|---|
/new [model] |
現在のセッションをアーカイブし、新しいセッションを開始します |
/reset [soft [message]] |
現在のセッションをその場でリセットします。soft はトランスクリプトを保持し、再利用された CLI バックエンドセッション ID を破棄し、起動処理を再実行します |
/name <title> |
現在のセッションに名前を付ける、または名前を変更します。現在の名前と候補を見るにはタイトルを省略します |
/compact [instructions] |
セッションコンテキストを圧縮します。Compaction を参照してください |
/stop |
現在の実行を中止します |
/session idle <duration|off> |
スレッドバインディングのアイドル期限を管理します |
/session max-age <duration|off> |
スレッドバインディングの最大有効期限を管理します |
/export-session [path] |
現在のセッションを HTML にエクスポートします。エイリアス: /export |
/export-trajectory [path] |
現在のセッションの JSONL trajectory バンドルをエクスポートします。エイリアス: /trajectory |
モデルと実行の制御
| コマンド | 説明 |
|---|---|
/think <level|default> |
思考レベルを設定するか、セッション上書きをクリアします。エイリアス: /thinking、/t |
/verbose on|off|full |
詳細出力を切り替えます。エイリアス: /v |
/trace on|off |
現在のセッションの Plugin トレース出力を切り替えます |
/fast [status|auto|on|off|default] |
fast モードを表示、設定、またはクリアします |
/reasoning [on|off|stream] |
reasoning の可視性を切り替えます。エイリアス: /reason |
/elevated [on|off|ask|full] |
elevated モードを切り替えます。エイリアス: /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は Plugin 所有のトレース/デバッグ行のみを公開します。通常の詳細なおしゃべりはオフのままです。/fast auto|on|offはセッション上書きを永続化します。クリアするには Sessions UI のinheritオプションを使用します。/fastはプロバイダー固有です。OpenAI/Codex はこれをservice_tier=priorityにマップし、直接の Anthropic リクエストはservice_tier=autoまたはstandard_onlyにマップします。/reasoning、/verbose、/traceはグループ設定ではリスクがあります。内部 reasoning や Plugin 診断を公開する可能性があります。グループチャットではオフにしてください。
モデル切り替えの詳細
/modelは新しいモデルをただちにセッションへ永続化します。- エージェントがアイドル状態の場合、次の実行ですぐに使用されます。
- 実行がアクティブな場合、切り替えは保留としてマークされ、次のクリーンな再試行ポイントで適用されます。
検出と状態
| コマンド | 説明 |
|---|---|
/help |
短いヘルプ概要を表示します |
/commands |
生成されたコマンドカタログを表示します |
/tools [compact|verbose] |
現在のエージェントが今すぐ使用できるものを表示します |
/status |
実行/ランタイム状態、Gateway とシステムの稼働時間、Plugin の健全性、さらにプロバイダーの使用量/クォータを表示します |
/status plugins |
詳細な Plugin 健全性を表示します: 読み込みエラー、隔離、チャンネル障害、依存関係の問題、互換性通知 |
/goal [status|start|pause|resume|complete|block|clear] ... |
現在のセッションの永続的な goal を管理します |
/diagnostics [note] |
オーナー専用のサポートレポートフローです。毎回 exec 承認を求めます |
/crestodian <request> |
オーナー DM から 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 を実行します |
/allowlist [list|add|remove] ... |
許可リストエントリを管理します。テキストのみ |
/approve <id> <decision> |
exec または Plugin 承認プロンプトを解決します |
/btw <question> |
セッションコンテキストを変更せずに横から質問します。エイリアス: /side。BTW を参照してください |
サブエージェントと 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 セッションとランタイムオプションを管理する。ランタイム制御には、外部所有者または内部 Gateway 管理者 ID が必要 |
/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 の状態を確認または変更する。書き込みは所有者専用。エイリアス: /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> |
ホストのシェルコマンドを実行する。エイリアス: ! <command>。commands.bash: true が必要 |
!poll [sessionId] |
バックグラウンド bash ジョブを確認する |
!stop [sessionId] |
バックグラウンド bash ジョブを停止する |
Dock コマンド
Dock コマンドは、アクティブなセッションの返信先ルートを別のリンク済みチャンネルに切り替えます。 セットアップとトラブルシューティングについては、チャンネルドッキング を参照してください。
ネイティブコマンド対応のチャンネル Plugin から生成されます:
/dock-discord(エイリアス:/dock_discord)/dock-mattermost(エイリアス:/dock_mattermost)/dock-slack(エイリアス:/dock_slack)/dock-telegram(エイリアス:/dock_telegram)
Dock コマンドには session.identityLinks が必要です。送信元の送信者とターゲットのピアは、同じ ID グループに属している必要があります。
バンドル Plugin コマンド
| コマンド | 説明 |
|---|---|
/dreaming [on|off|status|help] |
メモリ Dreaming を切り替える (所有者または Gateway 管理者)。Dreaming を参照 |
/pair [qr|status|pending|approve|cleanup|notify] |
デバイスペアリングを管理する。ペアリング を参照 |
/phone status|arm ...|disarm |
高リスクの電話ノードコマンドを一時的に有効化する |
/voice status|list|set <voiceId> |
Talk 音声設定を管理する。Discord のネイティブ名: /talkvoice |
/card ... |
LINE リッチカードのプリセットを送信する。LINE を参照 |
/codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skills |
Codex アプリサーバーハーネスを制御する。Codex ハーネス を参照 |
QQBot 専用: /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 Plugin)
— OpenProse を参照してください。
ネイティブコマンド引数
Discord は、必須引数が省略された場合に動的オプションとボタンメニューにオートコンプリートを使用します。Telegram と Slack は、選択肢のあるコマンドにボタンメニューを表示します。動的な選択肢はターゲットセッションのモデルに対して解決されるため、/think レベルのようなモデル固有オプションはセッションの /model オーバーライドに従います。
/tools — エージェントが今使えるもの
/tools はランタイム上の質問、つまり静的な設定カタログではなく、この会話でこのエージェントが今使えるものに答えます。
/tools # compact view/tools verbose # with short descriptions結果はセッションスコープです。エージェント、チャンネル、スレッド、送信者の認可、またはモデルを変更すると、出力が変わる場合があります。プロファイルとオーバーライドを編集するには、Control UI の Tools パネルまたは設定サーフェスを使用してください。
/model — モデル選択
/model # show model picker/model list # same/model 3 # select by number from picker/model openai/gpt-5.4/model opus@anthropic:default/model default # clear the session model selection/model status # detailed view with endpoint and API modeDiscord では、/model と /models はプロバイダーとモデルのドロップダウンを備えた対話型ピッカーを開きます。ピッカーは provider/* エントリを含む agents.defaults.models を尊重します。
/config — ディスク上の設定書き込み
/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefix設定は書き込み前に検証されます。無効な変更は拒否されます。/config の更新は再起動後も維持されます。
/mcp — MCP サーバー設定
/mcp show/mcp show context7/mcp set context7={"command":"uvx","args":["context7-mcp"]}/mcp unset context7/mcp は設定を埋め込みエージェントのプロジェクト設定ではなく、OpenClaw 設定に保存します。
/debug — ランタイム専用オーバーライド
/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset/plugins — Plugin 管理
/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install ./path/to/plugin/plugins enable|disable は Plugin 設定を更新し、新しいエージェントターン向けに Gateway の Plugin ランタイムをホットリロードします。/plugins install は Plugin ソースモジュールが変更されるため、管理対象 Gateway を自動的に再起動します。
/trace — Plugin トレース出力
/trace # show current trace state/trace on/trace off/trace は、完全な詳細モードを使わずにセッションスコープの Plugin トレース/デバッグ行を表示します。これは /debug (ランタイムオーバーライド) や /verbose (通常のツール出力) の代替ではありません。
/btw — 横道の質問
/btw は現在のセッションコンテキストに関する簡単な横道の質問です。エイリアス: /side。
/btw what are we doing right now?/side what changed while the main run continued?通常のメッセージとは異なります:
- 現在のセッションを背景コンテキストとして使用します。
- Codex ハーネスセッションでは、一時的な Codex サイドスレッドとして実行されます。
- 将来のセッションコンテキストを変更しません。
- トランスクリプト履歴には書き込まれません。
完全な動作については、BTW 横道の質問 を参照してください。
サーフェスの注記
サーフェスごとのセッションスコープ
- テキストコマンド: 通常のチャットセッションで実行されます (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 グループ/トピックでの呼び出しでは、代わりにボットへ DM するよう所有者に求めます。/stopは現在の実行を中止するためにアクティブなチャットセッションをターゲットにします。
Slack 固有事項
channels.slack.slashCommand は単一の /openclaw 形式のコマンドをサポートします。
commands.native: true では、組み込みコマンドごとに Slack スラッシュコマンドを 1 つ作成します。
Slack は /status を予約しているため、/agentstatus (/status ではなく) を登録してください。テキストの /status は Slack メッセージ内で引き続き機能します。
高速パスとインラインショートカット
- 許可リストに含まれる送信者からのコマンドのみのメッセージは、即座に処理されます (キュー + モデルをバイパス)。
- インラインショートカット (
/help,/commands,/status,/whoami) は通常のメッセージ内に埋め込まれていても機能し、モデルが残りのテキストを見る前に取り除かれます。 - 認可されていないコマンドのみのメッセージは黙って無視されます。インラインの
/...トークンはプレーンテキストとして扱われます。
引数の注記
- コマンドは、コマンドと引数の間に任意の
:を受け付けます (/think: high,/send: on)。 /new <model>はモデルエイリアス、provider/model、またはプロバイダー名 (あいまい一致) を受け付けます。一致しない場合、テキストはメッセージ本文として扱われます。/allowlist add|removeにはcommands.config: trueが必要で、チャンネルのconfigWritesを尊重します。
プロバイダーの使用状況とステータス
- プロバイダーの使用量/クォータ (例: 「Claude 80% left」) は、使用量追跡が有効な場合に現在のモデルプロバイダーについて
/statusに表示されます。 /statusの トークン/キャッシュ行 は、ライブセッションスナップショットがまばらな場合、最新のトランスクリプト使用量エントリにフォールバックできます。- 実行とランタイム:
/statusは、有効なサンドボックスパスにはExecutionを、セッションを実行している主体にはRuntimeを報告します:OpenClaw Default、OpenAI Codex、CLI バックエンド、または ACP バックエンド。 - 応答ごとのトークン/コスト:
/usage off|tokens|fullで制御されます。 /model statusはモデル/認証/エンドポイントに関するもので、使用量に関するものではありません。