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

{  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 или плагина завершается ошибкой для этой цели, не отключая политику и не пропуская последующие цели в пакете.

Пример 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: "локальные пути плагинов не разрешены на этом хосте",      }),    );    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" }.

Списки разрешений агентов (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 (наинизший приоритет)

Изменения навыков и конфигурации вступают в силу в следующем новом сеансе, если наблюдатель включён, или на следующем ходу агента, когда наблюдатель обнаружит изменение.

Связанные разделы