​

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

​

التنسيق (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 كأمر slash للمستخدم.
  • disable-model-invocation — true|false (الافتراضي: false). عندما تكون true، تُستبعَد Skill من موجّه النموذج (مع بقائها متاحة عبر استدعاء المستخدم).
  • command-dispatch — tool (اختياري). عند تعيينها إلى tool، يتجاوز أمر slash النموذج ويُرسَل مباشرة إلى أداة.
  • 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 — 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؛ أما وقت تشغيل 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 (الافتراضي: تلقائي عند اكتشاف archive)، و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. يبني موجّه النظام باستخدام Skills المؤهلة.
4. يعيد البيئة الأصلية بعد انتهاء التشغيل.

​

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

​

عقد macOS البعيدة (Linux gateway)

​

مراقب 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 إلى توسيع & < > " ' إلى كيانات (& و< وغير ذلك)، مما يزيد الطول.
• تختلف أعداد الرموز حسب محلل الرموز الخاص بالنموذج. وتقدير تقريبي على نمط OpenAI هو ~4 أحرف/رمز، لذا فإن 97 حرفًا ≈ 24 رمزًا لكل Skill بالإضافة إلى أطوال حقولك الفعلية.

​

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

​

مرجع الإعدادات

​

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

​

ذو صلة

• إنشاء Skills — بناء Skills مخصصة
• إعدادات Skills — مرجع إعدادات Skills
• Slash Commands — جميع أوامر slash المتاحة
• Plugins — نظرة عامة على نظام plugins