Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Skills uczą agenta, jak i kiedy używać narzędzi. Każda umiejętność 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 swoją pierwszą umiejętność

1

Utwórz katalog umiejętności

Skills znajdują się w Twoim obszarze roboczym. Utwórz nowy folder:
mkdir -p ~/.openclaw/workspace/skills/hello-world
2

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żywaj zapisu z łącznikami, małymi literami, cyframi i łącznikami dla name umiejętności. Utrzymuj nazwę folderu i name we frontmatter spójne.
3

Dodaj narzędzia (opcjonalnie)

Możesz definiować 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 w pluginach razem z narzędziami, które dokumentują.
4

Załaduj umiejętność

Uruchom nową sesję, aby OpenClaw wykrył umiejętność:
# From chat
/new

# Or restart the gateway
openclaw gateway restart
Sprawdź, czy umiejętność została załadowana:
openclaw skills list
5

Przetestuj ją

Wyślij wiadomość, która powinna wyzwolić umiejętność:
openclaw agent --message "give me a greeting"
Możesz też po prostu porozmawiać z agentem i poprosić o powitanie.

Dokumentacja metadanych umiejętności

Frontmatter YAML obsługuje te pola:
PoleWymaganeOpis
nameTakUnikalny identyfikator używający małych liter, cyfr i łączników
descriptionTakJednowierszowy opis pokazywany agentowi
metadata.openclaw.osNieFiltr systemu operacyjnego (["darwin"], ["linux"] itd.)
metadata.openclaw.requires.binsNieWymagane pliki binarne w PATH
metadata.openclaw.requires.configNieWymagane klucze konfiguracji

Najlepsze praktyki

  • Pisz zwięźle — instruuj model, co ma zrobić, a nie jak być AI
  • Bezpieczeństwo przede wszystkim — jeśli Twoja umiejętność 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 umiejętności w ClawHub

Gdzie znajdują się Skills

LokalizacjaPriorytetZakres
\<workspace\>/skills/NajwyższyDla agenta
\<workspace\>/.agents/skills/WysokiDla agenta w obszarze roboczym
~/.agents/skills/ŚredniWspółdzielony profil agenta
~/.openclaw/skills/ŚredniWspółdzielone (wszyscy agenci)
Wbudowane (dostarczane z OpenClaw)NiskiGlobalny
skills.load.extraDirsNajniższyNiestandardowe foldery współdzielone

Powiązane