حصل OpenClaw على دليل روسي كامل لإعداد JSON5 وCLI والتهيئة الآمنة

نُشر على Habr دليلٌ مفصّل حول OpenClaw، وهي منصة تعتمد في تقريب كل إعداداتها التشغيلية على ملف واحد هو openclaw.json وواجهة سطر أوامر (CLI) واسعة. يجمع هذا الدليل في مكان واحد ما كان على المستخدمين البحث عنه في التوثيق الرسمي وتعليقات GitHub ومنشورات المجتمع.

ما يحتوي عليه الإعداد

يشرح المؤلف بنية المستوى الأعلى للإعداد، وسبب اشتراط OpenClaw الدقة عند التحرير اليدوي. يستخدم الملف صيغة JSON5، مما يتيح التعليقات والفواصل الزائدة، غير أن المخطط (schema) يُتحقق منه بصرامة شديدة عند التشغيل. وإذا أُضيف مفتاح غير معروف، فإن البوابة (gateway) لن تعمل ببساطة.

تُشرح بصورة منفصلة كلٌّ من: gateway وenv وagents وmodels وauth وchannels وsession وcron وtools وsandbox وlogging، فضلاً عن آلية عمل إعادة التحميل الساخن (hot reload) دون إعادة تشغيل كاملة.

• gateway: المنفذ، وضع bind، رمز الوصول، وسلوك hot reload
• agents وmodels: الإعدادات الأساسية، والـfallbacks، واختيار مزودي الخدمة
• auth وchannels: التبديل بين الملفات الشخصية، وTelegram، وDiscord، وقنوات أخرى
• session وcron: عزل الحوارات، وإعادة التعيين الزمنية، والمهام الخلفية
• env وsecrets: أولوية المتغيرات، وSecretRef، وتخزين البيانات الحساسة

تكمن القيمة الرئيسية للدليل في كونه لا يقتصر على قائمة من الحقول. إذ يشرح النص كيفية ترابط مستويات الإعداد المختلفة، وأين تسري القيم الافتراضية، ومتى تُطبَّق الإعدادات دون إعادة تشغيل، وأي المعاملات يُستحسن عدم تعديلها يدوياً.

بالنسبة لمن يشغّل OpenClaw ليس محلياً بل على VPS أو في بيئة عمل، لا يعود هذا مجرد مرجع، بل يصبح operational playbook متكاملاً.

أين ينهار الإعداد

yُكرَّس أكثر الأقسام فائدةً لا للمسار السعيد (happy path) بل لأعطال نمطية. يؤكد الدليل أن بعض المعاملات لا تعمل إلا ضمن agents.defaults وتُتجاهل بصمت إذا نُقلت إلى إعدادات وكيل بعينه. لذا قد يبدو الإعداد صحيحاً دون أن يُفعَّل السلوك المطلوب.

التوصية بسيطة: استخدام أوامر openclaw config get وset وunset بشكل أكثر تكراراً بدلاً من التحرير المباشر، وتشغيل التشخيص بعد كل تغيير.

openclaw doctor — الأمر الأكثر فائدة في الـCLI بأكمله.

كذلك يُعالج الدليل مشكلة انتفاخ السياق (context bloat). يستخدم OpenClaw آليتين مختلفتين: pruning التي تحذف نتائج الأدوات القديمة قبل استدعاء النموذج، وcompaction التي تضغط السجل عندما تكاد نافذة السياق تمتلئ. وكمثال، يُستشهد بحالة تحولت فيها 35 رسالة إلى ملف جلسة بحجم 2.9 ميغابايت وسياق مؤلف من 208,467 رمزاً (token)، مما أوقف استجابة النظام عند حد نموذج يبلغ 200,000 رمز.

الـCLI للمسؤولين

وُصف الـCLI لا وفق الترتيب الأبجدي، بل وفق سيناريوهات العمل، مما جعل الدليل عملياً. تُجمع في مكان واحد أوامر تشغيل البوابة، وحالة الخادم الخلفي (daemon)، وإدارة القنوات، والسجلات، ومهام cron، والإضافات (plugins)، والـskills، والجلسات، والتحديثات.

للأوامر البنية التحتية، تُبرز أوضاع الأمان بشكل منفصل: يعمل health حتى دون daemon نشط، ويتحقق security audit من الإعداد بحثاً عن مخاطر، بينما يساعد secrets audit في رصد تسربات بيانات الاعتماد قبل الوصول إلى الإنتاج.

يتناول القسم الأخير المهم متغيرات البيئة والتحكم في الإصدارات. يوثّق الدليل ترتيب الأولوية: بيئة العملية أولاً، ثم .env المحلي، ثم .env العالمي في دليل OpenClaw، وأخيراً env.vars المدمجة. وللأسرار، يُوصى باستخدام مراجع المتغيرات أو SecretRef بدلاً من القيم مباشرةً في openclaw.json، وبعدم إيداع (commit) سوى قالب الإعداد في المستودع، مع استثناء ملفات .env، ومجلدات الجلسات، وملفات الذاكرة، والحالة المؤقتة.

ما الذي يعنيه هذا

يتحول OpenClaw إلى أداة لا للمتحمسين المستعدين لقراءة الشيفرة المصدرية فحسب، بل أيضاً للفرق التي تحتاج إلى operational playbook واضح. إذا كان المشروع يعتمد على عدة نماذج وقنوات وأتمتة، فإن دليلاً كهذا يقلل من مخاطر الأعطال الصامتة، وتسربات الأسرار، والسلوك غير المستقر بعد التحديثات.