Skills कॉन्फ़िगरेशन

अधिकांश Skills कॉन्फ़िगरेशन ~/.openclaw/openclaw.json में skills के अंतर्गत होता है। एजेंट-विशिष्ट दृश्यता agents.defaults.skills और agents.entries.*.skills के अंतर्गत होती है।

{  skills: {    allowBundled: ["gemini", "peekaboo"],    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,    },    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)

जब ऑपरेटरों को होस्ट-विशिष्ट नीति के साथ Skill और Plugin इंस्टॉल को स्वीकृत या अवरुद्ध करने के लिए किसी विश्वसनीय स्थानीय कमांड की आवश्यकता हो, तो security.installPolicy का उपयोग करें। यह नीति OpenClaw द्वारा स्रोत सामग्री स्टेज किए जाने के बाद और इंस्टॉल या अपडेट जारी रहने से पहले चलती है। यह ClawHub Skills, अपलोड किए गए Skills, Git/स्थानीय Skills, Skill निर्भरता इंस्टॉलर और Plugin इंस्टॉल/अपडेट स्रोतों पर लागू होती है।

{  security: {    installPolicy: {      enabled: true,      // Omit targets to cover every supported target.      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"],      },    },  },}

नीति को stdin पर protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, वैकल्पिक संरचित source, संरचित origin, और request वाला एक JSON ऑब्जेक्ट मिलता है। इसे stdout पर एक JSON ऑब्जेक्ट लिखना होगा: { "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" }));});

बंडल किए गए Skill की अनुमति-सूची

प्रति-Skill प्रविष्टियाँ (skills.entries)

entries के अंतर्गत कुंजियाँ डिफ़ॉल्ट रूप से Skill name से मेल खाती हैं। यदि कोई Skill metadata.openclaw.skillKey परिभाषित करता है, तो उसके बजाय उस कुंजी का उपयोग करें। हाइफ़न वाले नामों को उद्धरण चिह्नों में रखें (JSON5 उद्धृत कुंजियों की अनुमति देता है)।

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false बंडल या इंस्टॉल होने पर भी Skill को अक्षम करता है। coding-agent बंडल किया गया Skill ऑप्ट-इन है—इसे true पर सेट करें और सुनिश्चित करें कि claude, codex, opencode, या कोई अन्य समर्थित CLI इंस्टॉल और प्रमाणीकृत हो।

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> metadata.openclaw.primaryEnv घोषित करने वाले Skills के लिए सुविधा फ़ील्ड। सादे टेक्स्ट स्ट्रिंग या SecretRef का समर्थन करता है: { source: "env", provider: "default", id: "VAR_NAME" }।

एजेंट अनुमति-सूचियाँ (agents)

जब एक ही मशीन/कार्यस्थान के Skill रूट रखते हुए प्रत्येक एजेंट के लिए अलग दृश्यमान Skill सेट चाहिए, तो एजेंट कॉन्फ़िगरेशन का उपयोग करें।

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

Workshop (skills.workshop)

पात्रता, गोपनीयता, लागत, केवल-प्रस्ताव अनुमतियों और समस्या निवारण के लिए स्वयं सीखना देखें।

यह कॉन्फ़िग जिन प्रस्ताव जीवनचक्र, CLI कमांड, एजेंट टूल पैरामीटर और Gateway विधियों को नियंत्रित करता है, उनके लिए Skill Workshop देखें।

सिमलिंक किए गए स्किल रूट

डिफ़ॉल्ट रूप से, वर्कस्पेस, प्रोजेक्ट-एजेंट, अतिरिक्त-डायरेक्टरी और बंडल किए गए स्किल रूट कंटेनमेंट सीमाएँ हैं। <workspace>/skills के अंतर्गत ऐसा सिमलिंक किया गया स्किल फ़ोल्डर, जो रूट के बाहर रिज़ॉल्व होता है, लॉग संदेश के साथ छोड़ दिया जाता है।

किसी अभिप्रेत सिमलिंक लेआउट की अनुमति देने के लिए, विश्वसनीय लक्ष्य घोषित करें:

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

इस कॉन्फ़िग के साथ, वास्तविक पथ रिज़ॉल्यूशन के बाद <workspace>/skills/manager -> ~/Projects/manager/skills स्वीकार किया जाता है। extraDirs सीधे सहोदर रिपॉज़िटरी को स्कैन करता है; allowSymlinkTargets मौजूदा लेआउट के लिए सिमलिंक किया गया पथ बनाए रखता है।

Skill Workshop का लागू करना डिफ़ॉल्ट रूप से उन सिमलिंक के माध्यम से नहीं लिखता। Workshop द्वारा पहले से विश्वसनीय सिमलिंक लक्ष्यों के अंतर्गत स्किल में बदलाव की अनुमति देने के लिए, अलग से ऑप्ट इन करें:

{  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 (न्यूनतम)

वॉचर सक्षम होने पर स्किल और कॉन्फ़िग में किए गए बदलाव अगले नए सत्र में, या वॉचर द्वारा बदलाव का पता लगाए जाने पर एजेंट के अगले चरण में प्रभावी होते हैं।

संबंधित