​

Skills (OpenClaw)

​

Lokalizacje i priorytet

1. Dodatkowe foldery Skills: konfigurowane przez skills.load.extraDirs
2. Wbudowane Skills: dostarczane z instalacją (pakiet npm lub OpenClaw.app)
3. Zarządzane/lokalne Skills: ~/.openclaw/skills
4. Osobiste Skills agenta: ~/.agents/skills
5. Projektowe Skills agenta: <workspace>/.agents/skills
6. Skills workspace: <workspace>/skills

​

Skills per agent vs współdzielone

• Skills per agent znajdują się w <workspace>/skills tylko dla tego agenta.
• Projektowe Skills agenta znajdują się w <workspace>/.agents/skills i mają zastosowanie do tego workspace przed zwykłym folderem skills/ workspace.
• Osobiste Skills agenta znajdują się w ~/.agents/skills i mają zastosowanie we wszystkich workspace na tej maszynie.
• Współdzielone Skills znajdują się w ~/.openclaw/skills (zarządzane/lokalne) i są widoczne dla wszystkich agentów na tej samej maszynie.
• Współdzielone foldery można też dodać przez skills.load.extraDirs (najniższy priorytet), jeśli chcesz używać wspólnego pakietu Skills dla wielu agentów.

​

Allowlisty Skills per agent

• Lokalizacja/priorytet decyduje, która kopia umiejętności o tej samej nazwie wygrywa.
• Allowlisty agenta decydują, których widocznych Skills agent faktycznie może używać.

{
  agents: {
    defaults: {
      skills: ["github", "weather"],
    },
    list: [
      { id: "writer" }, // dziedziczy github, weather
      { id: "docs", skills: ["docs-search"] }, // zastępuje domyślne
      { id: "locked-down", skills: [] }, // brak Skills
    ],
  },
}

• Pomiń agents.defaults.skills, aby domyślnie nie ograniczać Skills.
• Pomiń agents.list[].skills, aby dziedziczyć agents.defaults.skills.
• Ustaw agents.list[].skills: [], aby nie mieć żadnych Skills.
• Niepusta lista agents.list[].skills jest końcowym zestawem dla tego agenta; nie scala się z wartościami domyślnymi.

​

Plugins + Skills

​

ClawHub (instalacja + synchronizacja)

• Zainstaluj umiejętność do swojego workspace:
  • openclaw skills install <skill-slug>
• Zaktualizuj wszystkie zainstalowane Skills:
  • openclaw skills update --all
• Synchronizuj (skanuj + publikuj aktualizacje):
  • clawhub sync --all

​

Uwagi dotyczące bezpieczeństwa

• Traktuj Skills firm trzecich jako niezaufany kod. Przeczytaj je przed włączeniem.
• Dla niezaufanych danych wejściowych i ryzykownych narzędzi preferuj uruchomienia w sandboxie. Zobacz Sandboxing.
• Wykrywanie Skills w workspace i extra-dir akceptuje tylko korzenie umiejętności i pliki SKILL.md, których rozpoznany realpath pozostaje wewnątrz skonfigurowanego korzenia.
• Instalacje zależności Skills wykonywane przez Gateway (skills.install, onboarding i UI ustawień Skills) uruchamiają wbudowany skaner niebezpiecznego kodu przed wykonaniem metadanych instalatora. Znaleziska critical domyślnie blokują działanie, chyba że wywołujący jawnie ustawi niebezpieczne nadpisanie; podejrzane znaleziska nadal tylko ostrzegają.
• openclaw skills install <slug> działa inaczej: pobiera folder umiejętności z ClawHub do workspace i nie używa opisanej wyżej ścieżki metadanych instalatora.
• skills.entries.*.env i skills.entries.*.apiKey wstrzykują sekrety do procesu hosta dla tej tury agenta (nie do sandboxa). Trzymaj sekrety poza promptami i logami.
• Szerszy model zagrożeń i listy kontrolne znajdziesz w Bezpieczeństwo.

​

Format (zgodny z AgentSkills + Pi)

---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
---

• Stosujemy specyfikację AgentSkills dla układu/intencji.
• Parser używany przez osadzonego agenta obsługuje tylko jednoliniowe klucze frontmatter.
• metadata powinno być jednoliniowym obiektem JSON.
• Użyj {baseDir} w instrukcjach, aby odwołać się do ścieżki folderu umiejętności.
• Opcjonalne klucze frontmatter:
  • homepage — URL wyświetlany jako „Website” w UI Skills na macOS (obsługiwany także przez metadata.openclaw.homepage).
  • user-invocable — true|false (domyślnie: true). Gdy ma wartość true, umiejętność jest udostępniana jako slash command użytkownika.
  • disable-model-invocation — true|false (domyślnie: false). Gdy ma wartość true, umiejętność jest wykluczana z promptu modelu (nadal dostępna przez wywołanie użytkownika).
  • command-dispatch — tool (opcjonalne). Gdy ustawione na tool, slash command omija model i jest wysyłane bezpośrednio do narzędzia.
  • command-tool — nazwa narzędzia do wywołania, gdy ustawiono command-dispatch: tool.
  • command-arg-mode — raw (domyślnie). Dla wysyłania do narzędzia przekazuje surowy ciąg argumentów do narzędzia (bez parsowania przez rdzeń). Narzędzie jest wywoływane z parametrami: { command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }.

​

Gating (filtry podczas ładowania)

---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },
        "primaryEnv": "GEMINI_API_KEY",
      },
  }
---

• always: true — zawsze uwzględnia umiejętność (pomija inne bramki).
• emoji — opcjonalne emoji używane przez UI Skills na macOS.
• homepage — opcjonalny URL wyświetlany jako „Website” w UI Skills na macOS.
• os — opcjonalna lista platform (darwin, linux, win32). Jeśli ustawiona, umiejętność jest kwalifikowana tylko na tych systemach.
• requires.bins — lista; każdy wpis musi istnieć w PATH.
• requires.anyBins — lista; co najmniej jeden wpis musi istnieć w PATH.
• requires.env — lista; zmienna env musi istnieć albo być dostarczona w config.
• requires.config — lista ścieżek openclaw.json, które muszą mieć wartość truthy.
• primaryEnv — nazwa zmiennej env powiązana z skills.entries.<name>.apiKey.
• install — opcjonalna tablica specyfikacji instalatora używana przez UI Skills na macOS (brew/node/go/uv/download).

• requires.bins jest sprawdzane na hoście podczas ładowania umiejętności.
• Jeśli agent działa w sandboxie, binarium musi także istnieć wewnątrz kontenera. Zainstaluj je przez agents.defaults.sandbox.docker.setupCommand (lub własny image). setupCommand uruchamia się raz po utworzeniu kontenera. Instalacje pakietów wymagają też ruchu sieciowego na zewnątrz, zapisywalnego głównego systemu plików oraz użytkownika root w sandboxie. Przykład: umiejętność summarize (skills/summarize/SKILL.md) wymaga CLI summarize w kontenerze sandboxa, aby mogła tam działać.

---
name: gemini
description: Use Gemini CLI for coding assistance and Google search lookups.
metadata:
  {
    "openclaw":
      {
        "emoji": "♊️",
        "requires": { "bins": ["gemini"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "gemini-cli",
              "bins": ["gemini"],
              "label": "Install Gemini CLI (brew)",
            },
          ],
      },
  }
---

• Jeśli wymieniono wiele instalatorów, gateway wybiera jedną preferowaną opcję (brew, gdy dostępne, w przeciwnym razie node).
• Jeśli wszystkie instalatory to download, OpenClaw wyświetla każdy wpis, aby można było zobaczyć dostępne artefakty.
• Specyfikacje instalatora mogą zawierać os: ["darwin"|"linux"|"win32"], aby filtrować opcje według platformy.
• Instalacje node uwzględniają skills.install.nodeManager w openclaw.json (domyślnie: npm; opcje: npm/pnpm/yarn/bun). Dotyczy to tylko instalacji Skills; runtime Gateway nadal powinien działać na Node (Bun nie jest zalecany dla WhatsApp/Telegram).
• Wybór instalatora wykonywany przez Gateway opiera się na preferencjach, a nie tylko na node: gdy specyfikacje instalacji mieszają różne rodzaje, OpenClaw preferuje Homebrew, jeśli skills.install.preferBrew jest włączone i istnieje brew, następnie uv, potem skonfigurowany menedżer node, a na końcu inne opcje zapasowe, takie jak go lub download.
• Jeśli każda specyfikacja instalacji to download, OpenClaw pokazuje wszystkie opcje pobierania zamiast zwijać je do jednego preferowanego instalatora.
• Instalacje Go: jeśli brakuje go, a brew jest dostępne, gateway najpierw instaluje Go przez Homebrew i ustawia GOBIN na bin Homebrew, gdy to możliwe.
• Instalacje przez pobranie: url (wymagane), archive (tar.gz | tar.bz2 | zip), extract (domyślnie: auto po wykryciu archiwum), stripComponents, targetDir (domyślnie: ~/.openclaw/tools/<skillKey>).

​

Nadpisania config (~/.openclaw/openclaw.json)

{
  skills: {
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // lub zwykły ciąg tekstowy
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
        config: {
          endpoint: "https://example.invalid",
          model: "nano-pro",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• enabled: false wyłącza umiejętność, nawet jeśli jest wbudowana/zainstalowana.
• env: wstrzykiwane tylko wtedy, gdy zmienna nie jest już ustawiona w procesie.
• apiKey: wygodny skrót dla Skills, które deklarują metadata.openclaw.primaryEnv. Obsługuje zwykły ciąg tekstowy lub obiekt SecretRef ({ source, provider, id }).
• config: opcjonalny worek na niestandardowe pola per umiejętność; niestandardowe klucze muszą znajdować się tutaj.
• allowBundled: opcjonalna allowlista tylko dla wbudowanych Skills. Jeśli jest ustawiona, kwalifikowane są tylko wbudowane Skills z listy (zarządzane/Skills workspace pozostają bez zmian).

​

Wstrzykiwanie środowiska (per uruchomienie agenta)

1. Odczytuje metadane umiejętności.
2. Stosuje wszelkie skills.entries.<key>.env lub skills.entries.<key>.apiKey do process.env.
3. Buduje prompt systemowy z kwalifikowanymi Skills.
4. Po zakończeniu uruchomienia przywraca oryginalne środowisko.

​

Snapshot sesji (wydajność)

​

Zdalne node macOS (gateway Linux)

​

Watcher Skills (automatyczne odświeżanie)

{
  skills: {
    load: {
      watch: true,
      watchDebounceMs: 250,
    },
  },
}

​

Wpływ na tokeny (lista Skills)

• Narzut bazowy (tylko gdy istnieje ≥1 Skill): 195 znaków.
• Na Skill: 97 znaków + długość wartości <name>, <description> i <location> po escapowaniu XML.

total = 195 + Σ (97 + len(name_escaped) + len(description_escaped) + len(location_escaped))

• Escapowanie XML rozszerza & < > " ' do encji (&, < itd.), zwiększając długość.
• Liczba tokenów zależy od tokenizera modelu. Przybliżony szacunek w stylu OpenAI to ~4 znaki/token, więc 97 znaków ≈ 24 tokeny na Skill plus rzeczywiste długości pól.

​

Cykl życia zarządzanych Skills

​

Dokumentacja config

​

Szukasz więcej Skills?

​

Powiązane

• Tworzenie Skills — tworzenie niestandardowych Skills
• Konfiguracja Skills — dokumentacja konfiguracji Skills
• Slash Commands — wszystkie dostępne slash commands
• Plugins — przegląd systemu pluginów