OpenClawDocs
Na tej stronie

Na tej stronie

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Skills

Tworzenie Skills

Skills uczą agenta, jak i kiedy używać narzędzi. Każdy Skill jest katalogiem zawierającym plik SKILL.md z frontmatterem YAML i instrukcjami w formacie Markdown. OpenClaw ładuje Skills z kilku katalogów głównych zgodnie ze zdefiniowaną kolejnością pierwszeństwa.

Utwórz swój pierwszy Skill

  • Create the skill directory

    Skills znajdują się w folderze skills/ Twojego obszaru roboczego:

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

    Aby uporządkować Skills, możesz grupować je w podfolderach — nazwa Skilla nadal pochodzi z frontmatteru pliku SKILL.md, a nie ze ścieżki katalogu:

    bash
    mkdir -p ~/.openclaw/workspace/skills/personal/hello-world# skill name is still "hello-world", invoked as /hello-world

  • Write SKILL.md

    Frontmatter definiuje metadane, a treść zawiera instrukcje dla agenta.

    markdown
    ---name: hello-worlddescription: A simple skill that prints a greeting.--- # Hello World When the user asks for a greeting, use the `exec` tool to run: ```bashecho "Hello from your custom skill!"
    Code
     Reguły nazewnictwa:- W polu `name` używaj małych liter, cyfr i łączników.- Nazwa katalogu i pole `name` we frontmatterze powinny być zgodne.- Pole `description` jest wyświetlane agentowi oraz podczas wyszukiwania poleceń z ukośnikiem —  powinno mieścić się w jednym wierszu i zawierać mniej niż 160 znaków. </Step> <Step title="Verify the skill loaded">```bashopenclaw skills list

    OpenClaw domyślnie monitoruje pliki SKILL.md w katalogach głównych Skills. Jeśli monitorowanie jest wyłączone lub kontynuujesz istniejącą sesję, rozpocznij nową, aby agent otrzymał odświeżoną listę:

    bash
    # From chat — archive current session and start fresh/new # Or restart the gatewayopenclaw gateway restart

  • Test it

    bash
    openclaw agent --message "give me a greeting"

    Możesz też otworzyć czat i poprosić agenta bezpośrednio. Użyj /skill hello-world, aby jawnie wywołać Skill według nazwy.

    • Dokumentacja pliku SKILL.md

    Pola wymagane

    Pole Opis
    name Unikatowy identyfikator z małych liter, cyfr i łączników
    description Jednowierszowy opis wyświetlany agentowi i w wynikach wyszukiwania

    Opcjonalne klucze frontmatteru

    Pole Wartość domyślna Opis
    user-invocable true Udostępnia Skill jako polecenie użytkownika z ukośnikiem
    disable-model-invocation false Wyklucza Skill z monitu systemowego agenta (nadal można go uruchomić przez /skill)
    command-dispatch — Ustaw tool, aby kierować polecenie z ukośnikiem bezpośrednio do narzędzia, z pominięciem modelu
    command-tool — Nazwa narzędzia wywoływanego po ustawieniu command-dispatch: tool
    command-arg-mode raw Przy przekazywaniu do narzędzia przesyła nieprzetworzony ciąg argumentów
    homepage — Adres URL wyświetlany jako „Website” w interfejsie Skills systemu macOS

    Informacje o polach warunkowych (requires.bins, requires.env itd.) znajdziesz w sekcji Skills — warunki aktywacji.

    Używanie {baseDir}

    Odwołuj się do plików wewnątrz katalogu Skilla bez wpisywania ścieżek na stałe — agent rozpoznaje {baseDir} względem katalogu danego Skilla:

    markdown
    Run the helper script at `{baseDir}/scripts/run.sh`.

    Dodawanie aktywacji warunkowej

    Ustaw warunki Skilla, aby był ładowany tylko wtedy, gdy jego zależności są dostępne:

    markdown
    ---name: gemini-searchdescription: Search using Gemini CLI.metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }---
    Gating options
    Klucz Opis
    requires.bins Wszystkie pliki wykonywalne muszą istnieć w PATH
    requires.anyBins Co najmniej jeden plik wykonywalny musi istnieć w PATH
    requires.env Każda zmienna środowiskowa musi istnieć w procesie lub konfiguracji
    requires.config Każda ścieżka w openclaw.json musi mieć wartość logiczną prawda
    os Filtr platformy: ["darwin"], ["linux"], ["win32"]
    always Ustaw true, aby pominąć wszystkie warunki i zawsze uwzględniać Skill

    Pełna dokumentacja: Skills — warunki aktywacji.

    Environment and API keys

    Powiąż klucz API z wpisem Skilla w pliku openclaw.json:

    json5
    {  skills: {    entries: {      "gemini-search": {        enabled: true,        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },      },    },  },}

    Klucz jest wstrzykiwany do procesu hosta wyłącznie na czas danego przebiegu agenta. Nie trafia do piaskownicy — zobacz zmienne środowiskowe w piaskownicy.

    Zgłaszanie propozycji przez Skill Workshop

    W przypadku Skills przygotowanych przez agenta lub gdy chcesz, aby operator sprawdził Skill przed jego uruchomieniem, użyj propozycji w Skill Workshop, zamiast bezpośrednio zapisywać plik SKILL.md.

    bash
    # Propose a brand-new skillopenclaw skills workshop propose-create \  --name "hello-world" \  --description "A simple skill that prints a greeting." \  --proposal ./PROPOSAL.md # Propose an update to an existing skillopenclaw skills workshop propose-update hello-world \  --proposal ./PROPOSAL.md \  --description "Updated greeting skill"

    Użyj --proposal-dir, gdy propozycja zawiera pliki pomocnicze:

    bash
    openclaw skills workshop propose-create \  --name "hello-world" \  --description "A simple skill that prints a greeting." \  --proposal-dir ./hello-world-proposal/

    Katalog musi zawierać plik PROPOSAL.md w swoim katalogu głównym. Pliki pomocnicze umieść w katalogach assets/, examples/, references/, scripts/ lub templates/.

    Po sprawdzeniu:

    bash
    openclaw skills workshop inspect <proposal-id>openclaw skills workshop apply <proposal-id>

    Pełny cykl życia propozycji opisano w sekcji Skill Workshop.

    Publikowanie w ClawHub

  • Ensure your SKILL.md is complete

    Upewnij się, że ustawiono pola name, description oraz wszystkie pola warunkowe metadata.openclaw. Dodaj adres URL homepage, jeśli masz stronę projektu.

  • Install the standalone ClawHub CLI and log in

    bash
    npm i -g clawhubclawhub login

  • Publish

    bash
    clawhub skill publish ./path/to/hello-world

    Dodaj --version <version> lub --owner <owner>, aby zastąpić wykrytą wersję albo opublikować Skill jako określony właściciel. Pełny proces, zakres właściciela i pozostałe polecenia konserwacyjne (clawhub sync, clawhub skill rename, ...) opisano w sekcjach ClawHub — publikowanie oraz CLI ClawHub.

    • Najlepsze praktyki

    Powiązane materiały

    Skills reference

    Kolejność ładowania, warunki aktywacji, listy dozwolonych elementów i format pliku SKILL.md.
    Skill Workshop

    Kolejka propozycji Skills przygotowanych przez agenta.
    Skills config

    Pełny schemat konfiguracji skills.*.
    ClawHub

    Przeglądaj i publikuj Skills w publicznym rejestrze.
    Building plugins

    Pluginy mogą dostarczać Skills wraz z narzędziami, które dokumentują.
    Was this useful?