واجهات CLI الخلفية في OpenClaw

عندما يكون مزوّد API متوقفًا، أو مقيّدًا بحدود المعدل، أو يتصرف بشكل غير سليم، يستطيع OpenClaw تشغيل أداة CLI محلية للذكاء الاصطناعي كبديل احتياطي نصي فقط. والتوثيق متعمّد في رسم هذا الشكل: لا تُحقن الأدوات مباشرة، مع أن الواجهة الخلفية يمكن أن تتلقى أدوات Gateway عبر جسر MCP على loopback، والبث المتدفق بصيغة JSONL حيث تدعمه أداة CLI، والجلسات مدعومة كي تبقى رسائل المتابعة متسقة، والصور تمر عندما تقبل أداة CLI المسارات. إنه شبكة أمان، لا مسار أساسي، وليس ACP. إليك البدء السريع، وتوصيل البديل الاحتياطي، وآلية الدور، وخصوصيات Claude CLI، والجلسات، وجسر MCP، والضغط، والقيود.

البدء السريع والبديل الاحتياطي

• يسجّل المكوّن الإضافي Anthropic المضمّن واجهة Claude CLI خلفية تعمل دون أي إعداد سوى أن يكون Claude Code مثبّتًا ومسجّل الدخول؛ ويمكن إثبات ذلك بتشغيل وكيل برسالة واحدة مع مرجع نموذج Claude CLI، ويجب أن تجد خدمة Gateway أداة CLI في مسارها، مع مكوّن إضافي للواجهة الخلفية إذا كان الملف التنفيذي غير قياسي.
• لاستخدامها فقط عند فشل النماذج الأساسية، أضف نموذج Claude CLI إلى قائمة البدائل الاحتياطية؛ فالبدائل المعدّة تبقى مؤهلة عندما يفشل النموذج الأساسي بسبب المصادقة أو حدود المعدل أو انتهاء المهلة، حتى لو لم تكن ضمن سياسة السماح بالنماذج، التي لا تهم إلا في الاختيار المباشر.
• لتوجيه نموذج Anthropic بمعرّفه القياسي عبر أداة CLI، اضبط معرّف محرك الوكيل على ذلك النموذج؛ وتبقى بيانات الاعتماد في ملفات تعريف المصادقة أو في إعداد المكوّن الإضافي، أما الأمر والمعاملات والبيئة والتحليل والجلسات والصور وآليات المراقبة (watchdog) فهي شيفرة المكوّن الإضافي.
• يختار الدور الواجهة الخلفية بحسب بادئة المزوّد، ويبني مطالبة النظام من مطالبة OpenClaw نفسها ومن سياق مساحة العمل، وينفّذ أداة CLI بمعرّف جلسة حيثما كان ذلك مدعومًا، ويحلّل JSON أو النص، ويحفظ معرّفات الجلسات لكل واجهة خلفية حتى تعيد رسائل المتابعة استخدام الجلسة.

استخدمه كشبكة أمان لردود نصية «تعمل دائمًا»، لا كمسار أساسي.

خصوصيات Claude CLI

تتحدث الواجهة الخلفية المضمّنة إلى الملف التنفيذي Claude Code المثبّت عبر بروتوكول stdio المهيكل الخاص به، وتُبقي عملية فرعية دافئة واحدة عبر الأدوار المتوافقة، وتبدأ عملية جديدة عندما يتغير النموذج أو مطالبة النظام أو سياسة الأدوات، وتستأنف من معرّفات الجلسات المخزّنة بعد إعادة التشغيل؛ ويملك Claude Code تسجيل دخوله واشتراكه، ولا يقرأ OpenClaw الرموز الأصلية أبدًا، ولا يحفظها، ولا يجددها، ولا يمررها. يصل سياق خطافات بناء المطالبة إلى Claude كمرفق خطاف أصلي، وتُعاد ملاحظات الجلسة المحفوظة ضمن ميزانية موزونة محدودة، ويُستخدم محلّل المهارات الأصلي عبر مجلد مكوّن إضافي مؤقت عندما يكون للمهارة مسار فعلي على القرص، وتُعطَّل تعليمات Git في Claude Code حتى لا تُبطل تعديلات مساحة العمل سجله المخزّن مؤقتًا. يُطلَق Claude Code في وضع الأذونات الافتراضي الخاص به، بينما تُبقي ردود الأذونات في OpenClaw وخطاف ما قبل الأداة (pre-tool) الأدوات الأصلية تحت سيطرة المضيف، إذ تُحوَّل أسماء الأدوات الأصلية ومعاملات الملفات إلى ما يقابلها في OpenClaw قبل سياسة exec والموافقة؛ وعندما يطلب إعداد exec ask تأكيدًا، تُمرَّر طلبات الأدوات الأصلية إلى قناة الجلسة مع الخيارات allow once، وallow always للجلسة الدافئة نفسها، وdeny، حيث يؤدي انتهاء المهلة أو تعذّر الوصول إلى المسار أو انتهاء الدور كلها إلى الرفض، ولا ينطبق allow always أبدًا على Bash. تُطابَق مستويات التفكير مع خيار effort في Claude Code، ومع قيمة max-thinking-tokens للنماذج ذات الميزانية الثابتة، ويعمل كل من تسجيل الدخول الأصلي ورمز الاشتراك الملصوق.

أوامر Bash الأصلية، والجلسات، والجسر

• مع إعداد ask على القيمة on-miss، تُفحص أوامر Bash الأصلية مقابل قائمة سماح exec الخاصة بالوكيل باستخدام مقيّم shell الذي يملكه OpenClaw نفسه: لا يعمل الاستدعاء دون طلب تأكيد إلا عندما يُحال كل مقطع إلى ملف تنفيذي مدرج في قائمة السماح ويمكن ربطه بالكامل، وتُرفض خطوط الأنابيب (pipelines) والاستبدالات والأصداف الفرعية (subshells) وعمليات إعادة التوجيه قبل أي طلب تأكيد، وهذه سياسة على مستوى المعاملات للأمر الذي سيشغّله Claude Code، لا تنفيذ داخل بيئة معزولة، لأن Claude Code يملك مجلد العمل والمسار والبيئة والعزل.
• جلسات CLI المخزّنة استمرارية يملكها المزوّد، ويُتحقق منها مقابل سجل محادثة قابل للقراءة قبل الاستئناف؛ ويمكن للجلسات الجديدة استعادة سجل OpenClaw من قاعدة بيانات الجلسات عندما تتطابق حدود الحساب مع بيانات الاعتماد المحددة، وتُحدَّد الأهلية ببصمة حساب خاصة مع تغطية متصلة لسجل المحادثة، لذا فإن تبديل الحسابات يجعل السجل المختلط غير مؤهل، وتغيّر هوية المصادقة يُسقط إعادة استخدام الجلسة. ويمكن لمحاولة Claude CLI الفاشلة أن تتحول إلى نموذج غير CLI يُهيّأ بمقدمة مستخلصة من سجل المحادثة المحلي في Claude Code: آخر ملخص ضغط فيه إضافة إلى الأدوار الأخيرة.
• الواجهة الخلفية التي تختار طبقة bundle-MCP تحصل على خادم MCP عبر HTTP على loopback يتيح أدوات Gateway لعملية CLI برمز خاص بكل تشغيل، ومرتبط بالجلسة والحساب والقناة التي اختارها Gateway؛ وتقيّد سياسات السماح والرفض خوادم MCP الأصلية أيضًا، وتُعطّل التشغيلات المقيّدة مثل مهام cron أدوات Claude الأصلية وتخصيصاته بالكامل ولا تتيح إلا أدوات OpenClaw المسموح بها، وتُزال محركات الجسر المرتبطة بالجلسة بعد عشر دقائق من الخمول.

مقال OpenClaw وClaude Code هو الثنائي نفسه منظورًا إليه من الجهة الأخرى، ومقال التحويل عند فشل النموذج في OpenClaw يشرح الآلية التي تقرر متى يعمل البديل الاحتياطي.

المهل، والضغط، والقيود

حدّان مستقلان: ميزانية دور الوكيل، وهي 48 ساعة افتراضيًا و0 تعني بلا حد، ومراقب انعدام المخرجات في CLI الذي تملكه الواجهة الخلفية، وهو نشط حتى عندما تكون ميزانية الدور غير محدودة؛ والعمل في الخلفية الذي يبدأ داخل CLI يموت مع العملية الفرعية عند انتهاء الدور، لذا فإن مكان العمل الطويل الدائم هو وكيل فرعي منفصل. تعلن واجهة Claude CLI الخلفية أنها تملك الضغط الأصلي، لذا يُحيل OpenClaw الأمر إلى Claude Code ويمرّر ميزانية السياق عبر نافذة الضغط التلقائي في Claude Code، بينما يستأنف أمر compact الصريح الجلسة المرتبطة ويرسل الأمر الأصلي؛ وواجهة Gemini CLI الخلفية تملك ضغطها أيضًا، دون أمر يدوي. تملك Anthropic واجهة Claude الخلفية وتملك Google واجهة Gemini، ومتطلباتها أداة CLI على المسار وملف تعريف مفتاح Google AI Studio؛ ولا توجد واجهة Codex CLI خلفية مضمّنة، إذ يعمل Codex عبر إطار تشغيل app-server. أما القيود فهي: لا استدعاءات أدوات تُحقن في بروتوكول CLI دون الجسر، وبث متدفق يختلف بحسب الواجهة الخلفية، ومخرجات مهيكلة تعتمد على JSON الخاص بأداة CLI نفسها. يغطي مقال موافقات exec في OpenClaw قائمة السماح التي تُفحص أوامر Bash الأصلية مقابلها، ومقال OpenClaw وGemini المزوّد الذي يقف خلف الواجهة الخلفية المضمّنة الثانية.

على Diali

على Diali لا توجد أداة CLI على المضيف للرجوع إليها: مسار النموذج هو مفتاح API في Vault أو الرصيد المدار، والتحويل عند الفشل يحدث بين المزوّدين لا إلى ملف تنفيذي محلي. تعرض صفحة OpenClaw المستضاف على Diali المساعد، أما دليل النماذج والمزوّدين في OpenClaw فيغطي المزوّدين الذين يستطيع هذا المسار استخدامهم.

• بديل احتياطي، لا مسار أساسي.
• عملية فرعية دافئة، وتسجيل دخول أصلي، وأدوات عبر الجسر فقط.
• يُخضع OpenClaw أوامر Bash الأصلية لقائمة السماح، لكنه لا يشغّلها أبدًا في بيئة معزولة.