Конфігурація 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 і Plugin відповідно до політики конкретного хоста. Політика запускається після того, як OpenClaw підготував вихідний матеріал, і до продовження встановлення або оновлення. Вона застосовується до Skills ClawHub, завантажених Skills, Git/local Skills, інсталяторів залежностей Skills, а також джерел встановлення/оновлення Plugin.

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

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

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

Масові оновлення застосовують політику до кожної цілі окремо: заблоковане оновлення Skills або 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: "local plugin paths are not approved on this host",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

Allowlist вбудованих Skills

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

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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false вимикає Skills, навіть коли вони вбудовані або встановлені. Вбудовані Skills 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" }.

Allowlist агентів (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    ],  },}

Workshop (skills.workshop)

Корені Skills із симлінками

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

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

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

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

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

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

Керовані каталоги ~/.openclaw/skills і персональні каталоги ~/.agents/skills уже приймають симлінки каталогів Skills (containment для SKILL.md кожної Skills усе одно застосовується).

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

Передайте секрети в Docker sandbox за допомогою:

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

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

workspace/skills      (highest)workspace/.agents/skills~/.agents/skills~/.openclaw/skillsbundled skillsskills.load.extraDirs (lowest)

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

Пов’язане