Skills Configuration

All Skills-related config lives under the skills block in ~/.openclaw/openclaw.json. This page focuses on switches, extra directories, installer preferences and per-skill overrides.

Skills Plugin Exec

Complete Example

skills config block

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills"],
      watch: true,
      watchDebounceMs: 250
    },
    install: {
      preferBrew: true,
      nodeManager: "npm"
    },
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: "GEMINI_KEY_HERE",
        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" }
      }
    }
  }
}

Field Notes

allowBundled: only affects bundled Skills and does not limit workspace or locally installed Skills.

load.extraDirs: additional scan directories. load.watch and watchDebounceMs control dynamic refresh.

install.nodeManager: only changes which Node package manager is used during Skill installation and does not alter the Gateway runtime recommendation.

entries.<skillKey>: per-skill overrides for enabled, env and apiKey.