إعدادات Skills

تقع معظم إعدادات Skills ضمن skills في ~/.openclaw/openclaw.json. أما مستوى الرؤية الخاص بكل وكيل فيقع ضمن agents.defaults.skills وagents.list[].skills.

{  skills: {    allowBundled: ["gemini", "peekaboo"],    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,      watchDebounceMs: 250,    },    install: {      preferBrew: true,      nodeManager: "npm",      allowUploadedArchives: false,    },    workshop: {      autonomous: { enabled: false },      allowSymlinkTargetWrites: false,      approvalPolicy: "auto",      maxPending: 50,      maxSkillBytes: 40000,    },    entries: {      "image-lab": {        enabled: true,        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },      },      peekaboo: { enabled: true },      sag: { enabled: false },    },  },}

التحميل (skills.load)

التثبيت (skills.install)

سياسة تثبيت المشغّل (security.installPolicy)

استخدم security.installPolicy عندما يحتاج المشغّلون إلى أمر محلي موثوق للموافقة على تثبيت Skills والـ Plugins أو حظره وفق سياسة خاصة بالمضيف. تعمل السياسة بعد أن يجهّز OpenClaw المواد المصدرية وقبل متابعة التثبيت أو التحديث. وتنطبق على Skills من ClawHub، وSkills المرفوعة، وSkills من Git/المسار المحلي، ومثبّتات تبعيات Skills، ومصادر تثبيت/تحديث الـ Plugins.

{  security: {    installPolicy: {      enabled: true,      // احذف targets لتغطية كل هدف مدعوم.      targets: ["skill", "plugin"],      exec: {        source: "exec",        command: "/usr/local/bin/openclaw-install-policy",        args: ["--json"],        timeoutMs: 10000,        noOutputTimeoutMs: 10000,        maxOutputBytes: 1048576,        passEnv: ["OPENCLAW_STATE_DIR", "PATH"],        env: { POLICY_MODE: "strict" },        trustedDirs: ["/usr/local/bin"],      },    },  },}

تستقبل السياسة كائن JSON واحدًا على stdin يحتوي على protocolVersion: 1، وopenclawVersion، وtargetType، وtargetName، وsourcePath، وsourcePathKind، وsource منظّمًا اختياريًا، وorigin منظّمًا، وrequest. ويجب أن تكتب كائن JSON واحدًا على stdout: { "protocolVersion": 1, "decision": "allow" } أو { "protocolVersion": 1, "decision": "block", "reason": "..." }. يؤدي الخروج برمز غير صفري، أو انتهاء المهلة، أو JSON غير صالح، أو غياب الحقول، أو إصدارات بروتوكول غير مدعومة إلى الرفض الافتراضي.

لا ينفّذ OpenClaw سياسة التثبيت أثناء بدء تشغيل Gateway العادي. تُرفض عمليات التثبيت والتحديث افتراضيًا عندما تكون السياسة مفعّلة لكنها غير متاحة. ينفّذ openclaw doctor تحققًا ثابتًا؛ بينما ينفّذ openclaw doctor --deep اختبار تثبيت اصطناعيًا على الأمر المضبوط.

تطبّق التحديثات المجمّعة السياسة على كل هدف على حدة: يؤدي حظر تحديث Skill أو Plugin إلى فشل ذلك الهدف من دون تعطيل السياسة أو تخطي الأهداف اللاحقة في الدُفعة.

مثال على stdin:

{  "protocolVersion": 1,  "openclawVersion": "2026.6.1",  "targetType": "skill",  "targetName": "weather",  "sourcePath": "/var/folders/.../openclaw-skill-clawhub/root",  "sourcePathKind": "directory",  "source": {    "kind": "clawhub",    "authority": "openclaw",    "mutable": false,    "network": true  },  "origin": {    "type": "clawhub",    "registry": "https://clawhub.openclaw.ai",    "slug": "weather",    "version": "1.0.0"  },  "request": {    "kind": "skill-install",    "mode": "install",    "requestedSpecifier": "clawhub:weather@1.0.0"  },  "skill": {    "installId": "clawhub"  }}

أمر سياسة بالحد الأدنى:

#!/usr/bin/env node let input = "";process.stdin.setEncoding("utf8");process.stdin.on("data", (chunk) => {  input += chunk;});process.stdin.on("end", () => {  const request = JSON.parse(input);  if (request.targetType === "plugin" && request.source?.kind === "local-path") {    process.stdout.write(      JSON.stringify({        protocolVersion: 1,        decision: "block",        reason: "مسارات Plugin المحلية غير معتمدة على هذا المضيف",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

قائمة السماح لـ Skills المضمّنة

إدخالات كل Skill (skills.entries)

تطابق المفاتيح ضمن entries قيمة name الخاصة بالـ Skill افتراضيًا. إذا عرّفت Skill القيمة metadata.openclaw.skillKey، فاستخدم ذلك المفتاح بدلًا منها. ضع الأسماء التي تحتوي على شرطات بين علامتي اقتباس (يسمح JSON5 بالمفاتيح المقتبسة).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> يعطّل false الـ Skill حتى إن كانت مضمّنة أو مثبّتة. أما Skill المضمّنة coding-agent فتتطلب الاشتراك الصريح — اضبطها على true وتأكد من تثبيت claude أو codex أو opencode أو CLI آخر مدعوم ومصادَق عليه.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> حقل تسهيلي لـ Skills التي تعلن metadata.openclaw.primaryEnv. يدعم سلسلة نصية صريحة أو SecretRef: ‏{ source: "env", provider: "default", id: "VAR_NAME" }.

قوائم سماح الوكلاء (agents)

استخدم إعداد الوكيل عندما تريد جذور Skills نفسها على الجهاز/مساحة العمل، لكن مجموعة مختلفة من Skills المرئية لكل وكيل.

{  agents: {    defaults: {      skills: ["github", "weather"], // خط أساس مشترك    },    list: [      { id: "writer" }, // يرث github وweather      { id: "docs", skills: ["docs-search"] }, // يستبدل الإعدادات الافتراضية بالكامل      { id: "locked-down", skills: [] }, // بلا Skills    ],  },}

ورشة العمل (skills.workshop)

راجع التعلّم الذاتي لمعرفة الأهلية والخصوصية والتكلفة والأذونات الخاصة بالمقترحات فقط واستكشاف الأخطاء وإصلاحها.

راجع ورشة المهارات للتعرّف على دورة حياة المقترح وأوامر CLI ومعاملات أداة الوكيل وطرائق Gateway التي يتحكم فيها هذا الإعداد.

جذور المهارات المرتبطة رمزياً

تُعد جذور مهارات مساحة العمل ووكيل المشروع والدليل الإضافي والمهارات المضمّنة حدود احتواء افتراضياً. يُتخطى مجلد مهارات مرتبط رمزياً ضمن <workspace>/skills إذا كان يُحل إلى خارج الجذر، مع تسجيل رسالة في السجل.

للسماح بتخطيط روابط رمزية مقصود، صرّح بالهدف الموثوق:

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

باستخدام هذا الإعداد، تُقبل <workspace>/skills/manager -> ~/Projects/manager/skills بعد حل المسار الحقيقي. تفحص extraDirs المستودع الشقيق مباشرةً؛ وتحافظ allowSymlinkTargets على المسار المرتبط رمزياً للتخطيطات الحالية.

لا يكتب تطبيق ورشة المهارات عبر تلك الروابط الرمزية افتراضياً. للسماح لتطبيق الورشة بتعديل المهارات ضمن أهداف الروابط الرمزية الموثوقة بالفعل، اشترك في ذلك بصورة منفصلة:

{  skills: {    load: {      allowSymlinkTargets: ["~/Projects/manager/skills"],    },    workshop: {      allowSymlinkTargetWrites: true,    },  },}

تقبل أدلة ~/.openclaw/skills المُدارة وأدلة ~/.agents/skills الشخصية الروابط الرمزية لأدلة المهارات دون شروط بالفعل (مع استمرار تطبيق احتواء SKILL.md لكل مهارة) — ولا تلزم allowSymlinkTargets إلا لجذور مساحة العمل والدليل الإضافي ووكيل المشروع (<workspace>/.agents/skills).

المهارات المعزولة ومتغيرات البيئة

مرّر الأسرار إلى بيئة Docker معزولة باستخدام:

{  agents: {    defaults: {      sandbox: {        docker: {          env: { GEMINI_API_KEY: "your-key-here" },        },      },    },  },}

تذكير بترتيب التحميل

workspace/skills      (الأعلى)workspace/.agents/skills~/.agents/skills~/.openclaw/skillsالمهارات المضمّنةskills.load.extraDirs (الأدنى)

تسري تغييرات المهارات والإعداد في الجلسة الجديدة التالية عندما تكون المراقبة مفعّلة، أو في دور الوكيل التالي عندما تكتشف المراقبة تغييراً.

ذو صلة