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

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

नीचे दिए गए अनुभाग acpx हार्नेस कॉन्फ़िग, MCP ब्रिज के लिए Plugin सेटअप, और अनुमति कॉन्फ़िगरेशन को कवर करते हैं।

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

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

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

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

वर्तमान acpx बिल्ट-इन हार्नेस उपनाम:

• claude
• codex
• copilot
• cursor (Cursor CLI: cursor-agent acp)
• droid
• gemini
• iflow
• kilocode
• kimi
• kiro
• openclaw
• opencode
• qwen

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

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

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

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

कोर ACP बेसलाइन:

{  acp: {    enabled: true,    // Optional. Default is true; set false to pause ACP dispatch while keeping /acp controls.    dispatch: { enabled: true },    backend: "acpx",    defaultAgent: "codex",    allowedAgents: [      "claude",      "codex",      "copilot",      "cursor",      "droid",      "gemini",      "iflow",      "kilocode",      "kimi",      "kiro",      "openclaw",      "opencode",      "openclaw",      "qwen",    ],    maxConcurrentSessions: 8,    stream: {      coalesceIdleMs: 300,      maxChunkChars: 1200,    },    runtime: {      ttlMinutes: 120,    },  },}

थ्रेड बाइंडिंग कॉन्फ़िग चैनल-adapter विशिष्ट है। Discord के लिए उदाहरण:

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

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

• Discord: channels.discord.threadBindings.spawnSessions=true

वर्तमान-वार्तालाप binds को child-thread निर्माण की आवश्यकता नहीं होती। उन्हें एक सक्रिय वार्तालाप संदर्भ और ACP वार्तालाप बाइंडिंग प्रदर्शित करने वाला चैनल adapter चाहिए।

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

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

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

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

Source checkouts pnpm install के बाद स्थानीय workspace Plugin का भी उपयोग कर सकते हैं।

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

/acp doctor

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

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

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

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

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

/acp doctor

acpx कमांड और संस्करण कॉन्फ़िगरेशन

डिफ़ॉल्ट रूप से, acpx Plugin Gateway स्टार्टअप के दौरान embedded ACP बैकएंड पंजीकृत करता है और gateway ready संकेत से पहले embedded रनटाइम स्टार्टअप probe की प्रतीक्षा करता है। OPENCLAW_ACPX_RUNTIME_STARTUP_PROBE=0 या OPENCLAW_SKIP_ACPX_RUNTIME_PROBE=1 केवल उन scripts या environments के लिए सेट करें जो जानबूझकर स्टार्टअप probe को अक्षम रखते हैं। स्पष्ट on-demand probe के लिए /acp doctor चलाएँ।

Plugin कॉन्फ़िग में कमांड या संस्करण ओवरराइड करें:

{  "plugins": {    "entries": {      "acpx": {        "enabled": true,        "config": {          "command": "../acpx/dist/cli.js",          "expectedVersion": "any"        }      }    }  }}

• command एक absolute path, relative path (OpenClaw workspace से resolved), या command name स्वीकार करता है।
• expectedVersion: "any" सख्त version matching अक्षम करता है।
• कस्टम command पथ plugin-local auto-install अक्षम करते हैं।

जब किसी path या flag value को एक argv token ही रहना चाहिए, तो structured arguments के साथ किसी एक ACP एजेंट कमांड को ओवरराइड करें:

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

• agents.<id>.command उस ACP एजेंट के लिए executable या मौजूदा command string है।
• agents.<id>.args वैकल्पिक है। OpenClaw द्वारा उसे वर्तमान acpx command-string registry से गुजारने से पहले हर array item को shell-quoted किया जाता है।

Plugins देखें।

स्वचालित dependency इंस्टॉल

जब आप npm install -g openclaw के साथ OpenClaw globally इंस्टॉल करते हैं, तो acpx रनटाइम dependencies (platform-specific binaries) postinstall hook के माध्यम से स्वचालित रूप से इंस्टॉल होती हैं। यदि स्वचालित इंस्टॉल विफल होता है, तो gateway फिर भी सामान्य रूप से शुरू होता है और openclaw acp doctor के माध्यम से missing dependency रिपोर्ट करता है।

Plugin tools MCP ब्रिज

डिफ़ॉल्ट रूप से, ACPX सेशन OpenClaw Plugin-registered tools को ACP हार्नेस के सामने expose नहीं करते।

यदि आप चाहते हैं कि Codex या Claude Code जैसे ACP एजेंट installed OpenClaw Plugin tools जैसे memory recall/store को कॉल करें, तो समर्पित bridge सक्षम करें:

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

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

• ACPX सेशन bootstrap में openclaw-plugin-tools नाम का बिल्ट-इन MCP सर्वर inject करता है।
• installed और enabled OpenClaw plugins द्वारा पहले से registered plugin tools expose करता है।
• सुविधा को explicit और default-off रखता है।

सुरक्षा और trust notes:

• यह ACP हार्नेस tool surface का विस्तार करता है।
• ACP एजेंट को केवल gateway में पहले से active plugin tools तक पहुंच मिलती है।
• इसे वैसी ही trust boundary मानें जैसी उन plugins को OpenClaw में ही execute करने देने की होती है।
• इसे सक्षम करने से पहले installed plugins की समीक्षा करें।

कस्टम mcpServers पहले की तरह काम करते रहते हैं। बिल्ट-इन plugin-tools bridge एक अतिरिक्त opt-in सुविधा है, generic MCP server config का replacement नहीं।

OpenClaw tools MCP ब्रिज

डिफ़ॉल्ट रूप से, ACPX सेशन built-in OpenClaw tools को भी MCP के माध्यम से expose नहीं करते। जब किसी ACP एजेंट को cron जैसे selected built-in tools चाहिए हों, तो अलग core-tools bridge सक्षम करें:

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

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

• ACPX सेशन bootstrap में openclaw-tools नाम का बिल्ट-इन MCP सर्वर inject करता है।
• selected built-in OpenClaw tools expose करता है। प्रारंभिक server cron expose करता है।
• core-tool exposure को explicit और default-off रखता है।

रनटाइम operation timeout कॉन्फ़िगरेशन

acpx Plugin embedded रनटाइम स्टार्टअप और control operations को डिफ़ॉल्ट रूप से 120 सेकंड देता है। इससे Gemini CLI जैसे धीमे हार्नेस को ACP स्टार्टअप और initialization पूरा करने के लिए पर्याप्त समय मिलता है। यदि आपके host को अलग operation limit चाहिए, तो इसे ओवरराइड करें:

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

रनटाइम turns OpenClaw agent/run timeouts का उपयोग करते हैं, जिसमें /acp timeout शामिल है। sessions_spawn per-call timeout overrides स्वीकार नहीं करता। यह मान बदलने के बाद gateway restart करें।

Health probe एजेंट कॉन्फ़िगरेशन

जब /acp doctor या startup probe बैकएंड जाँचता है, तो bundled acpx Plugin एक हार्नेस एजेंट को probe करता है। यदि acp.allowedAgents सेट है, तो यह डिफ़ॉल्ट रूप से पहले allowed agent पर जाता है; अन्यथा यह डिफ़ॉल्ट रूप से codex पर जाता है। यदि आपके deployment को health checks के लिए अलग ACP एजेंट चाहिए, तो probe agent स्पष्ट रूप से सेट करें:

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

यह मान बदलने के बाद gateway restart करें।

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

ACP सेशन non-interactively चलते हैं — file-write और shell-exec अनुमति prompts को approve या deny करने के लिए कोई TTY नहीं होता। acpx Plugin दो config keys प्रदान करता है जो नियंत्रित करती हैं कि permissions कैसे संभाली जाएँ:

ये ACPX हार्नेस permissions OpenClaw exec approvals से अलग हैं और Claude CLI --permission-mode bypassPermissions जैसे CLI-backend vendor bypass flags से भी अलग हैं। ACPX approve-all ACP सेशन के लिए harness-level break-glass switch है।

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

permissionMode

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

nonInteractivePermissions

नियंत्रित करता है कि जब permission prompt दिखाया जाता, लेकिन कोई interactive TTY उपलब्ध नहीं होता, तब क्या होता है (जो ACP सेशन के लिए हमेशा होता है)।

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

Plugin config के माध्यम से सेट करें:

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

इन मानों को बदलने के बाद gateway restart करें।

संबंधित

• ACP एजेंट — overview, operator runbook, concepts
• उप-एजेंट
• बहु-एजेंट routing