Tworzenie Skills
Skills uczą agenta, jak i kiedy używać narzędzi. Każda Skill jest katalogiem zawierającym plikSKILL.md z frontmatter YAML i instrukcjami w Markdown.
Aby dowiedzieć się, jak Skills są ładowane i priorytetyzowane, zobacz Skills.
Utwórz swoją pierwszą Skill
Napisz SKILL.md
Utwórz
SKILL.md wewnątrz tego katalogu. Frontmatter definiuje metadane,
a treść Markdown zawiera instrukcje dla agenta.Dodaj narzędzia (opcjonalnie)
Możesz zdefiniować niestandardowe schematy narzędzi w frontmatter albo poinstruować agenta,
aby używał istniejących narzędzi systemowych (takich jak
exec lub browser). Skills mogą być też
dostarczane we wtyczkach razem z narzędziami, które dokumentują.Załaduj Skill
Rozpocznij nową sesję, aby OpenClaw wykrył Skill:Sprawdź, czy Skill została załadowana:
Dokumentacja metadanych Skill
Frontmatter YAML obsługuje następujące pola:| Pole | Wymagane | Opis |
|---|---|---|
name | Tak | Unikalny identyfikator (snake_case) |
description | Tak | Jednowierszowy opis wyświetlany agentowi |
metadata.openclaw.os | Nie | Filtr systemu operacyjnego (["darwin"], ["linux"] itp.) |
metadata.openclaw.requires.bins | Nie | Wymagane pliki binarne w PATH |
metadata.openclaw.requires.config | Nie | Wymagane klucze konfiguracji |
Dobre praktyki
- Bądź zwięzły — instruuj model, co ma zrobić, a nie jak ma być AI
- Bezpieczeństwo przede wszystkim — jeśli Twoja Skill używa
exec, upewnij się, że prompty nie pozwalają na dowolne wstrzykiwanie poleceń z niezaufanego wejścia - Testuj lokalnie — używaj
openclaw agent --message "...", aby testować przed udostępnieniem - Używaj ClawHub — przeglądaj i współtwórz Skills na ClawHub
Gdzie znajdują się Skills
| Lokalizacja | Priorytet najwyższeństwa | Zakres |
|---|---|---|
\<workspace\>/skills/ | Najwyższy | Per-agent |
\<workspace\>/.agents/skills/ | Wysoki | Per-workspace agent |
~/.agents/skills/ | Średni | Współdzielony profil agenta |
~/.openclaw/skills/ | Średni | Współdzielone (wszyscy agenci) |
| Dołączone (dostarczane z OpenClaw) | Niski | Globalny |
skills.load.extraDirs | Najniższy | Niestandardowe foldery współdzielone |
Powiązane
- Dokumentacja Skills — zasady ładowania, priorytetu i bramkowania
- Konfiguracja Skills — schemat konfiguracji
skills.* - ClawHub — publiczny rejestr Skills
- Tworzenie wtyczek — wtyczki mogą dostarczać Skills