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 exec gebruikt, 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