> ## 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 Yapılandırması

# Skills Yapılandırması

Skills ile ilgili tüm yapılandırmalar `skills` altında, `~/.openclaw/openclaw.json` içinde yer alır.

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

## 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.