ClawHub
ClawHub — це публічний реєстр для Skills і plugins OpenClaw.- Використовуйте нативні команди
openclawдля пошуку/встановлення/оновлення Skills і встановлення plugins з ClawHub. - Використовуйте окремий CLI
clawhub, коли потрібні автентифікація реєстру, публікація, видалення, відновлення або робочі процеси sync.
Нативні сценарії OpenClaw
Skills:openclaw встановлюють у ваш активний workspace і зберігають
метадані джерела, щоб подальші виклики update могли залишатися в ClawHub.
Під час установлення plugins перевіряється сумісність заявлених pluginApi і minGatewayVersion
ще до запуску встановлення архіву, тому несумісні хости рано завершуються у безпечний спосіб
замість часткового встановлення пакета.
openclaw plugins install clawhub:... приймає лише сімейства plugins, які можна встановити.
Якщо пакет ClawHub насправді є skill, OpenClaw зупиняється і натомість вказує вам на
openclaw skills install <slug>.
Що таке ClawHub
- Публічний реєстр для Skills і plugins OpenClaw.
- Версіоноване сховище пакетів skills і метаданих.
- Поверхня виявлення для пошуку, тегів і сигналів використання.
Як це працює
- Користувач публікує пакет skill (файли + метадані).
- ClawHub зберігає пакет, аналізує метадані та призначає версію.
- Реєстр індексує skill для пошуку й виявлення.
- Користувачі переглядають, завантажують і встановлюють Skills в OpenClaw.
Що можна робити
- Публікувати нові Skills і нові версії наявних Skills.
- Знаходити Skills за назвою, тегами або пошуком.
- Завантажувати пакети skills і переглядати їхні файли.
- Повідомляти про Skills, які є шкідливими або небезпечними.
- Якщо ви модератор, приховувати, показувати, видаляти або банити.
Для кого це призначено (зручно для початківців)
Якщо ви хочете додати нові можливості своєму агенту OpenClaw, ClawHub — найпростіший спосіб знайти та встановити Skills. Вам не потрібно знати, як працює бекенд. Ви можете:- Шукати Skills звичайною мовою.
- Установлювати skill у свій workspace.
- Пізніше оновлювати Skills однією командою.
- Робити резервні копії власних Skills через публікацію.
Швидкий старт (без технічних деталей)
- Знайдіть те, що вам потрібно:
openclaw skills search "calendar"
- Установіть skill:
openclaw skills install <skill-slug>
- Запустіть нову сесію OpenClaw, щоб він підхопив новий skill.
- Якщо ви хочете публікувати або керувати автентифікацією реєстру, також установіть окремий
CLI
clawhub.
Установлення ClawHub CLI
Він потрібен лише для робочих процесів з автентифікацією реєстру, таких як publish/sync:Як це вписується в OpenClaw
Нативна командаopenclaw skills install встановлює в каталог skills/
активного workspace. openclaw plugins install clawhub:... записує звичайне кероване
встановлення plugin плюс метадані джерела ClawHub для оновлень.
Анонімні встановлення plugins з ClawHub також безпечно завершуються для приватних пакетів.
Спільнота або інші неофіційні канали все ще можуть виконати встановлення, але OpenClaw попереджає,
щоб оператори могли перевірити джерело й валідацію перед увімкненням.
Окремий CLI clawhub також установлює Skills у ./skills у вашому
поточному робочому каталозі. Якщо налаштовано workspace OpenClaw, clawhub
перемикається на цей workspace, якщо ви не перевизначите --workdir (або
CLAWHUB_WORKDIR). OpenClaw завантажує Skills workspace з <workspace>/skills
і підхоплює їх у наступній сесії. Якщо ви вже використовуєте
~/.openclaw/skills або вбудовані Skills, Skills workspace мають пріоритет.
Докладніше про те, як Skills завантажуються, спільно використовуються й обмежуються, див.
у Skills.
Огляд системи Skills
Skill — це версіонований пакет файлів, який навчає OpenClaw виконувати певне завдання. Кожна публікація створює нову версію, а реєстр зберігає історію версій, щоб користувачі могли перевіряти зміни. Типовий skill містить:- Файл
SKILL.mdз основним описом і використанням. - Необов’язкові конфігурації, scripts або допоміжні файли, які використовує skill.
- Метадані, такі як теги, summary і вимоги до встановлення.
Що надає сервіс (можливості)
- Публічний перегляд Skills та їхнього вмісту
SKILL.md. - Пошук на основі embeddings (векторний пошук), а не лише ключових слів.
- Контроль версій із semver, changelog-ами й тегами (включно з
latest). - Завантаження як zip для кожної версії.
- Stars і comments для зворотного зв’язку спільноти.
- Гачки moderation для схвалень і аудитів.
- CLI-friendly API для автоматизації та сценаріїв.
Безпека та moderation
ClawHub за замовчуванням відкритий. Завантажувати Skills може будь-хто, але для публікації обліковий запис GitHub має існувати щонайменше один тиждень. Це допомагає стримувати зловживання, не блокуючи легітимних учасників. Скарги й moderation:- Будь-який користувач, який увійшов у систему, може поскаржитися на skill.
- Причини скарги є обов’язковими та записуються.
- Кожен користувач може мати не більше 20 активних скарг одночасно.
- Skills із понад 3 унікальними скаргами типово приховуються автоматично.
- Модератори можуть переглядати приховані Skills, показувати їх знову, видаляти або банити користувачів.
- Зловживання функцією скарг може призвести до бану облікового запису.
Команди CLI і параметри
Глобальні параметри (застосовуються до всіх команд):--workdir <dir>: Робочий каталог (типово: поточний каталог; якщо можливо, використовується workspace OpenClaw).--dir <dir>: Каталог Skills відносно workdir (типово:skills).--site <url>: Базова URL-адреса сайту (вхід через браузер).--registry <url>: Базова URL-адреса API реєстру.--no-input: Вимкнути prompts (неінтерактивний режим).-V, --cli-version: Вивести версію CLI.
clawhub login(потік через браузер) абоclawhub login --token <token>clawhub logoutclawhub whoami
--token <token>: Вставити API token.--label <label>: Мітка, що зберігається для token-ів входу через браузер (типово: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 skill publish <path>--slug <slug>: Slug skill.--name <name>: Видиме ім’я.--version <version>: Версія semver.--changelog <text>: Текст changelog (може бути порожнім).--tags <tags>: Теги, розділені комами (типово:latest).
clawhub package publish <source><source>може бути локальною папкою,owner/repo,owner/repo@refабо URL GitHub.--dry-run: Побудувати точний план публікації без фактичного завантаження.--json: Вивести машинозчитуваний результат для CI.--source-repo,--source-commit,--source-ref: Необов’язкові перевизначення, коли автодетекції недостатньо.
clawhub delete <slug> --yesclawhub undelete <slug> --yes
clawhub sync--root <dir...>: Додаткові корені сканування.--all: Завантажити все без prompts.--dry-run: Показати, що буде завантажено.--bump <type>:patch|minor|majorдля оновлень (типово:patch).--changelog <text>: Changelog для неінтерактивних оновлень.--tags <tags>: Теги, розділені комами (типово:latest).--concurrency <n>: Перевірки реєстру (типово: 4).
Типові робочі процеси для агентів
Пошук Skills
Завантаження нових Skills
Оновлення встановлених Skills
Резервне копіювання своїх Skills (publish або sync)
Для окремої папки skill:Публікація plugin з GitHub
package.json:
Додаткові деталі (технічні)
Контроль версій і теги
- Кожна публікація створює нову semver-версію
SkillVersion. - Теги (як-от
latest) вказують на версію; переміщення тегів дає змогу відкотитися. - Changelog-и прив’язуються до кожної версії й можуть бути порожніми під час sync або публікації оновлень.
Локальні зміни проти версій у реєстрі
Оновлення порівнюють локальний вміст skill з версіями в реєстрі за допомогою content hash. Якщо локальні файли не відповідають жодній опублікованій версії, CLI запитує підтвердження перед перезаписом (або вимагає--force у неінтерактивних запусках).
Сканування sync і резервні корені
clawhub sync спочатку сканує ваш поточний workdir. Якщо Skills не знайдено, він переходить до відомих застарілих розташувань (наприклад, ~/openclaw/skills і ~/.openclaw/skills). Це зроблено, щоб знаходити старі встановлення skills без додаткових прапорців.
Сховище і lockfile
- Установлені Skills записуються в
.clawhub/lock.jsonу вашому workdir. - Auth tokens зберігаються у файлі конфігурації ClawHub CLI (можна перевизначити через
CLAWHUB_CONFIG_PATH).
Телеметрія (кількість установлень)
Коли ви запускаєтеclawhub sync, будучи в системі, CLI надсилає мінімальний знімок для обчислення кількості встановлень. Це можна повністю вимкнути:
Змінні середовища
CLAWHUB_SITE: Перевизначає URL-адресу сайту.CLAWHUB_REGISTRY: Перевизначає URL-адресу API реєстру.CLAWHUB_CONFIG_PATH: Перевизначає місце, де CLI зберігає token/конфігурацію.CLAWHUB_WORKDIR: Перевизначає типовий workdir.CLAWHUB_DISABLE_TELEMETRY=1: Вимикає телеметрію дляsync.