Skills

• Не указывайте agents.defaults.skills, чтобы по умолчанию не ограничивать никакие навыки.
• Не указывайте agents.list[].skills, чтобы наследовать agents.defaults.skills.
• Задайте agents.list[].skills: [], чтобы не предоставлять этому агенту никаких навыков.
• Непустой список agents.list[].skills является окончательным набором — он не объединяется со значениями по умолчанию.
• Итоговый список разрешённых навыков применяется при формировании промпта, обнаружении команд с косой чертой, синхронизации песочницы и создании снимков навыков.
• Это не граница авторизации оболочки хоста. Если тот же агент может использовать exec, ограничьте эту оболочку отдельно с помощью песочницы, изоляции пользователей ОС, списков запрещённых и разрешённых команд выполнения и отдельных учётных данных для каждого ресурса.

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

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

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

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

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

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

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

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

• Если указано несколько установщиков, 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: для автоматической установки навыков OpenClaw требуется Go 1.21 или новее. Если go отсутствует, но доступен Homebrew, OpenClaw сначала устанавливает Go через Homebrew; в Linux без Homebrew вместо этого можно использовать apt-get от имени root или через sudo без запроса пароля, если обновлённый кандидат golang-go соответствует минимальной версии. Фактический go install для зависимости всегда указывает на отдельный каталог исполняемых файлов под управлением OpenClaw (bin Homebrew при новой установке, иначе ~/.local/bin), а не на настроенный вами GOBIN — ваши переменные окружения GOBIN, GOPATH и GOTOOLCHAIN считываются, но никогда не перезаписываются.
• Загрузка: url (обязательно), archive (tar.gz | tar.bz2 | zip), extract (по умолчанию: автоматически при обнаружении архива), stripComponents, targetDir (по умолчанию: ~/.openclaw/tools/<skillKey>).

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

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

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true, // по умолчанию      watchDebounceMs: 250, // по умолчанию    },  },}

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

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

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