Конфігурація 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: "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 },    },  },}

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

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

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

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

{  security: {    installPolicy: {      enabled: true,      // Пропустіть targets, щоб охопити всі підтримувані цілі.      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 або plugin завершується помилкою для цієї цілі, не вимикаючи політику й не пропускаючи наступні цілі в пакеті.

Приклад 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: "локальні шляхи plugins не схвалені на цьому хості",      }),    );    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"], // спільна базова конфігурація    },    list: [      { id: "writer" }, // успадковує github, weather      { id: "docs", skills: ["docs-search"] }, // повністю замінює значення за замовчуванням      { id: "locked-down", skills: [] }, // без Skills    ],  },}

Workshop (skills.workshop)

Відомості про критерії відповідності, конфіденційність, вартість, дозволи лише на створення пропозицій і усунення несправностей див. у розділі Самонавчання.

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

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

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

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

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

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

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

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

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

Ізольовані навички та змінні середовища

Передайте секрети в ізольоване середовище Docker так:

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

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

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

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

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