​

Umiejętności (OpenClaw)

​

Lokalizacje i priorytety

1. Dołączone skills: dostarczane wraz z instalacją (pakiet npm lub OpenClaw.app)
2. Zarządzane/lokalne skills: ~/.openclaw/skills
3. Skills obszaru roboczego: <workspace>/skills

​

Skills per-agent vs współdzielone

• Skills per-agent znajdują się w <workspace>/skills wyłącznie dla tego agenta.
• Skills współdzielone 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 przez wielu agentów.

​

Wtyczki + skills

​

ClawHub (instalacja + synchronizacja)

• Instalacja skilla do obszaru roboczego:
  • clawhub install <skill-slug>
• Aktualizacja wszystkich zainstalowanych skills:
  • clawhub update --all
• Synchronizacja (skanowanie + publikowanie aktualizacji):
  • clawhub sync --all

​

Uwagi dotyczące bezpieczeństwa

• Traktuj skills firm trzecich jako niezaufany kod. Przeczytaj je przed włączeniem.
• Preferuj uruchomienia w sandbox dla niezaufanych danych wejściowych i ryzykownych narzędzi. Zobacz Sandboxing.
• skills.entries.*.env i skills.entries.*.apiKey wstrzykują sekrety do procesu hosta dla danej tury agenta (nie do sandboxa). Trzymaj sekrety poza promptami i logami.
• Aby zapoznać się z szerszym modelem zagrożeń i checklistami, zobacz Security.

​

Format (AgentSkills + zgodny z Pi)

---
name: nano-banana-pro
description: Generate or edit images via Gemini 3 Pro Image
---

• Stosujemy specyfikację AgentSkills w zakresie układu i intencji.
• Parser używany przez osadzonego agenta obsługuje wyłącznie klucze frontmatteru jednolinijkowe.
• metadata powinno być jednolinijkowym obiektem JSON.
• Używaj {baseDir} w instrukcjach, aby odwoływać się do ścieżki folderu skilla.
• Opcjonalne klucze frontmatteru:
  • homepage — URL prezentowany jako „Website” w interfejsie Skills na macOS (obsługiwane również przez metadata.openclaw.homepage).
  • user-invocable — true|false (domyślnie: true). Gdy true, skill jest udostępniany jako komenda ukośnikowa użytkownika.
  • disable-model-invocation — true|false (domyślnie: false). Gdy true, skill jest wykluczony z promptu modelu (nadal dostępny przez wywołanie użytkownika).
  • command-dispatch — tool (opcjonalne). Gdy ustawione na tool, komenda ukośnikowa omija model i jest bezpośrednio przekazywana do narzędzia.
  • command-tool — nazwa narzędzia do wywołania, gdy ustawiono command-dispatch: tool.
  • command-arg-mode — raw (domyślnie). Dla dyspozycji narzędzia przekazuje surowy ciąg argumentów do narzędzia (bez parsowania po stronie core). Narzędzie jest wywoływane z parametrami: { command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }.

​

Bramkowanie (filtry czasu ładowania)

---
name: nano-banana-pro
description: Generate or edit images via Gemini 3 Pro Image
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },
        "primaryEnv": "GEMINI_API_KEY",
      },
  }
---

• always: true — zawsze uwzględnia skill (pomija inne bramki).
• emoji — opcjonalna emoji używana przez interfejs Skills na macOS.
• homepage — opcjonalny URL wyświetlany jako „Website” w interfejsie Skills na macOS.
• os — opcjonalna lista platform (darwin, linux, win32). Jeśli ustawiona, skill jest kwalifikowany wyłącznie na tych systemach operacyjnych.
• requires.bins — lista; każdy element musi istnieć na PATH.
• requires.anyBins — lista; co najmniej jeden element musi istnieć na PATH.
• requires.env — lista; zmienna środowiskowa musi istnieć lub być podana w konfiguracji.
• requires.config — lista ścieżek openclaw.json, które muszą być prawdziwe.
• primaryEnv — nazwa zmiennej środowiskowej powiązana z skills.entries.<name>.apiKey.
• install — opcjonalna tablica specyfikacji instalatorów używanych przez interfejs Skills na macOS (brew/node/go/uv/download).

• requires.bins jest sprawdzane na hoście w czasie ładowania skilla.
• Jeśli agent działa w sandboxie, binarium musi również istnieć wewnątrz kontenera. Zainstaluj je przez agents.defaults.sandbox.docker.setupCommand (lub niestandardowy obraz). setupCommand uruchamia się raz po utworzeniu kontenera. Instalacje pakietów wymagają także wyjścia sieciowego, zapisywalnego głównego systemu plików oraz użytkownika root w sandboxie. Przykład: skill summarize (skills/summarize/SKILL.md) wymaga CLI summarize w kontenerze sandboxa, aby działać w nim.

---
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 podano wiele instalatorów, Gateway wybiera jedną preferowaną opcję (brew, gdy dostępny, w przeciwnym razie node).
• Jeśli wszystkie instalatory są download, OpenClaw wyświetla każdą pozycję, aby było widać dostępne artefakty.
• Specyfikacje instalatorów mogą zawierać os: ["darwin"|"linux"|"win32"], aby filtrować opcje według platformy.
• Instalacje Node honorują skills.install.nodeManager w openclaw.json (domyślnie: npm; opcje: npm/pnpm/yarn/bun). Dotyczy to wyłącznie instalacji skills; środowisko uruchomieniowe Gateway nadal powinno być Node (Bun nie jest zalecany dla WhatsApp/Telegram).
• 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 typu download: url (wymagane), archive (tar.gz | tar.bz2 | zip), extract (domyślnie: auto, gdy wykryto archiwum), stripComponents, targetDir (domyślnie: ~/.openclaw/tools/<skillKey>).

​

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

{
  skills: {
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: "GEMINI_KEY_HERE",
        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 skill nawet jeśli jest dołączony/zainstalowany.
• env: wstrzykiwane tylko jeśli zmienna nie jest już ustawiona w procesie.
• apiKey: ułatwienie dla skills deklarujących metadata.openclaw.primaryEnv.
• config: opcjonalny worek na niestandardowe pola per-skill; niestandardowe klucze muszą się tu znajdować.
• allowBundled: opcjonalna lista dozwolonych wyłącznie dla dołączonych skills. Jeśli ustawiona, kwalifikują się tylko dołączone skills z listy (zarządzane/obszaru roboczego nie są dotknięte).

​

Wstrzykiwanie środowiska (na uruchomienie agenta)

1. Odczytuje metadane skills.
2. Stosuje wszelkie skills.entries.<key>.env lub skills.entries.<key>.apiKey do process.env.
3. Buduje prompt systemowy z kwalifikującymi się skills.
4. Przywraca oryginalne środowisko po zakończeniu uruchomienia.

​

Migawka sesji (wydajność)

​

Zdalne węzły macOS (Gateway na Linuxie)

​

Watcher skills (automatyczne odświeżanie)

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

​

Wpływ na tokeny (lista skills)

• Bazowy narzut (tylko gdy ≥1 skill): 195 znaków.
• Na skill: 97 znaków + długość wartości <name>, <description> oraz <location> po ucieczce XML.

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

• Ucieczka XML rozszerza & < > " ' do encji (&, < itd.), zwiększając długość.
• Liczba tokenów różni się w zależności od tokenizera modelu. Przybliżone oszacowanie 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

​

Referencja konfiguracji

​

Szukasz więcej skills?