​

ClawHub

​

Czym jest ClawHub

• Publiczny rejestr Skills dla OpenClaw.
• Wersjonowany magazyn pakietów Skills i metadanych.
• Powierzchnia odkrywania oparta na wyszukiwaniu, tagach i sygnałach użycia.

​

Jak to działa

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

​

Co możesz zrobić

• Publikować nowe Skills oraz nowe wersje istniejących Skills.
• Odkrywać Skills według nazwy, tagów lub wyszukiwania.
• Pobierać pakiety Skills i przeglądać ich pliki.
• Zgłaszać Skills, które są nadużywające lub niebezpieczne.
• Jeśli jesteś moderatorem, ukrywać, odkrywać, usuwać lub banować.

​

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

• Wyszukiwać Skills prostym językiem.
• Instalować Skill w swoim obszarze roboczym.
• Aktualizować Skills później jednym poleceniem.
• Tworzyć kopie zapasowe własnych Skills, publikując je.

​

Szybki start (nietechniczny)

1. Zainstaluj CLI (zobacz następną sekcję).
2. Wyszukaj to, czego potrzebujesz:
   • clawhub search "calendar"
3. Zainstaluj Skill:
   • clawhub install <skill-slug>
4. Uruchom nową sesję OpenClaw, aby wczytała nowy Skill.

​

Instalacja CLI

npm i -g clawhub

pnpm add -g clawhub

​

Jak to pasuje do OpenClaw

​

Przegląd systemu Skills

• Plik SKILL.md z podstawowym opisem i sposobem użycia.
• 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, dziennikami zmian i tagami (w tym latest).
• Pobrania jako zip dla każdej wersji.
• Gwiazdki i komentarze dla opinii społeczności.
• Moderacja: mechanizmy zatwierdzania i audytu.
• 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 rejestrowane.
• 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; przełącza się na obszar roboczy OpenClaw).
• --dir <dir>: Katalog Skills, względny do katalogu roboczego (domyślnie: skills).
• --site <url>: Bazowy URL strony (logowanie w przeglądarce).
• --registry <url>: Bazowy URL API rejestru.
• --no-input: Wyłącz monity (tryb nieinteraktywny).
• -V, --cli-version: Wyświetl 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 zapisywana dla tokenów logowania w przeglądarce (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 określoną wersję.
• --force: Nadpisz, jeśli folder już istnieje.

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

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

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

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

• clawhub sync
• --root <dir...>: Dodatkowe katalogi skanowania.
• --all: Prześlij wszystko bez monitów.
• --dry-run: Pokaż, co zostałoby przesłane.
• --bump <type>: patch|minor|major dla aktualizacji (domyślnie: patch).
• --changelog <text>: Dziennik zmian dla aktualizacji nieinteraktywnych.
• --tags <tags>: Tagi oddzielone przecinkami (domyślnie: latest).
• --concurrency <n>: Kontrole 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 zapasowych Skills (publikacja lub synchronizacja)

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

clawhub sync --all

​

Szczegóły zaawansowane (techniczne)

​

Wersjonowanie i tagi

• Każda publikacja tworzy nową semver SkillVersion.
• Tagi (takie jak latest) wskazują na wersję; przenoszenie tagów pozwala na cofanie zmian.
• Dzienniki zmian są przypisane do każdej wersji i mogą być puste podczas synchronizacji lub publikowania aktualizacji.

​

Zmiany lokalne a wersje w rejestrze

​

Skanowanie synchronizacji i zapasowe katalogi

​

Przechowywanie i plik blokady

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

​

Telemetria (liczniki instalacji)

export CLAWHUB_DISABLE_TELEMETRY=1

​

Zmienne środowiskowe

• CLAWHUB_SITE: Nadpisz URL strony.
• CLAWHUB_REGISTRY: Nadpisz URL API rejestru.
• CLAWHUB_CONFIG_PATH: Nadpisz miejsce przechowywania tokenu/konfiguracji przez CLI.
• CLAWHUB_WORKDIR: Nadpisz domyślny katalog roboczy.
• CLAWHUB_DISABLE_TELEMETRY=1: Wyłącz telemetrię dla sync.