الانتقال إلى المحتوى الرئيسي

​
تهيئة Skills

توجد جميع التهيئات المتعلقة بـ Skills ضمن skills في ~/.openclaw/openclaw.json. 
{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills", "~/Projects/oss/some-skill-pack/skills"],
      watch: true,
      watchDebounceMs: 250,
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun (Gateway runtime still Node; bun not recommended)
    },
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: "GEMINI_KEY_HERE",
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

​
الحقول

  • allowBundled: قائمة سماح اختيارية للـ Skills المضمّنة فقط. عند تعيينها، تكون Skills المضمّنة الموجودة في القائمة فقط مؤهلة (ولا تتأثر Skills المُدارة/الخاصة بمساحة العمل).
  • load.extraDirs: أدلة 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).
  • entries.<skillKey>: تجاوزات لكل Skill.
الحقول الخاصة بكل Skill:
  • enabled: عيّن false لتعطيل Skill حتى لو كانت مضمّنة/مثبّتة.
  • env: متغيرات البيئة التي تُحقن أثناء تشغيل الوكيل (فقط إذا لم تكن مضبوطة بالفعل).
  • apiKey: خيار تسهيلي اختياري للـ Skills التي تعلن عن متغير بيئة أساسي.

​
ملاحظات

  • المفاتيح تحت entries تُطابق اسم Skill افتراضيًا. إذا عرّفت Skill metadata.openclaw.skillKey، فاستخدم ذلك المفتاح بدلًا منه.
  • تُلتقط التغييرات على Skills في دورة الوكيل التالية عندما تكون المراقبة مفعّلة.

​
Skills داخل sandbox + متغيرات البيئة

عندما تكون الجلسة sandboxed، تعمل عمليات Skills داخل Docker. لا يرث sandbox متغيرات process.env من المضيف. استخدم أحد الخيارين:
  • agents.defaults.sandbox.docker.env (أو agents.list[].sandbox.docker.env لكل وكيل)
  • تضمين متغيرات البيئة داخل صورة sandbox مخصّصة لديك
تُطبَّق env وskills.entries.<skill>.env/apiKey العامة على عمليات المضيف فقط.