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.

Je eerste skill maken

  • 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 skill wordt nog steeds benoemd via de SKILL.md-frontmatter, niet via het mappad:

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

    markdown
    ---name: hello-worlddescription: 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: ```bashecho "Hallo vanuit je aangepaste skill!"
    Code
     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.  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 sessie 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.

    • 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:

    markdown
    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:

    markdown
    ---name: gemini-searchdescription: 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:

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

    bash
    # Stel een volledig nieuwe skill vooropenclaw 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 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 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:

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

    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 flow, eigenaarsbereik en andere onderhoudsopdrachten (clawhub sync, clawhub skill rename, ...).

    • Aanbevolen werkwijzen

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

    On this page