Naar hoofdinhoud gaan
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. OpenClaw laadt Skills uit meerdere roots in een gedefinieerde volgorde van prioriteit.

​
Maak je eerste skill

1

Maak de skilldirectory

Skills staan in de map skills/ van je workspace. Maak een directory voor je nieuwe skill:
mkdir -p ~/.openclaw/workspace/skills/hello-world
Je kunt Skills groeperen in submappen voor organisatie — de skill wordt nog steeds benoemd door de SKILL.md-frontmatter, niet door het mappad:
mkdir -p ~/.openclaw/workspace/skills/personal/hello-world
# skill name is still "hello-world", invoked as /hello-world
2

Schrijf SKILL.md

Maak SKILL.md aan in de directory. De frontmatter definieert metadata; de body geeft de agent instructies.
---
name: hello-world
description: A simple skill that prints a greeting.
---

# Hello World

When the user asks for a greeting, use the `exec` tool to run:

```bash
echo "Hello from your custom skill!"


Naamgevingsregels:
- Gebruik kleine letters, cijfers en koppeltekens voor `name`.
- Houd de directorynaam en frontmatter-`name` op elkaar afgestemd.
- `description` wordt getoond aan de agent en in slash-command-detectie —
  houd deze op één regel en onder 160 tekens.

</Step>

<Step title="Controleer of de skill is geladen">
```bash
openclaw skills list
OpenClaw bewaakt standaard SKILL.md-bestanden onder skillroots. Als de watcher is uitgeschakeld of je een bestaande sessie voortzet, start dan een nieuwe zodat de agent de vernieuwde lijst ontvangt:
# From chat — archive current session and start fresh
/new

# Or restart the gateway
openclaw gateway restart
3

Test het

Stuur een bericht dat de skill zou moeten activeren:
openclaw agent --message "give me a greeting"
Of open een chat en vraag het rechtstreeks aan de agent. Gebruik /skill hello-world om deze expliciet op naam aan te roepen.

​
SKILL.md-referentie

​
Vereiste velden

VeldBeschrijving
nameUnieke slug met kleine letters, cijfers en koppeltekens
descriptionBeschrijving van één regel die aan de agent en in detectie-uitvoer wordt getoond

​
Optionele frontmatter-sleutels

VeldStandaardBeschrijving
user-invocabletrueStel de skill beschikbaar als slash-command voor gebruikers
disable-model-invocationfalseHoud de skill buiten de systeemprompt van de agent (draait nog steeds via /skill)
command-dispatch—Stel in op tool om het slash-command direct naar een tool te routeren, buiten het model om
command-tool—Toolnaam om aan te roepen wanneer command-dispatch: tool is ingesteld
command-arg-moderawStuurt bij tooldispatch de raw args string door naar de tool
homepage—URL die als “Website” wordt getoond in de macOS Skills UI
Zie voor gatevelden (requires.bins, requires.env, enz.) Skills — gating.

​
{baseDir} gebruiken

Gebruik {baseDir} in de skillbody om te verwijzen naar bestanden binnen de skilldirectory zonder paden hard te coderen: 
Run the helper script at `{baseDir}/scripts/run.sh`.

​
Voorwaardelijke activatie toevoegen

Gate je skill zodat deze alleen laadt wanneer de afhankelijkheden beschikbaar zijn: 
---
name: gemini-search
description: Search using Gemini CLI.
metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }
---
SleutelBeschrijving
requires.binsAlle binaries moeten bestaan op PATH
requires.anyBinsMinstens één binary moet bestaan op PATH
requires.envElke env var moet bestaan in het proces of de configuratie
requires.configElk openclaw.json-pad moet truthy zijn
osPlatformfilter: ["darwin"], ["linux"], ["win32"]
alwaysStel in op true om alle gates over te slaan en de skill altijd op te nemen
Volledige referentie: Skills — gating.
Koppel een API-sleutel aan een skillitem in openclaw.json:
{
  skills: {
    entries: {
      "gemini-search": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
      },
    },
  },
}
De sleutel wordt alleen voor die agentbeurt in het hostproces geïnjecteerd. Deze bereikt de sandbox niet — zie sandboxed env vars.

​
Voorstellen via Skill Workshop

Gebruik voor door agents opgestelde Skills, of wanneer je operatorbeoordeling wilt voordat een skill live gaat, voorstellen van Skill Workshop in plaats van SKILL.md rechtstreeks te schrijven. 
# Propose a brand-new skill
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal ./PROPOSAL.md

# Propose an update to an existing skill
openclaw skills workshop propose-update hello-world \
  --proposal ./PROPOSAL.md \
  --description "Updated greeting skill"
Gebruik --proposal-dir wanneer het voorstel ondersteunende bestanden bevat: 
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal-dir ./hello-world-proposal/
De directory moet PROPOSAL.md bevatten. Ondersteunende bestanden kunnen in assets/, examples/, references/, scripts/ of templates/. Na beoordeling: 
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>
Zie Skill Workshop voor de volledige levenscyclus van voorstellen.

​
Publiceren naar ClawHub

1

Zorg dat je SKILL.md compleet is

Zorg dat name, description en eventuele metadata.openclaw-gatevelden zijn ingesteld. Voeg een homepage-URL toe als je een projectpagina hebt.
2

Installeer de ClawHub-skill

De ClawHub-skill documenteert de huidige vorm van het publish-command en vereiste metadata:
openclaw skills install @openclaw/clawhub-publish
3

Publiceer

clawhub publish
Zie ClawHub — publiceren voor de volledige flow.

​
Best practices

  • Wees beknopt — instrueer het model over wat het moet doen, niet hoe het een AI moet zijn.
  • Veiligheid eerst — als je skill exec gebruikt, zorg er dan voor dat prompts geen willekeurige commando-injectie vanuit niet-vertrouwde invoer toestaan.
  • Test lokaal — gebruik openclaw agent --message "..." voordat je deelt.
  • Gebruik ClawHub — blader door community-Skills op clawhub.ai voordat je vanaf nul bouwt.

​
Gerelateerd

Skills-referentie

Laadvolgorde, gating, allowlists en SKILL.md-formaat.

Skill Workshop

Voorstelwachtrij voor door agents opgestelde Skills.

Skills-configuratie

Volledig skills.*-configuratieschema.

ClawHub

Blader door Skills en publiceer ze in het openbare register.

Plugins bouwen

Plugins kunnen Skills meeleveren naast de tools die ze documenteren.