OpenClaw Skills: od zera do ClawHub

OPUBLIKOWANO: 11 lutego 2026

OpenClaw działa, ale chcesz więcej: integrację z polskim systemem faktur, automatyzację specyficzną dla Twojego workflow albo narzędzie wewnętrzne dla zespołu. W tym momencie dochodzisz do najważniejszej cechy OpenClaw: Skills. To one zamieniają „czat z AI” w asystenta, który potrafi wykonywać konkretne zadania.

Dobra wiadomość: stworzenie własnego skilla nie wymaga pisania wtyczki w C++ ani budowania wielkiej aplikacji. W większości przypadków to po prostu folder z plikiem SKILL.md i (opcjonalnie) kilkoma skryptami pomocniczymi. Najważniejsza jest jakość instrukcji: agent musi wiedzieć, kiedy i jak użyć narzędzia, jakie są parametry oraz jakie są ograniczenia.

W tym poradniku przeprowadzę Cię przez cały proces: anatomia skilla, „Hello World”, najlepsze praktyki (gating, wymagania, bezpieczeństwo), a na końcu – jak spakować i opublikować skilla w ClawHub, żeby inni mogli z niego korzystać.

1. Czym jest Skill w OpenClaw
2. Struktura projektu: minimalna i rozbudowana
3. Frontmatter: pola obowiązkowe i praktyczne opcje
4. Pierwszy Skill: „Hello World” w 10 minut
5. Skill „real-world”: integracja z API (na przykładzie systemu faktur)
6. Publikacja na ClawHub: co przygotować, żeby ludzie Cię nie znienawidzili

Czym jest Skill w OpenClaw

Skill to paczka instrukcji, która uczy agenta, jak wykonywać określone zadania. Z perspektywy użytkownika wygląda to tak, jakby asystent nagle „umiał” obsługiwać GitHuba, transkrypcję, przeglądarkę czy API jakiegoś systemu.

Z perspektywy twórcy skill to przede wszystkim:

• nazwa i opis (żeby dało się go znaleźć),
• wymagania (np. binaria, zmienne środowiskowe),
• instrukcje użycia (kiedy i jak agent ma działać),
• przykłady i zasady bezpieczeństwa (żeby nie było katastrofy w produkcji).

Kluczowa idea: skill ma być przewidywalny. Agent ma dostać jasne procedury, a nie luźną inspirację.

Struktura projektu: minimalna i rozbudowana

Minimalny skill to katalog z jednym plikiem SKILL.md.

Rozbudowany skill zwykle ma dodatkowe skrypty (np. walidację, formatowanie) oraz przykłady danych. To pomaga agentowi działać powtarzalnie, a Tobie – szybciej debugować.

Frontmatter: pola obowiązkowe i praktyczne opcje

SKILL.md zaczyna się od frontmatter (YAML), gdzie definiujesz metadane skilla. Absolutne minimum to name i description. Reszta to narzędzia, które pozwalają Twojemu skillowi działać w prawdziwym świecie.

Najbardziej praktyczne dodatki to:

• homepage (gdzie jest kod/dokumentacja),
• metadata.openclaw.requires (jakie binaria/env/config są potrzebne),
• metadata.openclaw.os (na jakich systemach działa),
• metadata.openclaw.primaryEnv (główna zmienna z kluczem API).

Przykładowy frontmatter:

---
name: infakt-invoices
description: Zarządzanie fakturami przez API (przez chat)
homepage: https://github.com/twoj-user/infakt-skill
metadata:
  openclaw:
    emoji: "🧾"
    os: ["darwin", "linux"]
    requires:
      env: ["INFAKT_API_KEY"]
      bins: ["jq"]
    primaryEnv: "INFAKT_API_KEY"
---

Warto też pamiętać o zasadzie fail fast: jeśli czegoś brakuje (np. jq albo klucza API), skill powinien zostać oznaczony jako missing, zamiast zachowywać się losowo.

Pierwszy Skill: „Hello World” w 10 minut

Zacznij od skilla, który jest prosty i testowalny. Najczęstszy błąd to start od integracji z produkcyjnym API, a potem debugowanie trzech problemów naraz.

W praktyce „Hello World” to skill z jedną regułą zachowania (np. specjalny styl odpowiedzi po komendzie). Dzięki temu sprawdzasz:

• czy struktura katalogu jest poprawna,
• czy YAML frontmatter jest poprawny,
• czy agent w ogóle ładuje skilla.

Dopiero gdy to działa, dokładasz zależności i narzędzia.

Skill „real-world”: integracja z API (na przykładzie systemu faktur)

W integracjach API najważniejsze są trzy rzeczy: autoryzacja, walidacja i formatowanie wyniku.

Autoryzacja powinna iść przez zmienne środowiskowe (nigdy przez prompt). Walidacja ma chronić przed śmieciowym wejściem (np. niepoprawny NIP). Formatowanie wyniku powinno być czytelne i zwięzłe, bo agent będzie to wklejał do odpowiedzi.

Jeśli integrujesz system faktur, dobry zakres na start to:

• lista ostatnich faktur,
• status faktury,
• utworzenie draftu (nie od razu: „wyślij do klienta”).

Najlepsza praktyka: na początku traktuj integrację jak human-in-the-loop. Agent przygotowuje payload i pokazuje go do zatwierdzenia, zamiast od razu robić write.

Publikacja na ClawHub: co przygotować, żeby ludzie Cię nie znienawidzili

Jeśli chcesz publikować skilla, potraktuj to jak mini-produkt. Ludzie nie „kupują” skilla, bo jest sprytny. Korzystają z niego, bo działa powtarzalnie.

Minimalny zestaw, który warto dowieźć przed publikacją:

• czytelny opis (co robi i czego nie robi),
• lista wymagań (env/bins/os),
• 2–3 przykłady użycia,
• jasne ostrzeżenia bezpieczeństwa (np. jakie dane nie powinny trafiać do promptów),
• wersjonowanie i changelog (nawet prosty).

Dobry skill ma też „happy path” i „failure path”: co agent ma zrobić, gdy API zwróci błąd, gdy brakuje uprawnień albo gdy nie ma danych.

Chcesz zbudować własnego skilla dla OpenClaw?