Skills
Skills aanmaken
Skills leren de agent hoe en wanneer tools te gebruiken. Elke skill is een directory
met een SKILL.md-bestand met YAML-frontmatter en markdown-instructies.
Zie Skills voor hoe Skills worden geladen en geprioriteerd.
Maak je eerste skill
Maak de skill-directory
Skills staan in je werkruimte. Maak een nieuwe map:
mkdir -p ~/.openclaw/workspace/skills/hello-worldSchrijf SKILL.md
Maak SKILL.md in die directory. De frontmatter definieert metadata,
en de markdown-body bevat instructies voor de agent.
---name: hello-worlddescription: A simple skill that says hello.--- # Hello World Skill When the user asks for a greeting, use the `echo` tool to say"Hello from your custom skill!".Gebruik hyphen-case met kleine letters, cijfers en koppeltekens voor de skill
name. Houd de mapnaam en frontmatter-name gelijk.
Voeg tools toe (optioneel)
Je kunt aangepaste toolschema's definiëren in de frontmatter of de agent instrueren
bestaande systeemtools te gebruiken (zoals exec of browser). Skills kunnen ook
binnen plugins worden meegeleverd naast de tools die ze documenteren.
Laad de skill
Start een nieuwe sessie zodat OpenClaw de skill oppikt:
# From chat/new # Or restart the gatewayopenclaw gateway restartControleer of de skill is geladen:
openclaw skills listTest het
Stuur een bericht dat de skill zou moeten triggeren:
openclaw agent --message "give me a greeting"Of chat gewoon met de agent en vraag om een begroeting.
Referentie voor skill-metadata
De YAML-frontmatter ondersteunt deze velden:
| Veld | Vereist | Beschrijving |
|---|---|---|
name |
Ja | Unieke identifier met kleine letters, cijfers en koppeltekens |
description |
Ja | Eénregelige beschrijving die aan de agent wordt getoond |
metadata.openclaw.os |
Nee | OS-filter (["darwin"], ["linux"], enz.) |
metadata.openclaw.requires.bins |
Nee | Vereiste binaries op PATH |
metadata.openclaw.requires.config |
Nee | Vereiste config-sleutels |
Best practices
- Wees beknopt — instrueer het model over wat het moet doen, niet hoe het een AI moet zijn
- Veiligheid eerst — als je skill
execgebruikt, zorg er dan voor dat prompts geen willekeurige command-injectie vanuit onvertrouwde invoer toestaan - Test lokaal — gebruik
openclaw agent --message "..."om te testen voordat je deelt - Gebruik ClawHub — blader door en draag Skills bij op ClawHub
Waar Skills staan
| Locatie | Voorrang | Scope |
|---|---|---|
\<workspace\>/skills/ |
Hoogst | Per agent |
\<workspace\>/.agents/skills/ |
Hoog | Per werkruimte-agent |
~/.agents/skills/ |
Gemiddeld | Gedeeld agentprofiel |
~/.openclaw/skills/ |
Gemiddeld | Gedeeld (alle agents) |
| Gebundeld (meegeleverd met OpenClaw) | Laag | Globaal |
skills.load.extraDirs |
Laagst | Aangepaste gedeelde mappen |
Gerelateerd
- Skills-referentie — laad-, voorrangs- en gatingregels
- Skills-config —
skills.*-configschema - ClawHub — openbaar skill-register
- Plugins bouwen — plugins kunnen Skills meeleveren