/ で始まる単独メッセージとして送信されたコマンドを処理します。
ホスト専用の 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()呼び出し
コアコマンド
セッションと実行
セッションと実行
明示的な
/export-session パスを指定すると、ワークスペース内の既存ファイルが
置き換えられます。パスを省略すると、名前の衝突を回避したファイル名が生成されます。Control UI は、入力された
/new をインターセプトし、新しい
ダッシュボードセッションを作成して切り替えます。ただし、session.dmScope: "main" が設定されていて、
現在の親がエージェントのメインセッションである場合は、/new が
メインセッションをその場でリセットします。入力された /reset は引き続き Gateway の
インプレースリセットを実行します。固定されたセッションのモデル選択をクリアする場合は
/model default を使用します。モデルと実行の制御
モデルと実行の制御
verbose / trace / fast / reasoning の安全性
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はグループ環境では危険です。内部推論や Plugin の診断情報が公開される可能性があります。グループチャットではオフにしてください。
モデル切り替えの詳細
モデル切り替えの詳細
/modelは新しいモデルを即座にセッションへ永続化します。- エージェントがアイドル状態の場合、次回の実行から直ちに使用されます。
- 実行中の場合、切り替えは保留としてマークされ、次の正常な再試行ポイントで適用されます。
検出とステータス
検出とステータス
Skills、許可リスト、承認
Skills、許可リスト、承認
サブエージェントと ACP
サブエージェントと ACP
オーナー限定の書き込みと管理
オーナー限定の書き込みと管理
音声、TTS、チャンネル制御
音声、TTS、チャンネル制御
ドックコマンド
ドックコマンドは、アクティブなセッションの返信経路を、リンク済みの別のチャンネルへ切り替えます。 セットアップとトラブルシューティングについては、チャンネルのドッキングを参照してください。 ネイティブコマンドをサポートするチャンネル 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.nativeSkillsとchannels.<provider>.commands.nativeSkillsで制御されます。 - 名前は
a-z0-9_にサニタイズされ(最大32文字)、重複時には数字のサフィックスが付きます。
スキルコマンドのディスパッチ
スキルコマンドのディスパッチ
デフォルトでは、スキルコマンドは通常のリクエストとしてモデルにルーティングされます。Skills は
command-dispatch: tool を宣言することで、ツールへ直接ルーティングできます
(決定論的で、モデルは関与しません)。例: /prose(OpenProse Plugin)
— OpenProseを参照してください。ネイティブコマンドの引数
ネイティブコマンドの引数
Discord は、必須の引数が省略された場合、動的オプションにはオートコンプリートを、
ボタンメニューには必要に応じてボタンを使用します。Telegram と Slack は、選択肢のある
コマンドにボタンメニューを表示します。動的な選択肢はターゲットセッションのモデルに
基づいて解決されるため、
/think レベルのようなモデル固有のオプションは、
セッションの /model オーバーライドに従います。/tools: エージェントが現在使用できるもの
/tools は、ランタイムに関する質問、つまりこの会話でこのエージェントが今すぐ
使用できるものに答えます。静的な設定カタログではありません。
/model: モデルの選択
/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 サイドスレッドとして実行されます。
- 今後のセッションコンテキストは変更しません。
- トランスクリプト履歴には書き込まれません。
サーフェスに関する注記
サーフェスごとのセッションスコープ
サーフェスごとのセッションスコープ
- テキストコマンド: 通常のチャットセッションで実行されます(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 固有の事項
Slack 固有の事項
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 Default、OpenAI Codex、CLI バックエンド、または ACP バックエンドのいずれかです。 - 応答ごとのトークン数/コスト:
/usage off|tokens|fullで制御します。 /model statusは使用量ではなく、モデル/認証/エンドポイントに関するものです。
関連項目
Skills
skill のスラッシュコマンドが登録され、利用を制御される仕組み。
skill の作成
独自のスラッシュコマンドを登録する skill を構築します。
BTW
セッションコンテキストを変更せずに補足的な質問をします。
ステアリング
実行中に
/steer を使用してエージェントを誘導します。