Tworzenie umiejetnosci (Skills) w OpenClaw

Wprowadzenie

Umiejetnosci ucza agentow, jak i kiedy uzywac narzedzi. Kazda umiejetnosc to katalog zawierajacy plik SKILL.md z frontmatterem YAML i instrukcjami w Markdown.

Szybki start w 5 krokach

Krok 1 — Utworz katalog

Stworz folder umiejetnosci, na przyklad:

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

Krok 2 — Napisz SKILL.md

Umiesc metadane YAML i instrukcje dla agenta. Przykladowa struktura zawiera pole name, description i wskazowki dotyczace uzycia narzedzi w formacie Markdown.

---
name: hello-world
description: Przyjazne powitanie uzytkownika
---

# Hello World

Gdy uzytkownik prosi o powitanie, odpowiedz przyjaznym
komunikatem w jezyku, w ktorym pisze.

Krok 3 — Dodaj narzedzia (opcjonalnie)

Mozesz zdefiniowac wlasne schematy narzedzi lub odwolac sie do istniejacych narzedzi systemowych, takich jak exec czy browser.

Krok 4 — Zaladuj umiejetnosc

Rozpocznij nowa sesje poleceniem /new lub zrestartuj Gateway poleceniem openclaw gateway restart. Nastepnie zweryfikuj poleceniem:

openclaw skills list

Krok 5 — Przetestuj

Uruchom agenta z wiadomoscia testowa:

openclaw agent --message "przywitaj mnie"

Referencja metadanych

Pola wymagane

• name — unikalny identyfikator w formacie snake_case
• description — jednozdaniowe podsumowanie dla agenta

Pola opcjonalne

• Filtrowanie wedlug systemu operacyjnego
• Wymagane pliki wykonywalne w PATH
• Wymagane klucze konfiguracyjne
• user-invocable — czy uzytkownik moze wywolac umiejetnosc bezposrednio
• disable-model-invocation — zapobiega automatycznemu wywolaniu przez model
• command-dispatch — konfiguracja ekspozycji jako komendy slash

Dobre praktyki

• Zwiezlosc — instrukcje powinny byc krotkie i konkretne
• Bezpieczenstwo — szczegolna ostroznosc przy poleceniach exec, walidacja danych wejsciowych
• Testowanie lokalne — zawsze testuj umiejetnosc przed udostepnieniem
• Publikacja — udostepniaj spolecznosci przez ClawHub

Hierarchia lokalizacji

Umiejetnosci laduja sie z wielu lokalizacji o roznym priorytecie — od umiejetnosci specyficznych dla workspace'u az po globalne umiejetnosci wbudowane. Umiejetnosci z wyzszym priorytetem nadpisuja te z nizszym, jesli maja te sama nazwe.