​

وكلاء 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 هو جلسة حاضنة مع عناصر تحكم ACP، واستئناف الجلسة، وتتبع المهام في الخلفية، وإمكانية ربط المحادثة/سلسلة المحادثة اختياريًا.
• الواجهات الخلفية لـ 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) خاصًا به أو مساحة عمل يديرها في الواجهة الخلفية على القرص. مساحة عمل وقت التشغيل هذه منفصلة عن سطح الدردشة ولا تعني وجود سلسلة رسائل جديدة.
• إذا أنشأت جلسة لوكيل ACP مختلف ولم تمرر --cwd، فسيرث OpenClaw مساحة عمل الوكيل المستهدف افتراضيًا، وليس مساحة عمل الطالب.
• إذا كان مسار مساحة العمل الموروثة هذا مفقودًا (ENOENT/ENOTDIR)، فسيعود OpenClaw إلى cwd الافتراضي للواجهة الخلفية بدلًا من إعادة استخدام الشجرة الخاطئة بصمت.
• إذا كانت مساحة العمل الموروثة موجودة لكن تعذر الوصول إليها (مثل EACCES)، فستعيد عملية الإنشاء خطأ الوصول الحقيقي بدلًا من إسقاط cwd.

• سطح الدردشة: المكان الذي يواصل فيه الناس الحديث (Discord channel، Telegram topic، iMessage chat)
• جلسة 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 وتستمر عبر عمليات إعادة تشغيل البوابة العادية.

• --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 (اختياري): دليل عمل وقت التشغيل المطلوب (ويتم التحقق منه وفق سياسة الواجهة الخلفية/وقت التشغيل). إذا تم حذفه، يرث إنشاء ACP مساحة عمل الوكيل المستهدف عند ضبطها؛ وتعود المسارات الموروثة المفقودة إلى القيم الافتراضية للواجهة الخلفية، بينما تُعاد أخطاء الوصول الحقيقية.
• 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، ولكن الآن بدون واجهة مباشرة عبر وكيلك
• استكمال العمل الذي انقطع بسبب إعادة تشغيل البوابة أو انتهاء مهلة الخمول

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

​

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

1. تحقّق من إصدار/التزام البوابة المنشورة على المضيف المستهدف.
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)
   • يحاول أولًا المفتاح
   • ثم معرّف الجلسة على هيئة 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,
    // اختياري. القيمة الافتراضية true؛ اضبطها على false لإيقاف توجيه ACP مؤقتًا مع الإبقاء على عناصر تحكم /acp.
    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 المحلي داخل حزمة plugin ACPX.
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 النشطة بالفعل في البوابة.
• تعامل مع هذا باعتباره الحد نفسه من الثقة الذي ينطبق على السماح لتلك plugins بالتنفيذ داخل OpenClaw نفسه.
• راجع plugins المثبّتة قبل تفعيله.

​

إعداد مهلة وقت التشغيل

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

​

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

​

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 حتى تتدهور الجلسات بسلاسة بدلًا من أن تتعطل.

​

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