> ## Documentation Index > Fetch the complete documentation index at: https://openclawdoc.org/llms.txt > Use this file to discover all available pages before exploring further. # acp > OpenClaw ゲートウェイと通信する Agent Client Protocol (ACP) ブリッジを実行します。このコマンドは、IDE 等との標準入出力を介した ACP 通信を行い、プロンプトを WebSocket 経由でゲートウェイに転送します。 OpenClaw ゲートウェイと通信する [Agent Client Protocol (ACP)](https://agentclientprotocol.com/) ブリッジを実行します。 このコマンドは、IDE 等との標準入出力を介した ACP 通信を行い、プロンプトを WebSocket 経由でゲートウェイに転送します。ACP セッションとゲートウェイのセッションキーのマッピングを維持します。 `openclaw acp` はゲートウェイをバックエンドとする ACP ブリッジであり、完全な ACP ネイティブのエディタランタイムではありません。セッションのルーティング、プロンプトの配信、および基本的なストリーミング更新に重点を置いています。 ## 互換性マトリックス | ACP 領域 | ステータス | 備考 | | :-------------------------------------------------------------- | :---- | :---------------------------------------------------------------------------------------------------------------------------------------- | | `initialize`, `newSession`, `prompt`, `cancel` | 実装済み | 標準入出力を介したブリッジフロー。ゲートウェイへの chat/send および実行中止に対応。 | | `listSessions`, スラッシュコマンド | 実装済み | セッション一覧はゲートウェイのセッション状態に基づきます。コマンドは `available_commands_update` 経由で通知されます。 | | `loadSession` | 部分的 | ACP セッションをゲートウェイのセッションキーに再バインドし、保存されているユーザー/アシスタントのテキスト履歴を再生します。ツールやシステムの履歴はまだ再構築されません。 | | プロンプト内容 (`text`, 埋め込み `resource`, 画像) | 部分的 | テキストやリソースはチャット入力にフラット化されます。画像はゲートウェイの添付ファイルになります。 | | セッションモード | 部分的 | `session/set_mode` がサポートされています。ブリッジは、思考レベル、ツールの詳細度、推論、使用状況の詳細、および権限昇格アクションに対するゲートウェイベースの初期制御を公開します。広範な ACP ネイティブのモードや構成は対象外です。 | | セッション情報と使用状況の更新 | 部分的 | キャッシュされたゲートウェイのセッションスナップショットから `session_info_update` と、ベストエフォートで `usage_update` 通知を発行します。使用状況は概算であり、ゲートウェイのトークン合計が更新された場合にのみ送信されます。 | | ツールストリーミング | 部分的 | `tool_call` / `tool_call_update` イベントには、生の I/O、テキスト内容、およびゲートウェイツールの引数/結果に含まれる場合はベストエフォートでファイル位置が含まれます。埋め込みターミナルやリッチな diff 出力にはまだ対応していません。 | | セッションごとの MCP サーバー (`mcpServers`) | 未サポート | ブリッジモードではセッションごとの MCP サーバー要求を拒否します。代わりに OpenClaw のゲートウェイまたはエージェントで MCP を構成してください。 | | クライアント側ファイルシステムメソッド (`fs/read_text_file`, `fs/write_text_file`) | 未サポート | ブリッジは ACP クライアントのファイルシステムメソッドを呼び出しません。 | | クライアント側ターミナルメソッド (`terminal/*`) | 未サポート | ブリッジは ACP クライアントターミナルを作成したり、ツール呼び出しを通じてターミナル ID をストリーミングしたりしません。 | | セッションプラン / 思考ストリーミング | 未サポート | 現在、ブリッジは出力テキストとツールのステータスのみを出力し、ACP のプランや思考プロセスの更新は出力しません。 | ## 既知の制限事項 * `loadSession` は保存されたユーザーとアシスタントのテキスト履歴を再生しますが、過去のツール呼び出し、システム通知、またはリッチな ACP ネイティブイベントタイプは再構築しません。 * 複数の ACP クライアントが同じゲートウェイセッションキーを共有する場合、イベントやキャンセル（中断）のルーティングはクライアントごとに厳密に分離されるのではなく、ベストエフォートになります。クリーンなエディタローカルのターンが必要な場合は、デフォルトの分離された `acp:` セッションを使用してください。 * ゲートウェイの停止状態は ACP の停止理由に変換されますが、そのマッピングは完全な ACP ネイティブランタイムほど表現力が高くありません。 * 初期のセッション制御は、現在、思考レベル、ツールの詳細度、推論、使用状況の詳細、および権限昇格アクションといった、ゲートウェイの設定のサブセットのみを対象としています。モデル選択や実行ホストの制御は、まだ ACP 構成オプションとして公開されていません。 * `session_info_update` と `usage_update` は、ライブの ACP ネイティブランタイム計測ではなく、ゲートウェイのセッションスナップショットから派生しています。使用状況は概算であり、コストデータは含まれず、ゲートウェイがトークン合計データを「最新」とマークした場合にのみ発行されます。 * ツールの追跡データはベストエフォートです。ブリッジは既知のツールの引数や結果に現れるファイルパスを表示できますが、ACP ターミナルや構造化されたファイル diff はまだ発行しません。 ## 使用法 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw acp # リモートゲートウェイへの接続 openclaw acp --url wss://gateway-host:18789 --token # リモートゲートウェイへの接続 (トークンをファイルから読み込む) openclaw acp --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token # 既存のセッションキーにアタッチ openclaw acp --session agent:main:main # ラベルで指定してアタッチ (既存のラベルである必要があります) openclaw acp --session-label "support inbox" # 初回プロンプトの前にセッションキーをリセット openclaw acp --session agent:main:main --reset-session ``` ## ACP クライアント (デバッグ用) IDE を介さずにブリッジの動作確認を行うための組み込み ACP クライアントです。ACP ブリッジを起動し、対話的にプロンプトを入力できます。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw acp client # 起動したブリッジをリモートゲートウェイに向ける openclaw acp client --server-args --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token # サーバーコマンドを上書き (デフォルト: openclaw) openclaw acp client --server "node" --server-args openclaw.mjs acp --url ws://127.0.0.1:19001 ``` 権限モデル (クライアントデバッグモード): * 自動承認は許可リストに基づいており、信頼されたコアツール ID にのみ適用されます。 * `read` の自動承認は、現在の作業ディレクトリ（`--cwd` 設定時）に制限されます。 * 未知のツールや非コアツール、範囲外の読み取り、および危険なツールには、常に明示的な承認プロンプトが必要です。 * サーバーから提供される `toolCall.kind` は、信頼できないメタデータとして扱われます（権限付与の根拠にはなりません）。 ## 利用手順 IDE（または他のクライアント）が Agent Client Protocol をサポートしており、OpenClaw ゲートウェイのセッションを操作したい場合に ACP を使用します。 1. ゲートウェイが起動していることを確認します（ローカルまたはリモート）。 2. ゲートウェイの接続先を構成します（構成ファイルまたはフラグ）。 3. IDE の設定で、stdio 経由で `openclaw acp` を実行するように指定します。 構成例（永続化する場合）: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw config set gateway.remote.url wss://gateway-host:18789 openclaw config set gateway.remote.token ``` 直接実行する場合（構成を書き換えない）: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw acp --url wss://gateway-host:18789 --token # ローカルプロセスの安全性の観点から以下を推奨します openclaw acp --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token ``` ## エージェントの選択 ACP はエージェントを直接選択するのではなく、ゲートウェイのセッションキーによってルーティングを行います。 特定のエージェントをターゲットにするには、エージェントスコープのセッションキーを使用します: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw acp --session agent:main:main openclaw acp --session agent:design:main openclaw acp --session agent:qa:bug-123 ``` 各 ACP セッションは単一のゲートウェイセッションキーにマップされます。1 つのエージェントが複数のセッションを持つことができます。ACP は、キーやラベルを明示的に上書きしない限り、デフォルトで分離された `acp:` セッションを使用します。 ブリッジモードでは、セッションごとの `mcpServers` はサポートされていません。ACP クライアントが `newSession` や `loadSession` 時にこれらを送信した場合、ブリッジは黙って無視するのではなく、明確なエラーを返します。 ## `acpx` (Codex, Claude Code 等の ACP クライアント) からの利用 Codex や Claude Code などのコーディングエージェントから OpenClaw ボットと ACP 経由で通信したい場合は、`acpx` の組み込み `openclaw` ターゲットを使用します。 標準的な流れ: 1. ゲートウェイを実行し、ACP ブリッジから到達可能であることを確認します。 2. `acpx openclaw` の参照先として `openclaw acp` を指定します。 3. コーディングエージェントに使用させたい OpenClaw のセッションキーを指定します。 実行例: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # デフォルトの OpenClaw ACP セッションに対して一度限りの要求を行う acpx openclaw exec "現在の OpenClaw セッションの状態を要約してください。" # 継続的なターンのために永続的な名前付きセッションを使用する acpx openclaw sessions ensure --name codex-bridge acpx openclaw -s codex-bridge --cwd /path/to/repo \ "仕事用の OpenClaw エージェントに、このリポジトリに関連する最近のコンテキストを尋ねてください。" ``` 毎回特定のゲートウェイとセッションキーをターゲットにしたい場合は、`~/.acpx/config.json` で `openclaw` エージェントコマンドを上書きします: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "agents": { "openclaw": { "command": "env OPENCLAW_HIDE_BANNER=1 OPENCLAW_SUPPRESS_NOTES=1 openclaw acp --url ws://127.0.0.1:18789 --token-file ~/.openclaw/gateway.token --session agent:main:main" } } } ``` リポジトリローカルの OpenClaw チェックアウトを使用する場合は、ACP ストリームをクリーンに保つため、dev ランナーではなく直接的な CLI エントリポイントを使用してください。例: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} env OPENCLAW_HIDE_BANNER=1 OPENCLAW_SUPPRESS_NOTES=1 node openclaw.mjs acp ... ``` これは、Codex や Claude Code などの ACP 対応クライアントが、ターミナルの画面をスクレイピングすることなく、OpenClaw エージェントからコンテキスト情報を取得するための最も簡単な方法です。 ## Zed エディタのセットアップ `~/.config/zed/settings.json` にカスタム ACP エージェントを追加します（または Zed の設定 UI を使用します）: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "agent_servers": { "OpenClaw ACP": { "type": "custom", "command": "openclaw", "args": ["acp"], "env": {} } } } ``` 特定のゲートウェイやエージェントを指定する場合: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "agent_servers": { "OpenClaw ACP": { "type": "custom", "command": "openclaw", "args": [ "acp", "--url", "wss://gateway-host:18789", "--token", "", "--session", "agent:design:main" ], "env": {} } } } ``` Zed でエージェントパネルを開き、"OpenClaw ACP" を選択してスレッドを開始します。 ## セッションマッピング デフォルトでは、ACP セッションには `acp:` プレフィックスが付いた分離されたゲートウェイセッションキーが割り当てられます。既存のセッションを再利用するには、セッションキーまたはラベルを渡します。 * `--session `: 特定のゲートウェイセッションキーを使用します。 * `--session-label