Навыки

ClawHub

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

Что такое ClawHub

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

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

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

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

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

Для кого это (новичкам)

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

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

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

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

Установка CLI

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

npm i -g clawhub

pnpm add -g clawhub

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

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

Обзор системы навыков

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

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

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

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

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

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

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

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

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

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

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

  • --workdir <dir>: Рабочая директория (по умолчанию: текущая директория; иначе используется рабочая область OpenClaw).
  • --dir <dir>: Директория навыков, относительно 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 навыка.
  • --name <name>: Отображаемое имя.
  • --version <version>: Версия Semver.
  • --changelog <text>: Текст списка изменений (может быть пустым).
  • --tags <tags>: Теги через запятую (по умолчанию: latest).

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

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

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

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

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

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

clawhub search "postgres backups"

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

clawhub install my-skill-pack

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

clawhub update --all

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

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

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

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

clawhub sync --all

Продвинутые детали (технические)

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

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

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

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

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

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

Хранилище и lock-файл

  • Установленные навыки записываются в .clawhub/lock.json в вашей рабочей директории.
  • Токены аутентификации хранятся в файле конфигурации ClawHub CLI (можно переопределить через 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.

Конфигурация навыковПлагины