acp

​

互換性マトリックス

​

既知の制限事項

• loadSession は保存されたユーザーとアシスタントのテキスト履歴を再生しますが、過去のツール呼び出し、システム通知、またはリッチな ACP ネイティブイベントタイプは再構築しません。
• 複数の ACP クライアントが同じゲートウェイセッションキーを共有する場合、イベントやキャンセル（中断）のルーティングはクライアントごとに厳密に分離されるのではなく、ベストエフォートになります。クリーンなエディタローカルのターンが必要な場合は、デフォルトの分離された acp:<uuid> セッションを使用してください。
• ゲートウェイの停止状態は ACP の停止理由に変換されますが、そのマッピングは完全な ACP ネイティブランタイムほど表現力が高くありません。
• 初期のセッション制御は、現在、思考レベル、ツールの詳細度、推論、使用状況の詳細、および権限昇格アクションといった、ゲートウェイの設定のサブセットのみを対象としています。モデル選択や実行ホストの制御は、まだ ACP 構成オプションとして公開されていません。
• session_info_update と usage_update は、ライブの ACP ネイティブランタイム計測ではなく、ゲートウェイのセッションスナップショットから派生しています。使用状況は概算であり、コストデータは含まれず、ゲートウェイがトークン合計データを「最新」とマークした場合にのみ発行されます。
• ツールの追跡データはベストエフォートです。ブリッジは既知のツールの引数や結果に現れるファイルパスを表示できますが、ACP ターミナルや構造化されたファイル diff はまだ発行しません。

​

使用法

openclaw acp

# リモートゲートウェイへの接続
openclaw acp --url wss://gateway-host:18789 --token <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 クライアント (デバッグ用)

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 は、信頼できないメタデータとして扱われます（権限付与の根拠にはなりません）。

​

利用手順

1. ゲートウェイが起動していることを確認します（ローカルまたはリモート）。
2. ゲートウェイの接続先を構成します（構成ファイルまたはフラグ）。
3. IDE の設定で、stdio 経由で openclaw acp を実行するように指定します。

openclaw config set gateway.remote.url wss://gateway-host:18789
openclaw config set gateway.remote.token <token>

openclaw acp --url wss://gateway-host:18789 --token <token>
# ローカルプロセスの安全性の観点から以下を推奨します
openclaw acp --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

​

エージェントの選択

openclaw acp --session agent:main:main
openclaw acp --session agent:design:main
openclaw acp --session agent:qa:bug-123

​

acpx (Codex, Claude Code 等の ACP クライアント) からの利用

1. ゲートウェイを実行し、ACP ブリッジから到達可能であることを確認します。
2. acpx openclaw の参照先として openclaw acp を指定します。
3. コーディングエージェントに使用させたい OpenClaw のセッションキーを指定します。

# デフォルトの OpenClaw ACP セッションに対して一度限りの要求を行う
acpx openclaw exec "現在の OpenClaw セッションの状態を要約してください。"

# 継続的なターンのために永続的な名前付きセッションを使用する
acpx openclaw sessions ensure --name codex-bridge
acpx openclaw -s codex-bridge --cwd /path/to/repo \
  "仕事用の OpenClaw エージェントに、このリポジトリに関連する最近のコンテキストを尋ねてください。"

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

env OPENCLAW_HIDE_BANNER=1 OPENCLAW_SUPPRESS_NOTES=1 node openclaw.mjs acp ...

​

Zed エディタのセットアップ

{
  "agent_servers": {
    "OpenClaw ACP": {
      "type": "custom",
      "command": "openclaw",
      "args": ["acp"],
      "env": {}
    }
  }
}

{
  "agent_servers": {
    "OpenClaw ACP": {
      "type": "custom",
      "command": "openclaw",
      "args": [
        "acp",
        "--url",
        "wss://gateway-host:18789",
        "--token",
        "<token>",
        "--session",
        "agent:design:main"
      ],
      "env": {}
    }
  }
}

​

セッションマッピング

• --session <key>: 特定のゲートウェイセッションキーを使用します。
• --session-label <label>: 既存のセッションをラベルで解決します。
• --reset-session: そのキーに対して新しいセッション ID を発行します（同じキーですが、履歴は新しくなります）。

{
  "_meta": {
    "sessionKey": "agent:main:main",
    "sessionLabel": "support inbox",
    "resetSession": true
  }
}

​

オプション

• --url <url>: ゲートウェイの WebSocket URL (構成済みであれば gateway.remote.url がデフォルトとなります)。
• --token <token>: ゲートウェイ認証トークン。
• --token-file <path>: ゲートウェイ認証トークンをファイルから読み込みます。
• --password <password>: ゲートウェイ認証パスワード。
• --password-file <path>: ゲートウェイ認証パスワードをファイルから読み込みます。
• --session <key>: デフォルトのセッションキー。
• --session-label <label>: 解決するデフォルトのセッションラベル。
• --require-existing: セッションキーやラベルが存在しない場合にエラーにします。
• --reset-session: 初回使用前にセッションキーをリセットします。
• --no-prefix-cwd: プロンプトの前に作業ディレクトリを付加しません。
• --verbose, -v: stderr への詳細ログ出力を有効にします。

• 一部のシステムでは、--token や --password はローカルのプロセス一覧から可視状態になる場合があります。
• --token-file / --password-file または環境変数 (OPENCLAW_GATEWAY_TOKEN, OPENCLAW_GATEWAY_PASSWORD) の使用を推奨します。
• ゲートウェイ認証の解決は、他のゲートウェイクライアントと共通のルールに従います:
  • ローカルモード: 環境変数 (OPENCLAW_GATEWAY_*) -> gateway.auth.* -> gateway.auth.* 未設定時は gateway.remote.* へフォールバック
  • リモートモード: gateway.remote.* (リモート優先順位ルールによる環境変数/構成フォールバックあり)
  • --url 指定時は上書きが優先され、暗黙的な構成や環境変数の認証情報は再利用されません。明示的に --token / --password (またはファイル版) を指定してください。
• ACP ランタイムバックエンドの子プロセスは OPENCLAW_SHELL=acp を受け取ります。これはコンテキスト固有のシェルやプロフィールルールに使用できます。
• openclaw acp client は、起動したブリッジプロセスに OPENCLAW_SHELL=acp-client を設定します。

​

acp client オプション

• --cwd <dir>: ACP セッションの作業ディレクトリ。
• --server <command>: ACP サーバーコマンド (デフォルト: openclaw)。
• --server-args <args...>: ACP サーバーに渡す追加の引数。
• --server-verbose: ACP サーバーの詳細ログ出力を有効にします。
• --verbose, -v: クライアントの詳細ログ出力。