// dokumentacja openclaw

Umiejetnosci (Skills) w OpenClaw

Czym sa umiejetnosci

OpenClaw wykorzystuje foldery umiejetnosci zgodne ze standardem AgentSkills do rozszerzania mozliwosci agentow o narzedzia. Kazda umiejetnosc to katalog zawierajacy plik SKILL.md z frontmatterem YAML i instrukcjami w formacie Markdown.

Hierarchia ladowania

Umiejetnosci ladowane sa z szesciu zrodel, w kolejnosci od najwyzszego priorytetu:

  1. Umiejetnosci workspace'u — <workspace>/skills
  2. Umiejetnosci agenta w projekcie — <workspace>/.agents/skills
  3. Osobiste umiejetnosci agenta — ~/.agents/skills
  4. Umiejetnosci zarzadzane/lokalne — ~/.openclaw/skills
  5. Umiejetnosci wbudowane — dostarczane z instalacja
  6. Dodatkowe katalogi — skills.load.extraDirs

Zarzadzanie w konfiguracji multi-agentowej

W ustawieniach z wieloma agentami kazdy agent ma wlasny workspace. Umiejetnosci moga byc:

  • Per-agent — umieszczone w katalogu specyficznym dla danego agenta
  • Wspoldzielone — dostepne dla wszystkich agentow przez ~/.openclaw/skills lub skonfigurowane dodatkowe katalogi

Agenci maja listy dozwolonych (allowlists) kontrolujace, ktore widoczne umiejetnosci moga uzywac. Konfiguracja odbywa sie przez agents.defaults.skills i nadpisania per-agent.

Format umiejetnosci

Plik SKILL.md musi zawierac podstawowy frontmatter:

---
name: nazwa-umiejetnosci
description: Co robi ta umiejetnosc
---

Opcjonalne pola frontmatteru obejmuja: homepage, user-invocable, disable-model-invocation i ustawienia command-dispatch.

Filtrowanie w czasie ladowania

Umiejetnosci sa filtrowane za pomoca metadanych w sekcji metadata.openclaw:

  • requires.bins — wymagane pliki wykonywalne w PATH
  • requires.env — wymagane zmienne srodowiskowe
  • requires.config — wymagane klucze konfiguracyjne
  • os — ograniczenia platformowe (darwin, linux, win32)
  • install — specyfikacje instalatora do konfiguracji

Rejestr ClawHub

OpenClaw udostepnia publiczny rejestr umiejetnosci na clawhub.ai. Uzytkownicy moga:

  • Instalowac umiejetnosci: openclaw skills install <skill-slug>
  • Aktualizowac umiejetnosci: openclaw skills update --all
  • Publikowac aktualizacje: clawhub sync --all

Bezpieczenstwo

Umiejetnosci od osob trzecich nalezy traktowac jako niezaufany kod. Przed wlaczeniem nalezy je przeczytac. Gateway skanuje niebezpieczny kod przed wykonaniem, a sandboxing jest zalecany dla ryzykownych narzedzi. Sekrety nigdy nie powinny pojawiac sie w promptach ani logach.

Optymalizacja wydajnosci

OpenClaw tworzy snapshot kwalifikujacych sie umiejetnosci na poczatku sesji i ponownie uzywa tej listy w kolejnych turach. Watcher moze automatycznie odswiezac liste, gdy pliki umiejetnosci sie zmienia. Koszty tokenow sa deterministyczne i zaleza od liczby umiejetnosci oraz dlugosci pol.

Wróc do dokumentacji