Ana içeriğe atla

​
Skills Yapılandırması

Skills ile ilgili tüm yapılandırmalar skills altında, ~/.openclaw/openclaw.json içinde yer alır. 
{
  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 },
    },
  },
}

​
Alanlar

  • allowBundled: yalnızca paketli Skills için isteğe bağlı izin listesi. Ayarlandığında, listede yer alan paketli Skills uygundur (yönetilen/çalışma alanı Skills etkilenmez).
  • load.extraDirs: taranacak ek skill dizinleri (en düşük öncelik).
  • load.watch: skill klasörlerini izle ve Skills anlık görüntüsünü yenile (varsayılan: true).
  • load.watchDebounceMs: skill izleyici olayları için milisaniye cinsinden debounce (varsayılan: 250).
  • install.preferBrew: mevcut olduğunda brew yükleyicilerini tercih et (varsayılan: true).
  • install.nodeManager: node yükleyici tercihi (npm | pnpm | yarn | bun, varsayılan: npm). Bu yalnızca skill kurulumlarını etkiler; Gateway çalışma zamanı yine Node olmalıdır (WhatsApp/Telegram için Bun önerilmez).
  • entries.<skillKey>: skill bazında geçersiz kılmalar.
Skill başına alanlar:
  • enabled: paketli/kurulu olsa bile bir skill’i devre dışı bırakmak için false olarak ayarlayın.
  • env: ajan çalıştırması için enjekte edilen ortam değişkenleri (yalnızca zaten ayarlı değilse).
  • apiKey: birincil bir ortam değişkeni bildiren Skills için isteğe bağlı kolaylık.

​
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.
  • İzleyici etkinleştirildiğinde, Skills’teki değişiklikler bir sonraki ajan turunda alınır.

​
Sandbox içindeki Skills + ortam değişkenleri

Bir oturum sandbox içindeyken, skill süreçleri Docker içinde çalışır. Sandbox, ana makinenin process.env değerini devralmaz. Aşağıdakilerden birini kullanın:
  • agents.defaults.sandbox.docker.env (veya ajan başına agents.list[].sandbox.docker.env)
  • ortamı özel sandbox imajınıza gömün
Genel env ve skills.entries.<skill>.env/apiKey yalnızca ana makine çalıştırmaları için geçerlidir.