Skills

OpenClaw gebruikt AgentSkills-compatibele skillmappen om de agent te leren hoe tools te gebruiken. Elke skill is een directory met een SKILL.md met YAML-frontmatter en instructies. OpenClaw laadt gebundelde skills plus optionele lokale overschrijvingen, en filtert ze tijdens het laden op basis van omgeving, configuratie en aanwezigheid van binaries.

Locaties en prioriteit

OpenClaw laadt skills uit deze bronnen, hoogste prioriteit eerst:

Als een skillnaam conflicteert, wint de hoogste bron.

De native $CODEX_HOME/skills-directory van Codex CLI is niet een van deze OpenClaw-skillroots. In Codex-harnessmodus gebruiken lokale app-serverstarts geisoleerde Codex-homes per agent, dus persoonlijke Codex CLI-skills worden niet impliciet geladen. Gebruik openclaw migrate codex --dry-run om ze te inventariseren en openclaw migrate codex om skilldirectories te kiezen met een interactieve checkboxprompt voordat ze naar de huidige OpenClaw-agentworkspace worden gekopieerd. Herhaal voor niet-interactieve runs --skill <name> voor de exacte skills die moeten worden gekopieerd.

Per-agent versus gedeelde skills

In multi-agent-opstellingen heeft elke agent een eigen workspace:

Dezelfde naam op meerdere plaatsen → de hoogste bron wint. Workspace wint van project-agent, wint van persoonlijke agent, wint van beheerd/lokaal, wint van gebundeld, wint van extra directories.

Agent-skill-allowlists

Skilllocatie en skillzichtbaarheid zijn aparte controles. Locatie/prioriteit bepaalt welke kopie van een gelijknamige skill wint; agent- allowlists bepalen welke skills een agent daadwerkelijk kan gebruiken.

{  agents: {    defaults: {      skills: ["github", "weather"],    },    list: [      { id: "writer" }, // inherits github, weather      { id: "docs", skills: ["docs-search"] }, // replaces defaults      { id: "locked-down", skills: [] }, // no skills    ],  },}

Plugins en skills

Plugins kunnen hun eigen skills meeleveren door skills-directories te vermelden in openclaw.plugin.json (paden relatief aan de Plugin-root). Pluginskills worden geladen wanneer de Plugin is ingeschakeld. Dit is de juiste plek voor toolspecifieke bedieningsgidsen die te lang zijn voor de toolbeschrijving maar beschikbaar moeten zijn wanneer de Plugin is geinstalleerd - de browserplugin levert bijvoorbeeld een browser-automation-skill voor browserbesturing in meerdere stappen.

Pluginskilldirectories worden samengevoegd in hetzelfde pad met lage prioriteit als skills.load.extraDirs, dus een gelijknamige gebundelde, beheerde, agent- of workspaceskill overschrijft ze. Je kunt ze blokkeren of toestaan via metadata.openclaw.requires.config in de configuratie-entry van de Plugin.

Zie Plugins voor ontdekking/configuratie en Tools voor het tooloppervlak dat die skills aanleren.

Skill Workshop

De optionele, experimentele Skill Workshop-Plugin kan workspaceskills maken of bijwerken op basis van herbruikbare procedures die tijdens agentwerk zijn geobserveerd. Deze is standaard uitgeschakeld en moet expliciet worden ingeschakeld via plugins.entries.skill-workshop.

Skill Workshop schrijft alleen naar <workspace>/skills, scant gegenereerde inhoud, ondersteunt wachtende goedkeuring of automatische veilige schrijfacties, plaatst onveilige voorstellen in quarantaine en vernieuwt het skillsnapshot na succesvolle schrijfacties zodat nieuwe skills beschikbaar worden zonder een Gateway-herstart.

Gebruik dit voor correcties zoals "controleer de volgende keer GIF-attributie" of zwaar bevochten workflows zoals checklists voor media-QA. Begin met wachtende goedkeuring; gebruik automatische schrijfacties alleen in vertrouwde workspaces na beoordeling van de voorstellen. Volledige gids: Skill Workshop-Plugin.

ClawHub (installeren en synchroniseren)

ClawHub is het openbare skillsregister voor OpenClaw. Gebruik native openclaw skills-commands voor ontdekken/installeren/bijwerken, of de aparte clawhub CLI voor publicatie-/synchronisatieworkflows. Volledige gids: ClawHub.

Native openclaw skills install installeert in de actieve workspace- skills/-directory. De aparte clawhub CLI installeert ook in ./skills onder je huidige werkdirectory (of valt terug op de geconfigureerde OpenClaw-workspace). OpenClaw pikt dat op als <workspace>/skills in de volgende sessie. Geconfigureerde skillroots ondersteunen ook een groeperingsniveau, zoals skills/<group>/<skill>/SKILL.md, zodat gerelateerde skills van derden onder een gedeelde map kunnen worden bewaard zonder brede recursieve scanning.

Gateway-clients die private levering buiten ClawHub nodig hebben, kunnen een zip-skill archief klaarzetten met skills.upload.begin, skills.upload.chunk en skills.upload.commit, en daarna de vastgelegde upload installeren met skills.install({ source: "upload", uploadId, slug, force?, sha256? }). Dit is een expliciet admin-uploadpad voor vertrouwde clients, niet de normale openclaw skills install <slug>- of ClawHub-installatiestroom. Het staat standaard uit en werkt alleen wanneer skills.install.allowUploadedArchives: true is ingesteld in openclaw.json. Uploadmodus installeert nog steeds in de standaard agentworkspace- skills/<slug>-directory; de interne mapnaam van het archief wordt genegeerd voor het uiteindelijke installatiedoel.

ClawHub-skillpagina's tonen de nieuwste status van de veiligheidsscan voor installatie, met scannerdetailpagina's voor VirusTotal, ClawScan en statische analyse. openclaw skills install <slug> blijft alleen het installatiepad; uitgevers herstellen fout-positieven via het ClawHub-dashboard of clawhub skill rescan <slug>.

Beveiliging

• Workspace- en extra-directory-skillontdekking accepteert alleen skillroots en SKILL.md-bestanden waarvan de opgeloste realpath binnen de geconfigureerde root blijft.
• Private archiefinstallaties via Gateway staan standaard uit. Wanneer ze expliciet zijn ingeschakeld, vereisen ze een vastgelegde zip-upload met SKILL.md en hergebruiken ze dezelfde beveiligingen voor archiefextractie, path traversal, symlinks, force en rollback als ClawHub-skillinstallaties. Ze worden bewaakt door skills.install.allowUploadedArchives; normale ClawHub-installaties vereisen die instelling niet.
• Skilldependency-installaties via Gateway (skills.install, onboarding en de UI voor Skills-instellingen) voeren de ingebouwde scanner voor gevaarlijke code uit voordat installermetadata wordt uitgevoerd. critical-bevindingen blokkeren standaard, tenzij de caller expliciet de gevaarlijke override instelt; verdachte bevindingen geven nog steeds alleen een waarschuwing.
• openclaw skills install <slug> is anders - het downloadt een ClawHub-skillmap naar de workspace en gebruikt het installermetadata-pad hierboven niet.
• skills.entries.*.env en skills.entries.*.apiKey injecteren geheimen in het hostproces voor die agentbeurt (niet de sandbox). Houd geheimen uit prompts en logs.

Zie Security voor een breder dreigingsmodel en checklists.

SKILL.md-indeling

SKILL.md moet minimaal het volgende bevatten:

---name: image-labdescription: Generate or edit images via a provider-backed image workflow---

OpenClaw volgt de AgentSkills-specificatie voor layout/intentie. De parser die door de ingebedde agent wordt gebruikt, ondersteunt alleen single-line frontmatterkeys; metadata moet een single-line JSON object zijn. Gebruik {baseDir} in instructies om naar het pad van de skillmap te verwijzen.

Optionele frontmatterkeys

Gating (laadtijdfilters)

OpenClaw filtert skills tijdens het laden met metadata (single-line JSON):

---name: image-labdescription: Generate or edit images via a provider-backed image workflowmetadata:  {    "openclaw":      {        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },        "primaryEnv": "GEMINI_API_KEY",      },  }---

Velden onder metadata.openclaw:

Als er geen metadata.openclaw aanwezig is, komt de skill altijd in aanmerking (tenzij uitgeschakeld in de configuratie of geblokkeerd door skills.allowBundled voor gebundelde skills).

Opmerkingen over sandboxing

• requires.bins wordt gecontroleerd op de host tijdens het laden van skills.
• Als een agent in een sandbox draait, moet de binary ook binnen de container bestaan. Installeer deze via agents.defaults.sandbox.docker.setupCommand (of een custom image). setupCommand wordt eenmaal uitgevoerd nadat de container is gemaakt. Pakketinstallaties vereisen ook netwerk-egress, een beschrijfbaar rootbestandssysteem en een rootgebruiker in de sandbox.
• Voorbeeld: de summarize-skill (skills/summarize/SKILL.md) heeft de summarize CLI nodig in de sandboxcontainer om daar te kunnen draaien.

Installerspecificaties

---name: geminidescription: Use Gemini CLI for coding assistance and Google search lookups.metadata:  {    "openclaw":      {        "emoji": "♊️",        "requires": { "bins": ["gemini"] },        "install":          [            {              "id": "brew",              "kind": "brew",              "formula": "gemini-cli",              "bins": ["gemini"],              "label": "Install Gemini CLI (brew)",            },          ],      },  }---

Configuratie-overschrijvingen

Gebundelde en beheerde skills kunnen worden in- en uitgeschakeld en van env-waarden worden voorzien onder skills.entries in ~/.openclaw/openclaw.json:

{  skills: {    entries: {      "image-lab": {        enabled: true,        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string        env: {          GEMINI_API_KEY: "GEMINI_KEY_HERE",        },        config: {          endpoint: "https://example.invalid",          model: "nano-pro",        },      },      peekaboo: { enabled: true },      sag: { enabled: false },    },  },}

Als de skillnaam koppeltekens bevat, zet je de sleutel tussen aanhalingstekens (JSON5 staat aangehaalde sleutels toe). Configuratiesleutels komen standaard overeen met de skillnaam - als een skill metadata.openclaw.skillKey definieert, gebruik die sleutel dan onder skills.entries.

Omgevingsinjectie

Wanneer een agentrun start, doet OpenClaw het volgende:

1. Leest skillmetadata.
2. Past skills.entries.<key>.env en skills.entries.<key>.apiKey toe op process.env.
3. Bouwt de systeemprompt met in aanmerking komende skills.
4. Herstelt de oorspronkelijke omgeving nadat de run eindigt.

Omgevingsinjectie is beperkt tot de agentrun, niet tot een globale shellomgeving.

Voor de gebundelde claude-cli-backend materialiseert OpenClaw dezelfde in aanmerking komende snapshot ook als een tijdelijke Claude Code-plugin en geeft deze door met --plugin-dir. Claude Code kan dan zijn native skillresolver gebruiken, terwijl OpenClaw nog steeds eigenaar blijft van voorrang, allowlists per agent, gating en skills.entries.* env/API-sleutelinjectie. Andere CLI-backends gebruiken alleen de promptcatalogus.

Snapshots en vernieuwen

OpenClaw maakt snapshots van de in aanmerking komende skills wanneer een sessie start en hergebruikt die lijst voor volgende beurten in dezelfde sessie. Wijzigingen aan skills of configuratie worden van kracht bij de volgende nieuwe sessie.

Skills kunnen midden in een sessie in twee gevallen worden vernieuwd:

• De skills-watcher is ingeschakeld.
• Er verschijnt een nieuwe in aanmerking komende remote node.

Zie dit als een hot reload: de vernieuwde lijst wordt opgepakt bij de volgende agentbeurt. Als de effectieve skill-allowlist van de agent voor die sessie verandert, vernieuwt OpenClaw de snapshot zodat zichtbare skills afgestemd blijven op de huidige agent.

Skills-watcher

Standaard bewaakt OpenClaw skillmappen en verhoogt het de skillssnapshot wanneer SKILL.md-bestanden veranderen. Configureer onder skills.load:

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,      watchDebounceMs: 250,    },  },}

Gebruik allowSymlinkTargets voor opzettelijke sibling-repo-layouts waarin een ingebouwde skillroot een symlink bevat, bijvoorbeeld ~/.agents/skills/manager -> ~/Projects/manager/skills. De doellijst wordt gematcht na realpath-resolutie en moet beperkt blijven.

Remote macOS-nodes (Linux-gateway)

Als de Gateway op Linux draait maar een macOS-node is verbonden met system.run toegestaan (Exec-goedkeuringsbeveiliging niet ingesteld op deny), kan OpenClaw macOS-only skills als in aanmerking komend behandelen wanneer de vereiste binaries op die node aanwezig zijn. De agent moet die skills uitvoeren via de exec tool met host=node.

Dit vertrouwt erop dat de node zijn command-ondersteuning rapporteert en op een bin-probe via system.which of system.run. Offline nodes maken remote-only skills niet zichtbaar. Als een verbonden node stopt met reageren op bin-probes, wist OpenClaw zijn gecachte bin-matches zodat agents geen skills meer zien die daar momenteel niet kunnen draaien.

Tokenimpact

Wanneer skills in aanmerking komen, injecteert OpenClaw een compacte XML-lijst met beschikbare skills in de systeemprompt (via formatSkillsForPrompt in pi-coding-agent). De kosten zijn deterministisch:

• Basisoverhead (alleen wanneer ≥1 skill): 195 tekens.
• Per skill: 97 tekens + de lengte van de XML-geëscapete <name>, <description> en <location>-waarden.

Formule (tekens):

total = 195 + Σ (97 + len(name_escaped) + len(description_escaped) + len(location_escaped))

XML-escaping breidt & < > " ' uit naar entiteiten (&, <, enz.), waardoor de lengte toeneemt. Tokenaantallen verschillen per modeltokenizer. Een ruwe OpenAI-achtige schatting is ~4 tekens/token, dus 97 tekens ≈ 24 tokens per skill plus je daadwerkelijke veldlengtes.

Levenscyclus van beheerde skills

OpenClaw levert een basisset skills als gebundelde skills met de installatie (npm-pakket of OpenClaw.app). ~/.openclaw/skills bestaat voor lokale overschrijvingen - bijvoorbeeld om een skill vast te zetten of te patchen zonder de gebundelde kopie te wijzigen. Workspace-skills zijn eigendom van de gebruiker en overschrijven beide bij naamconflicten.

Op zoek naar meer skills?

Blader door https://clawhub.ai. Volledig configuratie schema: Skills-configuratie.

Gerelateerd

• ClawHub - openbaar skillsregister
• Skills maken - custom skills bouwen
• Plugins - overzicht van het pluginsysteem
• Skill Workshop-plugin - skills genereren uit agentwerk
• Skills-configuratie - referentie voor skillconfiguratie
• Slash commands - alle beschikbare slash commands