وكلاء ACP في OpenClaw

تريد أن تقود Claude Code أو Gemini CLI من رسالة على Telegram بدلًا من الطرفية، وOpenClaw قادر على ذلك عبر Agent Client Protocol. تطلق جلسة ACP أداة البرمجة الخارجية الحقيقية كعملية على مضيف Gateway، وتتابع كل عملية إطلاق كمهمة في الخلفية، ويمكنها ربط محادثة أو سلسلة رسائل حتى تواصل الرسائل اللاحقة الوصول إلى الأداة نفسها. تحتاج أولًا إلى مكوّن إضافي لمحرك التشغيل، وتحدد قائمة قصيرة من الشروط ما إذا كان وكيلك سيعلم يومًا بوجود هذا المسار.

تثبيت المكوّن الإضافي acpx لمحرك التشغيل

• تستخدم التثبيتات المحزّمة المكوّن الإضافي الرسمي acpx لمحرك التشغيل، المنشور ضمن النطاق openclaw على npm، والأمر لا يتطلب سوى أمرين: openclaw plugins install مع تسمية تلك الحزمة ذات النطاق، ثم openclaw config set plugins.entries.acpx.enabled true. أما النسخ المأخوذة من الشيفرة المصدرية فيمكنها بدلًا من ذلك استخدام المكوّن الإضافي المحلي extensions/acpx ضمن مساحة العمل بعد pnpm install. شغّل بعد ذلك ⁨/acp doctor⁩ للتحقق من الجاهزية، أو ⁨/acp install⁩ ليطبع OpenClaw خطوات التثبيت والتفعيل الحتمية.
• إذا كان plugins.allow مضبوطًا، فهو جرد مقيّد للمكونات الإضافية وليس مجرد تلميح، ويجب أن يتضمن acpx وإلا فإن الواجهة الخلفية لـ ACP المثبتة تُحظر عمدًا. هذا هو فشل التشغيل الأول الذي يساء فهمه غالبًا على أنه تثبيت معطوب، ويظهر في صورة الخطأ الذي يفيد بأن الواجهة الخلفية لمحرك ACP غير مهيأة؛ ويبلغ ⁨/acp doctor⁩ عن الإدخال المفقود في قائمة السماح بدلًا من أن يتركك تخمّن.
• يدمج المكوّن الإضافي acpx محرك ACP مباشرة، لذا لا يوجد ملف تنفيذي منفصل لـ acpx ولا إصدار تجب تهيئته. يسجّل المكوّن الواجهة الخلفية المدمجة أثناء بدء تشغيل Gateway وينتظر فحص سلامة واحدًا قبل إشارة ready الخاصة بـ gateway، وهذا الفحص يوفّر أيضًا تشخيصات الفشل. وهو محدود بـ plugins.entries.acpx.config.timeoutSeconds، الذي تبلغ قيمته الافتراضية 120 ثانية حتى تتمكن الأدوات الأبطأ مثل Gemini CLI من إنهاء بدء تشغيل ACP وتهيئته.
• يأتي محوّل Codex لـ ACP مع المكوّن الإضافي acpx ويبدأ محليًا متى أمكن، ويعمل بـ CODEX_HOME معزول ينسخ إليه OpenClaw إدخالات ثقة المشروع الموثوقة إضافة إلى إعدادات آمنة لتوجيه النماذج والمزوّدين، بينما تبقى المصادقة والإشعارات والخطافات (hooks) في إعدادات المضيف فقط. أما محوّلات الأدوات الأخرى فقد تُجلب عند الطلب باستخدام npx عند أول استخدام، لذا فإن المضيف الذي لا يتوفر فيه npm أو وصول إلى الشبكة يفشل في عمليات الجلب هذه إلى أن يتم تسخين ذاكرات التخزين المؤقت مسبقًا أو تثبيت المحوّل بطريقة أخرى.

إذا فشل أي شرط، تبقى مهارات ACP وإرشادات ACP الخاصة بـ sessions_spawn مخفية حتى لا يقترح الوكيل واجهة خلفية غير متاحة.

لماذا قد تكون مهارات ACP غير مرئية

الشروط مدرجة كاملة: يجب أن يكون ACP مفعّلًا، وألا يكون التوزيع (dispatch) معطّلًا، وألا تكون الجلسة الحالية محظورة بسبب البيئة المعزولة، وأن تكون هناك واجهة خلفية للمحرك محمّلة وسليمة. والوكيل الذي لم يعرض عليك قط إطلاق ACP يبلغ في الغالب عن إعداداته بدقة، ولا يتجاهلك. ويفشل الشقّان بطريقتين مختلفتين: acp.dispatch.enabled=false يوقف مؤقتًا التوزيع التلقائي لسلاسل ACP دون إخفاء أو حظر استدعاء صريح لـ sessions_spawn مع المحرك acp، بينما يُرفض الطالب الذي يعمل في بيئة معزولة رفضًا قاطعًا لأن محرك ACP يعمل على جانب المضيف. ومن جلسة داخل بيئة معزولة، فإن الحل الموثّق هو المحرك subagent.

قائمة المتطلبات المسبقة

• قبل أن تلوم OpenClaw، تأكد من أن ⁨/acp doctor⁩ يبلغ عن واجهة خلفية مفعّلة وسليمة، وأن المعرّف المستهدف مسموح به في acp.allowedAgents عند ضبط قائمة السماح هذه، وأن أمر الأداة يمكنه فعلًا البدء على مضيف Gateway. لكل من هذه الشروط نص خطأ خاص به بدلًا من فشل عام واحد، لذا فإن الرسالة التي تتلقاها تضيّق نطاق السبب مسبقًا.
• يجب أن تكون مصادقة المزوّد موجودة مسبقًا على المضيف للأداة التي تستهدفها: فلكل من claude وcodex وgemini وopencode وdroid وسائرها تسجيل دخول خاص به. ويعني خطأ المصادقة الصادر عن المورّد أن OpenClaw سليم وأن CLI أو المزوّد المستهدف لم يتم تسجيل الدخول إليه ببساطة، وتصلح ذلك بتسجيل الدخول أو بتوفير مفتاح المزوّد في بيئة مضيف Gateway، لا بتعديل إعدادات OpenClaw.
• يجب أن يكون النموذج المحدد موجودًا لتلك الأداة، لأن معرّفات النماذج غير قابلة للنقل بين الأدوات، والتحكم في النموذج يعتمد على قدرات المحوّل: فالأداة التي لا تعلن عن قدرة ACP models ولا عن خيار النموذج الخاص بها عند بدء التشغيل لا يمكن فرض نموذج عليها إطلاقًا. ويجب أن يكون مسار cwd المطلوب موجودًا ويمكن الوصول إليه، وإلا فاحذفه ودع الواجهة الخلفية تستخدم قيمتها الافتراضية.

شيء واحد يحسم الاختيار قبل أن تكتب أي إعدادات: أدوات المكونات الإضافية في OpenClaw وأدوات OpenClaw المدمجة غير متاحة لأدوات ACP افتراضيًا، وجسرا MCP اللذان يغيّران ذلك صريحان ومعطّلان افتراضيًا. إذا كان ما تريده تشغيلًا مفوّضًا أصيلًا في OpenClaw مع أدوات OpenClaw نفسها، فذلك تشغيل عبر الوكلاء الفرعيين في OpenClaw، بمفتاح جلسة خاص به وأمر شرطة مائلة خاص به؛ وإذا كنت تريد فقط أداة CLI محلية للذكاء الاصطناعي كنموذج احتياطي نصي فقط، فإن الواجهات الخلفية لـ CLI في OpenClaw ليست ACP ولا محرك أدوات، فلا أدوات OpenClaw فيها ولا عناصر تحكم ACP.

معرّفات الأدوات السبعة عشر

مع الواجهة الخلفية acpx، هذه هي المعرّفات التي تمررها إلى ⁨/acp spawn⁩ أو إلى sessions_spawn بصفتها agentId: claude، codex، copilot، cursor، droid، fast-agent، gemini، iflow، kilocode، kimi، kiro، mux، opencode، openclaw، qoder، qwen وtrae. تتطلب claude مصادقة Claude Code على المضيف، وcopilot تسجيل دخول إلى Copilot CLI أو إلى محركها، وcursor تشغّل cursor-agent acp، وdroid تتطلب مصادقة Factory أو Droid أو FACTORY_API_KEY في بيئة الأداة، وgemini تتطلب مصادقة Gemini CLI أو إعداد مفتاح API، وopencode تتطلب مصادقة OpenCode CLI أو المزوّد، أما openclaw فهي جسر Gateway الذي يتيح لأداة تدعم ACP أن تردّ على جلسة OpenClaw Gateway. وcodex هي الخيار الاحتياطي الصريح لـ ACP، ولا تُستخدم إلا عندما يكون المسار الأصيل ⁨/codex⁩ غير متاح أو عندما يُطلب ACP بالاسم. وpi مسجّلة أيضًا في الواجهة الخلفية acpx لكنها ليست أداة برمجة بالمعنى نفسه. كل عملية إطلاق تنتهي في المهام الخلفية في OpenClaw، وفي أوضاع الأذونات في OpenClaw تقع الإعدادات على مستوى الأداة إلى جانب موافقات التنفيذ في OpenClaw: فجلسة ACP لا تملك TTY تفاعليًا، لذا تحتاج أعمال البرمجة الكثيفة في الكتابة والتنفيذ عادة إلى ملف تعريف قادر على المتابعة دون تفاعل.

على Diali

يتولى Diali استضافة OpenClaw نيابةً عنك، ويشغّل كل عميل مساعده الخاص بدلًا من حصة من مساعد مشترك. تُولّد إعدادات المحرك من لوحة التحكم وتُستبدل مع كل إصدار، لذا تُكتب مفاتيح السياسات نيابةً عنك بدلًا من تعديلها يدويًا على خادم عليك أن تتذكره. تُحفظ الحالة على وحدة تخزين دائمة، وهذا ما يحافظ على الجلسة وسجلها عبر الترقية؛ وتتوفر لقطات يومية واستعادة بنقرة واحدة عبر إضافة «النسخ الاحتياطية» (مضمّنة في Max). تعرض صفحة OpenClaw المستضاف على Diali ما يغطيه المحرك المستضاف، وتضم صفحة أسعار Diali الخطط.

• أمران يثبّتان acpx، ثم ⁨/acp doctor⁩ قبل أي شيء آخر.
• إرشادات ACP المخفية تعني شرطًا فاشلًا، لا ميزة مفقودة.
• سبعة عشر معرّفًا للأدوات، لكل منها تسجيل دخول خاص على المضيف.