​

Skills ‏(OpenClaw)

​

المواقع والأولوية

1. مجلدات Skills إضافية: تُهيَّأ عبر skills.load.extraDirs
2. Skills المجمّعة: تُشحن مع التثبيت (حزمة npm أو OpenClaw.app)
3. Skills المُدارة/المحلية: ~/.openclaw/skills
4. Skills الوكيل الشخصية: ~/.agents/skills
5. Skills وكيل المشروع: <workspace>/.agents/skills
6. Skills مساحة العمل: <workspace>/skills

​

Skills لكل وكيل مقابل Skills المشتركة

• توجد Skills الخاصة بكل وكيل في <workspace>/skills لذلك الوكيل فقط.
• توجد Skills وكيل المشروع في <workspace>/.agents/skills وتُطبَّق على مساحة العمل تلك قبل مجلد skills/ العادي الخاص بمساحة العمل.
• توجد Skills الوكيل الشخصية في ~/.agents/skills وتُطبَّق عبر مساحات العمل على ذلك الجهاز.
• توجد Skills المشتركة في ~/.openclaw/skills (المُدارة/المحلية) وتكون مرئية إلى جميع الوكلاء على الجهاز نفسه.
• يمكن أيضًا إضافة مجلدات مشتركة عبر skills.load.extraDirs (بأدنى أولوية) إذا كنت تريد حزمة Skills مشتركة يستخدمها عدة وكلاء.

​

قوائم السماح الخاصة بـ Skills لكل وكيل

• يحدد الموقع/الأولوية أي نسخة من Skill بالاسم نفسه تفوز.
• وتحدد قوائم السماح الخاصة بالوكيل أي Skills مرئية يمكن للوكيل استخدامها فعليًا.

{
  agents: {
    defaults: {
      skills: ["github", "weather"],
    },
    list: [
      { id: "writer" }, // inherits github, weather
      { id: "docs", skills: ["docs-search"] }, // replaces defaults
      { id: "locked-down", skills: [] }, // no skills
    ],
  },
}

• احذف agents.defaults.skills إذا أردت Skills غير مقيّدة افتراضيًا.
• احذف agents.list[].skills للوراثة من agents.defaults.skills.
• عيّن agents.list[].skills: [] لعدم استخدام أي Skills.
• تمثل القائمة غير الفارغة في agents.list[].skills المجموعة النهائية لذلك الوكيل؛ ولا تندمج مع القيم الافتراضية.

​

Plugins + Skills

​

ClawHub ‏(التثبيت + المزامنة)

• تثبيت Skill في مساحة عملك:
  • openclaw skills install <skill-slug>
• تحديث جميع Skills المثبتة:
  • openclaw skills update --all
• المزامنة (الفحص + نشر التحديثات):
  • clawhub sync --all

​

ملاحظات الأمان

• تعامل مع Skills التابعة لجهات خارجية باعتبارها تعليمة برمجية غير موثوق بها. اقرأها قبل تمكينها.
• فضّل التشغيل داخل sandbox للمدخلات غير الموثوق بها والأدوات الخطِرة. راجع العزل.
• لا يقبل اكتشاف Skills في مساحة العمل والأدلة الإضافية إلا جذور Skills وملفات SKILL.md التي يبقى realpath المحلول الخاص بها داخل الجذر المهيأ.
• تقوم عمليات تثبيت تبعيات Skills المدعومة من Gateway (skills.install، والإعداد الأولي، وواجهة إعدادات Skills) بتشغيل ماسح التعليمة البرمجية الخطِرة المدمج قبل تنفيذ بيانات التثبيت الوصفية. وتحظر النتائج critical افتراضيًا ما لم يعيّن المستدعي صراحة تجاوز الخطورة؛ أما النتائج المريبة فتعرض تحذيرات فقط.
• يختلف openclaw skills install <slug> عن ذلك: فهو ينزّل مجلد Skill من ClawHub إلى مساحة العمل ولا يستخدم مسار بيانات التثبيت الوصفية المذكور أعلاه.
• يقوم skills.entries.*.env وskills.entries.*.apiKey بحقن الأسرار في عملية المضيف لذلك الدور الخاص بالوكيل (وليس في sandbox). أبقِ الأسرار خارج prompts والسجلات.
• للحصول على نموذج تهديد أشمل وقوائم تحقق، راجع الأمان.

​

التنسيق (متوافق مع AgentSkills وPi)

---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
---

• نتبع مواصفة AgentSkills من حيث التخطيط والغرض.
• يدعم المحلل المستخدم بواسطة الوكيل المضمّن مفاتيح frontmatter أحادية السطر فقط.
• يجب أن تكون metadata كائن JSON أحادي السطر.
• استخدم {baseDir} داخل التعليمات للإشارة إلى مسار مجلد Skill.
• مفاتيح frontmatter الاختيارية:
  • homepage — عنوان URL يظهر بوصفه “Website” في واجهة Skills في macOS (ومدعوم أيضًا عبر metadata.openclaw.homepage).
  • user-invocable — true|false (الافتراضي: true). عندما تكون true، يُعرَض Skill كأمر شرطة مائلة للمستخدم.
  • disable-model-invocation — true|false (الافتراضي: false). عندما تكون true، يُستبعد Skill من prompt الخاص بالنموذج (مع بقائه متاحًا عبر استدعاء المستخدم).
  • command-dispatch — tool (اختياري). عند تعيينه إلى tool، يتجاوز أمر الشرطة المائلة النموذج ويُرسَل مباشرة إلى أداة.
  • command-tool — اسم الأداة المطلوب استدعاؤها عند تعيين command-dispatch: tool.
  • command-arg-mode — raw (الافتراضي). بالنسبة إلى إرسال الأداة، يمرّر سلسلة الوسائط الخام إلى الأداة (من دون تحليل في core). تُستدعى الأداة بالمعلمات التالية: { command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }.

​

التقييد (مرشحات وقت التحميل)

---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },
        "primaryEnv": "GEMINI_API_KEY",
      },
  }
---

• always: true — تضمين Skill دائمًا (وتخطي بقية القيود).
• emoji — رمز تعبيري اختياري تستخدمه واجهة Skills في macOS.
• homepage — عنوان URL اختياري يُعرض بصفة “Website” في واجهة Skills في macOS.
• os — قائمة اختيارية بالمنصات (darwin وlinux وwin32). إذا تم تعيينها، يكون Skill مؤهلًا فقط على أنظمة التشغيل تلك.
• requires.bins — قائمة؛ يجب أن يوجد كل عنصر منها على PATH.
• requires.anyBins — قائمة؛ يجب أن يوجد عنصر واحد منها على الأقل على PATH.
• requires.env — قائمة؛ يجب أن يوجد متغير البيئة أو أن يُوفَّر في التهيئة.
• requires.config — قائمة بمسارات openclaw.json التي يجب أن تكون truthy.
• primaryEnv — اسم متغير البيئة المرتبط بـ skills.entries.<name>.apiKey.
• install — مصفوفة اختيارية من مواصفات التثبيت تستخدمها واجهة Skills في macOS (brew/node/go/uv/download).

• يتم التحقق من requires.bins على المضيف عند تحميل Skill.
• إذا كان الوكيل يعمل داخل sandbox، فيجب أن يكون الملف التنفيذي موجودًا أيضًا داخل الحاوية. قم بتثبيته عبر agents.defaults.sandbox.docker.setupCommand (أو صورة مخصصة). يتم تشغيل setupCommand مرة واحدة بعد إنشاء الحاوية. تتطلب عمليات تثبيت الحزم أيضًا خروجًا للشبكة، ونظام ملفات جذر قابلًا للكتابة، ومستخدم root داخل sandbox. مثال: يحتاج Skill ‏summarize ‏(skills/summarize/SKILL.md) إلى CLI ‏summarize داخل حاوية sandbox لكي يعمل هناك.

---
name: gemini
description: Use Gemini CLI for coding assistance and Google search lookups.
metadata:
  {
    "openclaw":
      {
        "emoji": "♊️",
        "requires": { "bins": ["gemini"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "gemini-cli",
              "bins": ["gemini"],
              "label": "Install Gemini CLI (brew)",
            },
          ],
      },
  }
---

• إذا أُدرجت عدة أدوات تثبيت، يختار gateway خيارًا مفضلًا واحدًا (brew عند توفره، وإلا node).
• إذا كانت جميع أدوات التثبيت من نوع download، يعرض OpenClaw كل إدخال لتتمكن من رؤية العناصر المتاحة.
• يمكن أن تتضمن مواصفات أداة التثبيت os: ["darwin"|"linux"|"win32"] لتصفية الخيارات حسب المنصة.
• تراعي عمليات تثبيت Node القيمة skills.install.nodeManager في openclaw.json (الافتراضي: npm؛ والخيارات: npm/pnpm/yarn/bun). يؤثر هذا فقط في تثبيت Skills؛ لكن Runtime الخاص بـ Gateway يجب أن يبقى Node (لا يُنصح باستخدام Bun مع WhatsApp/Telegram).
• يعتمد اختيار أداة التثبيت المدعوم من Gateway على التفضيل، وليس على node فقط: فعندما تمزج مواصفات التثبيت بين الأنواع، يفضّل 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>).

​

تجاوزات التهيئة (~/.openclaw/openclaw.json)

{
  skills: {
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
        config: {
          endpoint: "https://example.invalid",
          model: "nano-pro",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• تؤدي enabled: false إلى تعطيل Skill حتى لو كان مجمّعًا/مثبتًا.
• env: يُحقن فقط إذا لم يكن المتغير مضبوطًا بالفعل في العملية.
• apiKey: وسيلة ملائمة للـ Skills التي تعلن metadata.openclaw.primaryEnv. وتدعم سلسلة نصية واضحة أو كائن SecretRef ‏({ source, provider, id }).
• config: حاوية اختيارية لحقول مخصصة لكل Skill؛ ويجب أن توجد المفاتيح المخصصة هنا.
• allowBundled: قائمة سماح اختيارية لـ Skills المجمّعة فقط. إذا تم تعيينها، لا تكون مؤهلة إلا Skills المجمّعة الموجودة في القائمة (ولا تتأثر Skills المُدارة/مساحة العمل).

​

حقن البيئة (لكل تشغيل وكيل)

1. قراءة بيانات Skill الوصفية.
2. تطبيق أي قيم skills.entries.<key>.env أو skills.entries.<key>.apiKey على process.env.
3. بناء system prompt باستخدام Skills المؤهلة.
4. استعادة البيئة الأصلية بعد انتهاء التشغيل.

​

لقطة الجلسة (الأداء)

​

عُقد macOS البعيدة (Gateway على Linux)

​

مراقب Skills ‏(التحديث التلقائي)

{
  skills: {
    load: {
      watch: true,
      watchDebounceMs: 250,
    },
  },
}

​

أثر الرموز (قائمة Skills)

• العبء الأساسي (فقط عند وجود Skill واحد أو أكثر): 195 حرفًا.
• لكل Skill: ‏97 حرفًا + طول القيم <name> و<description> و<location> بعد تهريب XML.

total = 195 + Σ (97 + len(name_escaped) + len(description_escaped) + len(location_escaped))

• يوسّع تهريب XML الأحرف & < > " ' إلى كيانات (& و< وما إلى ذلك)، مما يزيد الطول.
• يختلف عدد الرموز باختلاف tokenizer الخاص بالنموذج. كتقدير تقريبي على نمط OpenAI، يساوي الرمز الواحد نحو 4 أحرف، لذا فإن 97 حرفًا ≈ 24 رمزًا لكل Skill إضافة إلى أطوال الحقول الفعلية.

​

دورة حياة Skills المُدارة

​

مرجع التهيئة

​

هل تبحث عن المزيد من Skills؟

​

ذو صلة

• إنشاء Skills — بناء Skills مخصصة
• تهيئة Skills — مرجع تهيئة Skills
• أوامر الشرطة المائلة — جميع أوامر الشرطة المائلة المتاحة
• Plugins — نظرة عامة على نظام plugin