Навыки OpenClaw из ClawHub: как найти, поставить и проверить готовый навык

Q: Что делать, если навык пометили как небезопасный уже после установки?

Запустите openclaw skills verify @владелец/имя : при неудачной проверке команда завершается с ненулевым кодом. До выяснения отключите навык ключом skills.entries. .enabled со значением false (шаг 5), а если проблема подтвердилась — удалите его командой clawhub uninstall (шаг 7). Автору навыка ложное срабатывание снимает через панель ClawHub или командой clawhub skill rescan , так что пометка не всегда означает вредоносный код, но и игнорировать её не нужно.

Q: Можно ли использовать навыки, написанные для других агентов?

Формат SKILL.md соответствует открытой спецификации Agent Skills, поэтому текст многих навыков переносим. Но зависимости и ключи конфигурации у каждого агента свои, а блок metadata.openclaw читает только OpenClaw. Для навыков Codex CLI есть описанный выше путь через openclaw migrate .

Коротко. Готовый навык для OpenClaw ставится тремя командами. openclaw skills search "запрос" находит его в реестре ClawHub, openclaw skills install @владелец/имя кладёт папку с файлом SKILL.md в каталог skills/ рабочего пространства агента, а openclaw skills verify @владелец/имя сверяет установленную версию с отметкой проверки в реестре. Но «установлен» не значит «безопасен» и не значит «работает». Сторонний навык — это чужие инструкции и, возможно, чужие команды, которые агент выполнит от вашего имени. А статус ready в списке не гарантирует, что нужная навыку программа есть на сервере: в нашем тесте навык показал Ready без единой проверки зависимостей. Ниже — порядок действий, проверенный на OpenClaw 2026.10.8: поиск, установка, проверка, ограничение набора навыков для каждого агента, отключение, обновление и удаление.

На чём это проверено

Команды и ключи конфигурации сверены с официальной документацией OpenClaw и запущены на чистой установке версии 2026.10.8 (выпуск от 27 октября 2026 года, лицензия MIT) с пустым каталогом состояния. По данным реестра npm на 27 октября 2026 года канал latest — это 2026.10.8, канал extended-stable — 2026.9.35. Вывод команд в статье настоящий, но сокращён: вместо колонок и служебных строк оставлено главное. ClawHub — живой публичный реестр, поэтому конкретные навыки, их описания и оценки сканеров на момент чтения могут отличаться.

Статья предполагает, что агент у вас уже установлен и отвечает. Если нет — начните с материала Настройка OpenClaw: API-ключи, выбор модели и подключение Telegram. Если вы хотите не ставить чужой навык, а написать свой, вам в другую статью: там разобран формат файла SKILL.md и пример от пустой папки до вызова (как написать навык для ИИ-агента). Здесь речь о готовых навыках: где их брать, как ставить и чем рисковать.

Откуда берутся навыки и какой из них победит

Навык в OpenClaw — это папка с файлом SKILL.md: в шапке (YAML) минимум name и description, ниже обычный текст с инструкциями для модели. Формат совместим с открытой спецификацией Agent Skills. OpenClaw собирает список из нескольких мест, и если один и тот же name встретился дважды, побеждает источник с более высоким приоритетом:

Приоритет	Где лежит	Кому виден
1 (высший)	`<workspace>/skills`	только агенту этого рабочего пространства; сюда ставит `openclaw skills install`
2	`<workspace>/.agents/skills`	агенту этого рабочего пространства
3	`~/.agents/skills`	агентам с состоянием по умолчанию
4	`~/.openclaw/skills`	всем агентам этого состояния; сюда ставит флаг `--global`
5	навыки, которые агент написал сам (Skill Workshop)	только этому агенту
6	встроенные в установку	всем
7 (низший)	папки из `skills.load.extraDirs` и навыки плагинов	всем, кто использует этот конфиг

Две практические детали. Во-первых, имя навыка берётся из поля name в шапке, а не из названия папки: папки можно группировать как угодно (глубина поиска — до шести уровней), а ограничения «какому агенту что можно» сверяются именно с name. Во-вторых, папка рабочего пространства по умолчанию — ~/.openclaw/workspace, и это самый высокий приоритет: установленный вами навык перекроет встроенный с тем же именем.

Шаг 1. Посмотреть, что уже есть

openclaw skills list              # все навыки и их статус
openclaw skills list --eligible   # только те, у которых выполнены требования
openclaw skills info github       # подробности по одному навыку
openclaw skills check             # сводка: что видно модели, что отфильтровано и почему

На чистой установке list начинается со строки Skills (22/55 ready): 55 навыков найдено, 22 готовы к работе. Дальше таблица из четырёх колонок — статус, имя, описание и источник (сокращённо):

Skills (22/55 ready)
✓ ready         github    ...  openclaw-bundled
△ needs setup   gemini    ...  openclaw-bundled

Статус ready означает, что условия навыка (нужные программы, переменные окружения, ключи конфигурации) выполнены. needs setup — чего-то не хватает, excluded — навык загружен, но этому агенту его видеть не положено (об этом в шаге 5). Для скриптов есть openclaw skills list --json: в нём, кроме списка, указаны каталог рабочего пространства и каталог общих навыков.

Карточка одного навыка показывает источник, видимость и требования:

$ openclaw skills info github
🐙 github ✓ Ready

GitHub CLI for issues, PRs, CI/check logs, comments, reviews, releases, repos, and gh api queries.

Details:
  Source: openclaw-bundled
  Visible to model: yes
  Available as command: yes

Requirements:
  Binaries: ✓ gh

А openclaw skills check отвечает на главный вопрос отладки — «навык есть, а агент его не видит, почему?»:

Total: 55
✓ Eligible: 22
✓ Visible to model: 22
✓ Available as command: 21
Disabled: 0
Blocked by allowlist: 0
Excluded by agent allowlist: 0
✗ Missing requirements: 33

Разница между «установлен» (inventory), «готов» (eligible) и «виден модели» (visible to model) — основная причина путаницы: навык может лежать на диске и быть в списке, но не попасть в подсказку агента из-за невыполненных требований, отключения или фильтра по агентам. Цифры у вас будут другими: они зависят от того, какие программы стоят на сервере.

Шаг 2. Найти навык в ClawHub

ClawHub — публичный реестр навыков. Искать в нём можно и на сайте, и из терминала:

openclaw skills search "calendar" --limit 5

Команда ходит в реестр и печатает строки вида «владелец/имя, название, описание» (сокращённо):

@steipete/gog  Gog  Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
@porteden/calendar-skill  Calendar  Calendar Management - secure Google Calendar, Microsoft Outlook & Exchange. ...

На 27 октября 2026 года по слову «calendar» нашлось несколько навыков с почти одинаковым названием «Calendar» от разных авторов. Для открытого реестра это нормально, и поэтому выбирать нужно не по названию, а по владельцу, описанию и прочитанному тексту навыка. Без запроса (openclaw skills search) команда показывает ленту популярных навыков. Ключ --json выдаёт результат в машинном виде. Сам поиск ничего не ставит.

Шаг 3. Установить

openclaw skills install @steipete/gog

Перед загрузкой OpenClaw выводит панель с результатом проверки, которую ClawHub сделал для этой версии, затем скачивает архив и распаковывает его (сокращённо):

╭─ ClawHub Security Audit ──────────────────────────────╮
│ @steipete/gog@1.0.0                                   │
│ Outcome: Safe                                         │
│ Overview: This skill is a straightforward Google      │
│ Workspace CLI helper that requires user-provided      │
│ OAuth setup and does not contain hidden code or       │
│ persistence.                                          │
│ Details: https://clawhub.ai/steipete/skills/gog/...   │
╰───────────────────────────────────────────────────────╯
Downloading gog@1.0.0 from ClawHub…
Installing to ~/.openclaw/workspace/skills/gog…
Installed gog@1.0.0 -> ~/.openclaw/workspace/skills/gog

Обратите внимание: панель аудита ничего у вас не спрашивает. По документации, для «подозрительных» исходов OpenClaw печатает обзор и ссылку на подробности и продолжает установку, а отказывается только от релизов, которые реестр пометил как вредоносные или заблокированные. Поэтому Outcome: Safe — это мнение сканера, а не гарантия. Когда агент с чужим навыком подключён к почте, CRM или файлам компании, оценку сканера лучше дополнить независимой проверкой: для этого мы делаем аудит безопасности AI-агента: проверку доступов, ограничителей и журнала действий.

Что появилось на диске. В папке навыка лежат SKILL.md, skill-card.md (карточка навыка из реестра), служебный _meta.json и каталог .clawhub/origin.json с источником и контрольными суммами. В корне рабочего пространства создаётся .clawhub/lock.json: версия, адрес реестра, хэши файлов и результат проверки. Именно по этим файлам update и verify знают, откуда навык взят.

Полезные флаги install:

--version <версия> — поставить конкретную версию вместо последней;
--global — положить навык в общую папку ~/.openclaw/skills, он будет виден всем локальным агентам, если фильтры по агентам его не сузят;
--agent <id> — поставить в рабочее пространство конкретного агента (с --global не сочетается);
--force — перезаписать уже существующую папку навыка с тем же именем;
--force-install — поставить навык из GitHub, который ClawHub ещё не успел просканировать. Это ровно та проверка, которую вы пропускаете, поэтому без веской причины флаг не нужен.

Кроме реестра, install понимает и другие источники: skills-sh:владелец/репозиторий/имя (такие навыки помечаются как «Not scanned by ClawHub» — не сканировались), git:владелец/репозиторий@ветка и локальную папку: openclaw skills install ./моя-папка --as имя. Для Git и локальных источников update не работает — обновлять их нужно повторной установкой. Мы проверили локальную установку: --as меняет имя папки, но в списке навык остаётся под именем из своего SKILL.md, а не из --as. Это важно помнить, когда будете настраивать ограничения по агентам.

Шаг 4. Проверить установленное

openclaw skills verify @steipete/gog

Команда спрашивает у ClawHub «конверт доверия» (trust envelope) для установленной версии и печатает его в JSON. Главное в нём (выдержка):

{
  "schema": "clawhub.skill.verify.v1",
  "ok": true,
  "decision": "pass",
  "slug": "gog",
  "version": "1.0.0",
  "security": { "status": "clean", "verdict": "benign", "confidence": "high" },
  "signature": { "status": "unsigned" }
}

При неудачной проверке команда завершается с ненулевым кодом, так что её можно ставить в скрипт обновления. Ключ --card печатает карточку навыка. Обратите внимание на signature: unsigned: подписи автора у этого навыка нет, значит, доверие строится на результатах сканирования и на вашем чтении текста. Для навыка, уже лежащего на диске, verify берёт версию и реестр из его .clawhub/origin.json, а в команде лучше указывать полное имя @владелец/имя, чтобы не перепутать авторов с одинаковыми названиями.

Ловушка: статус Ready, а программы нет

После установки откройте SKILL.md и посмотрите на блок metadata. Мы поставили gog и получили:

$ openclaw skills info gog
[skills] ~/.openclaw/workspace/skills shadows 1 skills from …/openclaw/skills (gog)
gog ✓ Ready

Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Details:
  Source: openclaw-workspace
  Visible to model: yes
  Available as command: yes

Блока Requirements нет, хотя программы gog на машине нет, а сам навык говорит, что без неё не работает. Причина в шапке файла: зависимости записаны в старом формате metadata.clawdbot. По документации, формат, использовавшийся до июля 2026 года, OpenClaw больше не читает, и его проверки зависимостей молча пропускаются. Когда мы удалили этот навык, на его месте появился встроенный навык с тем же именем — и он честно показал △ needs setup.

Правильная запись выглядит так (пример из документации; ключ metadata.openclaw):

---
name: gemini-search
description: Search using Gemini CLI.
metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }
---

На такой навык без установленной программы gemini openclaw skills info gemini-search отвечает так:

gemini-search △ Needs setup
  Visible to model: no
  Available as command: no
  Primary env: GEMINI_API_KEY

Requirements:
  Binaries: ✗ gemini

Вывод: статус Ready у навыка из реестра — не повод считать, что он заработает. Прочтите описание зависимостей в самом SKILL.md, а если нужные программы там перечислены в старом блоке clawdbot, переименуйте блок в openclaw и сохраните его содержимое — OpenClaw сам файл не перепишет. Заодно полезно знать: если установленный вами навык совпал по имени со встроенным (как gog здесь), OpenClaw при следующих командах печатает предупреждение вида ~/.openclaw/workspace/skills shadows 1 skills from … (gog). Побеждает установленный, и это одновременно удобно и опасно.

Чужой навык — это чужой код: короткий чек-лист

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

Прочитайте SKILL.md целиком и просмотрите остальные файлы в папке (скрипты, шаблоны). Подозрительны скачивание и запуск чего-то из сети, чтение чужих папок и ключей, отправка данных на сторонние адреса.
Выполните openclaw skills verify и откройте страницу навыка на ClawHub: там видно состояние сканирования (VirusTotal, ClawScan и статический анализ).
Проверьте, что навык просит из окружения: зависимости из блока metadata.openclaw и переменные окружения. Лишние права — повод отказаться.
Документация советует запускать недоверенные входные данные и рискованные инструменты в песочнице. Если агент работает в ней, зависимости навыка должны стоять внутри контейнера: их ставят командой agents.defaults.sandbox.docker.setupCommand (она выполняется один раз после создания контейнера и требует сетевого доступа, записи в корневую файловую систему и пользователя root) или собственным образом. Иначе навык там не заведётся.
В организации, где ставить навыки могут несколько человек, включите security.installPolicy: это команда-привратник, которая одобряет или блокирует установки навыков и плагинов. Если политика включена, а команда не настроена, установки блокируются («fail closed»), а не пропускаются.

Шаг 5. Ограничить набор навыков для каждого агента

Установка в рабочее пространство делает навык видимым только одному агенту. Установка с --global открывает его всем. Чтобы управлять видимостью явно, задайте список разрешённых навыков. Общая база для всех агентов:

openclaw config set agents.defaults.skills '["github","weather"]' --strict-json

Ответ: Updated agents.defaults.skills. Change will apply without restarting the gateway. После этого openclaw skills check показал на нашей установке:

✓ Visible to model: 2
✓ Available as command: 2
Excluded by agent allowlist: 56

Модели остались видны только github и weather, остальные навыки (на нашей установке их было 56) помечены как «загружены, но этому агенту их видеть не положено». Вернуть всё обратно: openclaw config unset agents.defaults.skills. Для отдельного агента список задаётся ключом agents.entries.<id>.skills. Он заменяет общий список целиком, а не дополняет его, а пустой список [] отключает навыки у этого агента совсем:

{
  agents: {
    defaults: { skills: ["github", "weather"] },   // общая база
    entries: {
      writer: { workspace: "~/.openclaw/workspace" },  // наследует github и weather
      docs: { skills: ["docs-search"] },               // заменяет общий список
      "locked-down": { skills: [] }                    // без навыков
    }
  }
}

Важная оговорка из документации: такой список — это фильтр видимости и загрузки (подсказка, команды, снимок навыков), а не защита на уровне оболочки. Если агенту разрешён запуск команд на хосте, он может запустить то же, что запускали бы вы, и прочитать файлы, доступные его пользователю. Для настоящей изоляции фильтр нужно сочетать с песочницей, отдельным пользователем ОС и жёстким ограничением exec.

Отключить один навык, не удаляя его, можно так:

openclaw config set skills.entries.weather.enabled false --strict-json

openclaw skills info weather после этого показывает статус Disabled, Visible to model: no, а в сводке check появляется строка Disabled: 1. Для встроенных навыков есть ещё список-ограничитель skills.allowBundled: если он задан, в работу идут только перечисленные в нём встроенные навыки (на установленные вами он не действует). Встроенный навык coding-agent включается только явно: ключом skills.entries.coding-agent.enabled со значением true и при условии, что установлена и авторизована одна из программ claude, codex, opencode или другая поддерживаемая.

Шаг 6. Ключи API и песочница

Если навык объявляет в шапке primaryEnv, ключ к нему удобно привязать в ~/.openclaw/openclaw.json (формат JSON5) через skills.entries.<имя>.apiKey — строкой или ссылкой на секрет:

{
  skills: {
    entries: {
      "gemini-search": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }
      }
    }
  }
}

Ключи из skills.entries.*.apiKey и skills.entries.*.env подставляются в окружение запуска агента на хосте и не попадают в песочницу. Навык, работающий в песочнице, без явной передачи ключа ответит ошибкой apiKey not configured. Передать переменную в Docker-песочницу можно ключом agents.defaults.sandbox.docker.env, но имейте в виду: значения оттуда видны всем, у кого есть доступ к Docker-демону на этом сервере. Если это неприемлемо, документация советует подмонтированный файл секрета или собственный образ.

Шаг 7. Обновить, откатить, удалить

openclaw skills update @steipete/gog      # один навык
openclaw skills update --all              # все навыки, установленные из ClawHub
openclaw skills update --all --global     # то же для общей папки

На практике update --all снова показывает панель аудита и, если нового выпуска нет, пишет gog already at 1.0.0. Правила обновления: команда работает только с установками из ClawHub; без ключа --force обновление сохраняет ваши локальные правки в файлах навыка, а с update --force навык заменяется, даже если файлы уже не совпадают с записанными при установке контрольными суммами. Ключ --all --force заменяет и навыки с найденными локальными правками, так что применять его вслепую не стоит. Свои правки в чужие навыки лучше не вносить — скопируйте навык под своим именем.

Удаляют навык отдельной программой clawhub (в OpenClaw для этого своей команды нет):

npm i -g clawhub
clawhub --workdir ~/.openclaw/workspace uninstall @steipete/gog

Программа спросит подтверждение (флагом --yes вопрос пропускается), удалит папку навыка и запись из .clawhub/lock.json. Для навыков из общей папки укажите --workdir ~/.openclaw (или каталог из OPENCLAW_STATE_DIR, если вы его переопределяли). Наблюдатель за файлами подхватит удаление при следующем ходе агента.

Когда новый навык «увидит» агент

Список навыков фиксируется в снимке в начале сессии. Он обновляется, когда изменился какой-либо SKILL.md, при перезапуске шлюза (Gateway) и при подключении нового узла; по умолчанию за файлами следит наблюдатель (skills.load.watch). Новый или изменённый навык попадает к агенту со следующего хода. Если наблюдатель выключен или вы продолжаете старую сессию, начните новую командой /new в чате или выполните openclaw gateway restart. Вызвать навык явно можно командой /skill <имя> [ввод].

Навыки и расходы на токены

Каждый подходящий навык добавляет в системную подсказку короткую запись: по документации, около 97 символов плюс длина его имени, описания и пути, то есть порядка 24 токенов на навык до учёта этих полей. Полный текст навыка читается только тогда, когда агент его открывает. Один навык почти ничего не стоит, но сотня «на всякий случай» — это сотня записей в каждом запросе. Если подсказка выходит за бюджет (skills.limits.maxSkillsPromptChars), OpenClaw сначала сохраняет имена и пути, потом укорачивает описания, а при совсем малом остатке убирает их. Поэтому ставьте то, чем пользуетесь, и держите фильтры по агентам из шага 5.

Что ломается чаще всего

Навык установлен, а агент про него не знает. Откройте openclaw skills check: навык может быть Disabled, Excluded by agent allowlist или Missing requirements. Если всё чисто — начните новую сессию (/new).
needs setup после установки. openclaw skills info <имя> покажет, каких программ или переменных не хватает; поставьте их на тот хост, где работает агент (и в образ песочницы, если он в песочнице).
Ready, а команды падают. Скорее всего, зависимости записаны в устаревшем metadata.clawdbot — см. выше.
Поставился не тот навык. Названия в реестре не уникальны. Указывайте полное имя @владелец/имя и сверяйте владельца на странице навыка.
Установленный навык тихо заменил встроенный. Ищите в выводе предупреждение shadows.
Старые установки не обновляются и не проверяются. Метаданные раньше лежали в каталоге .clawdhub, теперь читается только .clawhub. Для старых установок переименуйте каталоги метаданных (если .clawhub уже есть, объедините содержимое, а не перезаписывайте).
Навыки из Codex CLI не видны. Папка $CODEX_HOME/skills не является источником навыков OpenClaw. Выполните openclaw migrate plan codex, чтобы увидеть, что переносится, затем openclaw migrate codex.

Когда не стоит делать это самому

Поставить один навык и прочитать его текст — дело получаса. Дольше и дороже всё остальное: решить, каким агентам какие навыки можно, кто в компании вправе ставить сторонний код, как часто пересматривать установленное и что делать, когда в реестре пометили уже работающий навык. Пока агент один и работает с некритичными данными, хватит шагов 1–7. Когда агентов несколько, они подключены к почте, 1С или CRM, а за результат отвечает не тот, кто пишет код, правила нужно зафиксировать. Для этого мы делаем политики для AI-агентов: кто может ставить навыки, что требует подтверждения и что попадает в журнал.

Частые вопросы

Что делать, если навык пометили как небезопасный уже после установки?

Запустите openclaw skills verify @владелец/имя: при неудачной проверке команда завершается с ненулевым кодом. До выяснения отключите навык ключом skills.entries.<имя>.enabled со значением false (шаг 5), а если проблема подтвердилась — удалите его командой clawhub uninstall (шаг 7). Автору навыка ложное срабатывание снимает через панель ClawHub или командой clawhub skill rescan, так что пометка не всегда означает вредоносный код, но и игнорировать её не нужно.

Нужно ли уметь программировать?

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

Можно ли использовать навыки, написанные для других агентов?

Формат SKILL.md соответствует открытой спецификации Agent Skills, поэтому текст многих навыков переносим. Но зависимости и ключи конфигурации у каждого агента свои, а блок metadata.openclaw читает только OpenClaw. Для навыков Codex CLI есть описанный выше путь через openclaw migrate.

Сколько навыков можно держать одновременно?

Жёсткого числа в документации нет, граница задаётся бюджетом подсказки (skills.limits.maxSkillsPromptChars) и качеством описаний: чем больше навыков и чем длиннее их описания, тем больше токенов уходит в каждый запрос и тем чаще модель выбирает не тот.

Источники: официальная документация OpenClaw — разделы tools/skills, cli/skills, tools/skills-config, tools/creating-skills, clawhub; репозиторий openclaw/openclaw, выпуск v2026.10.8; реестр ClawHub; спецификация Agent Skills. Команды запускались на OpenClaw 2026.10.8 с пустым состоянием 27 октября 2026 года; содержимое реестра ClawHub на момент чтения может отличаться.