Configuración de Skills en OpenClaw

¿Alguna vez has sentido que gestionar scripts y herramientas externas es un laberinto de configuraciones? Mantener el control sobre qué se carga, cómo se instala y qué variables de entorno necesita cada pieza puede volverse tedioso rápidamente. OpenClaw centraliza todo esto en un solo lugar para que tus agentes funcionen sin complicaciones.

Requisitos previos

• Acceso al archivo de configuración en ~/.openclaw/openclaw.json.
• Skills instaladas o scripts locales que quieras integrar.

Inicio rápido

Para empezar, abre tu archivo openclaw.json y añade el bloque skills. Aquí tienes un ejemplo completo con la estructura recomendada:

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

Configuración de carga y directorios

Si tienes tus propios scripts, usa load.extraDirs para que OpenClaw los escanee. Te recomiendo mantener load.watch en true; esto permite que cualquier cambio en tus archivos se refleje en el siguiente turno del agente sin reiniciar todo.

Gestión de paquetes

En la sección install, puedes definir tu nodeManager preferido. Aunque puedes usar pnpm, yarn o bun, ten en cuenta que el runtime del Gateway debe seguir siendo Node.js (no se recomienda bun para integraciones de WhatsApp o Telegram). Si usas macOS, activa preferBrew para priorizar instalaciones mediante Homebrew.

Control individual de Skills

La sección entries permite sobrescribir comportamientos por cada skill:

• enabled: Úsalo para desactivar skills específicas sin borrarlas.
• env: Inyecta variables de entorno específicas para la ejecución del agente.
• apiKey: Un atajo conveniente si la skill requiere una clave principal.

Solución de problemas

Las variables de entorno no funcionan en el Sandbox

Si ejecutas sesiones en modo sandboxed, los procesos corren dentro de Docker y no heredan el process.env del host. Las configuraciones de env y apiKey en skills.entries solo funcionan en ejecuciones locales (host). Solución: Define las variables en agents.defaults.sandbox.docker.env o inclúyelas directamente en tu imagen de Docker personalizada.

La skill no reconoce mi configuración en entries

Por defecto, las claves en entries deben coincidir con el nombre de la skill. Solución: Si una skill define un metadata.openclaw.skillKey específico, debes usar ese valor exacto como clave en tu archivo JSON.

Si necesitas ayuda personalizada para configurar tus herramientas, consulta al AI Setup Assistant.

Próximos pasos

• Configuración de Agentes
• Uso del Sandbox con Docker