ClawdHub

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

Сайт: clawdhub.com

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

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

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

Быстрый старт (нетехнический)

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

Установка CLI

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

npm i -g clawdhub

pnpm add -g clawdhub

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

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

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

Что предоставляет сервис (функции)

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

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

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

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

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

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

Опции:

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

Поиск:

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

Установка:

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

Обновление:

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

Список:

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

Публикация:

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

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

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

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

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

Общие рабочие процессы для агентов

Поиск навыков

clawdhub search "postgres backups"

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

clawdhub install my-skill-pack

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

clawdhub update --all

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

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

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

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

clawdhub sync --all

Расширенные детали (технические)

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

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

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

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

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

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

Хранение и lockfile

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

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

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

export CLAWDHUB_DISABLE_TELEMETRY=1

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

  • CLAWDHUB_SITE: Переопределить URL сайта.
  • CLAWDHUB_REGISTRY: Переопределить URL API реестра.
  • CLAWDHUB_CONFIG_PATH: Переопределить, где CLI хранит токен/конфиг.
  • CLAWDHUB_WORKDIR: Переопределить workdir по умолчанию.
  • CLAWDHUB_DISABLE_TELEMETRY=1: Отключить телеметрию при sync.
← Назад к документации