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

{  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 выполняет синтетическую пробную установку с помощью настроенной команды.

При массовых обновлениях политика применяется отдельно к каждой цели: заблокированное обновление навыка или плагина завершается ошибкой для этой цели, не отключая политику и не пропуская последующие цели в пакете.

Пример 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.entries)

По умолчанию ключи в entries соответствуют name навыка. Если навык определяет metadata.openclaw.skillKey, используйте вместо него этот ключ. Имена с дефисами заключайте в кавычки (JSON5 допускает ключи в кавычках).

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

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

Списки разрешений агентов (agents)

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

{  agents: {    defaults: {      skills: ["github", "weather"], // общий базовый набор    },    list: [      { id: "writer" }, // наследует github, weather      { id: "docs", skills: ["docs-search"] }, // полностью заменяет значения по умолчанию      { id: "locked-down", skills: [] }, // без навыков    ],  },}

Мастерская (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 (наименьший приоритет)

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

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