ACP

​

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

• एडिटर/क्लाइंट ACP के माध्यम से OpenClaw से संचार करना चाहता है: openclaw acp का उपयोग करें
• OpenClaw को Codex/Claude/Gemini को ACP हार्नेस के रूप में लॉन्च करना चाहिए: /acp spawn और ACP Agents का उपयोग करें

​

संगतता मैट्रिक्स

​

ज्ञात सीमाएँ

• loadSession केवल ब्रिज द्वारा बनाए गए सत्रों के लिए पूरा ACP इवेंट-लेजर इतिहास दोबारा चलाता है। पुराने/बिना-लेजर वाले सत्र ट्रांसक्रिप्ट फ़ॉलबैक का उपयोग करते हैं और ऐतिहासिक टूल कॉल या सिस्टम सूचनाओं का पुनर्निर्माण नहीं करते।
• यदि कई ACP क्लाइंट समान Gateway सत्र कुंजी साझा करते हैं, तो इवेंट और रद्दीकरण रूटिंग प्रत्येक क्लाइंट के लिए सख्ती से पृथक होने के बजाय सर्वोत्तम-प्रयास होती है। जब आपको स्वच्छ एडिटर-स्थानीय टर्न चाहिए, तो डिफ़ॉल्ट पृथक acp-bridge:<uuid> सत्रों को प्राथमिकता दें।
• Gateway की रुकने की स्थितियाँ ACP रुकने के कारणों में अनूदित होती हैं, लेकिन यह मैपिंग पूर्णतः ACP-नेटिव रनटाइम की तुलना में कम अभिव्यंजक है।
• सत्र नियंत्रण Gateway विकल्पों का एक केंद्रित उपसमुच्चय उपलब्ध कराते हैं: विचार स्तर, टूल वर्बोसिटी, रीजनिंग, उपयोग विवरण और उन्नत कार्रवाइयाँ। मॉडल चयन और निष्पादन-होस्ट नियंत्रण ACP कॉन्फ़िग विकल्पों के रूप में उपलब्ध नहीं हैं।
• session_info_update और usage_update लाइव ACP-नेटिव रनटाइम लेखांकन के बजाय Gateway सत्र स्नैपशॉट से प्राप्त होते हैं। उपयोग अनुमानित है, इसमें लागत डेटा नहीं होता और इसे केवल तभी उत्सर्जित किया जाता है जब Gateway कुल टोकन डेटा को ताज़ा चिह्नित करता है।
• टूल फ़ॉलो-अलॉन्ग डेटा सर्वोत्तम-प्रयास है: ब्रिज ज्ञात टूल आर्ग्युमेंट/परिणामों में दिखाई देने वाले फ़ाइल पथ उपलब्ध कराता है, लेकिन ACP टर्मिनल या संरचित फ़ाइल डिफ़ उत्सर्जित नहीं करता।
• निष्पादन अनुमोदन रिले सक्रिय ACP प्रॉम्प्ट टर्न तक सीमित है; अन्य Gateway सत्रों के अनुमोदन अनदेखे किए जाते हैं।

​

उपयोग

openclaw acp

# रिमोट Gateway
openclaw acp --url wss://gateway-host:18789 --token <token>

# रिमोट Gateway (फ़ाइल से टोकन)
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

# स्पॉन किए गए ब्रिज को रिमोट Gateway की ओर इंगित करें
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

• स्वतः-अनुमोदन अनुमति-सूची पर आधारित है और केवल विश्वसनीय मुख्य टूल आईडी पर लागू होता है।
• read स्वतः-अनुमोदन वर्तमान कार्यशील डायरेक्टरी (--cwd सेट होने पर) तक सीमित है।
• ACP केवल सीमित रीड-ओनली वर्गों को स्वतः अनुमोदित करता है: सक्रिय cwd के अंतर्गत सीमित read कॉल, साथ ही रीड-ओनली खोज टूल (search, web_search, memory_search)। अज्ञात/गैर-मुख्य टूल, दायरे से बाहर रीड, निष्पादन-सक्षम टूल, कंट्रोल-प्लेन टूल, परिवर्तनकारी टूल और अंतःक्रियात्मक प्रवाहों के लिए हमेशा स्पष्ट प्रॉम्प्ट अनुमोदन आवश्यक होता है।
• सर्वर द्वारा प्रदान किए गए toolCall.kind को अविश्वसनीय मेटाडेटा माना जाता है, प्राधिकरण स्रोत नहीं।
• यह ACP ब्रिज नीति ACPX हार्नेस अनुमतियों से अलग है। यदि आप acpx बैकएंड के माध्यम से OpenClaw चलाते हैं, तो plugins.entries.acpx.config.permissionMode=approve-all उस हार्नेस सत्र के लिए आपातकालीन “yolo” स्विच है।

​

प्रोटोकॉल स्मोक परीक्षण

{
  "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 चल रहा है (स्थानीय या रिमोट)।
2. Gateway लक्ष्य कॉन्फ़िगर करें (कॉन्फ़िग या फ़्लैग)।
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, अन्य ACP क्लाइंट)

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

{
  "_meta": {
    "sessionKey": "agent:main:main",
    "sessionLabel": "सहायता इनबॉक्स",
    "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.auth.* अनसेट होने पर ही gateway.remote.* का फ़ॉलबैक (कॉन्फ़िगर किया गया लेकिन अनरिज़ॉल्व स्थानीय SecretRef चुपचाप फ़ॉलबैक करने के बजाय विफल हो जाता है)
  • रिमोट मोड: रिमोट प्राथमिकता नियमों के अनुसार env/config फ़ॉलबैक के साथ gateway.remote.*
  • --url ओवरराइड-सुरक्षित है और अप्रत्यक्ष config/env क्रेडेंशियल का पुनः उपयोग नहीं करता; स्पष्ट --token/--password (या फ़ाइल वाले रूप) पास करें

​

acp client विकल्प

• --cwd <dir>: ACP सत्र के लिए कार्यशील डायरेक्टरी।
• --server <command>: ACP सर्वर कमांड (डिफ़ॉल्ट: openclaw)।
• --server-args <args...>: ACP सर्वर को पास किए जाने वाले अतिरिक्त आर्ग्युमेंट।
• --server-verbose: ACP सर्वर पर विस्तृत लॉगिंग सक्षम करें।
• --verbose, -v: विस्तृत क्लाइंट लॉगिंग।
• openclaw acp client शुरू की गई ब्रिज प्रक्रिया पर OPENCLAW_SHELL=acp-client सेट करता है, जिसका उपयोग संदर्भ-विशिष्ट शेल/प्रोफ़ाइल नियमों के लिए किया जा सकता है।

​

संबंधित

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