Skip to content

Skills للبدء: التثبيت والاستخدام والإعداد ​

الهدف في جملة واحدة: تثبيت أول OpenClaw Skills (مهارة) في الـ Gateway الخاص بك، والتأكد من تحميلها بشكل صحيح، وإكمال الإعداد الأساسي للتقييد وقائمة السماح.

التحضير ​

  • أن تكون قد قرأت الصفحة السابقة «دليل متقدم: Skills وتعزيز الأمان»، وأن يكون الـ Gateway يعمل بشكل طبيعي (OpenClaw 2.0 أي v2026.8.1 وما فوق؛ يحتاج Node إلى 24.16.0+ أو 26.1.0+).
  • أن تعرف أين يقع دليل workspace ودليل state لديك.
  • أن تكون قناة محادثة واحدة على الأقل (Discord أو Telegram وغيرها) متصلة بـ Claw، لتسهيل التحقق عبر المحادثة.
  • ابنِ المفهوم أولًا: المهارة (Skill) ليست إضافة برمجية، بل ملف تعليمات بصيغة markdown يعلّم الـ agent كيف ومتى يستخدم الأدوات. كل مهارة هي دليل يحتوي على SKILL.md (YAML frontmatter + نص markdown). يقوم OpenClaw بتحميل المهارات المدمجة والتغطيات المحلية، ويرشّحها عند التحميل بناءً على البيئة والإعدادات ووجود الملفات التنفيذية.

اتبع الخطوات معي ​

الخطوة 1: تثبيت مهارة (Skill) ​

تصفّح واختر مهارة من المجتمع على ClawHub، وثبّتها باستخدام CLI، أو استخدم الطريقة المحلية بوضع دليل المهارات يدويًا.

bash
openclaw skills install @owner/<slug>

يتم التثبيت افتراضيًا في skills/ التابع لـ workspace الحالي؛ أضف --global للتثبيت في <state-dir>/skills/ المشترك.

الطريقة المحلية: انسخ دليل المهارات بالكامل (يجب أن يحتوي على SKILL.md) إلى دليل التحميل، مثل <workspace>/skills/ على مستوى workspace، أو <state-dir>/skills/ المُدار.

النتيجة المتوقعة: يظهر دليل المهارة في الموقع المستهدف، ويتم فحصه وتحميله بعد إعادة تشغيل الـ Gateway.

الخطوة 2: التحقق من التحميل والأولوية ​

استخدم CLI لعرض قائمة المهارات المحمّلة والتأكد من ظهور المهارة الجديدة؛ وعند حدوث تعارض بنفس الاسم، استكشف المشكلة حسب جدول الأولوية من الأعلى إلى الأدنى.

bash
openclaw skills list

عندما تظهر مهارة بنفس الاسم في مواقع متعددة، يفوز المصدر ذو الأولوية الأعلى:

الأولويةالمصدرالمسار
1 (الأعلى)مهارات Workspace<workspace>/skills
2مهارات agent المشروع<workspace>/.agents/skills
3مهارات agent الشخصية~/.agents/skills (للـ state الافتراضي فقط)
4مهارات مُدارة/محلية<state-dir>/skills
5مهارات Workshop<state-dir>/agents/<agentId>/agent/workshop-skills
6مهارات مدمجة / Custodianتُوزَّع مع حزمة التثبيت؛ مهارات Custodian تظهر فقط تحت الـ agent النظامي المحدد في agents.defaults.systemAgent.agentId
7 (الأدنى)أدلة إضافيةيحددها إعداد skills.*

النتيجة المتوقعة: تظهر المهارة الجديدة في القائمة؛ وعند التعارض بنفس الاسم يفوز المصدر ذو الأولوية الأعلى.

الخطوة 3: إعداد التقييد وقائمة السماح ​

في ملف الإعداد (الافتراضي ~/.openclaw/openclaw.json)، يُضبط تقييد المهارات وحقن البيئة في القسم skills.*، وتُضبط قائمة السماح للـ agent (تحديد أي الـ agents يمكنها استخدام أي المهارات) في القسم agents.*. بعد التعديل احفظ الملف وشغّل openclaw gateway restart لإعادة تشغيل الـ Gateway.

skills.* المفاتيح الشائعة: skills.entries.<技能名>.enabled (مفتاح تقييد مهارة واحدة)، وskills.entries.<技能名>.env مع apiKey (حقن البيئة)، وskills.load.extraDirs (أدلة تحميل إضافية)، وskills.install.* (سلوك التثبيت)، وskills.allowBundled (القائمة البيضاء للمهارات المدمجة). قواعد قائمة السماح: حذف agents.defaults.skills يعني عدم التقييد؛ agents.entries.<agentId>.skills هو مجموعة المهارات النهائية لذلك الـ agent (استبدال كلي وليس دمجًا)، و[] يعني عدم وجود مهارات.

النتيجة المتوقعة: لم تعد المهارة المقيَّدة فعّالة لجميع الـ agents؛ والـ agents المدرجة في قائمة السماح تعمل بشكل طبيعي.

التحقق ​

قل لـ Claw في قناة المحادثة جملة يمكنها تفعيل تلك المهارة، وشاهد ما إذا كان يستدعي الأدوات وينفّذ العملية وفق تعليمات SKILL.md. ثم أعد تسمية دليل المهارة مؤقتًا وأعد التحميل، وتأكد من اختفاء المهارة من القائمة — مما يثبت أن التحميل يأتي فعلًا من الدليل الذي وضعته، وليس من مهارة مدمجة تحمل نفس الاسم.

مزالق شائعة ​

  • مهارة بنفس الاسم تُستبدل بصمت: يفوز المصدر ذو الأولوية الأعلى مباشرة دون أي خطأ. عند الاستكشاف اتبع جدول الأولوية أعلاه طبقة بطبقة.
  • المهارة لا تُحمَّل مهما فعلت: يقوم OpenClaw بالترشيح عند التحميل بناءً على البيئة والإعدادات ووجود الملفات التنفيذية. إذا لم تُثبَّت أداة سطر الأوامر التي تعتمد عليها المهارة، فقد تُرشَّح خارجًا مباشرة. استخدم openclaw skills check للتمييز بين ثلاثة أنواع من المشكلات: inventory/readiness/visibility.
  • وضع الدليل في الطبقة الخاطئة: ~/.agents/skills يعمل كمصدر لمهارات agent الشخصية فقط تحت الـ state الافتراضي؛ أما مهارات المكتبة الشخصية على الـ Gateway المشترك فتُختار حسب الهوية والمراجعة، وليس عبر فحص ملفات كل مستخدم.
  • كتابة المهارة كأنها برنامج: هي مجرد تعليمات markdown تعلّم الـ agent استخدام الأدوات. إذا أردت أن يتعلّم Claw المهارات بنفسه، فراجع Skill Workshop — بدءًا من 2.0 يجمع proposals/checks/decisions، ومن v2026.10.5 يدعم سجل الإصدارات والتراجع.

الدرس التالي ​

بعد أن يعمل Skill بنجاح، انتقل إلى «اكتب Skill الخاص بك: SKILL.md والنشر على ClawHub»، حيث تكتب SKILL.md من الصفر وتنشره على ClawHub. لقراءة موسعة: «Skill Workshop: دع Claw يتعلم المهارات بنفسه» و«ربط MCP: أضف صندوق أدوات خارجيًا إلى Claw».

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.