Перейти к основному содержанию

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.