Skills

• Laat agents.defaults.skills weg om standaard geen beperkingen voor skills toe te passen.
• Laat agents.entries.*.skills weg om agents.defaults.skills over te nemen.
• Stel agents.entries.*.skills: [] in om voor die agent geen skills beschikbaar te maken.
• Een niet-lege lijst agents.entries.*.skills is de definitieve set — deze wordt niet samengevoegd met de standaardwaarden.
• De effectieve toelatingslijst geldt voor het opbouwen van prompts, het ontdekken van slashopdrachten, sandboxsynchronisatie en skillsnapshots.
• Dit is geen autorisatiegrens voor de hostshell. Als dezelfde agent exec kan gebruiken, beperk die shell dan afzonderlijk met sandboxing, isolatie per OS-gebruiker, uitvoeringsblokkeer-/toelatingslijsten en referenties per resource.

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

Bij Git- en lokale installaties wordt SKILL.md in de hoofdmap van de bron verwacht. De slug komt, indien geldig, uit name in de SKILL.md-frontmatter en valt vervolgens terug op de map- of repositorynaam. 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 de clawhub.skill.verify.v1-vertrouwensgrenzen 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-skillpagina's tonen vóór de installatie de status van de nieuwste beveiligingsscan, met detailpagina's voor VirusTotal, ClawScan en statische analyse. De opdracht sluit af met een niet-nulstatus 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. Normale ClawHub-installaties hebben die instelling nooit nodig.

Bij het ontdekken van werkruimte-, projectagent- en extra-mapskills worden alleen skillhoofdmappen geaccepteerd waarvan het opgeloste realpath binnen de geconfigureerde hoofdmap blijft, tenzij skills.load.allowSymlinkTargets een doelhoofdmap expliciet vertrouwt. Skill Workshop schrijft alleen via deze vertrouwde doelen wanneer skills.workshop.allowSymlinkTargetWrites is ingeschakeld. Beheerde ~/.openclaw/skills en persoonlijke ~/.agents/skills mogen skillmappen met symbolische koppelingen bevatten, maar elk realpath van SKILL.md moet nog steeds binnen de opgeloste skillmap blijven.

Configureer security.installPolicy om een vertrouwde lokale beleidsopdracht uit te voeren voordat skillinstallaties doorgaan. Het beleid ontvangt metagegevens en het klaargezette bronpad, is van toepassing op ClawHub-, upload-, Git-, lokale, update- en afhankelijkheidsinstallatiepaden, en sluit uit veiligheidsoverwegingen af 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 uit prompts en logboeken.

• Wanneer meerdere installatieprogramma's worden vermeld, kiest de Gateway één voorkeursoptie (brew indien beschikbaar, anders node).
• Als alle installatieprogramma's download zijn, vermeldt OpenClaw elk item zodat je 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 skillinstallaties; de Gateway-runtime 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 pakketopdrachten van het systeem. 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 skillinstallaties. 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 wachtwoordloze sudo gebruiken wanneer de vernieuwde golang-go- kandidaat aan de minimumversie voldoet. De daadwerkelijke go install voor de afhankelijkheid is altijd gericht op een speciale, door OpenClaw beheerde map voor binaire bestanden (bin van Homebrew bij een nieuwe installatie, anders ~/.local/bin) en niet op je geconfigureerde GOBIN — je eigen omgevingsvariabelen GOBIN, GOPATH en GOTOOLCHAIN worden gelezen, maar nooit overschreven.
• Download: url (vereist), 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 bestaan. 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.

Standaard bewaakt OpenClaw skillmappen en werkt het 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, // standaard    },  },}

Watchergebeurtenissen gebruiken een ingebouwde debounce van 250 ms. Gebruik allowSymlinkTargets voor opzettelijke indelingen met symbolische koppelingen waarbij een symbolische koppeling van een skillhoofdmap buiten de geconfigureerde hoofdmap wijst, 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 wordt uitgevoerd, maar een macOS-node is verbonden waarop system.run is toegestaan, kan OpenClaw uitsluitend voor macOS bestemde skills 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 uitsluitend externe skills niet zichtbaar. Als een node niet meer reageert op controles naar binaire bestanden, wist OpenClaw de overeenkomsten met binaire bestanden uit de cache.