> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

Skills to pliki instrukcji w Markdownie, które uczą agenta, jak i kiedy używać
narzędzi. Każdy skill znajduje się w katalogu zawierającym plik `SKILL.md` z
frontmatter YAML i treścią w Markdownie. OpenClaw ładuje wbudowane Skills oraz
wszelkie lokalne nadpisania, a następnie filtruje je podczas ładowania na
podstawie środowiska, konfiguracji i obecności plików binarnych.

<CardGroup cols={2}>
  <Card title="Creating skills" href="/pl/tools/creating-skills" icon="hammer">
    Zbuduj i przetestuj niestandardowy skill od podstaw.
  </Card>

  <Card title="Skill Workshop" href="/pl/tools/skill-workshop" icon="flask">
    Przeglądaj i zatwierdzaj propozycje Skills przygotowane przez agenta.
  </Card>

  <Card title="Skills config" href="/pl/tools/skills-config" icon="gear">
    Pełny schemat konfiguracji `skills.*` i listy dozwolonych dla agentów.
  </Card>

  <Card title="ClawHub" href="/clawhub" icon="cloud">
    Przeglądaj i instaluj społecznościowe Skills.
  </Card>
</CardGroup>

## Kolejność ładowania

OpenClaw ładuje z tych źródeł, **najpierw z najwyższym priorytetem**. Gdy ta
sama nazwa skillu pojawia się w wielu miejscach, wygrywa źródło o najwyższym
priorytecie.

| Priorytet     | Źródło                      | Ścieżka                                 |
| ------------- | --------------------------- | --------------------------------------- |
| 1 — najwyższy | Skills obszaru roboczego    | `<workspace>/skills`                    |
| 2             | Skills agenta projektu      | `<workspace>/.agents/skills`            |
| 3             | Osobiste Skills agenta      | `~/.agents/skills`                      |
| 4             | Zarządzane / lokalne Skills | `~/.openclaw/skills`                    |
| 5             | Wbudowane Skills            | dostarczane z instalacją                |
| 6 — najniższy | Dodatkowe katalogi          | `skills.load.extraDirs` + Skills Plugin |

Katalogi główne Skills obsługują układy grupowane. OpenClaw wykrywa skill za
każdym razem, gdy `SKILL.md` pojawia się gdziekolwiek pod skonfigurowanym
katalogiem głównym:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
<workspace>/skills/research/SKILL.md          ✓ found as "research"
<workspace>/skills/personal/research/SKILL.md ✓ also found as "research"
```

Ścieżka folderu służy wyłącznie do organizacji. Nazwa skillu, polecenie z
ukośnikiem i klucz listy dozwolonych pochodzą z pola frontmatter `name` (albo z
nazwy katalogu, gdy brakuje `name`).

<Note>
  Natywny katalog Codex CLI `$CODEX_HOME/skills` **nie** jest katalogiem głównym
  Skills OpenClaw. Użyj `openclaw migrate plan codex`, aby zinwentaryzować te
  Skills, a następnie `openclaw migrate codex`, aby skopiować je do obszaru
  roboczego OpenClaw.
</Note>

## Skills per agent a współdzielone Skills

W konfiguracjach wieloagentowych każdy agent ma własny obszar roboczy. Użyj
ścieżki odpowiadającej oczekiwanej widoczności:

| Zakres                   | Ścieżka                      | Widoczne dla                       |
| ------------------------ | ---------------------------- | ---------------------------------- |
| Per-agent                | `<workspace>/skills`         | Tylko ten agent                    |
| Agent projektu           | `<workspace>/.agents/skills` | Tylko agent tego obszaru roboczego |
| Agent osobisty           | `~/.agents/skills`           | Wszyscy agenci na tej maszynie     |
| Współdzielone zarządzane | `~/.openclaw/skills`         | Wszyscy agenci na tej maszynie     |
| Dodatkowe katalogi       | `skills.load.extraDirs`      | Wszyscy agenci na tej maszynie     |

## Listy dozwolonych agentów

**Lokalizacja** skillu (priorytet) i **widoczność** skillu (który agent może go
używać) to osobne mechanizmy kontroli. Użyj list dozwolonych, aby ograniczyć,
które Skills agent widzi, niezależnie od tego, skąd zostały załadowane.

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      skills: ["github", "weather"], // shared baseline
    },
    list: [
      { id: "writer" }, // inherits github, weather
      { id: "docs", skills: ["docs-search"] }, // replaces defaults entirely
      { id: "locked-down", skills: [] }, // no skills
    ],
  },
}
```

<AccordionGroup>
  <Accordion title="Allowlist rules">
    * Pomiń `agents.defaults.skills`, aby domyślnie pozostawić wszystkie Skills bez ograniczeń.
    * Pomiń `agents.list[].skills`, aby dziedziczyć `agents.defaults.skills`.
    * Ustaw `agents.list[].skills: []`, aby nie udostępniać żadnych Skills temu agentowi.
    * Niepusta lista `agents.list[].skills` jest **ostatecznym** zestawem — nie
      łączy się z wartościami domyślnymi.
    * Efektywna lista dozwolonych obowiązuje przy budowaniu promptu, wykrywaniu
      poleceń z ukośnikiem, synchronizacji sandboxa i migawkach Skills.
    * To nie jest granica autoryzacji powłoki hosta. Jeśli ten sam agent może
      używać `exec`, ogranicz tę powłokę osobno za pomocą sandboxingu, izolacji
      użytkownika systemu operacyjnego, list zakazów/dozwoleń dla exec oraz
      poświadczeń per zasób.
  </Accordion>
</AccordionGroup>

## Pluginy i Skills

Pluginy mogą dostarczać własne Skills, wskazując katalogi `skills` w
`openclaw.plugin.json` (ścieżki względne względem katalogu głównego Plugin).
Skills Plugin ładują się, gdy Plugin jest włączony — na przykład Plugin
przeglądarki dostarcza skill `browser-automation` do wieloetapowego sterowania
przeglądarką.

Katalogi Skills Plugin są scalane na tym samym poziomie niskiego priorytetu co
`skills.load.extraDirs`, więc wbudowany, zarządzany, agentowy albo roboczy skill
o tej samej nazwie je nadpisuje. Bramkuj je przez
`metadata.openclaw.requires.config` we wpisie konfiguracji Plugin.

Zobacz [Plugins](/pl/tools/plugin) i [Tools](/pl/tools), aby poznać pełny system Plugin.

## Skill Workshop

[Skill Workshop](/pl/tools/skill-workshop) to kolejka propozycji między agentem a
aktywnymi plikami Skills. Gdy agent zauważy pracę nadającą się do ponownego
użycia, przygotowuje propozycję zamiast pisać bezpośrednio do `SKILL.md`.
Przeglądasz i zatwierdzasz ją, zanim cokolwiek się zmieni.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>
```

Zobacz [Skill Workshop](/pl/tools/skill-workshop), aby poznać pełny cykl życia,
referencję CLI i konfigurację.

## Instalowanie z ClawHub

[ClawHub](https://clawhub.ai) to publiczny rejestr Skills. Używaj poleceń
`openclaw skills` do instalowania i aktualizowania albo CLI `clawhub` do
publikowania i synchronizacji.

| Akcja                                                 | Polecenie                                              |
| ----------------------------------------------------- | ------------------------------------------------------ |
| Zainstaluj skill w obszarze roboczym                  | `openclaw skills install @owner/<slug>`                |
| Zainstaluj z repozytorium Git                         | `openclaw skills install git:owner/repo@ref`           |
| Zainstaluj lokalny katalog skillu                     | `openclaw skills install ./path/to/skill --as my-tool` |
| Zainstaluj dla wszystkich lokalnych agentów           | `openclaw skills install @owner/<slug> --global`       |
| Zaktualizuj wszystkie Skills obszaru roboczego        | `openclaw skills update --all`                         |
| Zaktualizuj współdzielony zarządzany skill            | `openclaw skills update @owner/<slug> --global`        |
| Zaktualizuj wszystkie współdzielone zarządzane Skills | `openclaw skills update --all --global`                |
| Zweryfikuj kopertę zaufania skillu                    | `openclaw skills verify @owner/<slug>`                 |
| Wypisz wygenerowaną Skill Card                        | `openclaw skills verify @owner/<slug> --card`          |
| Publikuj / synchronizuj przez ClawHub CLI             | `clawhub sync --all`                                   |

<AccordionGroup>
  <Accordion title="Install details">
    `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 listy dozwolonych agentów go zawężą.

    Instalacje Git i lokalne oczekują `SKILL.md` w katalogu głównym źródła. Slug
    pochodzi z frontmatter `SKILL.md` pola `name`, gdy jest poprawne, a następnie
    używa nazwy katalogu albo repozytorium jako wartości zapasowej. Użyj
    `--as <slug>`, aby nadpisać. `openclaw skills update` śledzi tylko
    instalacje ClawHub — zainstaluj ponownie źródła Git albo lokalne, aby je
    odświeżyć.
  </Accordion>

  <Accordion title="Verification and security scanning">
    `openclaw skills verify @owner/<slug>` prosi ClawHub o kopertę zaufania
    `clawhub.skill.verify.v1` dla skillu. Zainstalowane Skills ClawHub są
    weryfikowane względem wersji i rejestru zapisanych w `.clawhub/origin.json`.
    Same slugi pozostają akceptowane dla istniejących zainstalowanych albo
    jednoznacznych Skills, ale referencje z właścicielem unikają niejednoznaczności
    wydawcy.

    Strony Skills w ClawHub pokazują najnowszy stan skanowania bezpieczeństwa
    przed instalacją, ze stronami szczegółów dla VirusTotal, ClawScan i analizy
    statycznej. Polecenie kończy się kodem niezerowym, gdy ClawHub oznaczy
    weryfikację jako nieudaną. Wydawcy obsługują fałszywe alarmy przez dashboard
    ClawHub albo `clawhub skill rescan @owner/<slug>`.
  </Accordion>

  <Accordion title="Private archive installs">
    Klienci Gateway, którzy potrzebują dostarczania poza ClawHub, mogą przygotować
    archiwum zip ze skillem za pomocą `skills.upload.begin`,
    `skills.upload.chunk` i `skills.upload.commit`, a następnie zainstalować je
    przez `skills.install({ source: "upload", ... })`. Ta ścieżka jest domyślnie
    wyłączona i wymaga `skills.install.allowUploadedArchives: true` w
    `openclaw.json`. Zwykłe instalacje ClawHub nigdy nie potrzebują tego
    ustawienia.
  </Accordion>
</AccordionGroup>

## Bezpieczeństwo

<Warning>
  Traktuj Skills stron trzecich jako **niezaufany kod**. Przeczytaj je przed
  włączeniem. Preferuj uruchomienia w sandboxie dla niezaufanych danych wejściowych
  i ryzykownych narzędzi. Zobacz [Sandboxing](/pl/gateway/sandboxing), aby poznać
  mechanizmy kontroli po stronie agenta.
</Warning>

<AccordionGroup>
  <Accordion title="Path containment">
    Wykrywanie Skills obszaru roboczego, agenta projektu i dodatkowych katalogów
    akceptuje tylko katalogi główne Skills, których rozwiązany realpath pozostaje
    wewnątrz skonfigurowanego katalogu głównego, chyba że
    `skills.load.allowSymlinkTargets` jawnie ufa katalogowi docelowemu. Skill
    Workshop zapisuje przez te zaufane cele tylko wtedy, gdy włączono
    `skills.workshop.allowSymlinkTargetWrites`. Zarządzane `~/.openclaw/skills`
    i osobiste `~/.agents/skills` mogą zawierać dowiązane symbolicznie foldery
    Skills, ale każdy realpath `SKILL.md` nadal musi pozostawać wewnątrz
    rozwiązanego katalogu skillu.
  </Accordion>

  <Accordion title="Operator install policy">
    Skonfiguruj `security.installPolicy`, aby uruchamiać zaufane lokalne polecenie
    polityki, zanim instalacje Skills będą kontynuowane. Polityka otrzymuje
    metadane i przygotowaną ścieżkę źródłową, dotyczy ścieżek ClawHub, przesłanych,
    Git, lokalnych, aktualizacji i instalatora zależności, a w razie braku
    możliwości zwrócenia prawidłowej decyzji kończy się odmową.
  </Accordion>

  <Accordion title="Secret injection scope">
    `skills.entries.*.env` i `skills.entries.*.apiKey` wstrzykują sekrety do
    procesu **hosta** tylko na czas tej tury agenta — nie do sandboxa. Nie
    umieszczaj sekretów w promptach ani logach.
  </Accordion>
</AccordionGroup>

Szerszy model zagrożeń i listy kontrolne bezpieczeństwa znajdziesz w
[Security](/pl/gateway/security).

## Format SKILL.md

Każdy skill wymaga co najmniej `name` i `description` we frontmatter:

```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}}
---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
---

When the user asks to generate an image, use the `image_generate` tool...
```

<Note>
  OpenClaw stosuje specyfikację [AgentSkills](https://agentskills.io). Parser
  frontmatter obsługuje **tylko klucze jednowierszowe** — `metadata` musi być
  jednowierszowym obiektem JSON. Użyj `{baseDir}` w treści, aby odwołać się do
  ścieżki folderu skillu.
</Note>

### Opcjonalne klucze frontmatter

<ParamField path="homepage" type="string">
  URL pokazywany jako "Website" w interfejsie macOS Skills. Obsługiwane także
  przez `metadata.openclaw.homepage`.
</ParamField>

<ParamField path="user-invocable" type="boolean" default="true">
  Gdy `true`, skill jest udostępniany jako wywoływane przez użytkownika polecenie
  z ukośnikiem.
</ParamField>

<ParamField path="disable-model-invocation" type="boolean" default="false">
  Gdy `true`, OpenClaw nie umieszcza instrukcji skillu w normalnym prompcie
  agenta. Skill nadal jest dostępny jako polecenie z ukośnikiem, gdy
  `user-invocable` również ma wartość `true`.
</ParamField>

<ParamField path="command-dispatch" type="&#x22;tool&#x22;">
  Gdy ustawione na `tool`, polecenie z ukośnikiem omija model i jest kierowane
  bezpośrednio do zarejestrowanego narzędzia.
</ParamField>

<ParamField path="command-tool" type="string">
  Nazwa narzędzia do wywołania, gdy ustawiono `command-dispatch: tool`.
</ParamField>

<ParamField path="command-arg-mode" type="&#x22;raw&#x22;" default="raw">
  Przy wysyłaniu narzędzia przekazuje surowy ciąg argumentów do narzędzia bez
  parsowania w rdzeniu. Narzędzie otrzymuje
  `{ command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }`.
</ParamField>

## Bramkowanie

OpenClaw filtruje umiejętności podczas ładowania przy użyciu `metadata.openclaw` (jednowierszowy
JSON we frontmatter). Umiejętność bez bloku `metadata.openclaw` jest zawsze
kwalifikowana, chyba że została jawnie wyłączona.

```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}}
---
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",
      },
  }
---
```

<ParamField path="always" type="boolean">
  Gdy `true`, zawsze dołączaj umiejętność i pomijaj wszystkie pozostałe bramki.
</ParamField>

<ParamField path="emoji" type="string">
  Opcjonalne emoji wyświetlane w interfejsie macOS Skills.
</ParamField>

<ParamField path="homepage" type="string">
  Opcjonalny URL wyświetlany jako „Witryna” w interfejsie macOS Skills.
</ParamField>

<ParamField path="os" type="&#x22;darwin&#x22; | &#x22;linux&#x22; | &#x22;win32&#x22;">
  Filtr platformy. Gdy jest ustawiony, umiejętność kwalifikuje się tylko na wymienionych systemach operacyjnych.
</ParamField>

<ParamField path="requires.bins" type="string[]">
  Każdy plik binarny musi istnieć w `PATH`.
</ParamField>

<ParamField path="requires.anyBins" type="string[]">
  Co najmniej jeden plik binarny musi istnieć w `PATH`.
</ParamField>

<ParamField path="requires.env" type="string[]">
  Każda zmienna env musi istnieć w procesie albo być dostarczona przez konfigurację.
</ParamField>

<ParamField path="requires.config" type="string[]">
  Każda ścieżka `openclaw.json` musi mieć wartość prawdziwą.
</ParamField>

<ParamField path="primaryEnv" type="string">
  Nazwa zmiennej env powiązana z `skills.entries.<name>.apiKey`.
</ParamField>

<ParamField path="install" type="object[]">
  Opcjonalne specyfikacje instalatora używane przez interfejs macOS Skills (brew / node / go / uv / download).
</ParamField>

<Note>
  Starsze bloki `metadata.clawdbot` są nadal akceptowane, gdy
  `metadata.openclaw` nie istnieje, więc starsze zainstalowane umiejętności zachowują swoje
  bramki zależności i wskazówki instalatora. Nowe umiejętności powinny używać
  `metadata.openclaw`.
</Note>

### Specyfikacje instalatora

Specyfikacje instalatora mówią interfejsowi macOS Skills, jak zainstalować zależność:

```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}}
---
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)",
            },
          ],
      },
  }
---
```

<AccordionGroup>
  <Accordion title="Reguły wyboru instalatora">
    * Gdy podano wiele instalatorów, gateway wybiera jedną preferowaną
      opcję (`brew`, gdy jest dostępny, w przeciwnym razie `node`).
    * Jeśli wszystkie instalatory to `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 respektują `skills.install.nodeManager` w `openclaw.json`
      (domyślnie: npm; opcje: npm / pnpm / yarn / bun). Dotyczy to tylko
      instalacji umiejętności; środowisko uruchomieniowe Gateway powinno nadal być Node.
    * Preferencje instalatora Gateway: Homebrew → uv → skonfigurowany menedżer node →
      go → download.
  </Accordion>

  <Accordion title="Szczegóły poszczególnych instalatorów">
    * **Homebrew:** OpenClaw nie instaluje automatycznie Homebrew ani nie tłumaczy formuł brew
      na polecenia pakietów systemowych. W kontenerach Linux bez
      `brew` instalatory wyłącznie brew są ukryte; użyj niestandardowego obrazu albo zainstaluj
      zależność ręcznie.
    * **Go:** OpenClaw wymaga Go 1.21 lub nowszego do automatycznych instalacji umiejętności i
      zachowuje istniejące ustawienia `GOBIN`, `GOPATH` oraz `GOTOOLCHAIN`. Jeśli
      skonfigurowany toolchain nie może spełnić wymaganej przez moduł wersji Go,
      onboarding grupuje umiejętność z ręcznymi wymaganiami wstępnymi Go po próbie
      instalacji. Jeśli brakuje `go`, a Homebrew jest dostępny, OpenClaw najpierw instaluje
      Go przez Homebrew i ustawia `GOBIN` na `bin` z Homebrew. W systemie Linux
      OpenClaw może zamiast tego użyć `apt-get` jako root albo przez bezhasłowe `sudo`,
      gdy odświeżony kandydat `golang-go` spełnia minimalną wersję.
    * **Download:** `url` (wymagane), `archive` (`tar.gz` | `tar.bz2` | `zip`),
      `extract` (domyślnie: auto po wykryciu archiwum), `stripComponents`,
      `targetDir` (domyślnie: `~/.openclaw/tools/<skillKey>`).
  </Accordion>

  <Accordion title="Uwagi o sandboxingu">
    `requires.bins` jest sprawdzane na **hoście** podczas ładowania umiejętności. Jeśli agent
    działa w sandboxie, plik binarny musi też istnieć **wewnątrz kontenera**.
    Zainstaluj go przez `agents.defaults.sandbox.docker.setupCommand` albo niestandardowy
    obraz. `setupCommand` uruchamia się raz po utworzeniu kontenera i wymaga
    wyjścia do sieci, zapisywalnego głównego systemu plików oraz użytkownika root w sandboxie.
  </Accordion>
</AccordionGroup>

## Nadpisania konfiguracji

Włączaj, wyłączaj i konfiguruj dołączone lub zarządzane umiejętności pod `skills.entries` w
`~/.openclaw/openclaw.json`:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  skills: {
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },
        config: {
          endpoint: "https://example.invalid",
          model: "nano-pro",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}
```

<ParamField path="enabled" type="boolean">
  `false` wyłącza umiejętność nawet wtedy, gdy jest dołączona lub zainstalowana. Dołączona
  umiejętność `coding-agent` jest opcjonalna — ustaw `skills.entries.coding-agent.enabled: true`
  i upewnij się, że `claude`, `codex`, `opencode` lub inny obsługiwany CLI
  jest zainstalowany i uwierzytelniony.
</ParamField>

<ParamField path="apiKey" type="string | { source, provider, id }">
  Wygodne pole dla umiejętności deklarujących `metadata.openclaw.primaryEnv`.
  Obsługuje zwykły ciąg tekstowy albo obiekt SecretRef.
</ParamField>

<ParamField path="env" type="Record<string, string>">
  Zmienne środowiskowe wstrzykiwane dla uruchomienia agenta. Wstrzykiwane tylko wtedy, gdy
  zmienna nie jest już ustawiona w procesie.
</ParamField>

<ParamField path="config" type="object">
  Opcjonalny zestaw niestandardowych pól konfiguracji dla danej umiejętności.
</ParamField>

<ParamField path="allowBundled" type="string[]">
  Opcjonalna lista dozwolonych wyłącznie dla **dołączonych** umiejętności. Gdy jest ustawiona, kwalifikują się tylko dołączone umiejętności
  z listy. Umiejętności zarządzane i z przestrzeni roboczej pozostają bez zmian.
</ParamField>

<Note>
  Klucze konfiguracji domyślnie odpowiadają **nazwie umiejętności**. Jeśli umiejętność definiuje
  `metadata.openclaw.skillKey`, użyj tego klucza pod `skills.entries`. Nazwy
  z łącznikiem ujmij w cudzysłów: JSON5 pozwala na klucze w cudzysłowie.
</Note>

## Wstrzykiwanie środowiska

Gdy rozpoczyna się uruchomienie agenta, OpenClaw:

<Steps>
  <Step title="Odczytuje metadane umiejętności">
    OpenClaw rozwiązuje efektywną listę umiejętności dla agenta, stosując reguły
    bramkowania, listy dozwolonych i nadpisania konfiguracji.
  </Step>

  <Step title="Wstrzykuje env i klucze API">
    `skills.entries.<key>.env` i `skills.entries.<key>.apiKey` są stosowane do
    `process.env` na czas trwania uruchomienia.
  </Step>

  <Step title="Buduje prompt systemowy">
    Kwalifikujące się umiejętności są kompilowane do zwartego bloku XML i wstrzykiwane do
    promptu systemowego.
  </Step>

  <Step title="Przywraca środowisko">
    Po zakończeniu uruchomienia przywracane jest pierwotne środowisko.
  </Step>
</Steps>

<Warning>
  Wstrzykiwanie env jest ograniczone do uruchomienia agenta na **hoście**, a nie do sandboxa. Wewnątrz
  sandboxa `env` i `apiKey` nie mają efektu. Zobacz
  [Konfiguracja Skills](/pl/tools/skills-config#sandboxed-skills-and-env-vars), aby dowiedzieć się,
  jak przekazywać sekrety do uruchomień w sandboxie.
</Warning>

Dla dołączonego backendu `claude-cli` OpenClaw materializuje również tę samą
kwalifikującą się migawkę umiejętności jako tymczasowy plugin Claude Code i przekazuje ją przez
`--plugin-dir`. Inne backendy CLI używają tylko katalogu promptów.

## Migawki i odświeżanie

OpenClaw tworzy migawkę kwalifikujących się umiejętności **gdy sesja się zaczyna** i ponownie używa tej
listy we wszystkich kolejnych turach w sesji. Zmiany w umiejętnościach lub konfiguracji zaczynają
działać przy następnej nowej sesji.

Umiejętności odświeżają się w trakcie sesji w dwóch przypadkach:

* Obserwator umiejętności wykryje zmianę `SKILL.md`.
* Połączy się nowy kwalifikujący się zdalny węzeł.

Odświeżona lista zostanie użyta w następnej turze agenta. Jeśli efektywna
lista dozwolonych agenta się zmieni, OpenClaw odświeża migawkę, aby utrzymać widoczne umiejętności
w zgodności.

<AccordionGroup>
  <Accordion title="Obserwator Skills">
    Domyślnie OpenClaw obserwuje foldery umiejętności i podbija migawkę, gdy
    zmieniają się pliki `SKILL.md`. Skonfiguruj pod `skills.load`:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      skills: {
        load: {
          extraDirs: ["~/Projects/agent-scripts/skills"],
          allowSymlinkTargets: ["~/Projects/manager/skills"],
          watch: true,
          watchDebounceMs: 250,
        },
      },
    }
    ```

    Użyj `allowSymlinkTargets` dla celowo dowiązanych układów, w których dowiązanie symboliczne
    katalogu głównego umiejętności 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
    powinien też stosować propozycje przez te zaufane dowiązane ścieżki.
  </Accordion>

  <Accordion title="Zdalne węzły macOS (Linux gateway)">
    Jeśli Gateway działa na Linuksie, ale połączony jest **węzeł macOS** z dozwolonym
    `system.run`, OpenClaw może traktować umiejętności dostępne tylko na macOS jako kwalifikujące się, gdy
    wymagane pliki binarne są obecne na tym węźle. Agent powinien uruchamiać te
    umiejętności przez narzędzie `exec` z `host=node`.

    Węzły offline **nie** sprawiają, że zdalne umiejętności stają się widoczne. Jeśli węzeł przestanie
    odpowiadać na sondy bin, OpenClaw czyści jego buforowane dopasowania bin.
  </Accordion>
</AccordionGroup>

## Wpływ na tokeny

Gdy umiejętności się kwalifikują, OpenClaw wstrzykuje zwarty blok XML do promptu
systemowego. Koszt jest deterministyczny:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
total = 195 + Σ (97 + len(name) + len(description) + len(filepath))
```

* **Narzut bazowy** (tylko gdy ≥ 1 umiejętność): \~195 znaków
* **Na umiejętność:** \~97 znaków + długości pól `name`, `description` i `location`
* Escapowanie XML rozszerza `& < > " '` do encji, dodając kilka znaków na każde wystąpienie
* Przy \~4 znakach/token, 97 znaków ≈ 24 tokeny na umiejętność przed długościami pól

Utrzymuj opisy krótkie i opisowe, aby zminimalizować narzut promptu.

## Powiązane

<CardGroup cols={2}>
  <Card title="Tworzenie umiejętności" href="/pl/tools/creating-skills" icon="hammer">
    Przewodnik krok po kroku po tworzeniu niestandardowej umiejętności.
  </Card>

  <Card title="Skill Workshop" href="/pl/tools/skill-workshop" icon="flask">
    Kolejka propozycji dla umiejętności szkicowanych przez agenta.
  </Card>

  <Card title="Konfiguracja Skills" href="/pl/tools/skills-config" icon="gear">
    Pełny schemat konfiguracji `skills.*` i listy dozwolonych agentów.
  </Card>

  <Card title="Polecenia ukośnikowe" href="/pl/tools/slash-commands" icon="terminal">
    Jak polecenia ukośnikowe umiejętności są rejestrowane i routowane.
  </Card>

  <Card title="ClawHub" href="/clawhub" icon="cloud">
    Przeglądaj i publikuj umiejętności w publicznym rejestrze.
  </Card>

  <Card title="Pluginy" href="/pl/tools/plugin" icon="plug">
    Pluginy mogą dostarczać umiejętności razem z narzędziami, które dokumentują.
  </Card>
</CardGroup>