Skills
Skills maken
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 skilldirectory
Skills staan in je workspace. Maak een nieuwe map:
mkdir -p ~/.openclaw/workspace/skills/hello-world
Schrijf SKILL.md
Maak SKILL.md aan binnen die directory. De frontmatter definieert metadata,
en de markdown-body bevat instructies voor de agent.
---
name: hello-world
description: 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 kebab-case met kleine letters, cijfers en koppeltekens voor de skill
name. Houd de mapnaam en frontmatter-name gelijk.
Tools toevoegen (optioneel)
Je kunt aangepaste toolschema's in de frontmatter definiëren of de agent
instrueren om bestaande systeemtools (zoals exec of browser) te gebruiken. Skills kunnen ook
in plugins worden meegeleverd naast de tools die ze documenteren.
De skill laden
Start een nieuwe sessie zodat OpenClaw de skill oppikt:
# From chat
/new
# Or restart the gateway
openclaw gateway restart
Controleer of de skill is geladen:
openclaw skills list
Test hem
Stuur een bericht dat de skill zou moeten activeren:
openclaw agent --message "give me a greeting"
Of chat gewoon met de agent en vraag om een begroeting.
Referentie voor skillmetadata
De YAML-frontmatter ondersteunt deze velden:
| Veld | Vereist | Beschrijving |
|---|---|---|
name |
Ja | Unieke identifier met kleine letters, cijfers en koppeltekens |
description |
Ja | Beschrijving van één regel 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 configuratiesleutels |
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 uit niet-vertrouwde invoer toestaan - Test lokaal — gebruik
openclaw agent --message "..."om te testen voordat je deelt - Gebruik ClawHub — blader door skills en draag eraan bij op ClawHub
Waar skills staan
| Locatie | Voorrang | Bereik |
|---|---|---|
\<workspace\>/skills/ |
Hoogste | Per agent |
\<workspace\>/.agents/skills/ |
Hoog | Per workspace-agent |
~/.agents/skills/ |
Gemiddeld | Gedeeld agentprofiel |
~/.openclaw/skills/ |
Gemiddeld | Gedeeld (alle agents) |
| Gebundeld (meegeleverd met OpenClaw) | Laag | Globaal |
skills.load.extraDirs |
Laagste | Aangepaste gedeelde mappen |
Gerelateerd
- Skills-referentie — laad-, voorrangs- en gatingregels
- Skills-configuratie —
skills.*-configuratieschema - ClawHub — openbaar skillregister
- Plugins bouwen — plugins kunnen skills meeleveren