Konfiguracja Skills

Większość konfiguracji Skills znajduje się w skills w ~/.openclaw/openclaw.json. Widoczność właściwa dla agenta znajduje się w agents.defaults.skills i agents.list[].skills.

{  skills: {    allowBundled: ["gemini", "peekaboo"],    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,      watchDebounceMs: 250,    },    install: {      preferBrew: true,      nodeManager: "npm",      allowUploadedArchives: false,    },    workshop: {      autonomous: { enabled: false },      allowSymlinkTargetWrites: false,      approvalPolicy: "auto",      maxPending: 50,      maxSkillBytes: 40000,    },    entries: {      "image-lab": {        enabled: true,        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },      },      peekaboo: { enabled: true },      sag: { enabled: false },    },  },}

Ładowanie (skills.load)

Instalacja (skills.install)

Zasady instalacji operatora (security.installPolicy)

Należy używać security.installPolicy, gdy operatorzy potrzebują zaufanego polecenia lokalnego do zatwierdzania lub blokowania instalacji Skills i Pluginów zgodnie z zasadami właściwymi dla hosta. Zasady są uruchamiane po przygotowaniu materiału źródłowego przez OpenClaw, a przed kontynuowaniem instalacji lub aktualizacji. Dotyczą Skills z ClawHub, przesłanych Skills, Skills z Git/lokalnych, instalatorów zależności Skills oraz źródeł instalacji i aktualizacji Pluginów.

{  security: {    installPolicy: {      enabled: true,      // Pomiń targets, aby objąć wszystkie obsługiwane cele.      targets: ["skill", "plugin"],      exec: {        source: "exec",        command: "/usr/local/bin/openclaw-install-policy",        args: ["--json"],        timeoutMs: 10000,        noOutputTimeoutMs: 10000,        maxOutputBytes: 1048576,        passEnv: ["OPENCLAW_STATE_DIR", "PATH"],        env: { POLICY_MODE: "strict" },        trustedDirs: ["/usr/local/bin"],      },    },  },}

Zasady otrzymują na stdin jeden obiekt JSON zawierający protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, opcjonalne ustrukturyzowane source, ustrukturyzowane origin oraz request. Muszą zapisać na stdout jeden obiekt JSON: { "protocolVersion": 1, "decision": "allow" } lub { "protocolVersion": 1, "decision": "block", "reason": "..." }. Niezerowy kod wyjścia, przekroczenie limitu czasu, nieprawidłowy JSON, brakujące pola lub nieobsługiwane wersje protokołu powodują bezpieczne zablokowanie operacji.

OpenClaw nie wykonuje zasad instalacji podczas zwykłego uruchamiania Gateway. Instalacje i aktualizacje są bezpiecznie blokowane, gdy zasady są włączone, ale niedostępne. openclaw doctor wykonuje walidację statyczną; openclaw doctor --deep wykonuje syntetyczną próbę instalacji przy użyciu skonfigurowanego polecenia.

Aktualizacje zbiorcze stosują zasady osobno dla każdego celu: zablokowana aktualizacja Skill lub Pluginu kończy się niepowodzeniem dla tego celu, bez wyłączania zasad ani pomijania kolejnych celów w partii.

Przykładowe dane stdin:

{  "protocolVersion": 1,  "openclawVersion": "2026.6.1",  "targetType": "skill",  "targetName": "weather",  "sourcePath": "/var/folders/.../openclaw-skill-clawhub/root",  "sourcePathKind": "directory",  "source": {    "kind": "clawhub",    "authority": "openclaw",    "mutable": false,    "network": true  },  "origin": {    "type": "clawhub",    "registry": "https://clawhub.openclaw.ai",    "slug": "weather",    "version": "1.0.0"  },  "request": {    "kind": "skill-install",    "mode": "install",    "requestedSpecifier": "clawhub:weather@1.0.0"  },  "skill": {    "installId": "clawhub"  }}

Minimalne polecenie zasad:

#!/usr/bin/env node let input = "";process.stdin.setEncoding("utf8");process.stdin.on("data", (chunk) => {  input += chunk;});process.stdin.on("end", () => {  const request = JSON.parse(input);  if (request.targetType === "plugin" && request.source?.kind === "local-path") {    process.stdout.write(      JSON.stringify({        protocolVersion: 1,        decision: "block",        reason: "lokalne ścieżki Pluginów nie są zatwierdzone na tym hoście",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

Lista dozwolonych wbudowanych Skills

Wpisy poszczególnych Skills (skills.entries)

Klucze w entries domyślnie odpowiadają name Skill. Jeśli Skill definiuje metadata.openclaw.skillKey, należy użyć tego klucza. Nazwy z łącznikami należy ująć w cudzysłowy (JSON5 zezwala na klucze w cudzysłowach).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false wyłącza Skill, nawet jeśli jest wbudowany lub zainstalowany. Wbudowany Skill coding-agent wymaga jawnego włączenia — należy ustawić go na true i upewnić się, że claude, codex, opencode lub inny obsługiwany CLI jest zainstalowany i uwierzytelniony.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> Pole pomocnicze dla Skills deklarujących metadata.openclaw.primaryEnv. Obsługuje ciąg tekstowy w postaci jawnej lub SecretRef: { source: "env", provider: "default", id: "VAR_NAME" }.

Listy dozwolonych Skills agentów (agents)

Konfiguracji agenta należy używać, gdy mają obowiązywać te same katalogi główne Skills maszyny lub obszaru roboczego, ale inny zestaw widocznych Skills dla każdego agenta.

{  agents: {    defaults: {      skills: ["github", "weather"], // wspólna wartość bazowa    },    list: [      { id: "writer" }, // dziedziczy github, weather      { id: "docs", skills: ["docs-search"] }, // całkowicie zastępuje wartości domyślne      { id: "locked-down", skills: [] }, // bez Skills    ],  },}

Warsztat (skills.workshop)

Informacje o kryteriach kwalifikacji, prywatności, kosztach, uprawnieniach ograniczonych do propozycji i rozwiązywaniu problemów zawiera sekcja Samouczenie.

Informacje o cyklu życia propozycji, poleceniach CLI, parametrach narzędzi agenta i metodach Gateway kontrolowanych przez tę konfigurację zawiera sekcja Skill Workshop.

Katalogi główne umiejętności z dowiązaniami symbolicznymi

Domyślnie katalogi główne umiejętności obszaru roboczego, agenta projektu, dodatkowych katalogów i umiejętności wbudowanych stanowią granice zawierania. Folder umiejętności z dowiązaniem symbolicznym w <workspace>/skills, który wskazuje poza katalog główny, jest pomijany, a informacja o tym trafia do dziennika.

Aby zezwolić na celowy układ dowiązań symbolicznych, należy zadeklarować zaufany cel:

{  skills: {    load: {      extraDirs: ["~/Projects/manager/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],    },  },}

Przy tej konfiguracji <workspace>/skills/manager -> ~/Projects/manager/skills jest akceptowane po rozwiązaniu ścieżki rzeczywistej. extraDirs skanuje bezpośrednio sąsiednie repozytorium; allowSymlinkTargets zachowuje ścieżkę z dowiązaniem symbolicznym dla istniejących układów.

Domyślnie zastosowanie propozycji przez Skill Workshop nie zapisuje za pośrednictwem tych dowiązań symbolicznych. Aby umożliwić funkcji Workshop modyfikowanie umiejętności w już zaufanych celach dowiązań symbolicznych, należy włączyć tę opcję osobno:

{  skills: {    load: {      allowSymlinkTargets: ["~/Projects/manager/skills"],    },    workshop: {      allowSymlinkTargetWrites: true,    },  },}

Zarządzane katalogi ~/.openclaw/skills i osobiste katalogi ~/.agents/skills już bezwarunkowo akceptują dowiązania symboliczne katalogów umiejętności (nadal obowiązuje zawieranie SKILL.md dla każdej umiejętności) — allowSymlinkTargets jest potrzebne tylko dla katalogów głównych obszaru roboczego, dodatkowych katalogów i agenta projektu (<workspace>/.agents/skills).

Umiejętności w piaskownicy i zmienne środowiskowe

Sekrety można przekazać do piaskownicy Docker za pomocą:

{  agents: {    defaults: {      sandbox: {        docker: {          env: { GEMINI_API_KEY: "your-key-here" },        },      },    },  },}

Przypomnienie o kolejności ładowania

workspace/skills      (najwyższy priorytet)workspace/.agents/skills~/.agents/skills~/.openclaw/skillswbudowane umiejętnościskills.load.extraDirs (najniższy priorytet)

Zmiany umiejętności i konfiguracji zaczynają obowiązywać w następnej nowej sesji, gdy obserwator jest włączony, lub w następnej turze agenta, gdy obserwator wykryje zmianę.

Powiązane