Skills yapılandırması

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 },
    },
  },
}

• Yerel Nano Banana Pro tarzı kurulum: agents.defaults.imageGenerationModel.primary: "google/gemini-3-pro-image-preview"
• Yerel fal kurulumu: agents.defaults.imageGenerationModel.primary: "fal/fal-ai/flux/dev"

​

Aracı skill izin listeleri

{
  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 değerini atlayan aracılar için paylaşılan temel izin listesi.
• Skills varsayılan olarak sınırsız kalsın istiyorsanız agents.defaults.skills değerini atlayın.
• agents.list[].skills: bu aracı için açık nihai skill kümesi; varsayılanlarla birleştirmez.
• agents.list[].skills: []: bu aracı için hiçbir skill göstermez.

​

Alanlar

• Yerleşik skill kökleri her zaman ~/.openclaw/skills, ~/.agents/skills, <workspace>/.agents/skills ve <workspace>/skills içerir.
• allowBundled: yalnızca paketlenmiş skill’ler için isteğe bağlı izin listesi. Ayarlandığında, yalnızca listedeki paketlenmiş skill’ler uygun olur (yönetilen, aracı ve çalışma alanı skill’leri etkilenmez).
• load.extraDirs: taranacak ek skill dizinleri (en düşük öncelik).
• load.allowSymlinkTargets: sembolik bağlantılı skill klasörlerinin, sembolik bağlantı o hedef kökün dışında bulunsa bile çözümlenebileceği güvenilir gerçek hedef dizinler. Bunu ~/.agents/skills/manager -> ~/Projects/manager/skills gibi kasıtlı kardeş repo düzenleri için kullanın.
• load.watch: skill klasörlerini izleyin ve Skills anlık görüntüsünü yenileyin (varsayılan: true).
• load.watchDebounceMs: skill izleyici olayları için milisaniye cinsinden bekletme (varsayılan: 250).
• install.preferBrew: mevcut olduğunda brew kurucularını tercih edin (varsayılan: true).
• install.nodeManager: node kurucu tercihi (npm | pnpm | yarn | bun, varsayılan: npm). Bu yalnızca skill kurulumlarını etkiler; Gateway çalışma zamanı hâlâ Node olmalıdır (Bun, WhatsApp/Telegram için önerilmez).
  • openclaw setup --node-manager daha dardır ve şu anda npm, pnpm veya bun kabul eder. Yarn destekli skill kurulumları istiyorsanız skills.install.nodeManager: "yarn" değerini elle ayarlayın.
• install.allowUploadedArchives: güvenilir operator.admin Gateway istemcilerinin skills.upload.* üzerinden hazırlanmış özel zip arşivlerini kurmasına izin verin (varsayılan: false). Bu yalnızca yüklenen arşiv yolunu etkinleştirir; normal ClawHub kurulumları bunu gerektirmez.
• entries.<skillKey>: skill başına geçersiz kılmalar.
• agents.defaults.skills: agents.list[].skills değerini atlayan aracılar tarafından devralınan isteğe bağlı varsayılan skill izin listesi.
• agents.list[].skills: isteğe bağlı, aracı başına nihai skill izin listesi; açık listeler devralınan varsayılanları birleştirmek yerine değiştirir.

​

Sembolik bağlantılı kardeş repolar

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

• enabled: paketlenmiş/kurulu olsa bile bir skill’i devre dışı bırakmak için false olarak ayarlayın.
• env: aracı çalıştırması için enjekte edilen ortam değişkenleri (yalnızca zaten ayarlı değilse).
• apiKey: birincil env var bildiren skill’ler için isteğe bağlı kolaylık. Düz metin dizesini veya SecretRef nesnesini ({ source, provider, id }) destekler.

​

Notlar

• entries altındaki anahtarlar varsayılan olarak skill adına eşlenir. Bir skill metadata.openclaw.skillKey tanımlıyorsa bunun yerine o anahtarı kullanın.
• Yükleme önceliği: <workspace>/skills → <workspace>/.agents/skills → ~/.agents/skills → ~/.openclaw/skills → paketlenmiş skill’ler → skills.load.extraDirs.
• İzleyici etkin olduğunda skill değişiklikleri bir sonraki aracı turunda alınır.

​

Korumalı alan skill’leri ve env var’lar

• Docker arka ucu için agents.defaults.sandbox.docker.env (veya aracı başına agents.list[].sandbox.docker.env).
• Env’i özel korumalı alan imajınıza veya uzak korumalı alan ortamınıza dahil edin.

​

İlgili