Как работает ClawHub

ClawHub — это уровень реестра для Skills и плагинов OpenClaw. Он дает пользователям место для обнаружения пакетов, издателям — место для выпуска версий, а OpenClaw — достаточно метаданных для безопасной установки и обновления этих пакетов.

Записи реестра

Каждая публичная карточка — это запись реестра, содержащая:

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

Страница карточки — каноническое место, где пользователи могут проверить, что, по заявлению Skill или плагина, он делает, прежде чем устанавливать его.

Skills

Skill — это версионируемый текстовый набор, сосредоточенный вокруг SKILL.md. Он может включать вспомогательные файлы, примеры, шаблоны и скрипты.

ClawHub читает frontmatter в SKILL.md, чтобы понять имя Skill, описание, требования, переменные окружения и метаданные. Точные метаданные важны, потому что они помогают пользователям решить, устанавливать ли Skill, и помогают автоматическим проверкам обнаруживать несоответствия между заявленным и наблюдаемым поведением.

См. Формат Skill.

Плагины

Плагины — это упакованные расширения OpenClaw. ClawHub хранит метаданные пакетов, сведения о совместимости, ссылки на источники, артефакты и записи версий.

Когда OpenClaw устанавливает плагин из ClawHub, он проверяет заявленные метаданные совместимости перед установкой. Записи пакетов могут включать совместимость API, минимальную версию Gateway, целевые хосты, требования к окружению и дайджесты артефактов.

Используйте явный источник установки ClawHub, когда хотите, чтобы реестр был источником истины:

openclaw plugins install clawhub:<package>

Публикация

Публикация создает новую неизменяемую запись версии. Издатели используют CLI clawhub для аутентифицированных рабочих процессов реестра:

clawhub skill publish ./my-skillclawhub package publish <source> --family code-plugin --dry-runclawhub package publish <source> --family code-plugin

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

Установки и обновления

Команды установки OpenClaw используют ClawHub как источник пакетов:

openclaw skills install @openclaw/demoopenclaw plugins install clawhub:<package>

OpenClaw записывает метаданные источника установки, чтобы обновления позднее могли разрешать тот же пакет реестра. CLI ClawHub также поддерживает прямые рабочие процессы установки и обновления Skills для пользователей, которым нужны управляемые реестром папки Skills вне полного рабочего пространства OpenClaw.

Состояние безопасности

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

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

См. Безопасность, Аудиты безопасности, Модерация и безопасность аккаунта и Допустимое использование.

Доступ к API

ClawHub предоставляет публичные API чтения для обнаружения, поиска, сведений о пакетах и скачиваний. Сторонние каталоги могут использовать эти API, если они ссылаются на каноническую карточку ClawHub, соблюдают ограничения частоты запросов и не создают впечатления одобрения.

См. Публичный API и HTTP API.