Skills
ClawHub
ClawHub — це публічний реєстр для OpenClaw skills і plugins.
- Використовуйте нативні команди
openclaw, щоб шукати, установлювати й оновлювати skills, а також установлювати plugins із ClawHub. - Використовуйте окремий CLI
clawhubдля автентифікації в реєстрі, публікації, видалення/відновлення та робочих процесів синхронізації.
Сайт: clawhub.ai
Швидкий старт
Пошук
openclaw skills search "calendar"
Установлення
openclaw skills install <skill-slug>
Використання
Запустіть нову сесію OpenClaw - вона підхопить новий skill.
Публікація (необов’язково)
Для робочих процесів із автентифікацією в реєстрі (публікація, синхронізація, керування) установіть
окремий CLI clawhub:
npm i -g clawhub
# or
pnpm add -g clawhub
Нативні робочі процеси OpenClaw
Skills
openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all
Нативні команди openclaw установлюють у ваш активний робочий простір і
зберігають метадані джерела, щоб подальші виклики update могли залишатися на ClawHub.
Plugins
openclaw plugins search "calendar"
openclaw plugins install clawhub:<package>
openclaw plugins update --all
plugins search опитує каталог plugin ClawHub і виводить готові до встановлення
назви пакетів. Використовуйте clawhub:<package>, коли потрібне розв’язання через ClawHub.
Специфікації plugin без префікса, безпечні для npm, установлюються з npm під час перехідного запуску:
openclaw plugins install openclaw-codex-app-server
npm:<package> також працює лише через npm і корисний, коли специфікація інакше
могла б бути неоднозначною:
openclaw plugins install npm:openclaw-codex-app-server
Установлення Plugin перевіряє сумісність заявлених pluginApi і
minGatewayVersion перед установленням архіву, тому
несумісні хости рано завершуються закрито, замість часткового встановлення
пакета. Коли версія пакета публікує артефакт ClawPack,
OpenClaw надає перевагу точно завантаженому npm-pack .tgz, перевіряє заголовок дайджесту ClawHub
і завантажені байти, а також записує тип артефакту, цілісність npm,
shasum npm, назву tarball і метадані дайджесту ClawPack для подальших
оновлень. Старіші версії пакетів без метаданих ClawPack і далі використовують
застарілий шлях перевірки архіву пакета.
Що таке ClawHub
- Публічний реєстр для OpenClaw skills і plugins.
- Версійне сховище пакетів skill і метаданих.
- Поверхня виявлення для пошуку, тегів і сигналів використання.
Типовий skill — це версійний пакет файлів, який містить:
- Файл
SKILL.mdз основним описом і використанням. - Необов’язкові конфігурації, scripts або допоміжні файли, які використовує skill.
- Метадані, як-от теги, підсумок і вимоги до встановлення.
ClawHub використовує метадані для підтримки виявлення та безпечного розкриття можливостей skill. Реєстр відстежує сигнали використання (зірки, завантаження), щоб покращувати ранжування та видимість. Кожна публікація створює нову версію semver, а реєстр зберігає історію версій, щоб користувачі могли перевіряти зміни.
Робочий простір і завантаження skill
Окремий CLI clawhub також установлює skills у ./skills у
вашому поточному робочому каталозі. Якщо робочий простір OpenClaw налаштовано,
clawhub повертається до цього робочого простору, якщо ви не перевизначите --workdir
(або CLAWHUB_WORKDIR). OpenClaw завантажує skills робочого простору з
<workspace>/skills і підхоплює їх у наступній сесії.
Якщо ви вже використовуєте ~/.openclaw/skills або вбудовані skills, skills
робочого простору мають пріоритет. Докладніше про те, як skills завантажуються,
спільно використовуються й обмежуються, див. Skills.
Функції сервісу
| Функція | Нотатки |
|---|---|
| Публічний перегляд | Skills і їхній вміст SKILL.md доступні для публічного перегляду. |
| Пошук | На основі embedding (векторний пошук), а не лише ключових слів. |
| Версіонування | Semver, журнали змін і теги (зокрема latest). |
| Завантаження | Zip для кожної версії. |
| Зірки та коментарі | Відгуки спільноти. |
| Підсумки сканування безпеки | Сторінки деталей показують найновіший стан сканування перед установленням або завантаженням. |
| Сторінки деталей сканера | Результати VirusTotal, ClawScan і статичного аналізу мають глибокі посилання. |
| Панель відновлення власника | Видавці можуть бачити власний вміст, затриманий скануванням, із /dashboard. |
| Повторні сканування на запит власника | Власники можуть запитувати обмежені повторні сканування для відновлення після хибних спрацьовувань. |
| Модерація | Схвалення та аудити. |
| API, зручний для CLI | Підходить для автоматизації та створення scripts. |
Безпека та модерація
ClawHub відкритий за замовчуванням - будь-хто може завантажувати skills, але обліковий запис GitHub має бути щонайменше тиждень давності, щоб публікувати. Це уповільнює зловживання, не блокуючи легітимних учасників.
Сканування безпеки
ClawHub запускає автоматизовані перевірки безпеки опублікованих skills і випусків plugin. Публічні сторінки деталей підсумовують поточний результат, а рядки сканерів посилаються на окремі сторінки деталей для VirusTotal, ClawScan і статичного аналізу.
Випуски, затримані скануванням або заблоковані, можуть бути недоступні в публічному каталозі та
на поверхнях установлення, але залишатися видимими для їхнього власника в /dashboard.
Звітування
- Будь-який користувач, який увійшов у систему, може повідомити про skill.
- Причини повідомлення є обов’язковими й записуються.
- Кожен користувач може мати до 20 активних повідомлень одночасно.
- Skills із понад 3 унікальними повідомленнями автоматично приховуються за замовчуванням.
Модерація
- Модератори можуть переглядати приховані skills, повертати їх, видаляти їх або блокувати користувачів.
- Зловживання функцією повідомлень може призвести до блокування облікового запису.
- Хочете стати модератором? Запитайте в OpenClaw Discord і зв’яжіться з модератором або супровідником.
CLI ClawHub
Він потрібен лише для робочих процесів із автентифікацією в реєстрі, як-от публікація/синхронізація.
Глобальні параметри
"--workdir"--dir"--site"--registry--no-inputbooleanВимкнути підказки (неінтерактивно).
-V, --cli-versionbooleanНадрукувати версію CLI.
Команди
Автентифікація (вхід / вихід / whoami)
clawhub login # browser flow
clawhub login --token <token>
clawhub logout
clawhub whoami
Параметри входу:
--token <token>- вставити API-токен.--label <label>- мітка, збережена для токенів входу через браузер (за замовчуванням:CLI token).--no-browser- не відкривати браузер (потребує--token).
Пошук
clawhub search "query"
Шукає skills. Для виявлення plugin/пакетів використовуйте clawhub package explore.
--limit <n>- максимальна кількість результатів.
Перегляд / інспектування plugins
clawhub package explore --family code-plugin
clawhub package explore "episodic-claw" --family code-plugin
clawhub package inspect episodic-claw
package explore і package inspect — це поверхні CLI ClawHub для виявлення plugin/пакетів та інспектування метаданих. Нативні встановлення OpenClaw і далі використовують openclaw plugins install clawhub:<package>.
Параметри:
--family skill|code-plugin|bundle-plugin- фільтрувати сімейство пакета.--official- показувати лише офіційні пакети.--executes-code- показувати лише пакети, які виконують код.--version <version>/--tag <tag>- інспектувати певну версію пакета.--versions,--files,--file <path>- інспектувати історію та файли пакета.--json- машинозчитуваний вивід.
Установлення / оновлення / список
clawhub install <slug>
clawhub update <slug>
clawhub update --all
clawhub list
Параметри:
--version <version>- установити або оновити до певної версії (лише один slug дляupdate).--force- перезаписати, якщо папка вже існує, або коли локальні файли не відповідають жодній опублікованій версії.clawhub listчитає.clawhub/lock.json.
Публікація skills
clawhub skill publish <path>
Параметри:
--slug <slug>- slug skill.--name <name>- відображувана назва.--version <version>- версія semver.--changelog <text>- текст журналу змін (може бути порожнім).--tags <tags>- теги, розділені комами (за замовчуванням:latest).
Публікація plugins
clawhub package publish <source>
<source> може бути локальною папкою, owner/repo, owner/repo@ref або
URL-адресою GitHub.
Параметри:
--dry-run- побудувати точний план публікації без завантаження будь-чого.--json- вивести машинозчитуваний результат для CI.--source-repo,--source-commit,--source-ref- необов’язкові перевизначення, коли автоматичного визначення недостатньо.
Запит повторних сканувань
clawhub skill rescan <slug>
clawhub skill rescan <slug> --yes --json
clawhub package rescan <name>
clawhub package rescan <name> --yes --json
Команди повторного сканування потребують токен власника, який увійшов у систему, і націлюються на найновішу
опубліковану версію skill або випуск plugin. У неінтерактивних запусках передавайте
--yes.
JSON-відповіді містять тип цілі, назву, версію, статус повторного сканування та залишкову/максимальну кількість запитів для цієї версії або випуску.
Видалення / відновлення (власник або адміністратор)
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"
Знайти plugin
clawhub package explore --family code-plugin
clawhub package explore "memory" --family code-plugin
clawhub package inspect episodic-claw
Установити
clawhub install my-skill-pack
Оновити все
clawhub update --all
Опублікувати один skill
clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
Синхронізувати багато skills
clawhub sync --all
Опублікувати plugin з GitHub
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/[email protected]
clawhub package publish https://github.com/your-org/your-plugin
Метадані пакета Plugin
Кодові plugins повинні містити обов’язкові метадані OpenClaw у
package.json:
{
"name": "@myorg/openclaw-my-plugin",
"version": "1.0.0",
"type": "module",
"openclaw": {
"extensions": ["./src/index.ts"],
"runtimeExtensions": ["./dist/index.js"],
"compat": {
"pluginApi": ">=2026.3.24-beta.2",
"minGatewayVersion": "2026.3.24-beta.2"
},
"build": {
"openclawVersion": "2026.3.24-beta.2",
"pluginSdkVersion": "2026.3.24-beta.2"
}
}
}
Опубліковані пакети мають постачати зібраний JavaScript і вказувати
runtimeExtensions на цей результат. Установлення з Git checkout усе ще можуть
відступати до вихідного коду TypeScript, коли зібраних файлів немає, але зібрані runtime-записи
уникають runtime-компіляції TypeScript під час запуску, doctor і
шляхів завантаження plugin.
Версіонування, lockfile і телеметрія
Версіонування й теги
- Кожна публікація створює нову semver
SkillVersion. - Теги (як-от
latest) вказують на версію; переміщення тегів дає змогу відкотитися. - Журнали змін прикріплюються до кожної версії та можуть бути порожніми під час синхронізації або публікації оновлень.
Локальні зміни порівняно з версіями registry
Оновлення порівнюють вміст локального skill з версіями registry за допомогою
хешу вмісту. Якщо локальні файли не збігаються з жодною опублікованою версією,
CLI запитує перед перезаписом (або вимагає --force у
неінтерактивних запусках).
Сканування sync і резервні корені
clawhub sync спочатку сканує ваш поточний workdir. Якщо skills не
знайдено, він відступає до відомих legacy-розташувань (наприклад
~/openclaw/skills і ~/.openclaw/skills). Це призначено для
пошуку старіших установлень skills без додаткових прапорців.
Сховище й lockfile
- Установлені skills записуються в
.clawhub/lock.jsonу вашому workdir. - Auth-токени зберігаються у файлі конфігурації ClawHub CLI (перевизначається через
CLAWHUB_CONFIG_PATH).
Телеметрія (лічильники встановлень)
Коли ви запускаєте clawhub sync після входу в систему, CLI надсилає мінімальний
знімок для обчислення кількості встановлень. Ви можете повністю вимкнути це:
export CLAWHUB_DISABLE_TELEMETRY=1
Змінні середовища
| Змінна | Ефект |
|---|---|
CLAWHUB_SITE |
Перевизначає URL сайту. |
CLAWHUB_REGISTRY |
Перевизначає URL API registry. |
CLAWHUB_CONFIG_PATH |
Перевизначає, де CLI зберігає token/config. |
CLAWHUB_WORKDIR |
Перевизначає типовий workdir. |
CLAWHUB_DISABLE_TELEMETRY=1 |
Вимикає телеметрію для sync. |