# Skills Config Documentation

## Overview

The Skills Config documentation describes how to manage skill-related settings in OpenClaw through the `~/.openclaw/openclaw.json` file under the `skills` key.

## Key Configuration Areas

**Bundled Skills Management**: The `allowBundled` parameter functions as an allowlist for pre-included skills. When configured, it restricts which bundled skills are available while leaving managed and workspace skills unaffected.

**Skill Loading**: The system supports watching skill directories for changes with configurable debounce timing. You can specify additional directories beyond defaults through `load.extraDirs`.

**Installation Preferences**: Configuration options let you choose between package managers (npm, pnpm, yarn, bun) and select Homebrew as the preferred installer when available.

**Per-Skill Configuration**: Individual skills can be toggled on/off, assigned API keys, and have custom environment variables injected during agent runs.

## Important Consideration for Sandboxed Environments

When running in sandboxed mode with Docker, skill processes don't automatically inherit the host's environment variables. You'll need to either configure environment variables at the sandbox level (`agents.defaults.sandbox.docker.env`) or include them in a custom sandbox image.

Changes to skills are picked up on the next agent turn when the watcher is enabled.
