Конфігурація Skills

Більшість налаштувань Skills міститься в розділі skills у ~/.openclaw/openclaw.json. Видимість для окремих агентів налаштовується в agents.defaults.skills і 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: "pending",      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 },    },  },}

Завантаження (skills.load)

Встановлення (skills.install)

Політика встановлення оператора (security.installPolicy)

Використовуйте security.installPolicy, коли операторам потрібна довірена локальна команда для схвалення або блокування встановлення Skills і плагінів відповідно до політики конкретного хоста. Політика виконується після того, як OpenClaw підготував вихідні матеріали, і до продовження встановлення чи оновлення. Вона застосовується до Skills із ClawHub, завантажених Skills, Skills із Git або локальних джерел, інсталяторів залежностей Skills, а також джерел встановлення й оновлення плагінів.

{  security: {    installPolicy: {      enabled: true,      // Omit targets to cover every supported target.      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"],      },    },  },}

Політика отримує зі stdin один об’єкт JSON із protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, необов’язковим структурованим source, структурованим origin і request. Вона має записати в stdout один об’єкт JSON: { "protocolVersion": 1, "decision": "allow" } або { "protocolVersion": 1, "decision": "block", "reason": "..." }. Ненульовий код завершення, перевищення часу очікування, некоректний JSON, відсутні поля або непідтримувані версії протоколу призводять до блокування операції.

OpenClaw не виконує політику встановлення під час звичайного запуску Gateway. Встановлення та оновлення блокуються, якщо політику ввімкнено, але вона недоступна. openclaw doctor виконує статичну перевірку; openclaw doctor --deep виконує синтетичну перевірку встановлення за допомогою налаштованої команди.

Для масових оновлень політика застосовується окремо до кожної цілі: заблоковане оновлення Skill або плагіна завершується помилкою для цієї цілі, не вимикаючи політику й не пропускаючи наступні цілі в пакеті.

Приклад 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"  }}

Мінімальна команда політики:

#!/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: "local plugin paths are not approved on this host",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

Список дозволених вбудованих Skills

Записи окремих Skills (skills.entries)

Ключі в entries типово відповідають name Skill. Якщо Skill визначає metadata.openclaw.skillKey, натомість використовуйте цей ключ. Беріть назви з дефісами в лапки (JSON5 дозволяє ключі в лапках).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false вимикає Skill, навіть якщо він вбудований або встановлений. Вбудований Skill coding-agent потребує явного ввімкнення — установіть значення true і переконайтеся, що claude, codex, opencode або інший підтримуваний CLI встановлено й автентифіковано.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> Допоміжне поле для Skills, які оголошують metadata.openclaw.primaryEnv. Підтримує рядок відкритого тексту або SecretRef: { source: "env", provider: "default", id: "VAR_NAME" }.

Списки дозволених Skills для агентів (agents)

Використовуйте конфігурацію агента, коли потрібні ті самі кореневі каталоги Skills машини чи робочого простору, але різний набір видимих Skills для кожного агента.

{  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    ],  },}

Майстерня (skills.workshop)

Див. Skill Workshop, щоб дізнатися про життєвий цикл пропозицій, команди CLI, параметри інструментів агента та методи Gateway, якими керує ця конфігурація.

Кореневі каталоги Skills із символічними посиланнями

За замовчуванням кореневі каталоги Skills робочого простору, агента проєкту, додаткових каталогів і вбудованих Skills є межами вкладеності. Каталог Skills із символічним посиланням у <workspace>/skills, що вказує за межі кореневого каталогу, пропускається з повідомленням у журналі.

Щоб дозволити навмисну структуру із символічними посиланнями, оголосіть довірену ціль:

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

З цією конфігурацією <workspace>/skills/manager -> ~/Projects/manager/skills приймається після визначення фактичного шляху. extraDirs безпосередньо сканує сусідній репозиторій; allowSymlinkTargets зберігає шлях із символічним посиланням для наявних структур.

За замовчуванням застосування через Skill Workshop не виконує запис через ці символічні посилання. Щоб дозволити Workshop під час застосування змінювати Skills у вже довірених цілях символічних посилань, увімкніть це окремо:

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

Керований каталог ~/.openclaw/skills і особистий каталог ~/.agents/skills уже безумовно приймають символічні посилання на каталоги Skills (обмеження вкладеності SKILL.md для кожного Skill усе одно застосовується) — allowSymlinkTargets потрібен лише для кореневих каталогів робочого простору, додаткових каталогів і агента проєкту (<workspace>/.agents/skills).

Skills у пісочниці та змінні середовища

Передавайте секрети до пісочниці Docker так:

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

Нагадування про порядок завантаження

workspace/skills      (найвищий пріоритет)workspace/.agents/skills~/.agents/skills~/.openclaw/skillsвбудовані Skillsskills.load.extraDirs (найнижчий пріоритет)

Зміни у Skills і конфігурації набувають чинності в наступному новому сеансі, якщо спостерігач увімкнений, або під час наступного ходу агента, коли спостерігач виявить зміну.

Пов’язані матеріали