Config de Habilidades

Toda la configuración relacionada con habilidades vive bajo ''skills'' en ''~/.openclaw/openclaw.json''.

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

- ''allowBundled'': lista permitida opcional para habilidades ''incluidas'' solamente. Cuando está establecido, solo

habilidades incluidas en la lista son elegibles (habilidades gestionadas/espacio de trabajo no afectadas).

- ''load.extraDirs'': directorios de habilidades adicionales a escanear (precedencia más baja).

- ''load.watch'': observa carpetas de habilidades y refresca el snapshot de habilidades (predeterminado: true).

- ''load.watchDebounceMs'': debounce para eventos de observador de habilidades en milisegundos (predeterminado: 250).

- ''install.preferBrew'': prefiere instaladores brew cuando están disponibles (predeterminado: true).

- ''install.nodeManager'': preferencia de instalador node (''npm'' | ''pnpm'' | ''yarn'' | ''bun'', predeterminado: npm).

Esto solo afecta <strong>instalaciones de habilidades</strong>; el runtime del Gateway todavía debe ser Node

(Bun no recomendado para WhatsApp/Telegram).

- ''entries.<skillKey>'': overrides por habilidad.

Campos por habilidad:

- ''enabled'': establece ''false'' para deshabilitar una habilidad incluso si está incluida/instalada.

- ''env'': variables de entorno inyectadas para la ejecución del agente (solo si no están ya establecidas).

- ''apiKey'': conveniencia opcional para habilidades que declaran una variable de entorno primaria.

- Las claves bajo ''entries'' mapean al nombre de habilidad por defecto. Si una habilidad define

''metadata.openclaw.skillKey'', usa esa clave en su lugar.

- Los cambios a habilidades se recogen en el próximo turno del agente cuando el observador está habilitado.

Cuando una sesión está en sandbox, los procesos de habilidades se ejecutan dentro de Docker. El sandbox

''no'' hereda el ''process.env'' del host.

Usa uno de:

- ''agents.defaults.sandbox.docker.env'' (o por agente ''agents.list[].sandbox.docker.env'')

- integra el env en tu imagen de sandbox personalizada

El ''env'' global y ''skills.entries.<skill>.env/apiKey'' aplican solo a ejecuciones en ''host''.