​

وكلاء ACP

​

أي صفحة أريد؟

​

هل يعمل هذا مباشرةً بعد التثبيت؟

• تأتي التثبيتات الجديدة الآن مع plugin وقت التشغيل المضمّن acpx مفعّلًا افتراضيًا.
• يفضّل plugin ‏acpx المضمّن ملفه التنفيذي acpx المثبّت محليًا داخل plugin.
• عند بدء التشغيل، يفحص OpenClaw هذا الملف التنفيذي ويصلحه ذاتيًا عند الحاجة.
• ابدأ بـ /acp doctor إذا أردت فحص جاهزية سريعًا.

• قد يتم جلب مهايئ الحزمة الهدف عند الطلب باستخدام npx في أول مرة تستخدم فيها تلك الحزمة.
• لا يزال يجب أن تكون مصادقة المورّد موجودة على المضيف لتلك الحزمة.
• إذا لم يكن لدى المضيف وصول إلى npm/الشبكة، فقد تفشل عمليات جلب المهايئات في أول تشغيل حتى يتم تدفئة الذاكرات المؤقتة مسبقًا أو تثبيت المهايئ بطريقة أخرى.

• /acp spawn codex: يجب أن يكون OpenClaw جاهزًا لتمهيد acpx، لكن مهايئ Codex ACP قد يظل بحاجة إلى جلب في أول تشغيل.
• /acp spawn claude: الأمر نفسه بالنسبة إلى مهايئ Claude ACP، بالإضافة إلى مصادقة Claude على ذلك المضيف.

​

تدفق تشغيل سريع للمشغّل

1. أنشئ جلسة:
   • /acp spawn codex --bind here
   • /acp spawn codex --mode persistent --thread auto
2. اعمل في المحادثة أو سلسلة المحادثة المرتبطة (أو استهدف مفتاح تلك الجلسة صراحةً).
3. تحقّق من حالة وقت التشغيل:
   • /acp status
4. اضبط خيارات وقت التشغيل حسب الحاجة:
   • /acp model <provider/model>
   • /acp permissions <profile>
   • /acp timeout <seconds>
5. وجّه جلسة نشطة من دون استبدال السياق:
   • /acp steer tighten logging and continue
6. أوقف العمل:
   • /acp cancel (إيقاف الدور الحالي)، أو
   • /acp close (إغلاق الجلسة + إزالة الارتباطات)

​

بداية سريعة للبشر

• “اربط قناة Discord هذه بـ Codex.”
• “ابدأ جلسة Codex دائمة في سلسلة محادثة هنا وأبقها مركزة.”
• “شغّل هذا كجلسة Claude Code ACP لمرة واحدة ولخّص النتيجة.”
• “اربط دردشة iMessage هذه بـ Codex وأبق المتابعات في مساحة العمل نفسها.”
• “استخدم Gemini CLI لهذه المهمة في سلسلة محادثة، ثم أبق المتابعات في تلك السلسلة نفسها.”

1. يختار runtime: "acp".
2. يحل هدف الحزمة المطلوب (agentId، مثل codex).
3. إذا طُلب ربط المحادثة الحالية وكان القناة النشطة تدعمه، يربط جلسة ACP بتلك المحادثة.
4. وإلا، إذا طُلب ربط سلسلة محادثة وكانت القناة الحالية تدعمه، يربط جلسة ACP بسلسلة المحادثة.
5. يوجّه رسائل المتابعة المرتبطة إلى جلسة ACP نفسها حتى يتم إلغاء التركيز/الإغلاق/الانتهاء.

​

ACP مقابل الوكلاء الفرعيين

​

كيف يشغّل ACP ‏Claude Code

1. طبقة التحكم في جلسة OpenClaw ACP
2. plugin وقت التشغيل المضمّن acpx
3. مهايئ Claude ACP
4. وقت تشغيل/آلية جلسة Claude على جانبه

• Claude عبر ACP ليس هو نفسه وقت التشغيل الاحتياطي المباشر claude-cli/....
• Claude عبر ACP هو جلسة حزمة تتضمن عناصر تحكم ACP، واستئناف الجلسة، وتتبع مهام الخلفية، وربطًا اختياريًا بالمحادثة/سلسلة المحادثة.
• claude-cli/... هو واجهة CLI خلفية محلية نصية فقط. راجع واجهات CLI الخلفية.

• إذا كنت تريد /acp spawn، أو جلسات قابلة للربط، أو عناصر تحكم وقت التشغيل، أو عمل حزمة دائم: استخدم ACP
• إذا كنت تريد احتياطيًا نصيًا محليًا بسيطًا عبر CLI الخام: استخدم واجهات CLI الخلفية

​

الجلسات المرتبطة

​

الارتباطات بالمحادثة الحالية

• يحتفظ OpenClaw بملكية نقل القناة، والمصادقة، والأمان، والتسليم.
• تُثبَّت المحادثة الحالية على مفتاح جلسة ACP التي أُنشئت.
• تُوجَّه رسائل المتابعة في تلك المحادثة إلى جلسة ACP نفسها.
• يعيد /new و/reset ضبط جلسة ACP المرتبطة نفسها في مكانها.
• يغلق /acp close الجلسة ويزيل ارتباط المحادثة الحالية.

• يبقي --bind here سطح الدردشة نفسه. ففي Discord، تبقى القناة الحالية هي القناة الحالية.
• يمكن لـ --bind here مع ذلك إنشاء جلسة ACP جديدة إذا كنت تنشئ عملًا جديدًا. يقوم الربط بإلحاق تلك الجلسة بالمحادثة الحالية.
• لا ينشئ --bind here سلسلة Discord فرعية أو موضوع Telegram بحد ذاته.
• يمكن لوقت تشغيل ACP أن يمتلك مع ذلك دليل عمل خاصًا به (cwd) أو مساحة عمل يديرها الـ backend على القرص. وهذه مساحة عمل وقت تشغيل منفصلة عن سطح الدردشة ولا تعني إنشاء سلسلة رسائل جديدة.
• إذا أنشأت جلسة لوكيل ACP مختلف ولم تمرّر --cwd، فإن OpenClaw يرث مساحة عمل الوكيل الهدف افتراضيًا، وليس مساحة عمل الطالب.
• إذا كان مسار مساحة العمل الموروثة هذا مفقودًا (ENOENT/ENOTDIR)، فإن OpenClaw يعود إلى cwd الافتراضي للواجهة الخلفية بدلًا من إعادة استخدام الشجرة الخاطئة بصمت.
• إذا كانت مساحة العمل الموروثة موجودة ولكن لا يمكن الوصول إليها (مثل EACCES)، فإن الإنشاء يعيد خطأ الوصول الحقيقي بدلًا من إسقاط cwd.

• سطح الدردشة: المكان الذي يواصل فيه الناس الكلام (قناة Discord، موضوع Telegram، دردشة iMessage)
• جلسة ACP: حالة وقت تشغيل Codex/Claude/Gemini الدائمة التي يوجّه إليها OpenClaw
• سلسلة/موضوع فرعي: سطح مراسلة إضافي اختياري يُنشأ فقط بواسطة --thread ...
• مساحة عمل وقت التشغيل: الموقع في نظام الملفات الذي تعمل فيه الحزمة (cwd، أو نسخة المستودع، أو مساحة عمل الواجهة الخلفية)

• /acp spawn codex --bind here: أبقِ هذه الدردشة، وأنشئ أو أرفق جلسة Codex ACP، ووجّه الرسائل المستقبلية هنا إليها
• /acp spawn codex --thread auto: قد ينشئ OpenClaw سلسلة/موضوعًا فرعيًا ويربط جلسة ACP هناك
• /acp spawn codex --bind here --cwd /workspace/repo: الربط بالدردشة نفسها كما أعلاه، لكن Codex يعمل في /workspace/repo

• يمكن لقنوات الدردشة/الرسائل التي تعلن دعم ربط المحادثة الحالية استخدام --bind here عبر مسار الربط المشترك للمحادثات.
• يمكن للقنوات ذات دلالات السلاسل/الموضوعات المخصصة أن توفّر مع ذلك تسوية خاصة بالقناة خلف الواجهة المشتركة نفسها.
• يعني --bind here دائمًا “اربط المحادثة الحالية في مكانها”.
• تستخدم الارتباطات العامة بالمحادثة الحالية مخزن الارتباطات المشترك في OpenClaw وتبقى بعد عمليات إعادة تشغيل gateway العادية.

• لا يمكن الجمع بين --bind here و--thread ... في /acp spawn.
• في Discord، يربط --bind here القناة أو السلسلة الحالية في مكانها. ولا يكون spawnAcpSessions مطلوبًا إلا عندما يحتاج OpenClaw إلى إنشاء سلسلة فرعية باستخدام --thread auto|here.
• إذا لم تكشف القناة النشطة عن ارتباطات ACP للمحادثة الحالية، يعيد OpenClaw رسالة عدم دعم واضحة.
• أسئلة resume و”الجلسة الجديدة” هي أسئلة جلسة ACP وليست أسئلة قناة. يمكنك إعادة استخدام حالة وقت التشغيل أو استبدالها من دون تغيير سطح الدردشة الحالي.

​

الجلسات المرتبطة بسلسلة محادثة

• يربط OpenClaw سلسلة محادثة بجلسة ACP مستهدفة.
• تُوجَّه رسائل المتابعة في تلك السلسلة إلى جلسة ACP المرتبطة.
• يُعاد تسليم مخرجات ACP إلى السلسلة نفسها.
• تؤدي إزالة التركيز/الإغلاق/الأرشفة/انتهاء مهلة الخمول أو انتهاء العمر الأقصى إلى إزالة الارتباط.

• acp.enabled=true
• acp.dispatch.enabled مفعّل افتراضيًا (اضبطه على false لإيقاف توجيه ACP مؤقتًا)
• تفعيل علم إنشاء سلسلة ACP في مهايئ القناة (خاص بالمهايئ)
  • Discord: ‏channels.discord.threadBindings.spawnAcpSessions=true
  • Telegram: ‏channels.telegram.threadBindings.spawnAcpSessions=true

​

القنوات التي تدعم السلاسل

• أي مهايئ قناة يكشف قدرة ربط الجلسة/السلسلة.
• الدعم المضمّن الحالي:
  • سلاسل/قنوات Discord
  • مواضيع Telegram ‏(مواضيع المنتدى في المجموعات/المجموعات الخارقة ومواضيع الرسائل الخاصة)
• يمكن لقنوات plugin إضافة الدعم عبر واجهة الربط نفسها.

​

إعدادات خاصة بالقناة

​

نموذج الربط

• يضع bindings[].type="acp" علامة على ربط محادثة ACP دائم.
• يحدّد bindings[].match المحادثة الهدف:
  • قناة أو سلسلة Discord: ‏match.channel="discord" + ‏match.peer.id="<channelOrThreadId>"
  • موضوع منتدى Telegram: ‏match.channel="telegram" + ‏match.peer.id="<chatId>:topic:<topicId>"
  • دردشة BlueBubbles الخاصة/الجماعية: ‏match.channel="bluebubbles" + ‏match.peer.id="<handle|chat_id:*|chat_guid:*|chat_identifier:*>" فضّل chat_id:* أو chat_identifier:* للارتباطات الجماعية المستقرة.
  • دردشة iMessage الخاصة/الجماعية: ‏match.channel="imessage" + ‏match.peer.id="<handle|chat_id:*|chat_guid:*|chat_identifier:*>" فضّل chat_id:* للارتباطات الجماعية المستقرة.
• bindings[].agentId هو معرّف وكيل OpenClaw المالك.
• تعيش تجاوزات ACP الاختيارية تحت bindings[].acp:
  • mode ‏(persistent أو oneshot)
  • label
  • cwd
  • backend

​

الإعدادات الافتراضية لوقت التشغيل لكل وكيل

• agents.list[].runtime.type="acp"
• agents.list[].runtime.acp.agent ‏(معرّف الحزمة، مثل codex أو claude)
• agents.list[].runtime.acp.backend
• agents.list[].runtime.acp.mode
• agents.list[].runtime.acp.cwd

1. bindings[].acp.*
2. agents.list[].runtime.acp.*
3. إعدادات ACP العامة الافتراضية (مثل acp.backend)

{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: {
            agent: "codex",
            backend: "acpx",
            mode: "persistent",
            cwd: "/workspace/openclaw",
          },
        },
      },
      {
        id: "claude",
        runtime: {
          type: "acp",
          acp: { agent: "claude", backend: "acpx", mode: "persistent" },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "discord",
        accountId: "default",
        peer: { kind: "channel", id: "222222222222222222" },
      },
      acp: { label: "codex-main" },
    },
    {
      type: "acp",
      agentId: "claude",
      match: {
        channel: "telegram",
        accountId: "default",
        peer: { kind: "group", id: "-1001234567890:topic:42" },
      },
      acp: { cwd: "/workspace/repo-b" },
    },
    {
      type: "route",
      agentId: "main",
      match: { channel: "discord", accountId: "default" },
    },
    {
      type: "route",
      agentId: "main",
      match: { channel: "telegram", accountId: "default" },
    },
  ],
  channels: {
    discord: {
      guilds: {
        "111111111111111111": {
          channels: {
            "222222222222222222": { requireMention: false },
          },
        },
      },
    },
    telegram: {
      groups: {
        "-1001234567890": {
          topics: { "42": { requireMention: false } },
        },
      },
    },
  },
}

• يضمن OpenClaw وجود جلسة ACP المضبوطة قبل الاستخدام.
• تُوجَّه الرسائل في تلك القناة أو الموضوع إلى جلسة ACP المضبوطة.
• في المحادثات المرتبطة، يعيد /new و/reset ضبط مفتاح جلسة ACP نفسه في مكانه.
• تظل ارتباطات وقت التشغيل المؤقتة (مثل التي تنشئها تدفقات التركيز على سلسلة محادثة) مطبّقة عند وجودها.
• في عمليات إنشاء ACP عبر وكلاء متعددة من دون cwd صريح، يرث OpenClaw مساحة عمل الوكيل الهدف من إعدادات الوكيل.
• تعود مسارات مساحة العمل الموروثة المفقودة إلى cwd الافتراضي للواجهة الخلفية؛ أما حالات فشل الوصول للمسارات الموجودة فتظهر كأخطاء إنشاء.

​

بدء جلسات ACP ‏(الواجهات)

​

من sessions_spawn

{
  "task": "Open the repo and summarize failing tests",
  "runtime": "acp",
  "agentId": "codex",
  "thread": true,
  "mode": "session"
}

• تكون القيمة الافتراضية لـ runtime هي subagent، لذا اضبط runtime: "acp" صراحةً لجلسات ACP.
• إذا تم حذف agentId، يستخدم OpenClaw القيمة acp.defaultAgent عند ضبطها.
• يتطلب mode: "session" أن يكون thread: true للاحتفاظ بمحادثة مرتبطة دائمة.

• task ‏(مطلوب): الموجّه الأولي المرسَل إلى جلسة ACP.
• runtime ‏(مطلوب لـ ACP): يجب أن يكون "acp".
• agentId ‏(اختياري): معرّف حزمة ACP الهدف. يعود إلى acp.defaultAgent إذا كانت مضبوطة.
• thread ‏(اختياري، الافتراضي false): طلب تدفق ربط سلسلة محادثة حيثما كان مدعومًا.
• mode ‏(اختياري): run ‏(لمرة واحدة) أو session ‏(دائم).
  • القيمة الافتراضية هي run
  • إذا كان thread: true وتم حذف النمط، فقد يستخدم OpenClaw سلوكًا دائمًا افتراضيًا بحسب مسار وقت التشغيل
  • يتطلب mode: "session" أن يكون thread: true
• cwd ‏(اختياري): دليل العمل المطلوب لوقت التشغيل (تتحقق منه سياسة الـ backend/وقت التشغيل). وإذا تم حذفه، يرث إنشاء ACP مساحة عمل الوكيل الهدف عند ضبطها؛ وتعاد المسارات الموروثة المفقودة إلى إعدادات backend الافتراضية، بينما تُعاد أخطاء الوصول الحقيقية.
• label ‏(اختياري): تسمية موجهة للمشغّل تُستخدم في نص الجلسة/اللافتة.
• resumeSessionId ‏(اختياري): استئناف جلسة ACP موجودة بدلًا من إنشاء جلسة جديدة. يعيد الوكيل تشغيل محفوظات المحادثة عبر session/load. ويتطلب runtime: "acp".
• streamTo ‏(اختياري): "parent" يبث ملخصات تقدم تشغيل ACP الأولي إلى جلسة الطالب على هيئة أحداث نظام.
  • عند توفره، قد تتضمن الردود المقبولة streamLogPath يشير إلى سجل JSONL خاص بالنطاق (<sessionId>.acp-stream.jsonl) يمكنك متابعته للاطلاع على كامل سجل الترحيل.

​

استئناف جلسة موجودة

{
  "task": "Continue where we left off — fix the remaining test failures",
  "runtime": "acp",
  "agentId": "codex",
  "resumeSessionId": "<previous-session-id>"
}

• تسليم جلسة Codex من حاسوبك المحمول إلى هاتفك — اطلب من وكيلك أن يكمل من حيث توقفت
• متابعة جلسة برمجة بدأتَها تفاعليًا في CLI، لكن الآن من دون واجهة مباشرة عبر وكيلك
• متابعة عمل انقطع بسبب إعادة تشغيل gateway أو انتهاء مهلة الخمول

• يتطلب resumeSessionId ‏runtime: "acp" — ويعيد خطأ إذا استُخدم مع وقت تشغيل الوكيل الفرعي.
• يعيد resumeSessionId محفوظات المحادثة في ACP من الجهة العليا؛ بينما يظل thread وmode مطبّقين بشكل طبيعي على جلسة OpenClaw الجديدة التي تنشئها، لذا يظل mode: "session" يتطلب thread: true.
• يجب أن يدعم الوكيل الهدف session/load ‏(Codex وClaude Code يفعلان ذلك).
• إذا لم يُعثر على معرّف الجلسة، يفشل الإنشاء بخطأ واضح — من دون رجوع صامت إلى جلسة جديدة.

​

اختبار دخاني للمشغّل

1. تحقّق من إصدار/التزام gateway المنشور على المضيف الهدف.
2. أكّد أن المصدر المنشور يتضمن قبول سلالة ACP في src/gateway/sessions-patch.ts ‏(subagent:* or acp:* sessions).
3. افتح جلسة جسر ACPX مؤقتة إلى وكيل مباشر (مثل razor(main) على jpclawhq).
4. اطلب من ذلك الوكيل استدعاء sessions_spawn بالقيم التالية:
   • runtime: "acp"
   • agentId: "codex"
   • mode: "run"
   • المهمة: Reply with exactly LIVE-ACP-SPAWN-OK
5. تحقّق من أن الوكيل يبلّغ عن:
   • accepted=yes
   • childSessionKey حقيقي
   • لا يوجد خطأ تحقق
6. نظّف جلسة جسر ACPX المؤقتة.

Use the sessions_spawn tool now with runtime: "acp", agentId: "codex", and mode: "run".
Set the task to: "Reply with exactly LIVE-ACP-SPAWN-OK".
Then report only: accepted=<yes/no>; childSessionKey=<value or none>; error=<exact text or none>.

• أبقِ هذا الاختبار الدخاني على mode: "run" ما لم تكن تختبر عمدًا جلسات ACP دائمة مرتبطة بسلسلة محادثة.
• لا تشترط streamTo: "parent" للبوابة الأساسية. فهذا المسار يعتمد على قدرات جلسة/الطالب وهو فحص تكاملي منفصل.
• تعامل مع اختبار mode: "session" المرتبط بسلسلة محادثة على أنه تمرير تكاملي ثانٍ وأكثر غنى من سلسلة Discord حقيقية أو موضوع Telegram.

​

التوافق مع sandbox

• إذا كانت جلسة الطالب داخل sandbox، يتم حظر عمليات إنشاء ACP لكل من sessions_spawn({ runtime: "acp" }) و/acp spawn.
  • الخطأ: Sandboxed sessions cannot spawn ACP sessions because runtime="acp" runs on the host. Use runtime="subagent" from sandboxed sessions.
• لا يدعم sessions_spawn مع runtime: "acp" القيمة sandbox: "require".
  • الخطأ: sessions_spawn sandbox="require" is unsupported for runtime="acp" because ACP sessions run outside the sandbox. Use runtime="subagent" or sandbox="inherit".

​

من أمر /acp

/acp spawn codex --mode persistent --thread auto
/acp spawn codex --mode oneshot --thread off
/acp spawn codex --bind here
/acp spawn codex --thread here

• --mode persistent|oneshot
• --bind here|off
• --thread auto|here|off
• --cwd <absolute-path>
• --label <name>

​

حل هدف الجلسة

1. وسيطة الهدف الصريحة (أو --session في /acp steer)
   • يحاول أولًا المفتاح
   • ثم session id على شكل UUID
   • ثم التسمية
2. ارتباط سلسلة المحادثة الحالية (إذا كانت هذه المحادثة/السلسلة مرتبطة بجلسة ACP)
3. الرجوع إلى جلسة الطالب الحالية

​

أوضاع ربط الإنشاء

• --bind here هو أبسط مسار للمشغّل لعبارة “اجعل هذه القناة أو الدردشة مدعومة بواسطة Codex.”
• لا ينشئ --bind here سلسلة فرعية.
• يتوفر --bind here فقط في القنوات التي تكشف دعم الربط بالمحادثة الحالية.
• لا يمكن الجمع بين --bind و--thread في استدعاء /acp spawn نفسه.

​

أوضاع سلاسل الإنشاء

• على الأسطح التي لا تدعم ربط السلاسل، يكون السلوك الافتراضي فعليًا هو off.
• يتطلب الإنشاء المرتبط بسلسلة دعم سياسة القناة:
  • Discord: ‏channels.discord.threadBindings.spawnAcpSessions=true
  • Telegram: ‏channels.telegram.threadBindings.spawnAcpSessions=true
• استخدم --bind here عندما تريد تثبيت المحادثة الحالية من دون إنشاء سلسلة فرعية.

​

عناصر تحكم ACP

• /acp spawn
• /acp cancel
• /acp steer
• /acp close
• /acp status
• /acp set-mode
• /acp set
• /acp cwd
• /acp permissions
• /acp timeout
• /acp model
• /acp reset-options
• /acp sessions
• /acp doctor
• /acp install

​

كتاب وصفات أوامر ACP

​

تعيين خيارات وقت التشغيل

• ‏/acp model <id> تُعيَّن إلى مفتاح إعداد وقت التشغيل model.
• ‏/acp permissions <profile> تُعيَّن إلى مفتاح إعداد وقت التشغيل approval_policy.
• ‏/acp timeout <seconds> تُعيَّن إلى مفتاح إعداد وقت التشغيل timeout.
• ‏/acp cwd <path> يحدّث تجاوز cwd لوقت التشغيل مباشرةً.
• ‏/acp set <key> <value> هو المسار العام.
  • حالة خاصة: تستخدم key=cwd مسار تجاوز cwd.
• ‏/acp reset-options يمسح كل تجاوزات وقت التشغيل للجلسة الهدف.

​

دعم حِزم acpx ‏(الحالي)

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

​

الإعدادات المطلوبة

{
  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",
      "pi",
      "qwen",
    ],
    maxConcurrentSessions: 8,
    stream: {
      coalesceIdleMs: 300,
      maxChunkChars: 1200,
    },
    runtime: {
      ttlMinutes: 120,
    },
  },
}

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

• Discord: ‏channels.discord.threadBindings.spawnAcpSessions=true

​

إعداد plugin للواجهة الخلفية acpx

/acp doctor

openclaw plugins install acpx
openclaw config set plugins.entries.acpx.enabled true

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

/acp doctor

​

إعداد الأمر والإصدار لـ acpx

1. يكون الأمر افتراضيًا هو node_modules/.bin/acpx المحلي داخل حزمة ACPX plugin.
2. يكون الإصدار المتوقع افتراضيًا هو الإصدار المثبّت في extension.
3. عند بدء التشغيل، يتم تسجيل واجهة ACP الخلفية فورًا على أنها غير جاهزة.
4. تتحقق مهمة ضمان في الخلفية من acpx --version.
5. إذا كان الملف التنفيذي المحلي داخل plugin مفقودًا أو لا يطابق الإصدار، فإنه يشغّل: npm install --omit=dev --no-save acpx@<pinned> ثم يعيد التحقق.

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

• يقبل command مسارًا مطلقًا، أو مسارًا نسبيًا، أو اسم أمر (acpx).
• تُحل المسارات النسبية انطلاقًا من دليل مساحة عمل OpenClaw.
• يؤدي expectedVersion: "any" إلى تعطيل المطابقة الصارمة للإصدار.
• عندما يشير command إلى ملف تنفيذي/مسار مخصص، يتم تعطيل التثبيت التلقائي المحلي داخل plugin.
• يظل بدء تشغيل OpenClaw غير حاجب أثناء تنفيذ فحص سلامة الواجهة الخلفية.

​

التثبيت التلقائي للتبعيات

​

جسر MCP لأدوات plugin

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

• يحقن خادم MCP مضمّنًا باسم openclaw-plugin-tools في تمهيد جلسة ACPX.
• يكشف أدوات plugin المسجّلة مسبقًا بواسطة plugins المثبّتة والمفعّلة في OpenClaw.
• يبقي الميزة صريحة وموقوفة افتراضيًا.

• يوسّع هذا سطح الأدوات في حزمة ACP.
• يحصل وكلاء ACP على وصول فقط إلى أدوات plugin النشطة أصلًا في gateway.
• تعامل مع هذا على أنه حد الثقة نفسه الذي ينطبق عند السماح لتلك plugins بالتنفيذ داخل OpenClaw نفسه.
• راجع plugins المثبّتة قبل تفعيل ذلك.

​

إعدادات الأذونات

​

permissionMode

​

nonInteractivePermissions

​

الإعداد

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

مهم: يستخدم OpenClaw حاليًا افتراضيًا permissionMode=approve-reads وnonInteractivePermissions=fail. في جلسات ACP غير التفاعلية، قد تفشل أي عملية كتابة أو تنفيذ تُطلق مطالبة إذن بخطأ AcpRuntimeError: Permission prompt unavailable in non-interactive mode. إذا كنت بحاجة إلى تقييد الأذونات، فاضبط nonInteractivePermissions على deny بحيث تتدهور الجلسات بسلاسة بدلًا من التعطل.

​

استكشاف الأخطاء وإصلاحها