ClawHub¶

ClawHub — это публичный реестр Skills для OpenClaw. Это бесплатный сервис: все Skills являются публичными, открытыми и видимыми для всех — для обмена и повторного использования. Skill — это просто папка с файлом SKILL.md (плюс вспомогательные текстовые файлы). Вы можете просматривать Skills в веб‑приложении или использовать CLI для поиска, установки, обновления и публикации Skills.

Сайт: clawhub.ai

Что такое ClawHub¶

• Публичный реестр Skills для OpenClaw.
• Версионируемое хранилище бандлов Skills и метаданных.
• Поверхность обнаружения для поиска, тегов и сигналов использования.

Как это работает¶

1. Пользователь публикует бандл Skill (файлы + метаданные).
2. ClawHub сохраняет бандл, разбирает метаданные и назначает версию.
3. Реестр индексирует Skill для поиска и обнаружения.
4. Пользователи просматривают, загружают и устанавливают Skills в OpenClaw.

Что вы можете делать¶

• Публиковать новые Skills и новые версии существующих Skills.
• Находить Skills по имени, тегам или поиску.
• Загружать бандлы Skills и просматривать их файлы.
• Сообщать о Skills, которые являются злоупотребляющими или небезопасными.
• Если вы модератор — скрывать, показывать, удалять или блокировать.

Для кого это (подходит для начинающих)¶

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

• Искать Skills на естественном языке.
• Устанавливать Skill в своё рабочее пространство.
• Обновлять Skills позже одной командой.
• Делать резервные копии собственных Skills, публикуя их.

Быстрый старт (без технических деталей)¶

1. Установите CLI (см. следующий раздел).
2. Найдите то, что вам нужно: - clawhub search "calendar"
3. Установите Skill: - clawhub install <skill-slug>
4. Запустите новый сеанс OpenClaw, чтобы он подхватил новый Skill.

Установка CLI¶

Выберите один вариант:

npm i -g clawhub

pnpm add -g clawhub

Как это вписывается в OpenClaw¶

По умолчанию CLI устанавливает Skills в ./skills в вашем текущем рабочем каталоге. Если настроено рабочее пространство OpenClaw, clawhub использует его как резервный вариант, если вы не переопределили --workdir (или CLAWHUB_WORKDIR). OpenClaw загружает Skills рабочего пространства из <workspace>/skills и подхватывает их в следующем сеансе. Если вы уже используете ~/.openclaw/skills или Skills из комплекта, Skills рабочего пространства имеют приоритет.

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

Обзор системы Skills¶

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

Типичный Skill включает:

• Файл SKILL.md с основным описанием и инструкциями по использованию.
• Необязательные конфиги, скрипты или вспомогательные файлы, используемые Skill.
• Метаданные, такие как теги, краткое описание и требования к установке.

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

Что предоставляет сервис (возможности)¶

• Публичный просмотр Skills и их содержимого SKILL.md.
• Поиск на базе эмбеддингов (векторный поиск), а не только по ключевым словам.
• Версионирование с semver, журналами изменений и тегами (включая latest).
• Загрузки в виде zip для каждой версии.
• Звёзды и комментарии для обратной связи от сообщества.
• Инструменты модерации для утверждений и аудитов.
• API, дружественный к CLI, для автоматизации и скриптов.

Безопасность и модерация¶

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

Сообщения и модерация:

• Любой вошедший пользователь может пожаловаться на Skill.
• Причины жалоб обязательны и фиксируются.
• У каждого пользователя может быть до 20 активных жалоб одновременно.
• Skills с более чем 3 уникальными жалобами автоматически скрываются по умолчанию.
• Модераторы могут просматривать скрытые Skills, показывать их, удалять или блокировать пользователей.
• Злоупотребление функцией жалоб может привести к блокировке аккаунта.

Хотите стать модератором? Спросите в Discord OpenClaw и свяжитесь с модератором или мейнтейнером.

Команды и параметры CLI¶

Глобальные параметры (применяются ко всем командам):

• --workdir <dir>: Рабочий каталог (по умолчанию: текущий каталог; с резервным переходом к рабочему пространству OpenClaw).
• --dir <dir>: Каталог Skills, относительно workdir (по умолчанию: skills).
• --site <url>: Базовый URL сайта (вход через браузер).
• --registry <url>: Базовый URL API реестра.
• --no-input: Отключить запросы (неинтерактивный режим).
• -V, --cli-version: Вывести версию CLI.

Аутентификация:

• clawhub login (через браузер) или clawhub login --token <token>
• clawhub logout
• clawhub whoami

Параметры:

• --token <token>: Вставить токен API.
• --label <label>: Метка, сохраняемая для токенов входа через браузер (по умолчанию: CLI token).
• --no-browser: Не открывать браузер (требуется --token).

Поиск:

• clawhub search "query"
• --limit <n>: Максимальное количество результатов.

Установка:

• clawhub install <slug>
• --version <version>: Установить конкретную версию.
• --force: Перезаписать, если папка уже существует.

Обновление:

• clawhub update <slug>
• clawhub update --all
• --version <version>: Обновить до конкретной версии (только один slug).
• --force: Перезаписать, когда локальные файлы не соответствуют ни одной опубликованной версии.

Список:

• clawhub list (читает .clawhub/lock.json)

Публикация:

• clawhub publish <path>
• --slug <slug>: Slug Skill.
• --name <name>: Отображаемое имя.
• --version <version>: Версия semver.
• --changelog <text>: Текст журнала изменений (может быть пустым).
• --tags <tags>: Теги через запятую (по умолчанию: latest).

Удаление/восстановление (только владелец/администратор):

• clawhub delete <slug> --yes
• clawhub undelete <slug> --yes

Синхронизация (сканирование локальных Skills + публикация новых/обновлённых):

• clawhub sync
• --root <dir...>: Дополнительные корни сканирования.
• --all: Загрузить всё без запросов.
• --dry-run: Показать, что будет загружено.
• --bump <type>: patch|minor|major для обновлений (по умолчанию: patch).
• --changelog <text>: Журнал изменений для неинтерактивных обновлений.
• --tags <tags>: Теги через запятую (по умолчанию: latest).
• --concurrency <n>: Проверки реестра (по умолчанию: 4).

Часто используемые рабочие процессы для агентов¶

Поиск Skills¶

clawhub search "postgres backups"

Загрузка новых Skills¶

clawhub install my-skill-pack

Обновление установленных Skills¶

clawhub update --all

Резервное копирование ваших Skills (публикация или синхронизация)¶

Для одной папки Skill:

clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

Для сканирования и резервного копирования множества Skills одновременно:

clawhub sync --all

Дополнительные сведения (технические)¶

Версионирование и теги¶

• Каждая публикация создаёт новую semver SkillVersion.
• Теги (например, latest) указывают на версию; перемещение тегов позволяет откатываться.
• Журналы изменений привязываются к каждой версии и могут быть пустыми при синхронизации или публикации обновлений.

Локальные изменения и версии реестра¶

Обновления сравнивают локальное содержимое Skill с версиями реестра с использованием хэша содержимого. Если локальные файлы не соответствуют ни одной опубликованной версии, CLI запрашивает подтверждение перед перезаписью (или требует --force в неинтерактивных запусках).

Сканирование при синхронизации и резервные корни¶

clawhub sync сначала сканирует текущий workdir. Если Skills не найдены, используется резервный переход к известным устаревшим расположениям (например, ~/openclaw/skills и ~/.openclaw/skills). Это сделано для обнаружения старых установок Skills без дополнительных флагов.

Хранилище и lockfile¶

• Установленные Skills записываются в .clawhub/lock.json в вашем workdir.
• Токены аутентификации хранятся в конфиге CLI ClawHub (переопределяется через CLAWHUB_CONFIG_PATH).

Телеметрия (счётчики установок)¶

Когда вы запускаете clawhub sync в состоянии входа, CLI отправляет минимальный снимок для расчёта количества установок. Вы можете полностью отключить это:

export CLAWHUB_DISABLE_TELEMETRY=1

Переменные окружения¶

• CLAWHUB_SITE: Переопределить URL сайта.
• CLAWHUB_REGISTRY: Переопределить URL API реестра.
• CLAWHUB_CONFIG_PATH: Переопределить место хранения токена/конфига CLI.
• CLAWHUB_WORKDIR: Переопределить рабочий каталог по умолчанию.
• CLAWHUB_DISABLE_TELEMETRY=1: Отключить телеметрию для sync.