Skills

• Pomiń agents.defaults.skills, aby domyślnie nie ograniczać żadnych umiejętności.
• Pomiń agents.list[].skills, aby odziedziczyć agents.defaults.skills.
• Ustaw agents.list[].skills: [], aby nie udostępniać temu agentowi żadnych umiejętności.
• Niepusta lista agents.list[].skills jest zbiorem ostatecznym — nie jest łączona z wartościami domyślnymi.
• Wynikowa lista dozwolonych obowiązuje podczas budowania promptów, wykrywania poleceń z ukośnikiem, synchronizacji piaskownicy oraz tworzenia migawek umiejętności.
• Nie jest to granica autoryzacji powłoki hosta. Jeśli ten sam agent może używać exec, ogranicz tę powłokę osobno za pomocą piaskownicy, izolacji użytkownika systemu operacyjnego, list zabronionych/dozwolonych poleceń exec oraz poświadczeń przypisanych do zasobów.

openclaw skills install domyślnie instaluje w katalogu skills/ aktywnego obszaru roboczego. Dodaj --global, aby zainstalować we współdzielonym katalogu ~/.openclaw/skills, widocznym dla wszystkich lokalnych agentów, chyba że ograniczają go listy dozwolonych umiejętności agentów.

Instalacje z Git i źródeł lokalnych oczekują pliku SKILL.md w katalogu głównym źródła. Identyfikator pochodzi z pola name w metadanych frontmatter pliku SKILL.md, jeśli jest prawidłowe, a w przeciwnym razie z nazwy katalogu lub repozytorium. Użyj --as <slug>, aby go zastąpić. openclaw skills update śledzi wyłącznie instalacje z ClawHub — aby odświeżyć źródła Git lub lokalne, zainstaluj je ponownie.

openclaw skills verify @owner/<slug> wysyła do ClawHub żądanie zakresu zaufania clawhub.skill.verify.v1 dla umiejętności. Zainstalowane umiejętności ClawHub są weryfikowane względem wersji i rejestru zapisanych w pliku .clawhub/origin.json. Same identyfikatory pozostają akceptowane w przypadku istniejących zainstalowanych lub jednoznacznych umiejętności, ale odwołania zawierające właściciela pozwalają uniknąć niejednoznaczności wydawcy.

Strony umiejętności w ClawHub przed instalacją pokazują stan najnowszego skanowania zabezpieczeń, wraz ze stronami szczegółów dla VirusTotal, ClawScan oraz analizy statycznej. Polecenie kończy się kodem różnym od zera, gdy ClawHub oznaczy weryfikację jako nieudaną. Wydawcy mogą rozwiązywać problemy z fałszywymi alarmami za pomocą panelu ClawHub lub polecenia clawhub skill rescan @owner/<slug>.

Klienci Gateway wymagający dostarczania poza ClawHub mogą przygotować archiwum ZIP umiejętności za pomocą skills.upload.begin, skills.upload.chunk oraz skills.upload.commit, a następnie zainstalować je za pomocą skills.install({ source: "upload", ... }). Ta ścieżka jest domyślnie wyłączona i wymaga ustawienia skills.install.allowUploadedArchives: true w pliku openclaw.json. Standardowe instalacje z ClawHub nigdy nie wymagają tego ustawienia.

Wykrywanie umiejętności w obszarze roboczym, dla agenta projektu oraz w dodatkowych katalogach akceptuje wyłącznie katalogi główne umiejętności, których rozwiązana ścieżka rzeczywista pozostaje wewnątrz skonfigurowanego katalogu głównego, chyba że skills.load.allowSymlinkTargets jawnie oznacza docelowy katalog główny jako zaufany. Warsztat umiejętności zapisuje przez takie zaufane cele tylko wtedy, gdy włączono skills.workshop.allowSymlinkTargetWrites. Zarządzany katalog ~/.openclaw/skills oraz osobisty katalog ~/.agents/skills mogą zawierać foldery umiejętności będące dowiązaniami symbolicznymi, ale rzeczywista ścieżka każdego pliku SKILL.md nadal musi pozostawać wewnątrz rozwiązanego katalogu tej umiejętności.

Skonfiguruj security.installPolicy, aby przed kontynuowaniem instalacji umiejętności uruchamiać zaufane lokalne polecenie zasad. Zasady otrzymują metadane oraz przygotowaną ścieżkę źródłową, dotyczą ścieżek ClawHub, przesyłania, Git, lokalnych, aktualizacji oraz instalatorów zależności i blokują operację, gdy polecenie nie może zwrócić prawidłowej decyzji.

skills.entries.*.env oraz skills.entries.*.apiKey wstrzykują sekrety do procesu hosta wyłącznie na czas danej tury agenta — nie do piaskownicy. Nie umieszczaj sekretów w promptach ani dziennikach.

• Gdy wymieniono wiele instalatorów, Gateway wybiera jedną preferowaną opcję (brew, jeśli jest dostępny, w przeciwnym razie node).
• Jeśli wszystkie instalatory mają typ download, OpenClaw wyświetla każdy wpis, aby można było zobaczyć wszystkie dostępne artefakty.
• Specyfikacje mogą zawierać os: ["darwin"|"linux"|"win32"], aby filtrować według platformy.
• Instalacje Node uwzględniają skills.install.nodeManager w openclaw.json (domyślnie: npm; opcje: npm / pnpm / yarn / bun). Dotyczy to wyłącznie instalacji Skills; środowiskiem wykonawczym Gateway nadal powinien być Node.
• Kolejność preferencji instalatora Gateway: Homebrew → uv → skonfigurowany menedżer node → go → download.

• Homebrew: OpenClaw nie instaluje automatycznie Homebrew ani nie przekształca formuł brew w polecenia systemowego menedżera pakietów. W kontenerach Linux bez brew instalatory korzystające wyłącznie z brew są ukryte; użyj niestandardowego obrazu lub zainstaluj zależność ręcznie.
• Go: OpenClaw wymaga Go 1.21 lub nowszego do automatycznych instalacji Skills. Jeśli brakuje go, a Homebrew jest dostępny, OpenClaw najpierw instaluje Go za pomocą Homebrew; w systemie Linux bez Homebrew może zamiast tego użyć apt-get jako użytkownik root lub przez niewymagające hasła sudo, jeśli odświeżony kandydat golang-go spełnia wymaganie minimalnej wersji. Właściwe polecenie go install dla zależności zawsze wskazuje dedykowany katalog plików wykonywalnych zarządzany przez OpenClaw (bin Homebrew w przypadku nowej instalacji, w przeciwnym razie ~/.local/bin), a nie skonfigurowany GOBIN — własne zmienne środowiskowe GOBIN, GOPATH i GOTOOLCHAIN są odczytywane, ale nigdy nadpisywane.
• Pobieranie: url (wymagane), archive (tar.gz | tar.bz2 | zip), extract (domyślnie: automatycznie po wykryciu archiwum), stripComponents, targetDir (domyślnie: ~/.openclaw/tools/<skillKey>).

requires.bins jest sprawdzane na hoście podczas ładowania Skills. Jeśli agent działa w piaskownicy, plik wykonywalny musi również istnieć wewnątrz kontenera. Zainstaluj go za pomocą agents.defaults.sandbox.docker.setupCommand lub niestandardowego obrazu. setupCommand jest uruchamiane raz po utworzeniu kontenera i wymaga dostępu wychodzącego do sieci, zapisywalnego głównego systemu plików oraz użytkownika root w piaskownicy.

Domyślnie OpenClaw obserwuje foldery Skills i aktualizuje zrzut po zmianie plików SKILL.md. Skonfiguruj to w skills.load:

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true, // default      watchDebounceMs: 250, // default    },  },}

Użyj allowSymlinkTargets w przypadku celowo utworzonych układów dowiązań symbolicznych, w których dowiązanie katalogu głównego Skills wskazuje poza skonfigurowany katalog główny, na przykład <workspace>/skills/manager -> ~/Projects/manager/skills. Włącz skills.workshop.allowSymlinkTargetWrites tylko wtedy, gdy Skill Workshop ma również stosować propozycje za pośrednictwem tych zaufanych ścieżek z dowiązaniami symbolicznymi.

Jeśli Gateway działa w systemie Linux, ale połączony jest węzeł macOS z dozwolonym system.run, OpenClaw może uznać Skills przeznaczone wyłącznie dla macOS za dopuszczone, gdy wymagane pliki wykonywalne są dostępne w tym węźle. Agent powinien uruchamiać te Skills za pomocą narzędzia exec z ustawieniem host=node.

Węzły offline nie powodują wyświetlania Skills dostępnych wyłącznie zdalnie. Jeśli węzeł przestanie odpowiadać na sondy plików wykonywalnych, OpenClaw usuwa z pamięci podręcznej dopasowania tych plików.