--- read_when: - ACP-आधारित IDE एकीकरण सेट अप करना - Gateway तक ACP सत्र रूटिंग की डीबगिंग summary: IDE एकीकरणों के लिए ACP ब्रिज चलाएँ title: ACP x-i18n: generated_at: "2026-07-27T19:26:42Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 32 provider: openai source_hash: becdcfdd1cc62b206cc92e9b8248c79a2ff63cfc3779d8a124b9713e779ad33c source_path: cli/acp.md workflow: 16 --- [Agent Client Protocol (ACP)](https://agentclientprotocol.com/) ब्रिज चलाएँ, जो OpenClaw Gateway से संचार करता है। `openclaw acp` IDE के लिए stdio पर ACP का उपयोग करता है और प्रॉम्प्ट को WebSocket पर Gateway को अग्रेषित करता है, साथ ही ACP सत्रों को Gateway सत्र कुंजियों से मैप करके रखता है। यह Gateway-समर्थित ACP ब्रिज है, पूर्ण ACP-नेटिव एडिटर रनटाइम नहीं: यह सत्र रूटिंग, प्रॉम्प्ट डिलीवरी और स्ट्रीमिंग अपडेट पर केंद्रित है। यदि आप चाहते हैं कि कोई बाहरी MCP क्लाइंट ACP हार्नेस सत्र होस्ट करने के बजाय सीधे OpenClaw चैनल वार्तालापों से संचार करे, तो इसके बजाय [`openclaw mcp serve`](/hi/cli/mcp) का उपयोग करें। ## यह क्या नहीं है `openclaw acp` का अर्थ है कि OpenClaw एक ACP सर्वर के रूप में कार्य करता है: कोई IDE या ACP क्लाइंट OpenClaw से कनेक्ट होता है, और OpenClaw उस कार्य को Gateway सत्र में अग्रेषित करता है। यह [ACP Agents](/hi/tools/acp-agents) से अलग है, जहाँ OpenClaw `acpx` के माध्यम से Codex या Claude Code जैसे किसी बाहरी हार्नेस को चलाता है। त्वरित नियम: - एडिटर/क्लाइंट ACP के माध्यम से OpenClaw से संचार करना चाहता है: `openclaw acp` का उपयोग करें - OpenClaw को Codex/Claude/Gemini को ACP हार्नेस के रूप में लॉन्च करना चाहिए: `/acp spawn` और [ACP Agents](/hi/tools/acp-agents) का उपयोग करें ## संगतता मैट्रिक्स | ACP क्षेत्र | स्थिति | टिप्पणियाँ | | --------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `initialize`, `newSession`, `prompt`, `cancel` | कार्यान्वित | stdio से Gateway chat/send + abort तक का मुख्य ब्रिज प्रवाह। | | `listSessions`, स्लैश कमांड | कार्यान्वित | सत्र सूची सीमित कर्सर पृष्ठांकन और `cwd` फ़िल्टरिंग के साथ Gateway सत्र स्थिति पर काम करती है, जहाँ Gateway सत्र पंक्तियों में कार्यस्थान मेटाडेटा होता है; कमांडों का विज्ञापन `available_commands_update` के माध्यम से किया जाता है। | | सत्र वंशावली मेटाडेटा | कार्यान्वित | सत्र सूचियों और सत्र जानकारी स्नैपशॉट में `_meta` में OpenClaw पैरेंट और चाइल्ड वंशावली शामिल होती है, ताकि ACP क्लाइंट निजी Gateway साइड चैनलों के बिना उप-एजेंट ग्राफ़ रेंडर कर सकें। | | `resumeSession`, `closeSession` | कार्यान्वित | फिर से शुरू करने पर इतिहास को दोबारा चलाए बिना ACP सत्र को किसी मौजूदा Gateway सत्र से फिर से बाँधा जाता है। बंद करने पर सक्रिय ब्रिज कार्य रद्द हो जाता है, लंबित प्रॉम्प्ट रद्द के रूप में हल हो जाते हैं और ब्रिज सत्र स्थिति जारी कर दी जाती है। | | `loadSession` | आंशिक | ACP सत्र को Gateway सत्र कुंजी से फिर से बाँधता है और ब्रिज द्वारा बनाए गए सत्रों के लिए ACP इवेंट-लेजर इतिहास को दोबारा चलाता है। पुराने/बिना-लेजर वाले सत्र संग्रहीत उपयोगकर्ता/सहायक टेक्स्ट पर वापस जाते हैं। | | प्रॉम्प्ट सामग्री (`text`, एम्बेडेड `resource`, छवियाँ) | आंशिक | टेक्स्ट/संसाधन चैट इनपुट में समतल हो जाते हैं; छवियाँ Gateway अटैचमेंट बन जाती हैं। | | सत्र मोड | आंशिक | `session/set_mode` समर्थित है; ब्रिज विचार स्तर, टूल वर्बोसिटी, रीजनिंग, उपयोग विवरण और उन्नत कार्रवाइयों के लिए Gateway-समर्थित सत्र नियंत्रण उपलब्ध कराता है। व्यापक ACP-नेटिव मोड/कॉन्फ़िग सतहें अभी भी दायरे से बाहर हैं। | | विचार स्ट्रीमिंग | कार्यान्वित | मॉडल की विचार सामग्री `agent_thought_chunk` सत्र अपडेट के रूप में स्ट्रीम होती है। ACP-नेटिव सत्र योजनाएँ उत्सर्जित नहीं होतीं। | | सत्र जानकारी और उपयोग अपडेट | आंशिक | ब्रिज कैश किए गए Gateway सत्र स्नैपशॉट से `session_info_update` और सर्वोत्तम-प्रयास `usage_update` सूचनाएँ उत्सर्जित करता है। उपयोग अनुमानित है और केवल तभी भेजा जाता है जब Gateway टोकन योग को ताज़ा चिह्नित किया गया हो। | | टूल स्ट्रीमिंग | आंशिक | जब Gateway टूल आर्ग्युमेंट/परिणाम उन्हें उजागर करते हैं, तब `tool_call`/`tool_call_update` इवेंट में रॉ I/O, टेक्स्ट सामग्री और सर्वोत्तम-प्रयास फ़ाइल स्थान शामिल होते हैं। एम्बेडेड टर्मिनल और अधिक समृद्ध डिफ़-नेटिव आउटपुट उपलब्ध नहीं कराए जाते। | | निष्पादन अनुमोदन | आंशिक | सक्रिय ACP प्रॉम्प्ट टर्न के दौरान Gateway निष्पादन अनुमोदन प्रॉम्प्ट `session/request_permission` के साथ ACP क्लाइंट को रिले किए जाते हैं। | | प्रति-सत्र MCP सर्वर (`mcpServers`) | असमर्थित | ब्रिज मोड प्रति-सत्र MCP सर्वर अनुरोधों को अस्वीकार करता है। इसके बजाय OpenClaw Gateway या एजेंट पर MCP कॉन्फ़िगर करें। | | क्लाइंट फ़ाइल-सिस्टम विधियाँ (`fs/read_text_file`, `fs/write_text_file`) | असमर्थित | ब्रिज ACP क्लाइंट फ़ाइल-सिस्टम विधियों को कॉल नहीं करता। | | क्लाइंट टर्मिनल विधियाँ (`terminal/*`) | असमर्थित | ब्रिज ACP क्लाइंट टर्मिनल नहीं बनाता और न ही टूल कॉल के माध्यम से टर्मिनल आईडी स्ट्रीम करता है। | ## ज्ञात सीमाएँ - `loadSession` केवल ब्रिज द्वारा बनाए गए सत्रों के लिए पूरा ACP इवेंट-लेजर इतिहास दोबारा चलाता है। पुराने/बिना-लेजर वाले सत्र ट्रांसक्रिप्ट फ़ॉलबैक का उपयोग करते हैं और ऐतिहासिक टूल कॉल या सिस्टम सूचनाओं का पुनर्निर्माण नहीं करते। - यदि कई ACP क्लाइंट समान Gateway सत्र कुंजी साझा करते हैं, तो इवेंट और रद्दीकरण रूटिंग प्रत्येक क्लाइंट के लिए सख्ती से पृथक होने के बजाय सर्वोत्तम-प्रयास होती है। जब आपको स्वच्छ एडिटर-स्थानीय टर्न चाहिए, तो डिफ़ॉल्ट पृथक `acp-bridge:` सत्रों को प्राथमिकता दें। - Gateway की रुकने की स्थितियाँ ACP रुकने के कारणों में अनूदित होती हैं, लेकिन यह मैपिंग पूर्णतः ACP-नेटिव रनटाइम की तुलना में कम अभिव्यंजक है। - सत्र नियंत्रण Gateway विकल्पों का एक केंद्रित उपसमुच्चय उपलब्ध कराते हैं: विचार स्तर, टूल वर्बोसिटी, रीजनिंग, उपयोग विवरण और उन्नत कार्रवाइयाँ। मॉडल चयन और निष्पादन-होस्ट नियंत्रण ACP कॉन्फ़िग विकल्पों के रूप में उपलब्ध नहीं हैं। - `session_info_update` और `usage_update` लाइव ACP-नेटिव रनटाइम लेखांकन के बजाय Gateway सत्र स्नैपशॉट से प्राप्त होते हैं। उपयोग अनुमानित है, इसमें लागत डेटा नहीं होता और इसे केवल तभी उत्सर्जित किया जाता है जब Gateway कुल टोकन डेटा को ताज़ा चिह्नित करता है। - टूल फ़ॉलो-अलॉन्ग डेटा सर्वोत्तम-प्रयास है: ब्रिज ज्ञात टूल आर्ग्युमेंट/परिणामों में दिखाई देने वाले फ़ाइल पथ उपलब्ध कराता है, लेकिन ACP टर्मिनल या संरचित फ़ाइल डिफ़ उत्सर्जित नहीं करता। - निष्पादन अनुमोदन रिले सक्रिय ACP प्रॉम्प्ट टर्न तक सीमित है; अन्य Gateway सत्रों के अनुमोदन अनदेखे किए जाते हैं। ## उपयोग ```bash openclaw acp # रिमोट Gateway openclaw acp --url wss://gateway-host:18789 --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 क्लाइंट (डीबग) IDE के बिना ब्रिज की सामान्य जाँच करने के लिए अंतर्निर्मित ACP क्लाइंट का उपयोग करें। यह ACP ब्रिज को स्पॉन करता है और आपको अंतःक्रियात्मक रूप से प्रॉम्प्ट टाइप करने देता है। ```bash 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" स्विच है। ## प्रोटोकॉल स्मोक परीक्षण प्रोटोकॉल-स्तरीय डीबगिंग के लिए, पृथक स्थिति वाला Gateway शुरू करें और ACP JSON-RPC क्लाइंट के साथ stdio पर `openclaw acp` संचालित करें। `initialize`, `session/new`, एक निरपेक्ष `cwd` के साथ `session/list`, `session/resume`, `session/close`, डुप्लिकेट बंद करना और अनुपस्थित पुनः आरंभ शामिल करें। प्रमाण में विज्ञापित जीवनचक्र क्षमताएँ, Gateway-समर्थित सत्र पंक्ति, अपडेट सूचनाएँ और Gateway `sessions.list` लॉग शामिल होने चाहिए: ```json { "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"] } ``` एकमात्र ACP प्रमाण के रूप में `openclaw gateway call sessions.list` का उपयोग करने से बचें। वह CLI पथ नए-टोकन ऑपरेटर स्कोप अपग्रेड का अनुरोध कर सकता है; ACP ब्रिज की शुद्धता ACP stdio फ़्रेम और Gateway `sessions.list` लॉग से प्रमाणित होती है। ## इसका उपयोग कैसे करें ACP का उपयोग तब करें जब कोई IDE (या अन्य क्लाइंट) Agent Client Protocol का उपयोग करता हो और आप चाहते हों कि वह OpenClaw Gateway सत्र को संचालित करे। 1. सुनिश्चित करें कि Gateway चल रहा है (स्थानीय या रिमोट)। 2. Gateway लक्ष्य कॉन्फ़िगर करें (कॉन्फ़िग या फ़्लैग)। 3. अपने IDE को stdio पर `openclaw acp` चलाने के लिए निर्देशित करें। उदाहरण कॉन्फ़िग (स्थायी): ```bash openclaw config set gateway.remote.url wss://gateway-host:18789 openclaw config set gateway.remote.token ``` प्रत्यक्ष रूप से चलाने का उदाहरण (कॉन्फ़िग में लिखे बिना): ```bash openclaw acp --url wss://gateway-host:18789 --token # स्थानीय प्रक्रिया सुरक्षा के लिए प्राथमिकता दें openclaw acp --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token ``` ## एजेंट चुनना ACP सीधे एजेंट नहीं चुनता। यह Gateway सत्र कुंजी के आधार पर रूट करता है। किसी विशिष्ट एजेंट को लक्षित करने के लिए एजेंट-स्कोप वाली सत्र कुंजियों का उपयोग करें: ```bash openclaw acp --session agent:main:main openclaw acp --session agent:design:main openclaw acp --session agent:qa:bug-123 ``` प्रत्येक ACP सत्र एक ही Gateway सत्र कुंजी से मैप होता है। एक एजेंट के कई सत्र हो सकते हैं; जब तक आप कुंजी या लेबल को ओवरराइड नहीं करते, ACP डिफ़ॉल्ट रूप से एक पृथक `acp-bridge:` सत्र का उपयोग करता है। ब्रिज मोड में प्रति-सत्र `mcpServers` समर्थित नहीं हैं। यदि कोई ACP क्लाइंट उन्हें `newSession` या `loadSession` के दौरान भेजता है, तो ब्रिज उन्हें चुपचाप अनदेखा करने के बजाय स्पष्ट त्रुटि लौटाता है। यदि आप चाहते हैं कि ACPX-समर्थित सत्र OpenClaw Plugin टूल या `cron` जैसे चुने हुए अंतर्निहित टूल देख सकें, तो प्रति-सत्र `mcpServers` पास करने की कोशिश करने के बजाय Gateway-साइड ACPX MCP ब्रिज सक्षम करें। [ACP एजेंट](/hi/tools/acp-agents-setup#plugin-tools-mcp-bridge) और [OpenClaw टूल MCP ब्रिज](/hi/tools/acp-agents-setup#openclaw-tools-mcp-bridge) देखें। ## `acpx` से उपयोग करें (Codex, Claude, अन्य ACP क्लाइंट) यदि आप चाहते हैं कि Codex या Claude Code जैसा कोई कोडिंग एजेंट ACP के माध्यम से आपके OpenClaw बॉट से संवाद करे, तो उसके अंतर्निहित `openclaw` लक्ष्य के साथ `acpx` का उपयोग करें। सामान्य प्रवाह: 1. Gateway चलाएँ और सुनिश्चित करें कि ACP ब्रिज उस तक पहुँच सकता है। 2. `acpx openclaw` को `openclaw acp` की ओर इंगित करें। 3. उस OpenClaw सत्र कुंजी को लक्षित करें जिसका उपयोग कोडिंग एजेंट से करवाना है। उदाहरण: ```bash # आपके डिफ़ॉल्ट OpenClaw ACP सत्र में एकल अनुरोध acpx openclaw exec "सक्रिय OpenClaw सत्र की स्थिति का सारांश दें।" # अनुवर्ती चरणों के लिए स्थायी नामित सत्र acpx openclaw sessions ensure --name codex-bridge acpx openclaw -s codex-bridge --cwd /path/to/repo \ "मेरे OpenClaw कार्य एजेंट से इस रेपो के लिए प्रासंगिक हालिया संदर्भ माँगें।" ``` यदि आप चाहते हैं कि `acpx openclaw` हर बार किसी विशिष्ट Gateway और सत्र कुंजी को लक्षित करे, तो `~/.acpx/config.json` में `openclaw` एजेंट कमांड को ओवरराइड करें: ```json { "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 चेकआउट के लिए, डेवलपमेंट रनर के बजाय सीधे CLI एंट्रीपॉइंट का उपयोग करें, ताकि ACP स्ट्रीम साफ़ रहे: ```bash 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 के Settings UI का उपयोग करें): ```json { "agent_servers": { "OpenClaw ACP": { "type": "custom", "command": "openclaw", "args": ["acp"], "env": {} } } } ``` किसी विशिष्ट Gateway या एजेंट को लक्षित करने के लिए: ```json { "agent_servers": { "OpenClaw ACP": { "type": "custom", "command": "openclaw", "args": [ "acp", "--url", "wss://gateway-host:18789", "--token", "", "--session", "agent:design:main" ], "env": {} } } } ``` Zed में, Agent पैनल खोलें और थ्रेड शुरू करने के लिए "OpenClaw ACP" चुनें। ## सत्र मैपिंग डिफ़ॉल्ट रूप से, ACP ब्रिज सत्रों को `acp-bridge:` उपसर्ग वाली पृथक Gateway सत्र कुंजी मिलती है। ये सामान्य-मॉडल ब्रिज सत्र कृत्रिम और अस्थायी होते हैं: इन पर पुराने रिकॉर्ड हटाने की प्रक्रिया लागू होती है और इन्हें संरक्षित मानवीय वार्तालाप सतह नहीं माना जाता। किसी ज्ञात सत्र का पुनः उपयोग करने के लिए सत्र कुंजी या लेबल पास करें: - `--session `: किसी विशिष्ट Gateway सत्र कुंजी का उपयोग करें। - `--session-label