> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# स्किल्स कॉन्फ़िगरेशन

# स्किल्स कॉन्फ़िगरेशन

Skills से संबंधित सभी विन्यास `skills` के अंतर्गत `~/.openclaw/openclaw.json` में रहते हैं।

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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`: केवल **बंडल्ड** स्किल्स के लिए वैकल्पिक allowlist। जब सेट किया जाता है, तो सूची में मौजूद केवल बंडल्ड स्किल्स ही पात्र होती हैं (managed/workspace स्किल्स अप्रभावित रहती हैं)।
* `load.extraDirs`: स्कैन करने के लिए अतिरिक्त skill निर्देशिकाएँ (सबसे कम प्राथमिकता)।
* `load.watch`: skill फ़ोल्डरों पर नज़र रखें और skills स्नैपशॉट को रिफ्रेश करें (डिफ़ॉल्ट: true)।
* `load.watchDebounceMs`: skill watcher घटनाओं के लिए डिबाउंस समय, मिलीसेकंड में (डिफ़ॉल्ट: 250)।
* `install.preferBrew`: उपलब्ध होने पर brew installers को प्राथमिकता दें (डिफ़ॉल्ट: true)।
* `install.nodeManager`: नोड इंस्टॉलर प्राथमिकता (`npm` | `pnpm` | `yarn` | `bun`, डिफ़ॉल्ट: npm)। यह केवल **स्किल इंस्टॉल** को प्रभावित करता है; गेटवे रनटाइम अभी भी Node होना चाहिए (WhatsApp/Telegram के लिए Bun अनुशंसित नहीं है)।
* `entries.<skillKey>`: प्रति-स्किल ओवरराइड्स।

Per-skill फ़ील्ड्स:

* `enabled`: किसी skill को अक्षम करने के लिए `false` सेट करें, भले ही वह bundled/installed हो।
* `env`: एजेंट रन के लिए इंजेक्ट किए गए environment variables (केवल तब, जब पहले से सेट न हों)।
* `apiKey`: उन skills के लिए वैकल्पिक सुविधा जो एक प्राथमिक env var घोषित करते हैं।

## नोट्स

* `entries` के अंतर्गत कीज़ डिफ़ॉल्ट रूप से स्किल नाम से मैप होती हैं। यदि कोई स्किल `metadata.openclaw.skillKey` परिभाषित करता है, तो उसी की का उपयोग करें।
* watcher सक्षम होने पर skills में किए गए परिवर्तन अगले एजेंट टर्न पर लागू हो जाते हैं।

### सैंडबॉक्स्ड स्किल्स + env vars

जब कोई सेशन **sandboxed** होता है, तो स्किल प्रोसेसेस Docker के अंदर चलते हैं। सैंडबॉक्स होस्ट `process.env` को इनहेरिट नहीं करता।

इनमें से किसी एक का उपयोग करें:

* `agents.defaults.sandbox.docker.env` (या प्रति-एजेंट `agents.list[].sandbox.docker.env`)
* अपने कस्टम sandbox इमेज में env को bake करें

ग्लोबल `env` और `skills.entries.<skill>.env/apiKey` केवल **होस्ट** रन पर लागू होते हैं।