Skills-configuratie

De meeste configuratie voor Skills staat onder skills in ~/.openclaw/openclaw.json. Agentspecifieke zichtbaarheid staat onder agents.defaults.skills en agents.list[].skills.

{  skills: {    allowBundled: ["gemini", "peekaboo"],    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,      watchDebounceMs: 250,    },    install: {      preferBrew: true,      nodeManager: "npm",      allowUploadedArchives: false,    },    workshop: {      autonomous: { enabled: false },      allowSymlinkTargetWrites: false,      approvalPolicy: "pending",      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 },    },  },}

Laden (skills.load)

Installatie (skills.install)

Installatiebeleid voor operators (security.installPolicy)

Gebruik security.installPolicy wanneer operators een vertrouwde lokale opdracht nodig hebben om installaties van Skills en Plugins goed te keuren of te blokkeren met hostspecifiek beleid. Het beleid wordt uitgevoerd nadat OpenClaw bronmateriaal heeft klaargezet en voordat de installatie of update doorgaat. Het is van toepassing op ClawHub-Skills, geüploade Skills, Git-/lokale Skills, installatieprogramma's voor Skill-afhankelijkheden en bronnen voor installatie en updates van Plugins.

{  security: {    installPolicy: {      enabled: true,      // Laat targets weg om elk ondersteund doel te omvatten.      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"],      },    },  },}

Het beleid ontvangt via stdin één JSON-object met protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, optioneel gestructureerd source, gestructureerd origin en request. Het moet één JSON-object naar stdout schrijven: { "protocolVersion": 1, "decision": "allow" } of { "protocolVersion": 1, "decision": "block", "reason": "..." }. Een afsluitcode die niet nul is, een time-out, ongeldige JSON, ontbrekende velden of niet-ondersteunde protocolversies leiden standaard tot blokkering.

OpenClaw voert tijdens het normaal opstarten van de Gateway geen installatiebeleid uit. Installaties en updates worden standaard geblokkeerd wanneer het beleid is ingeschakeld maar niet beschikbaar is. openclaw doctor voert statische validatie uit; openclaw doctor --deep voert een synthetische installatieproef uit met de geconfigureerde opdracht.

Bij bulksgewijze updates wordt het beleid per doel toegepast: een geblokkeerde update van een Skill of Plugin mislukt voor dat doel zonder het beleid uit te schakelen of latere doelen in de batch over te slaan.

Voorbeeld van 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"  }}

Minimale beleidsopdracht:

#!/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: "local plugin paths are not approved on this host",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

Toelatingslijst voor gebundelde Skills

Vermeldingen per Skill (skills.entries)

Sleutels onder entries komen standaard overeen met de name van de Skill. Als een Skill metadata.openclaw.skillKey definieert, gebruikt u in plaats daarvan die sleutel. Plaats namen met koppeltekens tussen aanhalingstekens (JSON5 staat sleutels tussen aanhalingstekens toe).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false schakelt de Skill uit, zelfs wanneer deze gebundeld of geïnstalleerd is. De gebundelde Skill coding-agent is opt-in: stel deze in op true en zorg ervoor dat claude, codex, opencode of een andere ondersteunde CLI is geïnstalleerd en geauthenticeerd.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> Gemaksveld voor Skills die metadata.openclaw.primaryEnv declareren. Ondersteunt een tekenreeks met platte tekst of een SecretRef: { source: "env", provider: "default", id: "VAR_NAME" }.

Toelatingslijsten voor agents (agents)

Gebruik agentconfiguratie wanneer u voor dezelfde machine/werkruimte dezelfde hoofdmappen voor Skills wilt gebruiken, maar per agent een andere zichtbare verzameling Skills wilt instellen.

{  agents: {    defaults: {      skills: ["github", "weather"], // gedeelde basislijn    },    list: [      { id: "writer" }, // neemt github en weather over      { id: "docs", skills: ["docs-search"] }, // vervangt de standaardwaarden volledig      { id: "locked-down", skills: [] }, // geen Skills    ],  },}

Workshop (skills.workshop)

Zie Skill Workshop voor de levenscyclus van voorstellen, CLI-opdrachten, parameters voor agenttools en Gateway-methoden die door deze configuratie worden beheerd.

Hoofdmappen voor Skills met symlinks

Standaard vormen hoofdmappen voor Skills van de werkruimte, projectagent, extra map en meegeleverde Skills insluitingsgrenzen. Een map voor Skills met een symlink onder <workspace>/skills die naar buiten de hoofdmap verwijst, wordt overgeslagen met een logbericht.

Declareer het vertrouwde doel om een doelbewuste indeling met symlinks toe te staan:

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

Met deze configuratie wordt <workspace>/skills/manager -> ~/Projects/manager/skills na realpath-resolutie geaccepteerd. extraDirs scant de aangrenzende repository rechtstreeks; allowSymlinkTargets behoudt het pad met de symlink voor bestaande indelingen.

Skill Workshop schrijft bij het toepassen standaard niet via deze symlinks. Schakel dit afzonderlijk in om Workshop bij het toepassen Skills onder reeds vertrouwde symlinkdoelen te laten wijzigen:

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

Beheerde mappen ~/.openclaw/skills en persoonlijke mappen ~/.agents/skills accepteren symlinks naar mappen voor Skills al onvoorwaardelijk (insluiting van SKILL.md per Skill blijft van toepassing) — allowSymlinkTargets is alleen nodig voor hoofdmappen van de werkruimte, extra map en projectagent (<workspace>/.agents/skills).

Skills in een sandbox en omgevingsvariabelen

Geef geheimen als volgt door aan een Docker-sandbox:

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

Herinnering aan de laadvolgorde

workspace/skills      (hoogste)workspace/.agents/skills~/.agents/skills~/.openclaw/skillsmeegeleverde Skillsskills.load.extraDirs (laagste)

Wijzigingen aan Skills en configuratie worden van kracht in de volgende nieuwe sessie wanneer de watcher is ingeschakeld, of tijdens de volgende agentbeurt wanneer de watcher een wijziging detecteert.

Gerelateerd