​

ClawHub

• Używaj natywnych poleceń openclaw do wyszukiwania/instalowania/aktualizowania Skills oraz instalowania pluginów z ClawHub.
• Używaj osobnego CLI clawhub, gdy potrzebujesz uwierzytelniania rejestru, publikowania, usuwania, przywracania lub przepływów synchronizacji.

​

Natywne przepływy OpenClaw

openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all

openclaw plugins install clawhub:<package>
openclaw plugins update --all

openclaw plugins install openclaw-codex-app-server

​

Czym jest ClawHub

• Publicznym rejestrem Skills i pluginów OpenClaw.
• Wersjonowanym magazynem pakietów Skills i metadanych.
• Powierzchnią odkrywania dla wyszukiwania, tagów i sygnałów użycia.

​

Jak to działa

1. Użytkownik publikuje pakiet skill (pliki + metadane).
2. ClawHub przechowuje pakiet, analizuje metadane i przypisuje wersję.
3. Rejestr indeksuje skill na potrzeby wyszukiwania i odkrywania.
4. Użytkownicy przeglądają, pobierają i instalują Skills w OpenClaw.

​

Co możesz zrobić

• Publikować nowe Skills i nowe wersje istniejących Skills.
• Odkrywać Skills po nazwie, tagach lub wyszukiwaniu.
• Pobierać pakiety Skills i przeglądać ich pliki.
• Zgłaszać Skills, które są nadużyciem lub są niebezpieczne.
• Jeśli jesteś moderatorem, ukrywać, odkrywać, usuwać lub banować.

​

Dla kogo to jest (przyjazne dla początkujących)

• Wyszukiwać Skills zwykłym językiem.
• Instalować skill w swojej przestrzeni roboczej.
• Później aktualizować Skills jednym poleceniem.
• Tworzyć kopie zapasowe własnych Skills przez ich publikowanie.

​

Szybki start (nietechniczny)

1. Wyszukaj coś, czego potrzebujesz:
   • openclaw skills search "calendar"
2. Zainstaluj skill:
   • openclaw skills install <skill-slug>
3. Rozpocznij nową sesję OpenClaw, aby wykrył nowy skill.
4. Jeśli chcesz publikować lub zarządzać uwierzytelnianiem rejestru, zainstaluj także osobne CLI clawhub.

​

Zainstaluj CLI ClawHub

npm i -g clawhub

pnpm add -g clawhub

​

Jak to pasuje do OpenClaw

​

Przegląd systemu Skills

• Plik SKILL.md z głównym opisem i użyciem.
• Opcjonalne konfiguracje, skrypty lub pliki pomocnicze używane przez skill.
• Metadane, takie jak tagi, podsumowanie i wymagania instalacyjne.

​

Co zapewnia usługa (funkcje)

• Publiczne przeglądanie Skills i ich zawartości SKILL.md.
• Wyszukiwanie oparte na embeddingach (wyszukiwanie wektorowe), a nie tylko słowach kluczowych.
• Wersjonowanie z semver, changelogami i tagami (w tym latest).
• Pobrania jako zip dla każdej wersji.
• Gwiazdki i komentarze dla opinii społeczności.
• Hooki moderacyjne dla zatwierdzeń i audytów.
• API przyjazne dla CLI do automatyzacji i skryptów.

​

Bezpieczeństwo i moderacja

• Każdy zalogowany użytkownik może zgłosić skill.
• Powody zgłoszeń są wymagane i zapisywane.
• Każdy użytkownik może mieć jednocześnie do 20 aktywnych zgłoszeń.
• Skills z więcej niż 3 unikalnymi zgłoszeniami są domyślnie automatycznie ukrywane.
• Moderatorzy mogą przeglądać ukryte Skills, odkrywać je, usuwać lub banować użytkowników.
• Nadużywanie funkcji zgłaszania może skutkować banem konta.

​

Polecenia i parametry CLI

• --workdir <dir>: Katalog roboczy (domyślnie: bieżący katalog; wraca do przestrzeni roboczej OpenClaw).
• --dir <dir>: Katalog Skills, względny względem workdir (domyślnie: skills).
• --site <url>: Bazowy URL strony (logowanie w przeglądarce).
• --registry <url>: Bazowy URL API rejestru.
• --no-input: Wyłącz prompty (tryb nieinteraktywny).
• -V, --cli-version: Wypisz wersję CLI.

• clawhub login (przepływ przeglądarkowy) lub clawhub login --token <token>
• clawhub logout
• clawhub whoami

• --token <token>: Wklej token API.
• --label <label>: Etykieta przechowywana dla tokenów logowania przeglądarkowego (domyślnie: CLI token).
• --no-browser: Nie otwieraj przeglądarki (wymaga --token).

• clawhub search "query"
• --limit <n>: Maksymalna liczba wyników.

• clawhub install <slug>
• --version <version>: Zainstaluj konkretną wersję.
• --force: Nadpisz, jeśli folder już istnieje.

• clawhub update <slug>
• clawhub update --all
• --version <version>: Zaktualizuj do konkretnej wersji (tylko pojedynczy slug).
• --force: Nadpisz, gdy lokalne pliki nie pasują do żadnej opublikowanej wersji.

• clawhub list (odczytuje .clawhub/lock.json)

• clawhub skill publish <path>
• --slug <slug>: Slug skill.
• --name <name>: Nazwa wyświetlana.
• --version <version>: Wersja semver.
• --changelog <text>: Tekst changeloga (może być pusty).
• --tags <tags>: Tagi rozdzielane przecinkami (domyślnie: latest).

• clawhub package publish <source>
• <source> może być lokalnym folderem, owner/repo, owner/repo@ref lub URL-em GitHub.
• --dry-run: Zbuduj dokładny plan publikacji bez wysyłania czegokolwiek.
• --json: Zwróć wynik czytelny maszynowo dla CI.
• --source-repo, --source-commit, --source-ref: Opcjonalne nadpisania, gdy automatyczne wykrywanie nie wystarcza.

• clawhub delete <slug> --yes
• clawhub undelete <slug> --yes

• clawhub sync
• --root <dir...>: Dodatkowe katalogi główne do skanowania.
• --all: Prześlij wszystko bez promptów.
• --dry-run: Pokaż, co zostałoby przesłane.
• --bump <type>: patch|minor|major dla aktualizacji (domyślnie: patch).
• --changelog <text>: Changelog dla aktualizacji nieinteraktywnych.
• --tags <tags>: Tagi rozdzielane przecinkami (domyślnie: latest).
• --concurrency <n>: Sprawdzenia rejestru (domyślnie: 4).

​

Typowe przepływy pracy dla agentów

​

Wyszukiwanie Skills

clawhub search "postgres backups"

​

Pobieranie nowych Skills

clawhub install my-skill-pack

​

Aktualizowanie zainstalowanych Skills

clawhub update --all

​

Tworzenie kopii zapasowej swoich Skills (publikowanie lub synchronizacja)

clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

clawhub sync --all

​

Publikowanie pluginu z GitHub

clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/your-plugin@v1.0.0
clawhub package publish https://github.com/your-org/your-plugin

{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./index.ts"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2",
      "minGatewayVersion": "2026.3.24-beta.2"
    },
    "build": {
      "openclawVersion": "2026.3.24-beta.2",
      "pluginSdkVersion": "2026.3.24-beta.2"
    }
  }
}

​

Szczegóły zaawansowane (techniczne)

​

Wersjonowanie i tagi

• Każda publikacja tworzy nową wersję semver SkillVersion.
• Tagi (takie jak latest) wskazują wersję; przesuwanie tagów pozwala wycofywać zmiany.
• Changelogi są dołączane do każdej wersji i mogą być puste podczas synchronizacji lub publikowania aktualizacji.

​

Zmiany lokalne vs wersje rejestru

​

Skanowanie synchronizacji i zapasowe katalogi główne

​

Przechowywanie i plik blokady

• Zainstalowane Skills są zapisywane w .clawhub/lock.json w workdir.
• Tokeny uwierzytelniania są przechowywane w pliku konfiguracji CLI ClawHub (nadpisanie przez CLAWHUB_CONFIG_PATH).

​

Telemetria (liczba instalacji)

export CLAWHUB_DISABLE_TELEMETRY=1

​

Zmienne środowiskowe

• CLAWHUB_SITE: Nadpisz URL strony.
• CLAWHUB_REGISTRY: Nadpisz URL API rejestru.
• CLAWHUB_CONFIG_PATH: Nadpisz lokalizację, w której CLI przechowuje token/konfigurację.
• CLAWHUB_WORKDIR: Nadpisz domyślny workdir.
• CLAWHUB_DISABLE_TELEMETRY=1: Wyłącz telemetrię przy sync.