Skills

• Опустите agents.defaults.skills, чтобы по умолчанию оставить все Skills без ограничений.
• Опустите agents.list[].skills, чтобы унаследовать agents.defaults.skills.
• Задайте agents.list[].skills: [], чтобы не предоставлять этому агенту никаких Skills.
• Непустой список agents.list[].skills является окончательным набором — он не объединяется со значениями по умолчанию.
• Итоговый список разрешений применяется к построению prompt, обнаружению slash-команд, синхронизации sandbox и снимкам Skills.

openclaw skills install по умолчанию устанавливает в каталог skills/ активной рабочей области. Добавьте --global, чтобы установить в общий каталог ~/.openclaw/skills, видимый всем локальным агентам, если списки разрешений агентов не сужают доступ.

Установки из Git и локальных источников ожидают SKILL.md в корне источника. Slug берется из frontmatter name файла SKILL.md, если он корректен, затем используется имя каталога или репозитория. Используйте --as <slug> для переопределения. openclaw skills update отслеживает только установки ClawHub — переустановите источники Git или локальные источники, чтобы обновить их.

openclaw skills verify @owner/<slug> запрашивает у ClawHub доверенный конверт clawhub.skill.verify.v1 для Skills. Установленные Skills ClawHub проверяются по версии и реестру, записанным в .clawhub/origin.json. Голые slugs остаются допустимыми для существующих установленных или однозначных Skills, но ссылки с указанием владельца избегают неоднозначности издателя.

Страницы Skills в ClawHub показывают актуальное состояние сканирования безопасности перед установкой, с подробными страницами для VirusTotal, ClawScan и статического анализа. Команда завершается с ненулевым кодом, когда ClawHub помечает проверку как неуспешную. Издатели исправляют ложные срабатывания через панель управления ClawHub или clawhub skill rescan @owner/<slug>.

Клиенты Gateway, которым нужна доставка не через ClawHub, могут подготовить zip-архив Skills с помощью skills.upload.begin, skills.upload.chunk и skills.upload.commit, а затем установить его через skills.install({ source: "upload", ... }). Этот путь по умолчанию отключен и требует skills.install.allowUploadedArchives: true в openclaw.json. Обычным установкам ClawHub эта настройка никогда не нужна.

Обнаружение Skills в рабочей области, у агента проекта и в дополнительных каталогах принимает только корни Skills, чей разрешенный realpath остается внутри настроенного корня, если только skills.load.allowSymlinkTargets явно не доверяет целевому корню. Мастерская Skills записывает через эти доверенные цели только тогда, когда включен skills.workshop.allowSymlinkTargetWrites. Управляемый ~/.openclaw/skills и личный ~/.agents/skills могут содержать папки Skills в виде символических ссылок, но каждый realpath SKILL.md все равно должен оставаться внутри разрешенного каталога Skills.

Настройте security.installPolicy, чтобы запускать доверенную локальную команду политики перед продолжением установки Skills. Политика получает метаданные и путь к подготовленному источнику, применяется к путям ClawHub, загрузок, Git, локальным источникам, обновлениям и установщику зависимостей и завершает работу закрытым отказом, если команда не может вернуть допустимое решение.

skills.entries.*.env и skills.entries.*.apiKey внедряют секреты в хостовый процесс только на время этого хода агента — не в sandbox. Не допускайте попадания секретов в prompts и журналы.

• Когда перечислено несколько установщиков, gateway выбирает один предпочтительный вариант (brew, если доступен, иначе node).
• Если все установщики имеют значение download, OpenClaw перечисляет каждую запись, чтобы вы могли видеть все доступные артефакты.
• Спецификации могут включать os: ["darwin"|"linux"|"win32"] для фильтрации по платформе.
• Установки Node учитывают skills.install.nodeManager в openclaw.json (по умолчанию: npm; варианты: npm / pnpm / yarn / bun). Это влияет только на установки навыков; среда выполнения Gateway по-прежнему должна быть Node.
• Предпочтения установщика Gateway: Homebrew → uv → настроенный менеджер node → go → download.

• Homebrew: OpenClaw не устанавливает Homebrew автоматически и не преобразует формулы brew в команды системного пакетного менеджера. В контейнерах Linux без brew установщики, доступные только через brew, скрыты; используйте собственный образ или установите зависимость вручную.
• Go: если go отсутствует, а brew доступен, gateway сначала устанавливает Go через Homebrew и задает GOBIN равным bin Homebrew.
• Download: url (обязательно), archive (tar.gz | tar.bz2 | zip), extract (по умолчанию: auto, когда обнаружен архив), stripComponents, targetDir (по умолчанию: ~/.openclaw/tools/<skillKey>).

requires.bins проверяется на хосте во время загрузки навыка. Если агент работает в изолированной среде, исполняемый файл также должен существовать внутри контейнера. Установите его через agents.defaults.sandbox.docker.setupCommand или собственный образ. setupCommand выполняется один раз после создания контейнера и требует исходящего доступа к сети, доступной для записи корневой ФС и пользователя root в изолированной среде.

По умолчанию OpenClaw отслеживает папки Skills и обновляет снимок при изменении файлов SKILL.md. Настраивается в skills.load:

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,      watchDebounceMs: 250,    },  },}

Используйте allowSymlinkTargets для намеренных компоновок с символическими ссылками, где корневая символическая ссылка Skill указывает за пределы настроенного корня, например <workspace>/skills/manager -> ~/Projects/manager/skills. Включайте skills.workshop.allowSymlinkTargetWrites только когда Skill Workshop также должен применять предложения через эти доверенные пути символических ссылок.

Если Gateway работает на Linux, но подключен узел macOS с разрешенным system.run, OpenClaw может считать Skills только для macOS допустимыми, когда необходимые бинарные файлы присутствуют на этом узле. Агент должен запускать эти Skills через инструмент exec с host=node.

Узлы не в сети не делают Skills, доступные только удаленно, видимыми. Если узел перестает отвечать на проверки бинарных файлов, OpenClaw очищает кэшированные совпадения бинарных файлов для него.