Skills

• Laat agents.defaults.skills weg om standaard geen beperkingen voor Skills toe te passen.
• Laat agents.list[].skills weg om agents.defaults.skills over te nemen.
• Stel agents.list[].skills: [] in om geen Skills beschikbaar te maken voor die agent.
• Een niet-lege lijst agents.list[].skills is de definitieve verzameling — deze wordt niet samengevoegd met de standaardwaarden.
• De effectieve toelatingslijst geldt voor het opbouwen van prompts, het ontdekken van slash-opdrachten, sandbox-synchronisatie en snapshots van Skills.
• Dit is geen autorisatiegrens voor de hostshell. Als dezelfde agent exec kan gebruiken, beperk die shell dan afzonderlijk met sandboxing, isolatie per OS-gebruiker, weigerings-/toelatingslijsten voor uitvoering en inloggegevens per resource.

openclaw skills install installeert standaard in de map skills/ van de actieve werkruimte. Voeg --global toe om te installeren in de gedeelde map ~/.openclaw/skills, die zichtbaar is voor alle lokale agents tenzij toelatingslijsten voor agents dit beperken.

Bij installaties vanuit Git en lokale bronnen wordt SKILL.md in de hoofdmap van de bron verwacht. De slug wordt overgenomen uit name in de frontmatter van SKILL.md wanneer deze geldig is en valt anders terug op de naam van de map of repository. Gebruik --as <slug> om dit te overschrijven. openclaw skills update houdt alleen ClawHub-installaties bij — installeer Git- of lokale bronnen opnieuw om ze te vernieuwen.

openclaw skills verify @owner/<slug> vraagt ClawHub om het vertrouwensprofiel clawhub.skill.verify.v1 van de Skill. Geïnstalleerde ClawHub-Skills worden geverifieerd aan de hand van de versie en het register die in .clawhub/origin.json zijn vastgelegd. Kale slugs blijven geaccepteerd voor bestaande geïnstalleerde of eenduidige Skills, maar verwijzingen met een eigenaar voorkomen onduidelijkheid over de uitgever.

ClawHub-pagina's voor Skills tonen vóór installatie de status van de meest recente beveiligingsscan, met detailpagina's voor VirusTotal, ClawScan en statische analyse. De opdracht eindigt met een niet-nulcode wanneer ClawHub de verificatie als mislukt markeert. Uitgevers kunnen fout-positieve resultaten herstellen via het ClawHub-dashboard of clawhub skill rescan @owner/<slug>.

Gateway-clients die levering buiten ClawHub nodig hebben, kunnen een ziparchief met een Skill klaarzetten met skills.upload.begin, skills.upload.chunk en skills.upload.commit, en dit vervolgens installeren met skills.install({ source: "upload", ... }). Dit pad is standaard uitgeschakeld en vereist skills.install.allowUploadedArchives: true in openclaw.json. Voor normale ClawHub-installaties is die instelling nooit nodig.

Bij het ontdekken van Skills in werkruimten, projectagents en extra mappen worden alleen hoofd- mappen voor Skills geaccepteerd waarvan het opgeloste realpath binnen de geconfigureerde hoofdmap blijft, tenzij skills.load.allowSymlinkTargets een doelhoofdmap expliciet vertrouwt. Skill Workshop schrijft alleen via die vertrouwde doelen wanneer skills.workshop.allowSymlinkTargetWrites is ingeschakeld. Beheerde ~/.openclaw/skills en persoonlijke ~/.agents/skills mogen via symbolische koppelingen verbonden Skill-mappen bevatten, maar het realpath van elk SKILL.md moet nog steeds binnen de opgeloste Skill-map blijven.

Configureer security.installPolicy om een vertrouwde lokale beleidsopdracht uit te voeren voordat installaties van Skills doorgaan. Het beleid ontvangt metadata en het klaargezette bronpad, is van toepassing op ClawHub-, upload-, Git-, lokale, update- en afhankelijkheidsinstallatiepaden en weigert standaard wanneer de opdracht geen geldige beslissing kan retourneren.

skills.entries.*.env en skills.entries.*.apiKey injecteren geheimen alleen voor die agentbeurt in het hostproces — niet in de sandbox. Houd geheimen buiten prompts en logboeken.

• Wanneer meerdere installatieprogramma's zijn vermeld, kiest de Gateway één voorkeursoptie (brew indien beschikbaar, anders node).
• Als alle installatieprogramma's download zijn, vermeldt OpenClaw elk item, zodat u alle beschikbare artefacten kunt zien.
• Specificaties kunnen os: ["darwin"|"linux"|"win32"] bevatten om op platform te filteren.
• Node-installaties respecteren skills.install.nodeManager in openclaw.json (standaard: npm; opties: npm / pnpm / yarn / bun). Dit is alleen van invloed op de installatie van skills; de runtime van de Gateway moet nog steeds Node zijn.
• Installatievoorkeur van de Gateway: Homebrew → uv → geconfigureerde nodebeheerder → go → download.

• Homebrew: OpenClaw installeert Homebrew niet automatisch en vertaalt brew-formules niet naar opdrachten voor systeempakketten. In Linux-containers zonder brew worden installatieprogramma's die alleen brew ondersteunen verborgen; gebruik een aangepaste image of installeer de afhankelijkheid handmatig.
• Go: OpenClaw vereist Go 1.21 of nieuwer voor automatische installatie van skills. Als go ontbreekt en Homebrew beschikbaar is, installeert OpenClaw eerst Go via Homebrew; op Linux zonder Homebrew kan het in plaats daarvan apt-get als root of via sudo zonder wachtwoord gebruiken wanneer de vernieuwde kandidaat golang-go aan de minimumversie voldoet. De daadwerkelijke go install voor de afhankelijkheid gebruikt altijd een speciale door OpenClaw beheerde map voor binaire bestanden (de bin-map van Homebrew bij een nieuwe installatie, anders ~/.local/bin) in plaats van uw geconfigureerde GOBIN — uw eigen omgevingsvariabelen GOBIN, GOPATH en GOTOOLCHAIN worden gelezen, maar nooit overschreven.
• Download: url (verplicht), archive (tar.gz | tar.bz2 | zip), extract (standaard: automatisch wanneer een archief wordt gedetecteerd), stripComponents, targetDir (standaard: ~/.openclaw/tools/<skillKey>).

requires.bins wordt tijdens het laden van de skill op de host gecontroleerd. Als een agent in een sandbox wordt uitgevoerd, moet het binaire bestand ook in de container aanwezig zijn. Installeer het via agents.defaults.sandbox.docker.setupCommand of een aangepaste image. setupCommand wordt eenmaal na het maken van de container uitgevoerd en vereist uitgaand netwerkverkeer, een beschrijfbaar rootbestandssysteem en een rootgebruiker in de sandbox.

OpenClaw bewaakt standaard de mappen met skills en werkt de momentopname bij wanneer SKILL.md-bestanden veranderen. Configureer dit onder skills.load:

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

Gebruik allowSymlinkTargets voor opzettelijke indelingen met symbolische koppelingen waarbij een symbolische koppeling naar de hoofdmap van een skill buiten de geconfigureerde hoofdmap verwijst, bijvoorbeeld <workspace>/skills/manager -> ~/Projects/manager/skills. Schakel skills.workshop.allowSymlinkTargetWrites alleen in wanneer Skill Workshop voorstellen ook via die vertrouwde paden met symbolische koppelingen moet toepassen.

Als de Gateway op Linux draait, maar er een macOS-node is verbonden waarop system.run is toegestaan, kan OpenClaw skills die alleen voor macOS zijn bedoeld als geschikt beschouwen wanneer de vereiste binaire bestanden op die node aanwezig zijn. De agent moet die skills uitvoeren via de tool exec met host=node.

Offline nodes maken skills die alleen extern beschikbaar zijn niet zichtbaar. Als een node niet meer reageert op controles van binaire bestanden, wist OpenClaw de overeenkomsten uit de cache.