تكوين Skills

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.

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills", "~/Projects/oss/some-skill-pack/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
      watch: true,
      watchDebounceMs: 250,
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun (Gateway runtime still Node; bun not recommended)
      allowUploadedArchives: false,
    },
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• إعداد أصلي بنمط Nano Banana Pro: agents.defaults.imageGenerationModel.primary: "google/gemini-3-pro-image-preview"
• إعداد أصلي لـ fal: agents.defaults.imageGenerationModel.primary: "fal/fal-ai/flux/dev"

​

قوائم سماح Skills للوكيل

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

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

​

الحقول

• تتضمن جذور Skills المدمجة دائمًا ~/.openclaw/skills و~/.agents/skills و<workspace>/.agents/skills و<workspace>/skills.
• allowBundled: قائمة سماح اختيارية لـ Skills المجمعة فقط. عند ضبطها، تكون Skills المجمعة الموجودة في القائمة فقط مؤهلة (لا تتأثر Skills المُدارة أو الخاصة بالوكيل أو مساحة العمل).
• load.extraDirs: أدلة Skills إضافية للمسح (أدنى أسبقية).
• load.allowSymlinkTargets: أدلة أهداف حقيقية موثوقة يمكن لمجلدات Skills ذات الروابط الرمزية أن تُحل إليها حتى عندما يكون الرابط الرمزي خارج جذر ذلك الهدف. استخدم هذا لتخطيطات المستودعات الشقيقة المقصودة مثل ~/.agents/skills/manager -> ~/Projects/manager/skills.
• load.watch: راقب مجلدات Skills وحدّث لقطة Skills (الافتراضي: true).
• load.watchDebounceMs: تأخير إزالة الارتداد لأحداث مراقب Skills بالميلي ثانية (الافتراضي: 250).
• install.preferBrew: فضّل مثبتات brew عند توفرها (الافتراضي: true).
• install.nodeManager: تفضيل مثبت node (npm | pnpm | yarn | bun، الافتراضي: npm). يؤثر هذا فقط في تثبيتات Skills؛ يجب أن يظل وقت تشغيل Gateway هو Node (لا يُوصى بـ Bun لـ WhatsApp/Telegram).
  • openclaw setup --node-manager أضيق نطاقًا ويقبل حاليًا npm أو pnpm أو bun. اضبط skills.install.nodeManager: "yarn" يدويًا إذا كنت تريد تثبيتات Skills مدعومة بـ Yarn.
• install.allowUploadedArchives: اسمح لعملاء Gateway الموثوقين من نوع operator.admin بتثبيت أرشيفات zip خاصة مُهيأة عبر skills.upload.* (الافتراضي: false). يفعّل هذا مسار الأرشيفات المرفوعة فقط؛ ولا تتطلب تثبيتات ClawHub العادية ذلك.
• entries.<skillKey>: تجاوزات لكل Skill.
• agents.defaults.skills: قائمة سماح Skills افتراضية اختيارية يرثها الوكلاء الذين يحذفون agents.list[].skills.
• agents.list[].skills: قائمة سماح Skills نهائية اختيارية لكل وكيل؛ تستبدل القوائم الصريحة الإعدادات الافتراضية الموروثة بدلًا من دمجها.

​

المستودعات الشقيقة ذات الروابط الرمزية

{
  skills: {
    load: {
      extraDirs: ["~/Projects/manager/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
    },
  },
}

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

​

ملاحظات

• تُطابق المفاتيح ضمن entries اسم Skill افتراضيًا. إذا عرّفت Skill metadata.openclaw.skillKey، فاستخدم ذلك المفتاح بدلًا من ذلك.
• أسبقية التحميل هي <workspace>/skills ← <workspace>/.agents/skills ← ~/.agents/skills ← ~/.openclaw/skills ← Skills المجمعة ← skills.load.extraDirs.
• تُلتقط التغييرات على Skills في دورة الوكيل التالية عندما يكون المراقب مفعّلًا.

​

Skills المعزولة ومتغيرات env

• agents.defaults.sandbox.docker.env لواجهة Docker الخلفية (أو agents.list[].sandbox.docker.env لكل وكيل).
• ادمج env في صورة sandbox المخصصة أو بيئة sandbox البعيدة.

​

ذو صلة