Skills-configuratie

De meeste Skills-configuratie staat onder skills in ~/.openclaw/openclaw.json. Agentspecifieke zichtbaarheid staat onder agents.defaults.skills en 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 },    },  },}

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 installatie-/updatebronnen 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 één JSON-object op stdin met protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, optionele gestructureerde source, gestructureerde 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 de normale opstart 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: "lokale Plugin-paden zijn niet goedgekeurd op deze 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 Skill-name. Als een Skill metadata.openclaw.skillKey definieert, gebruik je in plaats daarvan die sleutel. Zet 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 vereist expliciete inschakeling — stel deze in op true en zorg dat een van claude, codex, opencode of een andere ondersteunde CLI is geïnstalleerd en geverifieerd.

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 je dezelfde hoofdlocaties voor Skills op de machine/in de werkruimte wilt gebruiken, maar per agent een andere zichtbare verzameling Skills wilt instellen.

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

Workshop (skills.workshop)

Zie Zelflerend vermogen voor geschiktheid, privacy, kosten, uitsluitend-voorstellenmachtigingen en probleemoplossing.

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

Skill-roots met symlinks

Standaard vormen de skill-roots voor workspace, projectagent, extra directory en gebundelde skills insluitingsgrenzen. Een skillmap met een symlink onder <workspace>/skills die naar buiten de root verwijst, wordt overgeslagen met een logbericht.

Declareer het vertrouwde doel om een opzettelijke symlinkindeling toe te staan:

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

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

Bij toepassen schrijft Skill Workshop standaard niet via deze symlinks. Om Workshop bij toepassen skills onder reeds vertrouwde symlinkdoelen te laten wijzigen, moet je dit afzonderlijk inschakelen:

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

Beheerde ~/.openclaw/skills- en persoonlijke ~/.agents/skills-directory's accepteren symlinks naar skilldirectory's al onvoorwaardelijk (insluiting per skill via SKILL.md blijft van toepassing) — allowSymlinkTargets is alleen nodig voor roots van workspace, extra directory 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/skillsgebundelde 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