ACP एजेंट — सेटअप

अवलोकन, ऑपरेटर रनबुक और अवधारणाओं के लिए, ACP एजेंट देखें।

यह पृष्ठ acpx हार्नेस कॉन्फ़िगरेशन, MCP ब्रिज के लिए Plugin सेटअप और अनुमति कॉन्फ़िगरेशन को कवर करता है।

इस पृष्ठ का उपयोग केवल ACP/acpx रूट सेट अप करते समय करें। मूल Codex ऐप-सर्वर रनटाइम कॉन्फ़िगरेशन के लिए, Codex हार्नेस का उपयोग करें। OpenAI API कुंजियों या Codex OAuth मॉडल-प्रदाता कॉन्फ़िगरेशन के लिए, OpenAI का उपयोग करें।

Codex के दो OpenClaw रूट हैं:

जब तक आपको स्पष्ट रूप से ACP/acpx व्यवहार की आवश्यकता न हो, मूल रूट को प्राथमिकता दें।

acpx हार्नेस समर्थन (वर्तमान)

अंतर्निहित acpx हार्नेस उपनाम (पिन की गई acpx निर्भरता से):

factory-droid और factorydroid भी अंतर्निहित droid अडैप्टर में रिज़ॉल्व होते हैं।

जब OpenClaw acpx बैकएंड का उपयोग करता है, तब agentId के लिए इन मानों को प्राथमिकता दें, जब तक कि आपका acpx कॉन्फ़िगरेशन कस्टम एजेंट उपनाम परिभाषित न करता हो। यदि आपका स्थानीय Cursor इंस्टॉलेशन अभी भी ACP को agent acp के रूप में उपलब्ध कराता है, तो अंतर्निहित डिफ़ॉल्ट बदलने के बजाय अपने acpx कॉन्फ़िगरेशन में cursor एजेंट कमांड को ओवरराइड करें।

प्रत्यक्ष acpx CLI उपयोग --agent <command> के माध्यम से मनमाने अडैप्टर को भी लक्षित कर सकता है, लेकिन यह अपरिष्कृत एस्केप हैच acpx CLI की सुविधा है (सामान्य OpenClaw agentId पथ नहीं)।

मॉडल नियंत्रण अडैप्टर की क्षमता पर निर्भर है। Codex ACP मॉडल संदर्भों को स्टार्टअप से पहले OpenClaw सामान्यीकृत करता है। अन्य हार्नेस को ACP models के साथ session/set_model समर्थन की आवश्यकता होती है; यदि कोई हार्नेस न तो उस ACP क्षमता को और न ही अपना स्टार्टअप मॉडल फ़्लैग उपलब्ध कराता है, तो OpenClaw/acpx मॉडल चयन बाध्य नहीं कर सकता।

आवश्यक कॉन्फ़िगरेशन

मुख्य ACP आधाररेखा:

{  acp: {    enabled: true,    // वैकल्पिक। डिफ़ॉल्ट true है; /acp नियंत्रण बनाए रखते हुए ACP प्रेषण रोकने के लिए false सेट करें।    dispatch: { enabled: true },    backend: "acpx",    defaultAgent: "codex",    allowedAgents: [      "claude",      "codex",      "copilot",      "cursor",      "droid",      "gemini",      "iflow",      "kilocode",      "kimi",      "kiro",      "openclaw",      "opencode",      "qwen",    ],    stream: {      deliveryMode: "live",    },  },}

थ्रेड बाइंडिंग कॉन्फ़िगरेशन समर्थित चैनल अडैप्टरों में साझा होता है:

{  session: {    threadBindings: {      enabled: true,      idleHours: 24,      maxAgeHours: 0,      spawnSessions: true,    },  },}

यदि थ्रेड-बाउंड ACP स्पॉन काम नहीं करता, तो पहले अडैप्टर फ़ीचर फ़्लैग सत्यापित करें:

• Discord: session.threadBindings.spawnSessions=true

वर्तमान वार्तालाप बाइंड के लिए चाइल्ड-थ्रेड निर्माण आवश्यक नहीं है। इनके लिए एक सक्रिय वार्तालाप संदर्भ और ACP वार्तालाप बाइंडिंग उपलब्ध कराने वाला चैनल अडैप्टर आवश्यक है।

कॉन्फ़िगरेशन संदर्भ देखें।

acpx बैकएंड के लिए Plugin सेटअप

पैकेज किए गए इंस्टॉलेशन ACP के लिए आधिकारिक @openclaw/acpx रनटाइम Plugin का उपयोग करते हैं। ACP हार्नेस सत्रों का उपयोग करने से पहले इसे इंस्टॉल और सक्षम करें:

openclaw plugins install @openclaw/acpxopenclaw config set plugins.entries.acpx.enabled true

स्रोत चेकआउट pnpm install के बाद स्थानीय वर्कस्पेस Plugin का भी उपयोग कर सकते हैं।

इससे शुरू करें:

/acp doctor

यदि आपने acpx अक्षम किया है, इसे plugins.allow / plugins.deny के माध्यम से अस्वीकार किया है, या पैकेज किए गए Plugin पर वापस जाना चाहते हैं, तो स्पष्ट पैकेज पथ का उपयोग करें:

openclaw plugins install @openclaw/acpxopenclaw config set plugins.entries.acpx.enabled true

विकास के दौरान स्थानीय वर्कस्पेस इंस्टॉलेशन:

openclaw plugins install ./path/to/local/acpx-plugin

फिर बैकएंड की स्थिति सत्यापित करें:

/acp doctor

acpx रनटाइम स्टार्टअप प्रोब

acpx Plugin ACP रनटाइम को सीधे एम्बेड करता है (कॉन्फ़िगर करने के लिए कोई अलग acpx बाइनरी या संस्करण नहीं)। डिफ़ॉल्ट रूप से यह Gateway स्टार्टअप के दौरान एम्बेड किए गए बैकएंड को पंजीकृत करता है और गेटवे ready संकेत से पहले स्टार्टअप प्रोब की प्रतीक्षा करता है। केवल उन स्क्रिप्ट या परिवेशों के लिए OPENCLAW_ACPX_RUNTIME_STARTUP_PROBE=0 या OPENCLAW_SKIP_ACPX_RUNTIME_PROBE=1 सेट करें जो जानबूझकर स्टार्टअप प्रोब को अक्षम रखते हैं। स्पष्ट ऑन-डिमांड प्रोब के लिए /acp doctor चलाएँ।

जब किसी पथ या फ़्लैग मान को एक argv टोकन ही रहना चाहिए, तब संरचित आर्ग्युमेंट के साथ किसी व्यक्तिगत ACP एजेंट कमांड को ओवरराइड करें:

{  "plugins": {    "entries": {      "acpx": {        "enabled": true,        "config": {          "agents": {            "claude": {              "command": "node",              "args": ["/path/to/custom adapter.mjs", "--verbose"]            }          }        }      }    }  }}

• agents.<id>.command उस ACP एजेंट के लिए निष्पादन योग्य फ़ाइल या मौजूदा कमांड स्ट्रिंग है।
• agents.<id>.args वैकल्पिक है। OpenClaw द्वारा वर्तमान acpx कमांड-स्ट्रिंग रजिस्ट्री के माध्यम से पास किए जाने से पहले प्रत्येक ऐरे आइटम को शेल-कोट किया जाता है।

Plugins देखें।

स्वचालित अडैप्टर डाउनलोड

acpx पहले उपयोग पर npx के माध्यम से ACP अडैप्टर (उदाहरण के लिए Claude और Codex ACP ब्रिज) स्वतः डाउनलोड करता है। आपको अडैप्टर पैकेज मैन्युअल रूप से इंस्टॉल करने की आवश्यकता नहीं है और स्वयं OpenClaw के लिए कोई अलग पोस्टइंस्टॉल चरण नहीं है। यदि अडैप्टर डाउनलोड या स्पॉन विफल होता है, तो /acp doctor विफलता की रिपोर्ट करता है।

Plugin टूल MCP ब्रिज

डिफ़ॉल्ट रूप से, ACPX सत्र OpenClaw Plugin द्वारा पंजीकृत टूल को ACP हार्नेस के समक्ष उपलब्ध नहीं कराते।

यदि आप चाहते हैं कि Codex या Claude Code जैसे ACP एजेंट इंस्टॉल किए गए OpenClaw Plugin टूल, जैसे मेमोरी रिकॉल/स्टोर, को कॉल करें, तो समर्पित ब्रिज सक्षम करें:

openclaw config set plugins.entries.acpx.config.pluginToolsMcpBridge true

यह क्या करता है:

• ACPX सत्र बूटस्ट्रैप में openclaw-plugin-tools नाम का एक अंतर्निहित MCP सर्वर इंजेक्ट करता है।
• इंस्टॉल और सक्षम OpenClaw Plugins द्वारा पहले से पंजीकृत Plugin टूल उपलब्ध कराता है।
• सक्रिय ACP सत्र पहचान को Plugin टूल फ़ैक्टरियों तक पहुँचाता है, ताकि एजेंट-स्कोप वाले टूल उस एजेंट के नेमस्पेस में रहें।
• सुविधा को स्पष्ट और डिफ़ॉल्ट रूप से बंद रखता है।

सुरक्षा और विश्वास संबंधी टिप्पणियाँ:

• यह ACP हार्नेस टूल सतह का विस्तार करता है।
• ACP एजेंटों को केवल गेटवे में पहले से सक्रिय Plugin टूल तक पहुँच मिलती है।
• इसे वही विश्वास सीमा मानें जो उन Plugins को स्वयं OpenClaw में निष्पादित होने की अनुमति देने पर लागू होती है।
• इसे सक्षम करने से पहले इंस्टॉल किए गए Plugins की समीक्षा करें।

कस्टम mcpServers पहले की तरह काम करते रहते हैं। अंतर्निहित Plugin-टूल ब्रिज एक अतिरिक्त ऑप्ट-इन सुविधा है, सामान्य MCP सर्वर कॉन्फ़िगरेशन का प्रतिस्थापन नहीं।

OpenClaw टूल MCP ब्रिज

डिफ़ॉल्ट रूप से, ACPX सत्र अंतर्निहित OpenClaw टूल को भी MCP के माध्यम से उपलब्ध नहीं कराते। जब किसी ACP एजेंट को cron जैसे चुनिंदा अंतर्निहित टूल की आवश्यकता हो, तब अलग कोर-टूल ब्रिज सक्षम करें:

openclaw config set plugins.entries.acpx.config.openClawToolsMcpBridge true

यह क्या करता है:

• ACPX सत्र बूटस्ट्रैप में openclaw-tools नाम का एक अंतर्निहित MCP सर्वर इंजेक्ट करता है।
• चुनिंदा अंतर्निहित OpenClaw टूल उपलब्ध कराता है। आरंभिक सर्वर cron उपलब्ध कराता है।
• कोर-टूल उपलब्धता को स्पष्ट और डिफ़ॉल्ट रूप से बंद रखता है।

रनटाइम ऑपरेशन टाइमआउट कॉन्फ़िगरेशन

acpx Plugin एम्बेड किए गए रनटाइम स्टार्टअप और नियंत्रण ऑपरेशनों को डिफ़ॉल्ट रूप से 120 सेकंड देता है। इससे Gemini CLI जैसे धीमे हार्नेस को ACP स्टार्टअप और आरंभीकरण पूरा करने के लिए पर्याप्त समय मिलता है। यदि आपके होस्ट को अलग ऑपरेशन सीमा की आवश्यकता हो, तो इसे ओवरराइड करें:

openclaw config set plugins.entries.acpx.config.timeoutSeconds 180

रनटाइम टर्न OpenClaw एजेंट/रन टाइमआउट का उपयोग करते हैं, जिनमें /acp timeout शामिल है। sessions_spawn प्रति-कॉल टाइमआउट ओवरराइड स्वीकार नहीं करता; ऑपरेटर पथ agents.defaults.subagents.runTimeoutSeconds है। timeoutSeconds बदलने के बाद गेटवे पुनः आरंभ करें।

हेल्थ प्रोब एजेंट कॉन्फ़िगरेशन

जब /acp doctor या स्टार्टअप प्रोब बैकएंड की जाँच करता है, तब बंडल किया गया acpx Plugin एक हार्नेस एजेंट को प्रोब करता है। यदि acp.allowedAgents सेट है, तो यह डिफ़ॉल्ट रूप से पहला अनुमत एजेंट होता है; अन्यथा डिफ़ॉल्ट codex होता है। यदि आपके परिनियोजन को स्वास्थ्य जाँच के लिए किसी अन्य ACP एजेंट की आवश्यकता है, तो प्रोब एजेंट स्पष्ट रूप से सेट करें:

openclaw config set plugins.entries.acpx.config.probeAgent claude

इस मान को बदलने के बाद गेटवे पुनः आरंभ करें।

अनुमति कॉन्फ़िगरेशन

ACP सत्र गैर-इंटरैक्टिव रूप से चलते हैं—फ़ाइल-लेखन और शेल-निष्पादन अनुमति प्रॉम्प्ट को स्वीकृत या अस्वीकृत करने के लिए कोई TTY नहीं होता। acpx Plugin दो कॉन्फ़िगरेशन कुंजियाँ प्रदान करता है, जो यह नियंत्रित करती हैं कि अनुमतियों को कैसे संभाला जाए:

ये ACPX हार्नेस अनुमतियाँ OpenClaw exec अनुमोदनों से अलग हैं और Claude CLI --permission-mode bypassPermissions जैसे CLI-बैकएंड विक्रेता बायपास फ़्लैग से भी अलग हैं। ACPX approve-all ACP सत्रों के लिए हार्नेस-स्तरीय आपातकालीन स्विच है।

OpenClaw tools.exec.mode, Codex Guardian अनुमोदनों और ACPX हार्नेस अनुमतियों के बीच व्यापक तुलना के लिए, अनुमति मोड देखें।

permissionMode

यह नियंत्रित करता है कि हार्नेस एजेंट बिना संकेत दिए कौन-से संचालन कर सकता है।

nonInteractivePermissions

यह नियंत्रित करता है कि जब अनुमति संकेत दिखाया जाना हो, लेकिन कोई इंटरैक्टिव TTY उपलब्ध न हो (ACP सत्रों में हमेशा यही स्थिति होती है), तब क्या होता है।

कॉन्फ़िगरेशन

Plugin कॉन्फ़िगरेशन के माध्यम से सेट करें:

openclaw config set plugins.entries.acpx.config.permissionMode approve-allopenclaw config set plugins.entries.acpx.config.nonInteractivePermissions fail

इन मानों को बदलने के बाद Gateway पुनः आरंभ करें।

संबंधित

• ACP एजेंट — अवलोकन, ऑपरेटर रनबुक, अवधारणाएँ
• उप-एजेंट
• बहु-एजेंट रूटिंग