Skills maken

Skills leren de agent hoe en wanneer tools moeten worden gebruikt. Elke skill is een map met een SKILL.md-bestand met YAML-frontmatter en Markdown-instructies. OpenClaw laadt skills vanuit verschillende hoofdmappen in een vastgelegde prioriteitsvolgorde.

Je eerste skill maken

Maak de skillmap

Skills bevinden zich in de map skills/ van je werkruimte:

mkdir -p ~/.openclaw/workspace/skills/hello-world

Je kunt skills ter ordening in submappen groeperen — de skill wordt nog steeds benoemd via de SKILL.md-frontmatter, niet via het mappad:

mkdir -p ~/.openclaw/workspace/skills/personal/hello-world
# de skillnaam blijft "hello-world", aangeroepen als /hello-world

Schrijf SKILL.md

De frontmatter definieert metadata; de hoofdtekst bevat instructies voor de agent.

---
name: hello-world
description: Een eenvoudige skill die een begroeting afdrukt.
---

# Hallo wereld

Wanneer de gebruiker om een begroeting vraagt, gebruik je de tool `exec` om het volgende uit te voeren:

```bash
echo "Hallo vanuit je aangepaste skill!"

Naamgevingsregels:
- Gebruik kleine letters, cijfers en koppeltekens voor `name`.
- Houd de mapnaam en `name` in de frontmatter gelijk.
- `description` wordt aan de agent en bij het vinden van slash-opdrachten weergegeven —
  houd deze op één regel en korter dan 160 tekens.

</Step>

<Step title="Controleer of de skill is geladen">
```bash
openclaw skills list

OpenClaw bewaakt standaard SKILL.md-bestanden onder de hoofdmappen voor skills. Als de bewaking is uitgeschakeld of je doorgaat met een bestaande sessie, start je een nieuwe sessie zodat de agent de vernieuwde lijst ontvangt:

# Vanuit de chat — archiveer de huidige sessie en begin opnieuw
/new

# Of start de Gateway opnieuw
openclaw gateway restart

Test de skill

openclaw agent --message "geef me een begroeting"

Je kunt ook een chat openen en het rechtstreeks aan de agent vragen. Gebruik /skill hello-world om de skill expliciet op naam aan te roepen.

Naslaginformatie voor SKILL.md

Verplichte velden

Veld	Beschrijving
`name`	Unieke slug met kleine letters, cijfers en koppeltekens
`description`	Beschrijving van één regel die aan de agent en in zoekresultaten wordt weergegeven

Optionele frontmatter-sleutels

Veld	Standaard	Beschrijving
`user-invocable`	`true`	Stel de skill beschikbaar als een slash-opdracht voor gebruikers
`disable-model-invocation`	`false`	Houd de skill buiten de systeemprompt van de agent (wordt nog steeds uitgevoerd via `/skill`)
`command-dispatch`	—	Stel dit in op `tool` om de slash-opdracht rechtstreeks naar een tool te routeren en het model te omzeilen
`command-tool`	—	Naam van de tool die wordt aangeroepen wanneer `command-dispatch: tool` is ingesteld
`command-arg-mode`	`raw`	Stuurt bij toolroutering de onbewerkte argumenttekenreeks door naar de tool
`homepage`	—	URL die als “Website” wordt weergegeven in de macOS-interface voor Skills

Zie voor activeringsvoorwaarden (requires.bins, requires.env, enzovoort) Skills — Activeringsvoorwaarden.

`{baseDir}` gebruiken

Verwijs naar bestanden in de skillmap zonder paden hard te coderen — de agent herleidt {baseDir} ten opzichte van de eigen map van de skill:

Voer het helperscript uit op `{baseDir}/scripts/run.sh`.

Voorwaardelijke activering toevoegen

Stel voorwaarden in voor je skill, zodat deze alleen wordt geladen wanneer de afhankelijkheden beschikbaar zijn:

---
name: gemini-search
description: Zoeken met Gemini CLI.
metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }
---

Opties voor activeringsvoorwaarden

Sleutel	Beschrijving
`requires.bins`	Alle binaire bestanden moeten aanwezig zijn in `PATH`
`requires.anyBins`	Ten minste één binair bestand moet aanwezig zijn in `PATH`
`requires.env`	Elke omgevingsvariabele moet aanwezig zijn in het proces of de configuratie
`requires.config`	Elk `openclaw.json`-pad moet een waarheidswaarde hebben
`os`	Platformfilter: `["darwin"]`, `["linux"]`, `["win32"]`
`always`	Stel `true` in om alle voorwaarden over te slaan en de skill altijd op te nemen

Volledige naslaginformatie: Skills — Activeringsvoorwaarden.

Omgeving en API-sleutels

Koppel een API-sleutel aan een skillvermelding 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 omgevingsvariabelen in de sandbox.

Voorstellen via Skill Workshop

Gebruik voor door agents opgestelde skills, of wanneer je een operator een skill wilt laten beoordelen voordat deze actief wordt, voorstellen van Skill Workshop in plaats van SKILL.md rechtstreeks te schrijven.

# Stel een volledig nieuwe skill voor
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "Een eenvoudige skill die een begroeting afdrukt." \
  --proposal ./PROPOSAL.md

# Stel een update voor een bestaande skill voor
openclaw skills workshop propose-update hello-world \
  --proposal ./PROPOSAL.md \
  --description "Bijgewerkte begroetingsskill"

Gebruik --proposal-dir wanneer het voorstel ondersteunende bestanden bevat:

openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "Een eenvoudige skill die een begroeting afdrukt." \
  --proposal-dir ./hello-world-proposal/

De map moet PROPOSAL.md in de hoofdmap bevatten. Ondersteunende bestanden komen onder 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

Zorg dat je SKILL.md volledig is

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

Installeer de zelfstandige ClawHub CLI en meld je aan

npm i -g clawhub
clawhub login

Publiceer

clawhub skill publish ./path/to/hello-world

Voeg --version <version> of --owner <owner> toe om de afgeleide versie te overschrijven of onder een specifieke eigenaar te publiceren. Zie ClawHub — Publiceren en ClawHub CLI voor de volledige flow, eigenaarsbereik en andere onderhoudsopdrachten (clawhub sync, clawhub skill rename, …).

Aanbevolen werkwijzen

Wees beknopt — instrueer het model over wat het moet doen, niet hoe het een AI moet zijn.
Veiligheid voorop — als je skill exec gebruikt, zorg er dan voor dat prompts geen willekeurige opdrachtinjectie vanuit niet-vertrouwde invoer toestaan.
Test lokaal — gebruik openclaw agent --message "..." voordat je de skill deelt.
Gebruik ClawHub — bekijk communityskills op clawhub.ai voordat je iets vanaf nul bouwt.

Gerelateerd

Naslaginformatie voor Skills

Laadvolgorde, activeringsvoorwaarden, toegestane lijsten en de SKILL.md-indeling.

Skill Workshop

Voorstelwachtrij voor door agents opgestelde skills.

Configuratie van Skills

Volledig configuratieschema voor skills.*.

ClawHub

Bekijk en publiceer skills in het openbare register.

Plugins bouwen

Plugins kunnen skills meeleveren naast de tools die ze documenteren.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Je eerste skill maken

Naslaginformatie voor SKILL.md

Verplichte velden

Optionele frontmatter-sleutels

`{baseDir}` gebruiken

Voorwaardelijke activering toevoegen

Voorstellen via Skill Workshop

Publiceren naar ClawHub

Aanbevolen werkwijzen

Gerelateerd

Naslaginformatie voor Skills

Skill Workshop

Configuratie van Skills

ClawHub

Plugins bouwen

​Je eerste skill maken

​Naslaginformatie voor SKILL.md

​Verplichte velden

​Optionele frontmatter-sleutels

​{baseDir} gebruiken

​Voorwaardelijke activering toevoegen

​Voorstellen via Skill Workshop

​Publiceren naar ClawHub

​Aanbevolen werkwijzen

​Gerelateerd

Naslaginformatie voor Skills

Skill Workshop

Configuratie van Skills

ClawHub

Plugins bouwen

Je eerste skill maken

Naslaginformatie voor SKILL.md

Verplichte velden

Optionele frontmatter-sleutels

`{baseDir}` gebruiken

Voorwaardelijke activering toevoegen

Voorstellen via Skill Workshop

Publiceren naar ClawHub

Aanbevolen werkwijzen

Gerelateerd