Skills

Tworzenie Skills

Skills uczą agenta, jak i kiedy używać narzędzi. Każdy skill jest katalogiem zawierającym plik SKILL.md z frontmatter YAML i instrukcjami w Markdown.

Informacje o tym, jak Skills są ładowane i priorytetyzowane, znajdziesz w Skills.

Utwórz swój pierwszy skill

Utwórz katalog skill

Skills znajdują się w Twoim obszarze roboczym. Utwórz nowy folder:

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

Napisz SKILL.md

Utwórz SKILL.md w tym katalogu. Frontmatter definiuje metadane, a treść Markdown zawiera instrukcje dla agenta.

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

Użyj zapisu z dywizami, małymi literami, cyframi i dywizami dla name skill. Zachowaj zgodność nazwy folderu i name we frontmatter.

Dodaj narzędzia (opcjonalnie)

Możesz zdefiniować niestandardowe schematy narzędzi we frontmatter albo poinstruować agenta, aby używał istniejących narzędzi systemowych (takich jak exec lub browser). Skills mogą także być dostarczane wewnątrz plugins razem z narzędziami, które dokumentują.

Załaduj skill

Uruchom nową sesję, aby OpenClaw wykrył skill:

# From chat
/new

# Or restart the gateway
openclaw gateway restart

Sprawdź, czy skill został załadowany:

openclaw skills list

Przetestuj go

Wyślij wiadomość, która powinna uruchomić skill:

openclaw agent --message "give me a greeting"

Albo po prostu porozmawiaj z agentem i poproś o powitanie.

Dokumentacja metadanych skill

Frontmatter YAML obsługuje te pola:

Pole	Wymagane	Opis
`name`	Tak	Unikalny identyfikator używający małych liter, cyfr i dywizów
`description`	Tak	Jednowierszowy opis pokazywany agentowi
`metadata.openclaw.os`	Nie	Filtr systemu operacyjnego (`["darwin"]`, `["linux"]` itd.)
`metadata.openclaw.requires.bins`	Nie	Wymagane pliki binarne w PATH
`metadata.openclaw.requires.config`	Nie	Wymagane klucze konfiguracji

Najlepsze praktyki

Pisz zwięźle — instruuj model, co ma zrobić, a nie jak być AI
Najpierw bezpieczeństwo — jeśli Twój skill używa exec, upewnij się, że prompty nie pozwalają na dowolne wstrzykiwanie poleceń z niezaufanych danych wejściowych
Testuj lokalnie — użyj openclaw agent --message "...", aby przetestować przed udostępnieniem
Używaj ClawHub — przeglądaj i współtwórz Skills na ClawHub

Gdzie znajdują się Skills

Lokalizacja	Pierwszeństwo	Zakres
`\<workspace\>/skills/`	Najwyższe	Na agenta
`\<workspace\>/.agents/skills/`	Wysokie	Na agenta w obszarze roboczym
`~/.agents/skills/`	Średnie	Wspólny profil agenta
`~/.openclaw/skills/`	Średnie	Wspólne (wszyscy agenci)
Wbudowane (dostarczane z OpenClaw)	Niskie	Globalny
`skills.load.extraDirs`	Najniższe	Niestandardowe foldery współdzielone

Powiązane

Dokumentacja Skills — ładowanie, pierwszeństwo i reguły bramkowania
Konfiguracja Skills — schemat konfiguracji skills.*
ClawHub — publiczny rejestr Skills
Tworzenie Plugins — plugins mogą dostarczać Skills

# Utwórz swój pierwszy skill