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:

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:

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.

---
name: hello-world
description: A simple skill that prints a greeting.
---

# Hello World

When the user asks for a greeting, use the `exec` tool to run:

```bash
echo "Hello from your custom skill!"

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">
```bash
openclaw 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ę:

# From chat — archive current session and start fresh
/new

# Or restart the gateway
openclaw gateway restart

Test it

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:

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:

---
name: gemini-search
description: 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:

{
  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.

# Propose a brand-new skill
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal ./PROPOSAL.md

# Propose an update to an existing skill
openclaw skills workshop propose-update hello-world \
  --proposal ./PROPOSAL.md \
  --description "Updated greeting skill"

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

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:

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

npm i -g clawhub
clawhub login

Publish

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

Pisz zwięźle — poinstruuj model, co ma zrobić, zamiast wyjaśniać, jak ma być sztuczną inteligencją.
Bezpieczeństwo przede wszystkim — jeśli Twój Skill używa exec, upewnij się, że monity nie umożliwiają wstrzykiwania dowolnych poleceń z niezaufanych danych wejściowych.
Testuj lokalnie — przed udostępnieniem użyj openclaw agent --message "...".
Korzystaj z ClawHub — przed tworzeniem od podstaw przejrzyj Skills społeczności na stronie clawhub.ai.

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ą.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Utwórz swój pierwszy Skill

Dokumentacja pliku SKILL.md

Pola wymagane

Opcjonalne klucze frontmatteru

Używanie `{baseDir}`

Dodawanie aktywacji warunkowej

Zgłaszanie propozycji przez Skill Workshop

Publikowanie w ClawHub

Najlepsze praktyki

Powiązane materiały

Skills reference

Skill Workshop

Skills config

ClawHub

Building plugins

​Utwórz swój pierwszy Skill

​Dokumentacja pliku SKILL.md

​Pola wymagane

​Opcjonalne klucze frontmatteru

​Używanie {baseDir}

​Dodawanie aktywacji warunkowej

​Zgłaszanie propozycji przez Skill Workshop

​Publikowanie w ClawHub

​Najlepsze praktyki

​Powiązane materiały

Skills reference

Skill Workshop

Skills config

ClawHub

Building plugins

Utwórz swój pierwszy Skill

Dokumentacja pliku SKILL.md

Pola wymagane

Opcjonalne klucze frontmatteru

Używanie `{baseDir}`

Dodawanie aktywacji warunkowej

Zgłaszanie propozycji przez Skill Workshop

Publikowanie w ClawHub

Najlepsze praktyki

Powiązane materiały