ACP

​

यह क्या नहीं है

• OpenClaw ACP server की तरह काम करता है
• कोई IDE या ACP client OpenClaw से connect करता है
• OpenClaw उस work को Gateway session में forward करता है

• editor/client OpenClaw से ACP में बात करना चाहता है: openclaw acp उपयोग करें
• OpenClaw को Codex/Claude/Gemini को ACP harness के रूप में launch करना चाहिए: /acp spawn और ACP Agents उपयोग करें

​

Compatibility Matrix

​

ज्ञात सीमाएँ

• loadSession केवल bridge-created sessions के लिए complete ACP event-ledger history replay कर सकता है. पुराने/no-ledger sessions अभी भी transcript fallback उपयोग करते हैं और historic tool calls या system notices reconstruct नहीं करते.
• यदि कई ACP clients समान Gateway session key share करते हैं, तो event और cancel routing प्रति client strictly isolated होने के बजाय best-effort होती है. जब आपको clean editor-local turns चाहिए हों, तो default isolated acp-bridge:<uuid> sessions को prefer करें.
• Gateway stop states ACP stop reasons में translate किए जाते हैं, लेकिन वह mapping पूरी तरह ACP-native runtime से कम expressive है.
• शुरुआती session controls अभी Gateway knobs का focused subset surface करते हैं: thought level, tool verbosity, reasoning, usage detail, और elevated actions. Model selection और exec-host controls अभी ACP config options के रूप में expose नहीं हुए हैं.
• session_info_update और usage_update Gateway session snapshots से derived हैं, live ACP-native runtime accounting से नहीं. Usage approximate है, उसमें cost data नहीं होता, और केवल तब emit होता है जब Gateway total token data को fresh mark करता है.
• Tool follow-along data best-effort है. Bridge known tool args/results में दिखने वाले file paths surface कर सकता है, लेकिन अभी ACP terminals या structured file diffs emit नहीं करता.
• Exec approval relay active ACP prompt turn तक scoped है; अन्य Gateway sessions से approvals ignore किए जाते हैं.

​

उपयोग

openclaw acp

# Remote Gateway
openclaw acp --url wss://gateway-host:18789 --token <token>

# Remote Gateway (token from file)
openclaw acp --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

# Attach to an existing session key
openclaw acp --session agent:main:main

# Attach by label (must already exist)
openclaw acp --session-label "support inbox"

# Reset the session key before the first prompt
openclaw acp --session agent:main:main --reset-session

​

ACP client (debug)

openclaw acp client

# Point the spawned bridge at a remote Gateway
openclaw acp client --server-args --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

# Override the server command (default: openclaw)
openclaw acp client --server "node" --server-args openclaw.mjs acp --url ws://127.0.0.1:19001

• Auto-approval allowlist-based है और केवल trusted core tool IDs पर लागू होता है.
• read auto-approval current working directory (--cwd set होने पर) तक scoped है.
• ACP केवल narrow readonly classes को auto-approve करता है: active cwd के अंतर्गत scoped read calls और readonly search tools (search, web_search, memory_search). Unknown/non-core tools, out-of-scope reads, exec-capable tools, control-plane tools, mutating tools, और interactive flows को हमेशा explicit prompt approval चाहिए.
• Server-provided toolCall.kind को untrusted metadata माना जाता है (authorization source नहीं).
• यह ACP bridge policy ACPX harness permissions से अलग है. यदि आप OpenClaw को acpx backend के माध्यम से run करते हैं, तो plugins.entries.acpx.config.permissionMode=approve-all उस harness session के लिए break-glass “yolo” switch है.

​

Protocol smoke testing

{
  "initialize": {
    "protocolVersion": 1,
    "agentCapabilities": {
      "sessionCapabilities": {
        "list": {},
        "resume": {},
        "close": {}
      }
    }
  },
  "listSessions": {
    "sessions": [
      {
        "sessionId": "agent:main:acp-smoke",
        "cwd": "/path/to/workspace",
        "_meta": {
          "sessionKey": "agent:main:acp-smoke",
          "kind": "direct"
        }
      }
    ],
    "nextCursor": null
  },
  "notifications": ["session_info_update", "available_commands_update", "usage_update"],
  "gatewayLogTail": ["[gateway] ready", "[ws] ⇄ res ✓ sessions.list 305ms"]
}

​

इसका उपयोग कैसे करें

1. सुनिश्चित करें कि Gateway चल रहा है (local या remote).
2. Gateway target configure करें (config या flags).
3. अपने IDE को stdio पर openclaw acp run करने के लिए point करें.

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>
# preferred for local process safety
openclaw acp --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

​

Agents चुनना

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

​

acpx से उपयोग करें (Codex, Claude, अन्य ACP क्लाइंट)

1. Gateway चलाएँ और सुनिश्चित करें कि ACP ब्रिज उस तक पहुँच सकता है।
2. acpx openclaw को openclaw acp पर पॉइंट करें।
3. उस OpenClaw सेशन कुंजी को लक्ष्य बनाएँ जिसे आप कोडिंग एजेंट से उपयोग कराना चाहते हैं।

# One-shot request into your default OpenClaw ACP session
acpx openclaw exec "Summarize the active OpenClaw session state."

# Persistent named session for follow-up turns
acpx openclaw sessions ensure --name codex-bridge
acpx openclaw -s codex-bridge --cwd /path/to/repo \
  "Ask my OpenClaw work agent for recent context relevant to this repo."

{
  "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>: किसी विशिष्ट Gateway सेशन कुंजी का उपयोग करें।
• --session-label <label>: लेबल के आधार पर मौजूदा सेशन हल करें।
• --reset-session: उस कुंजी के लिए नया सेशन id बनाएँ (वही कुंजी, नया ट्रांसक्रिप्ट)।

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

​

विकल्प

• --url <url>: Gateway WebSocket URL (कॉन्फ़िगर होने पर डिफ़ॉल्ट gateway.remote.url होता है)।
• --token <token>: Gateway प्रमाणीकरण टोकन।
• --token-file <path>: फ़ाइल से Gateway प्रमाणीकरण टोकन पढ़ें।
• --password <password>: Gateway प्रमाणीकरण पासवर्ड।
• --password-file <path>: फ़ाइल से Gateway प्रमाणीकरण पासवर्ड पढ़ें।
• --session <key>: डिफ़ॉल्ट सेशन कुंजी।
• --session-label <label>: हल करने के लिए डिफ़ॉल्ट सेशन लेबल।
• --require-existing: यदि सेशन कुंजी/लेबल मौजूद नहीं है तो विफल हों।
• --reset-session: पहले उपयोग से पहले सेशन कुंजी रीसेट करें।
• --no-prefix-cwd: प्रॉम्प्ट में कार्यशील डायरेक्टरी को प्रीफ़िक्स न करें।
• --provenance <off|meta|meta+receipt>: ACP उद्गम मेटाडेटा या रसीदें शामिल करें।
• --verbose, -v: stderr पर विस्तृत लॉगिंग।

• कुछ सिस्टम पर --token और --password स्थानीय प्रोसेस सूचियों में दिखाई दे सकते हैं।
• --token-file/--password-file या एनवायरनमेंट वैरिएबल (OPENCLAW_GATEWAY_TOKEN, OPENCLAW_GATEWAY_PASSWORD) को प्राथमिकता दें।
• Gateway प्रमाणीकरण समाधान वही साझा अनुबंध अनुसरण करता है जिसे अन्य Gateway क्लाइंट उपयोग करते हैं:
  • लोकल मोड: env (OPENCLAW_GATEWAY_*) -> gateway.auth.* -> gateway.remote.* फ़ॉलबैक केवल तब जब gateway.auth.* सेट न हो (कॉन्फ़िगर-लेकिन-अनसुलझे स्थानीय SecretRefs बंद होकर विफल होते हैं)
  • रिमोट मोड: रिमोट प्राथमिकता नियमों के अनुसार env/config फ़ॉलबैक के साथ gateway.remote.*
  • --url ओवरराइड-सुरक्षित है और अप्रत्यक्ष config/env क्रेडेंशियल्स का पुनः उपयोग नहीं करता; स्पष्ट --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: विस्तृत क्लाइंट लॉगिंग।

​

संबंधित

• CLI संदर्भ
• ACP एजेंट