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.

    Пов’язане