إعداد المهارات في OpenClaw

معظم ما يحدد المهارات التي يراها وكيل OpenClaw وكيفية تثبيتها يقع تحت مفتاح واحد في ملف الإعداد، مع إمكانية الرؤية لكل وكيل ضمن إدخالات الوكلاء. صفحة المرجع طويلة لأن المخطط يغطي التحميل، والتثبيت، والتقييد، وWorkshop، وسياسة تثبيت يملكها المضيف. إليك الواجهة كاملة بالترتيب: التحميل والروابط الرمزية، وتفضيلات التثبيت، وسياسة التثبيت وكيف تُغلق عند الفشل، وقائمة السماح للمهارات المضمّنة والإدخالات لكل مهارة، وقوائم السماح للوكلاء وما ليست عليه، وإعدادات Workshop، وفخ البيئة المعزولة.

التحميل والتثبيت

• تُفحص المجلدات الإضافية بأدنى أولوية، تحت المهارات المضمّنة ومهارات المكونات الإضافية، مع توسيع رمز التلدة (~)؛ وأهداف الروابط الرمزية الموثوقة هي المجلدات الحقيقية التي يمكن أن يُحال إليها مجلد مهارة مرتبط رمزيًا حتى لو كان الرابط خارج الجذر المعدّ، ويوصي التوثيق بإبقاء هذه القائمة ضيقة بدلًا من توجيهها إلى مجلد المنزل؛ ويحدّث المراقب، المفعّل افتراضيًا، لقطة المهارات عندما يتغير ملف مهارة.
• تفضيلات التثبيت: تفضيل برامج تثبيت Homebrew عند توفرها، ومدير حزم Node من بين npm وpnpm وyarn وbun لا يؤثر إلا في تثبيت المهارات، وخيار معطّل افتراضيًا يسمح لعملاء المسؤول الموثوقين بتثبيت أرشيفات zip خاصة مجهّزة عبر مسار الرفع.
• تشغّل سياسة التثبيت الخاصة بمسؤول التشغيل أمرًا محليًا موثوقًا بعد أن يجهّز OpenClaw المصدر وقبل أن يستمر التثبيت أو التحديث، وذلك لمهارات ClawHub والمهارات المرفوعة ومهارات Git والمهارات المحلية، ولبرامج تثبيت الاعتماديات ومصادر المكونات الإضافية؛ ويتلقى الأمر كائن JSON واحدًا يصف الهدف والمصدر والأصل، ويجيب بالقيمة allow أو warn أو block مع سبب وملاحظات اختيارية. وإذا فُعّلت السياسة دون أمر صالح، تُمنع التثبيتات (fail closed)، وكذلك الحال عند block، أو رمز خروج غير صفري، أو انتهاء المهلة، أو JSON غير صالح، أو غياب السبب.
• يوقف التحذير التثبيت قبل اعتماده: تطلب الأوامر التفاعلية من مسؤول التشغيل كتابة اسم الهدف ثم تعيد تشغيل السياسة، ويمكن للأوامر غير التفاعلية تمرير خيار إقرار صريح، ويمكن لواجهة Control UI مراجعة تحذيرات تثبيت المكونات الإضافية، وتبقى عمليات التثبيت الأخرى المعتمدة على Gateway والتلقائية محظورة، ولا يوافق force أبدًا على تحذير. تُحدّ الملاحظات بمئة، والإشعار المعروض بأربعة آلاف حرف، ويُنفّذ فحص doctor المعمّق مسبار تثبيت اصطناعيًا، وتطبّق التحديثات الجماعية السياسة على كل هدف على حدة.

قوائم السماح لمهارات الوكيل مرشّح للرؤية والتحميل في اكتشاف مهارات OpenClaw، والمطالبات، واكتشاف أوامر slash، ومزامنة البيئة المعزولة، ولقطات المهارات. وهي ليست حدًّا للتفويض وقت تنفيذ shell.

الإدخالات وقوائم السماح

لا تقيّد قائمة السماح للمهارات المضمّنة إلا المهارات المضمّنة؛ ولا تتأثر المهارات المدارة ومهارات مستوى الوكيل ومهارات مساحة العمل. تُفهرس الإدخالات لكل مهارة باسم المهارة، أو بمفتاح المهارة الذي تعلنه: خيار enabled يعطّل المهارة حتى لو كانت مضمّنة أو مثبّتة، وهو ما يفعّل مهارة coding-agent الاختيارية بعد تثبيت أداة CLI مدعومة وتسجيل الدخول إليها؛ وحقل مريح لمفتاح API للمهارات التي تعلن متغير بيئة أساسيًا، كنص عادي أو كمرجع سر؛ ومتغيرات بيئة تُحقن في تشغيل الوكيل فقط عندما لا تكون مضبوطة مسبقًا في العملية؛ وحاوية حرة للحقول المخصصة. يستخدم توليد الصور المدمج إعدادات نماذج الوسائط وأداة الصور الأساسية بدلًا من إدخال. وتمنح قوائم السماح للوكلاء جذور الجهاز ومساحة العمل نفسها مجموعةً مرئية مختلفة لكل وكيل: خط أساس مشترك ضمن القيم الافتراضية، يرثه الوكلاء الذين لا يحددون قائمتهم الخاصة، وقوائم صريحة تستبدل القيم الافتراضية بالكامل، والقائمة الفارغة لا تُظهر أي مهارة. والتحذير مهم: إذا كان بإمكان الوكيل تشغيل exec على المضيف، فإن تلك الصدفة (shell) ما زالت قادرة على تشغيل عملاء خارجيين وقراءة ملفات المضيف المرئية لمستخدم التنفيذ، بما في ذلك سجلات عملاء MCP، لذا يحتاج العزل لكل وكيل إلى بيئة معزولة أو عزل على مستوى مستخدم نظام التشغيل، وإلى exec مرفوض أو قائمة سماح exec ضيقة، وإلى بيانات اعتماد لكل وكيل على خادم MCP.

Workshop، والروابط الرمزية، والبيئات المعزولة

• إعدادات Workshop: وضع مستقل بإحدى القيم off أو propose أو auto، حيث تستخدم auto، وهي القيمة الافتراضية، أدوات الوكيل العادية للصيانة المباشرة في كل دور والصيانة الأسبوعية دون فحص للمقترحات، بينما تنشئ propose مقترحات معلّقة من التصحيحات ومن العمل الكبير المنجز؛ وسياسة موافقة بالقيمة auto أو pending؛ وحد أقصى قدره خمسون مقترحًا معلّقًا ومحجورًا لكل وكيل ضمن نطاق من واحد إلى مئتين؛ وحد أقصى لجسم المقترح قدره أربعون ألف بايت ضمن نطاق يتراوح تقريبًا بين ألف ومئتي ألف، مع حد صارم للأوصاف قدره 160 بايت.
• جذور المهارات في مساحة العمل ووكيل المشروع والمجلدات الإضافية والمهارات المضمّنة هي حدود احتواء، لذا يُتخطّى مجلد المهارة المرتبط رمزيًا الذي يُحال إلى خارج جذره مع سطر في السجل، ما لم يكن هدفه موثوقًا؛ أما مجلدات المهارات المدارة والشخصية فتقبل الروابط الرمزية لمجلدات المهارات دون شروط، ويستخدم Workshop مجلد الاحتواء الخاص بكل وكيل، ويتجاهل قائمة الأهداف الموثوقة، ويرفض الروابط الرمزية التي تخرج منه.
• لا تنطبق قيم env ومفتاح API لكل مهارة إلا على التشغيلات على المضيف: داخل البيئة المعزولة لا تأثير لها، لذا تفشل المهارة التي تعتمد على مفتاح بخطأ عدم الإعداد (not-configured) ما لم تُمنح البيئة المعزولة المتغير بشكل منفصل عبر env الخاص ببيئة Docker المعزولة، ويستطيع المستخدمون الذين لديهم وصول إلى Docker daemon قراءة تلك القيم عبر البيانات الوصفية للحاويات، لذا فإن ملف سر مركّب أو صورة مخصصة هو الحل عندما يكون هذا الانكشاف غير مقبول.

يشرح مقال التعلّم الذاتي في OpenClaw قواعد الأهلية والخصوصية وراء الوضع المستقل، ومقال إنشاء مهارة في OpenClaw الملف الذي يراقبه المحمّل.

لماذا تهم ملاحظة الحدود

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

على Diali

على Diali، مركز المهارات في لوحة التحكم هو الواجهة الأمامية لهذا الملف: تفعيل مهارة ولصق مفتاحها هو ما يصبح الإدخال على المساعد، ولا توجد صدفة على المضيف لتعديله يدويًا. تعرض صفحة OpenClaw المستضاف على Diali المساعد، وتصف صفحة الأمان في Diali الحدود المحيطة بكل مساعد.

• قوائم السماح تستبدل؛ ولا تدمج أبدًا.
• تمنع سياسة التثبيت كل شيء ما عدا allow صريحًا.
• تتوقف متغيرات بيئة المهارات عند جدار البيئة المعزولة.