Configuración de Skills

La mayor parte de la configuración de Skills se encuentra en skills dentro de ~/.openclaw/openclaw.json. La visibilidad específica de cada agente se encuentra en agents.defaults.skills y agents.entries.*.skills.

{  skills: {    allowBundled: ["gemini", "peekaboo"],    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,    },    install: {      preferBrew: true,      nodeManager: "npm",      allowUploadedArchives: false,    },    workshop: {      autonomous: { enabled: false },      allowSymlinkTargetWrites: false,      approvalPolicy: "auto",      maxPending: 50,      maxSkillBytes: 40000,    },    entries: {      "image-lab": {        enabled: true,        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },      },      peekaboo: { enabled: true },      sag: { enabled: false },    },  },}

Carga (skills.load)

Instalación (skills.install)

Política de instalación del operador (security.installPolicy)

Use security.installPolicy cuando los operadores necesiten un comando local de confianza para aprobar o bloquear instalaciones de Skills y plugins mediante una política específica del host. La política se ejecuta después de que OpenClaw haya preparado el material de origen y antes de que la instalación o actualización continúe. Se aplica a Skills de ClawHub, Skills cargadas, Skills de Git/locales, instaladores de dependencias de Skills y orígenes de instalación/actualización de plugins.

{  security: {    installPolicy: {      enabled: true,      // Omita targets para incluir todos los destinos compatibles.      targets: ["skill", "plugin"],      exec: {        source: "exec",        command: "/usr/local/bin/openclaw-install-policy",        args: ["--json"],        timeoutMs: 10000,        noOutputTimeoutMs: 10000,        maxOutputBytes: 1048576,        passEnv: ["OPENCLAW_STATE_DIR", "PATH"],        env: { POLICY_MODE: "strict" },        trustedDirs: ["/usr/local/bin"],      },    },  },}

La política recibe un objeto JSON por stdin con protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, el campo estructurado opcional source, el campo estructurado origin y request. Debe escribir un objeto JSON por stdout: { "protocolVersion": 1, "decision": "allow" } o { "protocolVersion": 1, "decision": "block", "reason": "..." }. Una salida con código distinto de cero, un tiempo de espera agotado, JSON con formato incorrecto, campos ausentes o versiones de protocolo no compatibles provocan un bloqueo predeterminado.

OpenClaw no ejecuta la política de instalación durante el inicio normal del Gateway. Las instalaciones y actualizaciones se bloquean de forma predeterminada cuando la política está habilitada pero no disponible. openclaw doctor realiza una validación estática; openclaw doctor --deep ejecuta una prueba de instalación sintética con el comando configurado.

Las actualizaciones masivas aplican la política a cada destino: una actualización bloqueada de una Skill o un plugin hace que ese destino falle sin deshabilitar la política ni omitir los destinos posteriores del lote.

Ejemplo de stdin:

{  "protocolVersion": 1,  "openclawVersion": "2026.6.1",  "targetType": "skill",  "targetName": "weather",  "sourcePath": "/var/folders/.../openclaw-skill-clawhub/root",  "sourcePathKind": "directory",  "source": {    "kind": "clawhub",    "authority": "openclaw",    "mutable": false,    "network": true  },  "origin": {    "type": "clawhub",    "registry": "https://clawhub.openclaw.ai",    "slug": "weather",    "version": "1.0.0"  },  "request": {    "kind": "skill-install",    "mode": "install",    "requestedSpecifier": "clawhub:weather@1.0.0"  },  "skill": {    "installId": "clawhub"  }}

Comando de política mínimo:

#!/usr/bin/env node let input = "";process.stdin.setEncoding("utf8");process.stdin.on("data", (chunk) => {  input += chunk;});process.stdin.on("end", () => {  const request = JSON.parse(input);  if (request.targetType === "plugin" && request.source?.kind === "local-path") {    process.stdout.write(      JSON.stringify({        protocolVersion: 1,        decision: "block",        reason: "las rutas de plugins locales no están aprobadas en este host",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

Lista de Skills integradas permitidas

Entradas por Skill (skills.entries)

De forma predeterminada, las claves bajo entries coinciden con el name de la Skill. Si una Skill define metadata.openclaw.skillKey, use esa clave en su lugar. Escriba entre comillas los nombres con guiones (JSON5 permite claves entre comillas).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false deshabilita la Skill incluso cuando está integrada o instalada. La Skill integrada coding-agent es opcional: establézcala en true y asegúrese de que una de claude, codex, opencode u otra CLI compatible esté instalada y autenticada.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> Campo de conveniencia para Skills que declaran metadata.openclaw.primaryEnv. Admite una cadena de texto sin formato o una SecretRef: { source: "env", provider: "default", id: "VAR_NAME" }.

Listas de agentes permitidos (agents)

Use la configuración del agente cuando desee las mismas raíces de Skills de la máquina o del espacio de trabajo, pero un conjunto de Skills visibles diferente para cada agente.

{  agents: {    defaults: {      skills: ["github", "weather"], // base compartida    },    list: [      { id: "writer" }, // hereda github, weather      { id: "docs", skills: ["docs-search"] }, // reemplaza por completo los valores predeterminados      { id: "locked-down", skills: [] }, // sin Skills    ],  },}

Taller (skills.workshop)

Consulte Autoaprendizaje para obtener información sobre los requisitos, la privacidad, el coste, los permisos limitados a propuestas y la solución de problemas.

Consulte Skill Workshop para obtener información sobre el ciclo de vida de las propuestas, los comandos de la CLI, los parámetros de las herramientas del agente y los métodos del Gateway que controla esta configuración.

Raíces de Skills con enlaces simbólicos

De forma predeterminada, las raíces de Skills del espacio de trabajo, del agente del proyecto, de directorios adicionales e integradas son límites de contención. Una carpeta de Skills con un enlace simbólico bajo <workspace>/skills que se resuelva fuera de la raíz se omite y se registra un mensaje.

Para permitir una disposición intencionada de enlaces simbólicos, declare el destino de confianza:

{  skills: {    load: {      extraDirs: ["~/Projects/manager/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],    },  },}

Con esta configuración, <workspace>/skills/manager -> ~/Projects/manager/skills se acepta después de resolver la ruta real. extraDirs analiza directamente el repositorio hermano; allowSymlinkTargets conserva la ruta con enlace simbólico para las disposiciones existentes.

De forma predeterminada, la aplicación de Skill Workshop no escribe a través de esos enlaces simbólicos. Para permitir que la aplicación de Workshop modifique Skills bajo destinos de enlaces simbólicos que ya sean de confianza, active esta opción por separado:

{  skills: {    load: {      allowSymlinkTargets: ["~/Projects/manager/skills"],    },    workshop: {      allowSymlinkTargetWrites: true,    },  },}

Los directorios administrados ~/.openclaw/skills y personales ~/.agents/skills ya aceptan incondicionalmente enlaces simbólicos a directorios de Skills (la contención SKILL.md por Skill sigue siendo aplicable); allowSymlinkTargets solo es necesario para las raíces del espacio de trabajo, de directorios adicionales y del agente del proyecto (<workspace>/.agents/skills).

Skills en entornos aislados y variables de entorno

Pase secretos a un entorno aislado de Docker mediante:

{  agents: {    defaults: {      sandbox: {        docker: {          env: { GEMINI_API_KEY: "your-key-here" },        },      },    },  },}

Recordatorio del orden de carga

workspace/skills      (más alta)workspace/.agents/skills~/.agents/skills~/.openclaw/skillsSkills integradasskills.load.extraDirs (más baja)

Los cambios en las Skills y en la configuración surten efecto en la siguiente sesión nueva cuando el observador está activado, o en el siguiente turno del agente cuando el observador detecta un cambio.

Contenido relacionado