ACP

OpenClaw Gateway と対話する ACP（Agent Client Protocol）ブリッジを実行します。

このコマンドは IDE の stdio 経由で ACP を話し、プロンプトを Gateway に転送します

WebSocket 経由で。ACP セッションを Gateway セッションキーにマップします。

組み込みの ACP クライアントを使用して、IDE なしでブリッジの健全性チェックを行います。

ACP ブリッジを生成し、対話的にプロンプトを入力できます。

openclaw acp client


openclaw acp client --server-args --url wss://gateway-host:18789 --token <token>


openclaw acp client --server "node" --server-args openclaw.mjs acp --url ws://127.0.0.1:19001

IDE（またはその他のクライアント）が Agent Client Protocol を使用しており、OpenClaw Gateway セッションを

駆動させたい場合に ACP を使用します。

1. Gateway が実行中であることを確認します（ローカルまたはリモート）。

2. Gateway ターゲットを設定します（設定またはフラグ）。

3. IDE が stdio 経由で ''openclaw acp'' を実行するように設定します。

Config example (persistent):

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>

ACP はエージェントを直接選択しません。Gateway セッションキー経由でルーティングします。

エージェントスコープのセッションキーを使用して、特定のエージェントをターゲットにします：

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

各 ACP セッションは Gateway セッションキーにマップされます。エージェントは複数のエージェント

sessions; ACP defaults to an isolated ''acp:<uuid>'' session unless you override

キーまたはラベル。

''~/.config/zed/settings.json'' にカスタム ACP エージェントを追加します（または Zed の設定 UI を使用）：

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

特定の Gateway またはエージェントをターゲットにするには：

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

Zed で、Agent パネルを開き、「OpenClaw ACP」を選択してスレッドを開始します。

デフォルトでは、ACP セッションは ''acp:'' プレフィックス付きの分離された Gateway セッションキーを取得します。

既知のセッションを再利用するには、セッションキーまたはラベルを渡します：

- ''--session <key>'': Use a specific gateway session key.

- ''--session-label <label>'': Resolve an existing session by label.

- ''--reset-session''：そのキーの新しいセッション ID を作成します（同じキー、新しいレコード）。

ACP クライアントがメタデータをサポートしている場合、セッションごとにオーバーライドできます：

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

セッションキーの詳細については、''/concepts/session'' を参照してください。

- ''--url <url>'': Gateway WebSocket URL (defaults to gateway.remote.url when configured).

- ''--token <token>'': Gateway authentication token.

- ''--password <password>'': Gateway verification password.

- ''--session <key>'': Default session key.

- ''--session-label <label>'': Default session label to resolve.

- ''--require-existing''：セッションキー/ラベルが存在しない場合に失敗します。

- ''--reset-session''：最初の使用前にセッションキーをリセットします。

- ''--no-prefix-cwd''：プロンプトの前に作業ディレクトリをプレフィックスしません。

- ''--verbose, -v''：stderr への詳細ログ。

#

- ''--cwd <dir>'': Working directory for ACP session.

- ''--server <command>'': ACP server command (default: ''openclaw'').

- ''--server-args <args...>'': Extra arguments to pass to ACP server.

- ''--server-verbose''：ACP サーバーで詳細ログを有効にします。

- ''--verbose, -v''：詳細なクライアントログ。