​

المهارات (OpenClaw)

​

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

1. Skills المضمّنة: المشحونة مع التثبيت (حزمة npm أو OpenClaw.app)
2. Skills المُدارة/المحلية: ~/.openclaw/skills
3. Skills مساحة العمل: <workspace>/skills

​

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

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

​

الإضافات + Skills

​

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

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

​

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

• اعتبر Skills التابعة لجهات خارجية شيفرة غير موثوقة. اقرأها قبل التمكين.
• فضّل التشغيل داخل sandbox للمدخلات غير الموثوقة والأدوات عالية المخاطر. انظر Sandboxing.
• يقوم skills.entries.*.env وskills.entries.*.apiKey بحقن الأسرار في عملية المضيف لذلك الدور من الوكيل (وليس داخل sandbox). أبقِ الأسرار خارج المطالبات والسجلات.
• لنموذج تهديد أوسع وقوائم تحقق، انظر Security.

​

الصيغة (AgentSkills + متوافقة مع Pi)

---
name: nano-banana-pro
description: Generate or edit images via Gemini 3 Pro Image
---

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

​

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

---
name: nano-banana-pro
description: Generate or edit images via Gemini 3 Pro Image
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 يجب أن تكون صحيحة.
• primaryEnv — اسم متغير البيئة المرتبط بـ skills.entries.<name>.apiKey.
• install — مصفوفة اختيارية من مواصفات المُثبّت المستخدمة بواسطة واجهة Skills على macOS (brew/node/go/uv/download).

• يتم التحقق من requires.bins على المضيف وقت تحميل Skill.
• إذا كان الوكيل يعمل داخل sandbox، فيجب أن يكون الملف التنفيذي موجودًا أيضًا داخل الحاوية. قم بتثبيته عبر agents.defaults.sandbox.docker.setupCommand (أو صورة مخصّصة). يتم تشغيل setupCommand مرة واحدة بعد إنشاء الحاوية. تتطلب عمليات تثبيت الحِزم أيضًا خروج شبكة، ونظام ملفات جذر قابل للكتابة، ومستخدم جذر داخل 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)",
            },
          ],
      },
  }
---

• إذا سُردت عدة مُثبّتات، تختار البوابة خيارًا واحدًا مفضّلًا (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).
• تثبيت Go: إذا كان go مفقودًا وكان brew متاحًا، تقوم البوابة بتثبيت Go عبر Homebrew أولًا وتعيّن GOBIN إلى bin الخاص بـ Homebrew عندما يكون ذلك ممكنًا.
• تثبيت التنزيل: url (مطلوب)، archive (tar.gz | tar.bz2 | zip)، extract (الافتراضي: تلقائي عند اكتشاف أرشيف)، stripComponents، targetDir (الافتراضي: ~/.openclaw/tools/<skillKey>).

​

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

{
  skills: {
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: "GEMINI_KEY_HERE",
        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.
• config: حاوية اختيارية لحقول مخصّصة لكل Skill؛ يجب أن تعيش المفاتيح المخصّصة هنا.
• allowBundled: قائمة سماح اختيارية لـ Skills المضمّنة فقط. إذا عُيّنت، تكون Skills المضمّنة المدرجة فقط مؤهلة (ولا تتأثر Skills المُدارة/مساحة العمل).

​

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

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

​

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

​

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

​

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

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

​

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

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

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

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

​

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

​

مرجع التهيئة

​

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