Skip to main content
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 が 設定されている場合、それが使用される唯一の許可リストです。それ以外の場合、認可は チャンネルの許可リスト、ペアリング、および常時有効なアクセスグループの適用によって決まります。許可されていない 送信者からのディレクティブはプレーンテキストとして扱われます。

設定

boolean
デフォルト:"true"
チャットメッセージ内の /... の解析を有効にします。ネイティブコマンドがないサーフェス (WhatsApp、WebChat、Signal、iMessage、Google Chat、Microsoft Teams)では、false に 設定されている場合でもテキストコマンドが機能します。
boolean | "auto"
デフォルト:"\"auto\""
ネイティブコマンドを登録します。自動設定では Discord/Telegram で有効、Slack で無効となり、 ネイティブ対応のないプロバイダーでは無視されます。チャンネルごとに channels.<provider>.commands.native で上書きできます。Discord では、false によってスラッシュコマンドの 登録がスキップされます。以前に登録されたコマンドは、削除されるまで表示され続ける場合があります。
boolean | "auto"
デフォルト:"\"auto\""
対応している場合、スキルコマンドをネイティブに登録します。自動設定では Discord/Telegram で有効、Slack で無効となります。 channels.<provider>.commands.nativeSkills で上書きできます。
boolean
デフォルト:"false"
! <cmd> によるホストのシェルコマンド実行を有効にします(/bash <cmd> はエイリアスです)。 tools.elevated の許可リストが必要です。
number
デフォルト:"2000"
bash がバックグラウンドモードへ切り替わるまで待機する時間です(0 は 即座にバックグラウンド化します)。
boolean
デフォルト:"false"
/config を有効にします(openclaw.json を読み書きします)。オーナーのみ使用できます。
boolean
デフォルト:"false"
/mcp を有効にします(mcp.servers 配下にある OpenClaw 管理の MCP 設定を読み書きします)。オーナーのみ使用できます。
boolean
デフォルト:"false"
/plugins を有効にします(Plugin の検出とステータス、およびインストールと有効化/無効化)。書き込みはオーナーのみ実行できます。
boolean
デフォルト:"false"
/debug を有効にします(実行時のみの設定上書き)。オーナーのみ使用できます。
boolean
デフォルト:"true"
/restart および外部からの SIGUSR1 再起動リクエストを有効にします。
string[]
オーナー専用コマンドサーフェスに対する明示的なオーナー許可リストです。 commands.allowFrom および DM ペアリングアクセスとは別です。
boolean
デフォルト:"false"
チャンネルごとの設定です。オーナー専用コマンドにオーナー ID を要求します。true の場合、 送信者は commands.ownerAllowFrom と一致するか、内部の operator.admin スコープを保持している必要があります。ワイルドカードの allowFrom エントリだけでは不十分です。
"raw" | "hash"
システムプロンプトでのオーナー ID の表示方法を制御します。
string
commands.ownerDisplay: "hash" の場合に使用される HMAC シークレットです。
object
コマンド認可のためのプロバイダーごとの許可リストです。設定されている場合、これが コマンドとディレクティブに対する唯一の認可ソースになります。グローバルなデフォルトには "*" を使用します。プロバイダー固有のキーはこれを上書きします。

コマンド一覧

コマンドは次の 3 つのソースから提供されます。
  • コア組み込み: src/auto-reply/commands-registry.shared.ts
  • 生成されたドックコマンド: src/auto-reply/commands-registry.data.ts
  • Plugin コマンド: Plugin の registerCommand() 呼び出し
利用可否は、設定フラグ、チャンネルサーフェス、およびインストール済みで有効な Plugin によって決まります。

コアコマンド

明示的な /export-session パスを指定すると、ワークスペース内の既存ファイルが 置き換えられます。パスを省略すると、名前の衝突を回避したファイル名が生成されます。
Control UI は、入力された /new をインターセプトし、新しい ダッシュボードセッションを作成して切り替えます。ただし、session.dmScope: "main" が設定されていて、 現在の親がエージェントのメインセッションである場合は、/new が メインセッションをその場でリセットします。入力された /reset は引き続き Gateway の インプレースリセットを実行します。固定されたセッションのモデル選択をクリアする場合は /model default を使用します。
  • /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 はグループ環境では危険です。内部推論や Plugin の診断情報が公開される可能性があります。グループチャットではオフにしてください。
  • /model は新しいモデルを即座にセッションへ永続化します。
  • エージェントがアイドル状態の場合、次回の実行から直ちに使用されます。
  • 実行中の場合、切り替えは保留としてマークされ、次の正常な再試行ポイントで適用されます。

ドックコマンド

ドックコマンドは、アクティブなセッションの返信経路を、リンク済みの別のチャンネルへ切り替えます。 セットアップとトラブルシューティングについては、チャンネルのドッキングを参照してください。 ネイティブコマンドをサポートするチャンネル Plugin から生成されます。
  • /dock-discord(エイリアス: /dock_discord
  • /dock-mattermost(エイリアス: /dock_mattermost
  • /dock-slack(エイリアス: /dock_slack
  • /dock-telegram(エイリアス: /dock_telegram
ドックコマンドには session.identityLinks が必要です。送信元の送信者とターゲットのピアは、 同じアイデンティティグループに属している必要があります。

バンドルされた Plugin のコマンド

QQBot 限定: /bot-ping/bot-version/bot-help/bot-upgrade/bot-logs

スキルコマンド

ユーザーが呼び出せるスキルは、スラッシュコマンドとして公開されます。
  • /skill <name> [input] は汎用エントリポイントとして常に使用できます。
  • Skills は直接コマンドとして登録できます(例: OpenProse の /prose)。
  • ネイティブのスキルコマンド登録は commands.nativeSkillschannels.<provider>.commands.nativeSkills で制御されます。
  • 名前は a-z0-9_ にサニタイズされ(最大32文字)、重複時には数字のサフィックスが付きます。
デフォルトでは、スキルコマンドは通常のリクエストとしてモデルにルーティングされます。Skills は command-dispatch: tool を宣言することで、ツールへ直接ルーティングできます (決定論的で、モデルは関与しません)。例: /prose(OpenProse Plugin) — OpenProseを参照してください。
Discord は、必須の引数が省略された場合、動的オプションにはオートコンプリートを、 ボタンメニューには必要に応じてボタンを使用します。Telegram と Slack は、選択肢のある コマンドにボタンメニューを表示します。動的な選択肢はターゲットセッションのモデルに 基づいて解決されるため、/think レベルのようなモデル固有のオプションは、 セッションの /model オーバーライドに従います。

/tools: エージェントが現在使用できるもの

/tools は、ランタイムに関する質問、つまりこの会話でこのエージェントが今すぐ 使用できるものに答えます。静的な設定カタログではありません。
結果はセッション単位です。エージェント、チャンネル、スレッド、送信者の 認可、またはモデルを変更すると、出力が変わる場合があります。プロファイルとオーバーライドを編集するには、 Control UI の Tools パネルまたは設定サーフェスを使用してください。

/model: モデルの選択

Discord では、/model/models を使用すると、プロバイダーと モデルのドロップダウンを備えた対話型ピッカーが開きます。ピッカーは provider/* エントリを含む agents.defaults.modelPolicy.allow に従います。明示的な許可リストがない場合、 モデルエントリとエイリアスによって選択が制限されることはありません。

/config: ディスク上の設定への書き込み

オーナー限定。デフォルトでは無効です。commands.config: true で有効にしてください。
設定は書き込み前に検証されます。無効な変更は拒否されます。/config の 更新内容は再起動後も保持されます。

/mcp: MCP サーバー設定

オーナー限定。デフォルトでは無効です。commands.mcp: true で有効にしてください。
/mcp は、組み込みエージェントのプロジェクト設定ではなく、OpenClaw の設定に保存されます。 /mcp show は、認証情報を含むフィールド、認識された認証情報フラグの値、 および既知のシークレット形式の引数をマスキングします。グループから実行した場合、 設定はオーナーへ非公開で送信されます。オーナーへの非公開経路が利用できない場合、 コマンドはフェイルクローズし、ダイレクトチャットから再試行するようオーナーに求めます。

/debug: ランタイム限定のオーバーライド

オーナー限定。デフォルトでは無効です。commands.debug: true で有効にしてください。 オーバーライドは新しい設定の読み取りに即座に適用されますが、ディスクには書き込まれません

/plugins: Plugin の管理

書き込みはオーナー限定。デフォルトでは無効です。commands.plugins: true で有効にしてください。
/plugins enable|disable は Plugin の設定を更新し、新しいエージェントターンに向けて Gateway の Plugin ランタイムをホットリロードします。/plugins install は Plugin のソースモジュールが 変更されたため、管理対象の Gateway を自動的に再起動します。信頼済みの ClawHub および 公式カタログからのインストールには、追加の確認は不要です。任意の npm、git、アーカイブ、 npm-pack:、ローカルパスのソースでは、来歴に関する警告が表示され、 ソースを確認した後、末尾に --force を付ける必要があります。このフラグは ソースを確認したことを示し、既存のインストールの置き換えを許可しますが、 security.installPolicy やインストーラーのセキュリティチェックを回避するものではありません。 リスク警告がある ClawHub リリースでは、引き続きシェル限定の別フラグ --acknowledge-clawhub-risk が必要です。マーケットプレイス、リンク済み、固定済みの インストールも、引き続きシェル限定です。

/trace: Plugin のトレース出力

/trace は、完全な詳細モードを使わずに、セッション単位の Plugin のトレース/デバッグ行を 表示します。/debug(ランタイムオーバーライド)や /verbose(通常の ツール出力)の代わりにはなりません。

/btw: 補足質問

/btw は、現在のセッションコンテキストに関する簡単な補足質問です。エイリアス: /side
通常のメッセージとは異なり、次のように動作します。
  • 現在のセッションを背景コンテキストとして使用します。
  • 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 は、現在の実行を中止するため、アクティブなチャットセッションをターゲットにします。
channels.slack.slashCommand は単一の /openclaw 形式のコマンドをサポートします。 commands.native: true を使用する場合は、組み込みコマンドごとに Slack スラッシュコマンドを1つ作成します。 Slack が /status を予約しているため、/status ではなく /agentstatus を登録してください。 Slack メッセージ内では、テキスト /status も引き続き機能します。
  • 許可リストに登録された送信者からのコマンドのみのメッセージは、即座に処理されます(キューとモデルをバイパスします)。
  • インラインショートカット(/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 DefaultOpenAI Codex、CLI バックエンド、または ACP バックエンドのいずれかです。
  • 応答ごとのトークン数/コスト: /usage off|tokens|full で制御します。
  • /model status は使用量ではなく、モデル/認証/エンドポイントに関するものです。

関連項目

Skills

skill のスラッシュコマンドが登録され、利用を制御される仕組み。

skill の作成

独自のスラッシュコマンドを登録する skill を構築します。

BTW

セッションコンテキストを変更せずに補足的な質問をします。

ステアリング

実行中に /steer を使用してエージェントを誘導します。