OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Skills

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.

Maak je eerste skill

  • Maak de skillmap

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

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

    Je kunt skills ter ordening in submappen groeperen — de naam van de skill wordt nog steeds bepaald door de frontmatter van SKILL.md, niet door het mappad:

    bash
    mkdir -p ~/.openclaw/workspace/skills/personal/hello-world# de naam van de skill is nog steeds "hello-world", aangeroepen als /hello-world

  • Schrijf SKILL.md

    De frontmatter definieert de metagegevens; de inhoud bevat instructies voor de agent.

    markdown
    ---name: hello-worlddescription: Een eenvoudige skill die een begroeting weergeeft.--- # Hallo wereld Wanneer de gebruiker om een begroeting vraagt, gebruik je de tool `exec` om het volgende uit te voeren: ```bashecho "Hallo vanuit je aangepaste skill!"
    Code
     Naamgevingsregels:- Gebruik kleine letters, cijfers en koppeltekens voor `name`.- Zorg dat de mapnaam en `name` in de frontmatter overeenkomen.- `description` wordt aan de agent en in de ontdekking van slash-opdrachten getoond —  houd deze op één regel en korter dan 160 tekens.  OPENCLAW_DOCS_MARKER:stepClose:   OPENCLAW_DOCS_MARKER:stepOpen:IHRpdGxlPSJDb250cm9sZWVyIG9mIGRlIHNraWxsIGlzIGdlbGFkZW4i ```bashopenclaw 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 zodat de agent de vernieuwde lijst ontvangt:

    bash
    # Vanuit de chat — archiveer de huidige sessie en begin opnieuw/new # Of start de Gateway opnieuwopenclaw gateway restart

  • Test de skill

    bash
    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.

    • Naslag 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 de zoekresultaten wordt getoond

    Optionele frontmatter-sleutels

    Veld Standaardwaarde Beschrijving
    user-invocable true Stel de skill beschikbaar als slash-opdracht voor gebruikers
    disable-model-invocation false Laat de skill weg uit de systeemprompt van de agent (werkt nog steeds via /skill)
    command-dispatch — Stel in op tool om de slash-opdracht rechtstreeks naar een tool te leiden, zonder het model
    command-tool — Naam van de tool die wordt aangeroepen wanneer command-dispatch: tool is ingesteld
    command-arg-mode raw Stuurt bij toolroutering de onbewerkte tekenreeks met argumenten door naar de tool
    homepage — URL die als "Website" wordt getoond in de Skills-interface van macOS

    Zie Skills — Voorwaarden voor voorwaardevelden (requires.bins, requires.env, enzovoort).

    {baseDir} gebruiken

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

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

    Voorwaardelijke activering toevoegen

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

    markdown
    ---name: gemini-searchdescription: Zoeken met Gemini CLI.metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }---
    Voorwaardeopties
    Sleutel Beschrijving
    requires.bins Alle uitvoerbare bestanden moeten op PATH bestaan
    requires.anyBins Ten minste één uitvoerbaar bestand moet op PATH bestaan
    requires.env Elke omgevingsvariabele moet in het proces of de configuratie bestaan
    requires.config Elk pad in openclaw.json moet een waarheidswaarde hebben
    os Platformfilter: ["darwin"], ["linux"], ["win32"]
    always Stel in op true om alle voorwaarden over te slaan en de skill altijd op te nemen

    Volledige naslag: Skills — Voorwaarden.

    Omgeving en API-sleutels

    Koppel een API-sleutel aan een skillvermelding in openclaw.json:

    json5
    {  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. De sleutel bereikt de sandbox niet — zie omgevingsvariabelen in de sandbox.

    Voorstellen via Skill Workshop

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

    bash
    # Stel een volledig nieuwe skill vooropenclaw skills workshop propose-create \  --name "hello-world" \  --description "Een eenvoudige skill die een begroeting weergeeft." \  --proposal ./PROPOSAL.md # Stel een update van een bestaande skill vooropenclaw skills workshop propose-update hello-world \  --proposal ./PROPOSAL.md \  --description "Bijgewerkte begroetingsskill"

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

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

    De hoofdmap moet PROPOSAL.md bevatten. Ondersteunende bestanden komen onder assets/, examples/, references/, scripts/ of templates/.

    Na beoordeling:

    bash
    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 voorwaardevelden onder metadata.openclaw zijn ingesteld. Voeg een homepage-URL toe als je een projectpagina hebt.

  • Installeer de zelfstandige ClawHub CLI en meld je aan

    bash
    npm i -g clawhubclawhub login

  • Publiceer

    bash
    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 procedure, afbakening per eigenaar en andere onderhoudsopdrachten (clawhub sync, clawhub skill rename, ...).

    • Aanbevolen werkwijzen

    Gerelateerd

    Naslag voor Skills

    Laadvolgorde, voorwaarden, toestemmingslijsten en de indeling van SKILL.md.
    Skill Workshop

    Voorstellenwachtrij voor door agents opgestelde skills.
    Skills-configuratie

    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.
    Was this useful?
    On this page

    On this page