OpenClaw يستخدم مجلدات مهارات متوافقة مع AgentSkills لتعليم الوكيل كيفية استخدام الأدوات. كل مهارة هي دليل يحتوي علىDocumentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
SKILL.md مع مقدمة YAML وتعليمات. يحمّل OpenClaw المهارات المضمّنة إضافةً إلى التجاوزات المحلية الاختيارية، ويرشّحها وقت التحميل بناءً على البيئة، والإعدادات، ووجود الملفات الثنائية.
المواقع والأولوية
يحمّل OpenClaw المهارات من هذه المصادر، بأعلى أولوية أولًا:| # | المصدر | المسار |
|---|---|---|
| 1 | مهارات مساحة العمل | <workspace>/skills |
| 2 | مهارات وكيل المشروع | <workspace>/.agents/skills |
| 3 | مهارات الوكيل الشخصية | ~/.agents/skills |
| 4 | مهارات مُدارة/محلية | ~/.openclaw/skills |
| 5 | المهارات المضمّنة | مرفقة مع التثبيت |
| 6 | مجلدات مهارات إضافية | skills.load.extraDirs (الإعدادات) |
$CODEX_HOME/skills ليس واحدًا من جذور مهارات OpenClaw هذه. في وضع مشغّل Codex، تستخدم عمليات تشغيل خادم التطبيق المحلية أدلة Codex رئيسية معزولة لكل وكيل، لذلك لا تُحمّل مهارات Codex CLI الشخصية ضمنيًا. استخدم openclaw migrate codex --dry-run لجردها وopenclaw migrate codex لاختيار أدلة المهارات عبر مطالبة مربعات اختيار تفاعلية قبل نسخها إلى مساحة عمل وكيل OpenClaw الحالية. للتشغيل غير التفاعلي، كرّر --skill <name> لكل مهارة محددة تريد نسخها.
مهارات لكل وكيل مقابل المهارات المشتركة
في إعدادات تعدد الوكلاء تكون لكل وكيل مساحة عمل خاصة به:| النطاق | المسار | مرئي لـ |
|---|---|---|
| لكل وكيل | <workspace>/skills | ذلك الوكيل فقط |
| وكيل المشروع | <workspace>/.agents/skills | وكيل مساحة العمل تلك فقط |
| الوكيل الشخصي | ~/.agents/skills | كل الوكلاء على ذلك الجهاز |
| مشتركة مُدارة/محلية | ~/.openclaw/skills | كل الوكلاء على ذلك الجهاز |
| أدلة إضافية مشتركة | skills.load.extraDirs (الأولوية الأدنى) | كل الوكلاء على ذلك الجهاز |
قوائم السماح لمهارات الوكيل
موقع المهارة ورؤية المهارة عنصران منفصلان للتحكم. يقرر الموقع/الأولوية أي نسخة من مهارة لها الاسم نفسه تفوز؛ وتقرر قوائم سماح الوكيل أي مهارات يمكن للوكيل استخدامها فعليًا.Allowlist rules
Allowlist rules
- احذف
agents.defaults.skillsلجعل المهارات غير مقيّدة افتراضيًا. - احذف
agents.list[].skillsلوراثةagents.defaults.skills. - اضبط
agents.list[].skills: []لعدم إتاحة أي مهارات. - قائمة
agents.list[].skillsغير الفارغة هي المجموعة النهائية لذلك الوكيل - ولا تُدمج مع الافتراضيات. - تنطبق قائمة السماح الفعالة عبر بناء المطالبات، واكتشاف أوامر الشرطة المائلة للمهارات، ومزامنة صندوق العزل، ولقطات المهارات.
Plugins والمهارات
يمكن أن تشحن Plugins مهاراتها الخاصة عبر إدراج أدلةskills في openclaw.plugin.json (المسارات نسبية إلى جذر Plugin). تُحمّل مهارات Plugin عند تمكين Plugin. هذا هو المكان المناسب لأدلة التشغيل الخاصة بالأدوات التي تكون أطول من وصف الأداة ولكن ينبغي أن تكون متاحة كلما كان Plugin مثبتًا - مثلًا، يشحن Plugin المتصفح مهارة browser-automation للتحكم متعدد الخطوات في المتصفح.
تُدمج أدلة مهارات Plugin في المسار نفسه منخفض الأولوية مثل skills.load.extraDirs، لذلك تتجاوزها مهارة مضمّنة أو مُدارة أو تابعة لوكيل أو لمساحة عمل تحمل الاسم نفسه. يمكنك حجبها عبر metadata.openclaw.requires.config في إدخال إعدادات Plugin.
راجع Plugins للاكتشاف/الإعدادات والأدوات لسطح الأدوات الذي تعلّمه تلك المهارات.
Skill Workshop
يمكن لـ Plugin الاختياري والتجريبي Skill Workshop إنشاء مهارات مساحة العمل أو تحديثها من إجراءات قابلة لإعادة الاستخدام لوحظت أثناء عمل الوكيل. يكون معطلًا افتراضيًا ويجب تمكينه صراحةً عبرplugins.entries.skill-workshop.
يكتب Skill Workshop فقط إلى <workspace>/skills، ويفحص المحتوى المُنشأ، ويدعم الموافقة المعلقة أو الكتابات الآمنة التلقائية، ويعزل المقترحات غير الآمنة، ويحدّث لقطة المهارات بعد الكتابات الناجحة حتى تصبح المهارات الجديدة متاحة دون إعادة تشغيل Gateway.
استخدمه للتصحيحات مثل “في المرة القادمة، تحقق من نسب GIF” أو لسير العمل المكتسب بصعوبة مثل قوائم تحقق ضمان جودة الوسائط. ابدأ بالموافقة المعلقة؛ واستخدم الكتابات التلقائية فقط في مساحات العمل الموثوقة بعد مراجعة مقترحاته. الدليل الكامل: Plugin Skill Workshop.
ClawHub (التثبيت والمزامنة)
ClawHub هو سجل المهارات العام لـ OpenClaw. استخدم أوامرopenclaw skills الأصلية للاكتشاف/التثبيت/التحديث، أو CLI المنفصل clawhub لسير عمل النشر/المزامنة. الدليل الكامل: ClawHub.
| الإجراء | الأمر |
|---|---|
| تثبيت مهارة في مساحة العمل | openclaw skills install <skill-slug> |
| تحديث كل المهارات المثبتة | openclaw skills update --all |
| المزامنة (الفحص + نشر التحديثات) | clawhub sync --all |
openclaw skills install الأصلي في دليل skills/ داخل مساحة العمل النشطة. كما يثبّت CLI المنفصل clawhub في ./skills ضمن دليل العمل الحالي لديك (أو يعود إلى مساحة عمل OpenClaw المُعدة). يلتقط OpenClaw ذلك كـ <workspace>/skills في الجلسة التالية.
تدعم جذور المهارات المُعدة أيضًا مستوى تجميع واحدًا، مثل skills/<group>/<skill>/SKILL.md، حتى يمكن إبقاء المهارات الخارجية ذات الصلة تحت مجلد مشترك دون فحص تكراري واسع.
يمكن لعملاء Gateway الذين يحتاجون إلى تسليم خاص وغير تابع لـ ClawHub تجهيز أرشيف مهارة بصيغة zip عبر skills.upload.begin وskills.upload.chunk وskills.upload.commit، ثم تثبيت الرفع الملتزم به عبر skills.install({ source: "upload", uploadId, slug, force?, sha256? }). هذا مسار رفع إداري صريح للعملاء الموثوقين، وليس مسار openclaw skills install <slug> المعتاد أو تدفق تثبيت ClawHub. يكون معطلًا افتراضيًا ولا يعمل إلا عند ضبط skills.install.allowUploadedArchives: true في openclaw.json. يظل وضع الرفع يثبّت في دليل مساحة عمل الوكيل الافتراضية skills/<slug>؛ ويُتجاهل اسم المجلد الداخلي للأرشيف عند تحديد هدف التثبيت النهائي.
تعرض صفحات مهارات ClawHub أحدث حالة فحص أمني قبل التثبيت، مع صفحات تفاصيل للماسحات VirusTotal وClawScan والتحليل الثابت. يبقى openclaw skills install <slug> مسار التثبيت فقط؛ ويسترد الناشرون الإيجابيات الكاذبة عبر لوحة ClawHub أو clawhub skill rescan <slug>.
الأمان
- لا يقبل اكتشاف مهارات مساحة العمل والأدلة الإضافية إلا جذور المهارات وملفات
SKILL.mdالتي يبقى مسارها الحقيقي المحلول داخل الجذر المُعد. - تكون تثبيتات الأرشيف الخاص عبر Gateway معطلة افتراضيًا. عند تمكينها صراحةً، تتطلب رفع zip ملتزمًا به يحتوي على
SKILL.mdوتعيد استخدام وسائل الحماية نفسها لاستخراج الأرشيف، واجتياز المسارات، والروابط الرمزية، والفرض، والتراجع مثل تثبيتات مهارات ClawHub. وهي محكومة بـskills.install.allowUploadedArchives؛ أما تثبيتات ClawHub العادية فلا تتطلب ذلك الإعداد. - تشغّل تثبيتات تبعيات المهارات المدعومة من Gateway (
skills.install، والإعداد الأولي، وواجهة إعدادات Skills) ماسح التعليمات البرمجية الخطرة المضمّن قبل تنفيذ بيانات تعريف المثبّت. تحظر نتائجcriticalافتراضيًا ما لم يضبط المستدعي صراحةً تجاوز الخطر؛ أما النتائج المريبة فتظل تحذيرية فقط. - يختلف
openclaw skills install <slug>- فهو ينزّل مجلد مهارة ClawHub إلى مساحة العمل ولا يستخدم مسار بيانات تعريف المثبّت أعلاه. - يحقن
skills.entries.*.envوskills.entries.*.apiKeyالأسرار في عملية المضيف لدورة ذلك الوكيل (وليس في صندوق العزل). أبقِ الأسرار خارج المطالبات والسجلات.
تنسيق SKILL.md
يجب أن يتضمنSKILL.md على الأقل:
metadata كائن JSON في سطر واحد. استخدم {baseDir} في التعليمات للإشارة إلى مسار مجلد المهارة.
مفاتيح المقدمة الاختيارية
عنوان URL يظهر باسم “موقع الويب” في واجهة Skills على macOS. مدعوم أيضًا عبر
metadata.openclaw.homepage.عندما تكون
true، تُعرض المهارة كأمر شرطة مائلة للمستخدم.عندما تكون
true، يُبقي OpenClaw تعليمات المهارة خارج المطالبة العادية للوكيل. تظل المهارة مثبتة ويمكن تشغيلها صراحةً كأمر شرطة مائلة عندما تكون user-invocable أيضًا true.عند ضبطه على
tool، يتجاوز أمر الشرطة المائلة النموذج ويرسل مباشرةً إلى أداة.اسم الأداة المطلوب استدعاؤها عند ضبط
command-dispatch: tool.لإرسال الأداة، يمرر سلسلة الوسائط الخام إلى الأداة (دون تحليل من النواة). تُستدعى الأداة باستخدام
{ command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }.التقييد (مرشحات وقت التحميل)
يرشّح OpenClaw المهارات وقت التحميل باستخدامmetadata (JSON في سطر واحد):
metadata.openclaw:
عند
true، أدرج Skills دائمًا (وتجاوز البوابات الأخرى).رمز تعبيري اختياري تستخدمه واجهة Skills في macOS.
عنوان URL اختياري يظهر باسم “موقع الويب” في واجهة Skills في macOS.
قائمة اختيارية بالمنصات. إذا ضُبطت، تكون Skill مؤهلة فقط على أنظمة التشغيل تلك.
يجب أن يوجد كل عنصر على
PATH.يجب أن يوجد عنصر واحد على الأقل على
PATH.يجب أن يوجد متغير البيئة أو أن يُقدَّم في التكوين.
قائمة بمسارات
openclaw.json التي يجب أن تكون truthy.اسم متغير البيئة المرتبط بـ
skills.entries.<name>.apiKey.مواصفات تثبيت اختيارية تستخدمها واجهة Skills في macOS (brew/node/go/uv/download).
metadata.openclaw موجودة، تكون Skill مؤهلة دائمًا (ما لم
تُعطَّل في التكوين أو تمنعها skills.allowBundled بالنسبة إلى Skills المضمّنة).
ما زالت كتل
metadata.clawdbot القديمة مقبولة عندما تكون
metadata.openclaw غير موجودة، لكي تحتفظ Skills الأقدم المثبتة
ببوابات الاعتمادية وتلميحات التثبيت. يجب أن تستخدم Skills الجديدة والمحدّثة
metadata.openclaw.ملاحظات العزل
- يُتحقّق من
requires.binsعلى المضيف وقت تحميل Skill. - إذا كان الوكيل معزولًا، فيجب أن يوجد الملف الثنائي أيضًا داخل الحاوية. ثبّته عبر
agents.defaults.sandbox.docker.setupCommand(أو صورة مخصّصة). يعملsetupCommandمرة واحدة بعد إنشاء الحاوية. تتطلب عمليات تثبيت الحزم أيضًا خروجًا إلى الشبكة، ونظام ملفات جذر قابلًا للكتابة، ومستخدم جذر في العزل. - مثال: تحتاج Skill
summarize(skills/summarize/SKILL.md) إلى CLIsummarizeداخل حاوية العزل لكي تعمل هناك.
مواصفات التثبيت
قواعد اختيار المثبّت
قواعد اختيار المثبّت
- إذا أُدرجت مثبّتات متعددة، يختار Gateway خيارًا مفضّلًا واحدًا (brew عند توفره، وإلا node).
- إذا كانت كل المثبّتات
download، يسرد OpenClaw كل إدخال لكي ترى التحف المتاحة. - يمكن أن تتضمن مواصفات التثبيت
os: ["darwin"|"linux"|"win32"]لتصفية الخيارات حسب المنصة. - تحترم عمليات تثبيت Node قيمة
skills.install.nodeManagerفيopenclaw.json(الافتراضي: npm؛ الخيارات: npm/pnpm/yarn/bun). يؤثر هذا فقط في عمليات تثبيت Skills؛ يجب أن يظل وقت تشغيل Gateway على Node - لا يُنصح باستخدام Bun مع WhatsApp/Telegram. - اختيار المثبّت المدعوم من Gateway قائم على التفضيلات: عندما تمزج مواصفات التثبيت أنواعًا مختلفة، يفضّل OpenClaw Homebrew عندما تكون
skills.install.preferBrewمفعّلة ويكونbrewموجودًا، ثمuv، ثم مدير node المكوَّن، ثم البدائل الأخرى مثلgoأوdownload. - إذا كانت كل مواصفات التثبيت
download، يعرض OpenClaw كل خيارات التنزيل بدل اختزالها إلى مثبّت مفضّل واحد.
تفاصيل كل مثبّت
تفاصيل كل مثبّت
- عمليات تثبيت Go: إذا كان
goمفقودًا وكانbrewمتاحًا، يثبّت Gateway Go عبر Homebrew أولًا ويضبطGOBINإلىbinالخاص بـ Homebrew عندما يكون ذلك ممكنًا. - عمليات تثبيت التنزيل:
url(مطلوب)،archive(tar.gz|tar.bz2|zip)،extract(الافتراضي: تلقائي عند اكتشاف أرشيف)،stripComponents،targetDir(الافتراضي:~/.openclaw/tools/<skillKey>).
تجاوزات التكوين
يمكن تفعيل Skills المضمّنة والمُدارة أو تعطيلها وتزويدها بقيم بيئة تحتskills.entries في ~/.openclaw/openclaw.json:
يعطّل
false الـ Skill حتى لو كانت مضمّنة أو مثبتة.
Skill المضمّنة coding-agent اختيارية التفعيل: اضبط
skills.entries.coding-agent.enabled: true قبل إتاحتها للوكلاء،
ثم تأكد من تثبيت أحد claude أو codex أو opencode أو pi
ومصادقته من أجل CLI الخاص به.تسهيل لـ Skills التي تعلن
metadata.openclaw.primaryEnv. يدعم النص الصريح أو SecretRef.يُحقن فقط إذا لم يكن المتغير مضبوطًا مسبقًا في العملية.
حافظة اختيارية للحقول المخصّصة لكل Skill. يجب أن تكون المفاتيح المخصّصة هنا.
قائمة سماح اختيارية لـ Skills المضمّنة فقط. إذا ضُبطت، تكون Skills المضمّنة الموجودة في القائمة وحدها مؤهلة (لا تتأثر Skills المُدارة أو الخاصة بمساحة العمل).
metadata.openclaw.skillKey، فاستخدم ذلك المفتاح تحت skills.entries.
لتوليد/تحرير صور المخزون داخل OpenClaw، استخدم أداة
image_generate الأساسية مع agents.defaults.imageGenerationModel بدلًا
من Skill مضمّنة. أمثلة Skills هنا مخصّصة لسير عمل مخصّص أو تابع لجهة خارجية.
لتحليل الصور الأصلي استخدم أداة image مع
agents.defaults.imageModel. إذا اخترت openai/* أو google/*
أو fal/* أو نموذج صور آخر خاصًا بمزوّد، فأضف أيضًا مفتاح المصادقة/API
الخاص بذلك المزوّد.حقن البيئة
عند بدء تشغيل وكيل، يقوم OpenClaw بما يلي:- يقرأ بيانات Skill الوصفية.
- يطبّق
skills.entries.<key>.envوskills.entries.<key>.apiKeyعلىprocess.env. - يبني موجّه النظام باستخدام Skills المؤهلة.
- يستعيد البيئة الأصلية بعد انتهاء التشغيل.
claude-cli، يجسّد OpenClaw أيضًا
نفس اللقطة المؤهلة كـ Plugin مؤقت لـ Claude Code ويمررها باستخدام
--plugin-dir. يمكن لـ Claude Code بعد ذلك استخدام محلّل Skills الأصلي الخاص به بينما
يظل OpenClaw مالكًا للأسبقية، وقوائم السماح لكل وكيل، والبوابات،
وحقن مفاتيح البيئة/API عبر skills.entries.*. تستخدم الواجهات الخلفية الأخرى لـ CLI
كتالوج الموجّهات فقط.
اللقطات والتحديث
يلتقط OpenClaw لقطة لـ Skills المؤهلة عند بدء الجلسة ويعيد استخدام تلك القائمة في الأدوار اللاحقة داخل الجلسة نفسها. تسري التغييرات على Skills أو التكوين في الجلسة الجديدة التالية. يمكن تحديث Skills في منتصف الجلسة في حالتين:- مراقب Skills مفعّل.
- تظهر عقدة بعيدة مؤهلة جديدة.
مراقب Skills
افتراضيًا، يراقب OpenClaw مجلدات Skills ويرفع إصدار لقطة Skills عندما تتغير ملفاتSKILL.md. اضبط ذلك تحت skills.load:
allowSymlinkTargets لتخطيطات المستودعات الشقيقة المقصودة حيث يحتوي جذر
Skill مضمّنة على رابط رمزي، مثل
~/.agents/skills/manager -> ~/Projects/manager/skills. تتم مطابقة قائمة الأهداف
بعد حل realpath ويجب أن تبقى ضيقة.
عقد macOS البعيدة (Gateway على Linux)
إذا كان Gateway يعمل على Linux لكن عقدة macOS متصلة مع السماح بـsystem.run (أمان موافقات Exec غير مضبوط على deny)،
يمكن لـ OpenClaw اعتبار Skills الخاصة بـ macOS فقط مؤهلة عندما تكون
الملفات الثنائية المطلوبة موجودة على تلك العقدة. يجب أن ينفّذ الوكيل Skills تلك
عبر أداة exec مع host=node.
يعتمد ذلك على إبلاغ العقدة عن دعمها للأوامر وعلى فحص ملف ثنائي
عبر system.which أو system.run. لا تجعل العقد غير المتصلة
Skills البعيدة فقط مرئية. إذا توقفت عقدة متصلة عن الاستجابة لفحوص الملفات
الثنائية، يمسح OpenClaw مطابقات الملفات الثنائية المخزنة مؤقتًا الخاصة بها لكي لا يرى الوكلاء
Skills لا يمكن تشغيلها حاليًا هناك.
أثر الرموز
عندما تكون Skills مؤهلة، يحقن OpenClaw قائمة XML مضغوطة بـ Skills المتاحة في موجّه النظام (عبرformatSkillsForPrompt في
pi-coding-agent). التكلفة حتمية:
- الحمل الأساسي (فقط عند وجود Skill واحدة أو أكثر): 195 حرفًا.
- لكل Skill: 97 حرفًا + طول قيم
<name>و<description>و<location>بعد تهريب XML.
& < > " ' إلى كيانات (&، <، إلخ)،
ما يزيد الطول. تختلف أعداد الرموز حسب tokenizer النموذج. تقدير تقريبي
بأسلوب OpenAI هو نحو 4 أحرف/رمز، لذلك 97 حرفًا ≈ 24 رمزًا لكل
Skill إضافةً إلى أطوال الحقول الفعلية لديك.
دورة حياة Skills المُدارة
يشحن OpenClaw مجموعة أساسية من Skills كـ Skills مضمّنة مع التثبيت (حزمة npm أو OpenClaw.app). يوجد~/.openclaw/skills
للتجاوزات المحلية - مثل تثبيت إصدار Skill أو ترقيعها دون
تغيير النسخة المضمّنة. Skills الخاصة بمساحة العمل مملوكة للمستخدم وتتجاوز
كلتيهما عند تعارض الأسماء.
هل تبحث عن المزيد من Skills؟
تصفّح https://clawhub.ai. مخطط التكوين الكامل: تكوين Skills.ذات صلة
- ClawHub - سجل Skills العام
- إنشاء Skills - بناء Skills مخصّصة
- Plugins - نظرة عامة على نظام Plugin
- Plugin ورشة Skills - توليد Skills من عمل الوكيل
- تكوين Skills - مرجع تكوين Skill
- أوامر الشرطة المائلة - كل أوامر الشرطة المائلة المتاحة