CLI

Пакет CLI: clawhub, bin: clawhub.

Установите его глобально с помощью npm или pnpm:

npm i -g clawhub# orpnpm add -g clawhub

Затем проверьте его:

clawhub --helpclawhub loginclawhub whoami

Глобальные флаги

• --workdir <dir>: рабочий каталог (по умолчанию: cwd; откатывается к рабочей области Clawdbot, если она настроена)
• --dir <dir>: каталог установки внутри workdir (по умолчанию: skills)
• --site <url>: базовый URL для входа через браузер (по умолчанию: https://clawhub.ai)
• --registry <url>: базовый URL API (по умолчанию: обнаруженный, иначе https://clawhub.ai)
• --no-input: отключить запросы

Эквиваленты env:

• CLAWHUB_SITE (устаревший CLAWDHUB_SITE)
• CLAWHUB_REGISTRY (устаревший CLAWDHUB_REGISTRY)
• CLAWHUB_WORKDIR (устаревший CLAWDHUB_WORKDIR)

HTTP-прокси

CLI учитывает стандартные переменные окружения HTTP-прокси для систем за корпоративными прокси или в сетях с ограничениями:

• HTTPS_PROXY / https_proxy
• HTTP_PROXY / http_proxy
• NO_PROXY / no_proxy

Когда задана любая из этих переменных, CLI направляет исходящие запросы через указанный прокси. HTTPS_PROXY используется для HTTPS-запросов, HTTP_PROXY для обычного HTTP. NO_PROXY / no_proxy учитывается для обхода прокси для конкретных хостов или доменов.

Это требуется в системах, где прямые исходящие подключения заблокированы (например, Docker-контейнеры, Hetzner VPS с доступом в интернет только через прокси, корпоративные межсетевые экраны).

Пример:

export HTTPS_PROXY=http://proxy.example.com:3128export NO_PROXY=localhost,127.0.0.1clawhub search "my query"

Если переменная прокси не задана, поведение не меняется (прямые подключения).

Файл конфигурации

Хранит ваш API-токен + кэшированный URL реестра.

• macOS: ~/Library/Application Support/clawhub/config.json
• Linux/XDG: $XDG_CONFIG_HOME/clawhub/config.json или ~/.config/clawhub/config.json
• Windows: %APPDATA%\\clawhub\\config.json
• Устаревший резервный вариант: если clawhub/config.json еще не существует, но существует clawdhub/config.json, CLI повторно использует устаревший путь
• переопределение: CLAWHUB_CONFIG_PATH (устаревший CLAWDHUB_CONFIG_PATH)

Команды

login / auth login

• По умолчанию: открывает браузер на <site>/cli/auth и завершает вход через callback loopback.
• Headless: clawhub login --token clh_...
• Удаленный/headless интерактивный режим: clawhub login --device печатает код и ожидает, пока вы авторизуете его на <site>/cli/device.

whoami

• Проверяет сохраненный токен через /api/v1/whoami.

token

• Печатает сохраненный API-токен в stdout.
• Полезно для передачи локального токена входа в команды настройки секретов CI через pipe.

star <skill> / unstar <skill>

• Добавляет/удаляет skill из ваших избранных.
• Вызывает POST /api/v1/stars/<slug> и DELETE /api/v1/stars/<slug>.
• --yes пропускает подтверждение.

search <query...>

• Вызывает /api/v1/search?q=....
• Вывод включает slug skill, handle владельца, отображаемое имя и оценку релевантности.
• Поиск отдает приоритет точным совпадениям токенов slug/имени перед популярностью скачиваний. Отдельный токен slug, такой как map, сопоставляется с personal-map сильнее, чем подстрока внутри amap.
• Популярность — небольшой ранжирующий prior, а не гарантия верхней позиции.
• Если skill должен появляться, но не появляется, выполните clawhub inspect @owner/slug после входа, чтобы проверить видимую владельцу модерационную диагностику перед переименованием метаданных.

explore

• Выводит список новейших skills через /api/v1/skills?limit=...&sort=createdAt (сортировка по createdAt по убыванию).
• Флаги:
  • --limit <n> (1-200, по умолчанию: 25)
  • --sort newest|updated|rating|downloads|trending (по умолчанию: newest). Устаревшие псевдонимы сортировки установки по-прежнему работают для совместимости.
  • --json (машиночитаемый вывод)
• Вывод: <slug> v<version> <age> <summary> (summary обрезается до 50 символов).

inspect @owner/slug

• Получает метаданные skill и файлы версии без установки.
• --version <version>: проверить конкретную версию (по умолчанию: latest).
• --tag <tag>: проверить версию с тегом (например, latest).
• --versions: вывести историю версий (первая страница).
• --limit <n>: максимальное число версий в списке (1-200).
• --files: вывести список файлов для выбранной версии.
• --file <path>: получить исходное содержимое файла (только текстовые файлы; лимит 200 КБ).
• --json: машиночитаемый вывод.

install @owner/slug

• Определяет последнюю версию для указанного владельца и skill.
• Загружает zip через /api/v1/download.
• Извлекает в <workdir>/<dir>/<slug>.
• Отказывается перезаписывать закрепленные skills; сначала выполните clawhub unpin <skill>.
• Записывает:
  • <workdir>/.clawhub/lock.json (устаревший .clawdhub)
  • <skill>/.clawhub/origin.json (устаревший .clawdhub)

uninstall <skill>

• Удаляет <workdir>/<dir>/<slug> и удаляет запись из lockfile.
• Отправляет телеметрию best-effort, если выполнен вход, чтобы текущие счетчики установок можно было деактивировать.
• Интерактивный режим: запрашивает подтверждение.
• Неинтерактивный режим (--no-input): требует --yes.

list

• Читает <workdir>/.clawhub/lock.json (устаревший .clawdhub).
• Показывает pinned рядом со skills, замороженными через clawhub pin, включая необязательную причину.

pin <skill>

• Помечает установленный skill как закрепленный в lockfile.
• --reason <text> записывает, почему skill заморожен.
• Закрепленные skills пропускаются update --all и отклоняются прямым update <skill>.
• Закрепленные skills также отклоняют install --force, чтобы локальные байты нельзя было случайно заменить.

unpin <skill>

• Удаляет закрепление из lockfile для установленного skill, чтобы будущие обновления могли его изменить.

update [@owner/slug] / update --all

• Вычисляет fingerprint из локальных файлов.
• Если fingerprint совпадает с известной версией: без запроса.
• Если fingerprint не совпадает:
  • отказывается по умолчанию
  • перезаписывает с --force (или по запросу, если интерактивно)
• Закрепленные skills никогда не обновляются через --force.
• update <skill> быстро завершается с ошибкой для закрепленных skills и предлагает сначала выполнить clawhub unpin <skill>.
• update --all пропускает закрепленные slug и печатает сводку о том, что осталось замороженным.

skill publish <path>

• Сравнивает fingerprint локального bundle с ClawHub и успешно завершается, когда содержимое уже опубликовано.
• Для новых skills по умолчанию используется 1.0.0; для измененных skills по умолчанию используется следующая patch version.
• --version <version> явно выбирает версию и публикует, даже когда содержимое совпадает с существующей версией.
• --dry-run выполняет разрешение публикации без загрузки; --json печатает машиночитаемый результат.
• --owner <handle> публикует под handle издателя организации/пользователя, когда actor имеет доступ издателя.
• --migrate-owner переносит существующий skill в --owner, одновременно публикуя новую версию. Требует доступа admin/owner у обоих издателей.
• Поведение владельца и ревью объясняется в docs/publishing.md.
• Публикация skill означает, что он выпускается на ClawHub под MIT-0.
• Опубликованные skills можно свободно использовать, изменять и распространять без указания авторства.
• ClawHub не поддерживает платные skills или pricing для отдельных skills.
• Устаревший псевдоним: publish <path>.

clawhub skill publish ./my-skill --dry-runclawhub skill publish ./my-skillclawhub skill publish ./my-skill --version 2.0.0

GitHub Actions

Переиспользуемый workflow ClawHub skill-publish.yml вызывает skill publish для одного skill_path или для каждой непосредственной папки skill под root (по умолчанию: skills). Он пропускает неизмененные skills и использует то же поведение автоматической patch-версии.

Установите dry_run: true для предварительного просмотра без токена. Реальные публикации требуют секрет clawhub_token.

sync

• Сканирует текущий workdir, настроенный каталог skills и любые папки --root <dir> на наличие локальных папок skill, содержащих SKILL.md или skill.md.
• Сравнивает fingerprint каждого локального skill с ClawHub и публикует только новые или измененные skills.
• Новые skills публикуются как 1.0.0; измененные skills по умолчанию публикуют следующую patch version. Используйте --bump minor|major для пакетов обновлений, которые должны перейти на более крупный шаг semver.
• --dry-run показывает план публикации без загрузки; --json печатает машиночитаемый план.
• --all публикует каждый новый или измененный skill без запроса. Без --all интерактивные терминалы позволяют выбрать skills для публикации.
• --owner <handle> публикует под handle издателя организации/пользователя, когда actor имеет доступ издателя.
• sync — только односторонняя публикация. Он не устанавливает, не обновляет, не скачивает и не сообщает телеметрию установок/скачиваний.

clawhub sync --all --dry-runclawhub sync --allclawhub sync --root ./skills --owner openclaw --bump minor

scan --slug <slug>

• Требует clawhub login.
• Запускает ClawHub ClawScan через POST /api/v1/skills/-/scan, затем опрашивает до терминального состояния сканирования.
• Сканирования асинхронны и могут занимать время. Пока задача в очереди, terminal spinner показывает текущую приоритетную позицию сканирования и сколько сканирований впереди.
• Опубликованные сканирования требуют права собственности или управленческого доступа издателя. Модераторы/admins могут использовать тот же backend через clawhub-admin.
• --update допустим только с --slug; он записывает успешные результаты опубликованного сканирования обратно в выбранную версию.
• --output <file.zip> скачивает полный архив отчета с manifest.json, clawscan.json, skillspector.json, static-analysis.json, virustotal.json и README.md.
• --json печатает полный ответ опроса для автоматизации.
• Сканирования локального пути больше не поддерживаются. Загрузите новую версию, затем используйте scan download, чтобы получить сохраненные результаты сканирования для этой отправленной версии.

clawhub scan --slug gifgrepclawhub scan --slug gifgrep --version 1.2.3clawhub scan --slug gifgrep --update --output report.zip

scan download <name>

• Требует clawhub login.
• Скачивает сохраненный ZIP-отчет сканирования для отправленной версии skill или plugin, включая версии, заблокированные или скрытые проверками безопасности ClawHub.
• Загрузки skill используют slug skill и по умолчанию --kind skill.
• Загрузки plugin используют имя пакета и требуют --kind plugin.
• --version обязателен, чтобы авторы проверяли точную отправленную версию, которую ClawHub заблокировал.
• --output <file.zip> выбирает путь назначения.

clawhub scan download gifgrep --version 1.2.3clawhub scan download @scope/demo --version 2.0.0 --kind plugin --output report.zip

GitHub Actions

ClawHub поставляет официальный переиспользуемый workflow по адресу /.github/workflows/skill-publish.yml для репозиториев skills и каталогов.

Типичная настройка каталога:

name: Skill Publish on:  pull_request:  workflow_dispatch: jobs:  dry-run:    if: github.event_name == 'pull_request'    uses: openclaw/clawhub/.github/workflows/skill-publish.yml@v1    with:      owner: nvidia      dry_run: true   publish:    if: github.event_name == 'workflow_dispatch'    uses: openclaw/clawhub/.github/workflows/skill-publish.yml@v1    with:      owner: nvidia      dry_run: false    secrets:      clawhub_token: ${{ secrets.CLAWHUB_TOKEN }}

Примечания:

• root по умолчанию равен skills для репозиториев каталогов.
• Передайте skill_path: skills/review-helper, чтобы обработать одну папку skill.
• owner соответствует флагу CLI --owner; опустите его, чтобы публиковать как аутентифицированный пользователь.
• Публикация skills V1 использует clawhub_token; доверенная публикация GitHub OIDC пока доступна только для пакетов.

delete <skill>

• Без --version мягко удаляет навык (владелец, модератор или администратор).
• Вызывает DELETE /api/v1/skills/{slug}.
• Мягкие удаления, инициированные владельцем, резервируют короткое имя на 30 дней; команда выводит время истечения срока.
• --version <version> безвозвратно удаляет одну принадлежащую владельцу версию, не являющуюся последней, через маршрут для конкретной версии, который при сбое отказывает в доступе. Удаленные версии нельзя восстановить или опубликовать заново. Опубликуйте замену перед удалением текущей последней версии. Сотрудники платформы не обходят проверку владения для этого потока только для версии.
• --reason <text> записывает модераторскую заметку для мягкого удаления всего навыка и журнала аудита.
• --note <text> является псевдонимом для --reason.
• --yes пропускает подтверждение.

undelete <skill>

• Восстановить скрытый навык (владелец, модератор или администратор).
• Восстановления версии нет; безвозвратно удаленные версии нельзя восстановить.
• Вызывает POST /api/v1/skills/{slug}/undelete.
• --reason <text> записывает модераторскую заметку для навыка и журнала аудита.
• --note <text> является псевдонимом для --reason.
• --yes пропускает подтверждение.

hide <skill>

• Скрыть навык (владелец, модератор или администратор).
• Псевдоним для delete.

unhide <skill>

• Отобразить навык (владелец, модератор или администратор).
• Псевдоним для undelete.

skill rename <skill> <new-name>

• Переименовать принадлежащий владельцу навык и сохранить прежнее короткое имя как псевдоним перенаправления.
• Вызывает POST /api/v1/skills/{slug}/rename.
• --yes пропускает подтверждение.

skill merge <source> <target>

• Объединить один принадлежащий владельцу навык с другим принадлежащим владельцу навыком.
• Исходное короткое имя перестает отображаться публично и становится псевдонимом перенаправления на целевой навык.
• Вызывает POST /api/v1/skills/{sourceSlug}/merge.
• --yes пропускает подтверждение.

transfer

• Рабочий процесс передачи владения.
• Передачи на пользовательские имена создают ожидающий запрос, который получатель принимает.
• Передачи на имена организаций/издателей применяются сразу только когда у действующего пользователя есть административный доступ и к текущему владельцу, и к целевому издателю.
• Подкоманды:
  • transfer request <skill> <handle> [--message "..."] [--yes]
  • transfer list [--outgoing]
  • transfer accept <skill> [--yes]
  • transfer reject <skill> [--yes]
  • transfer cancel <skill> [--yes]
• Конечные точки:
  • POST /api/v1/skills/{slug}/transfer
  • POST /api/v1/skills/{slug}/transfer/accept
  • POST /api/v1/skills/{slug}/transfer/reject
  • POST /api/v1/skills/{slug}/transfer/cancel
  • GET /api/v1/transfers/incoming
  • GET /api/v1/transfers/outgoing

package explore [query...]

• Просматривает или ищет в едином каталоге пакетов через GET /api/v1/packages и GET /api/v1/packages/search.
• Используйте это для plugins и других записей семейств пакетов; верхнеуровневый search остается поверхностью поиска навыков.
• Флаги:
  • --family skill|code-plugin|bundle-plugin
  • --official
  • --executes-code
  • --target <target>, --os <os>, --arch <arch>, --libc <libc>
  • --requires-browser, --requires-desktop, --requires-native-deps
  • --requires-external-service, --external-service <name>
  • --binary <name>, --os-permission <name>
  • --artifact-kind legacy-zip|npm-pack
  • --npm-mirror
  • --limit <n> (1-100, по умолчанию: 25)
  • --json

Примеры:

clawhub package explore --family code-pluginclawhub package explore --family code-plugin --os darwin --requires-desktopclawhub package explore --family code-plugin --artifact-kind npm-packclawhub package explore --npm-mirrorclawhub package explore episodic-claw --family code-plugin

package inspect <name>

• Получает метаданные пакета без установки.
• Используйте это для метаданных Plugin, совместимости, проверки, исходного кода и просмотра версий/файлов.
• --version <version>: проверить конкретную версию (по умолчанию: последнюю).
• --tag <tag>: проверить версию с тегом (например, latest).
• --versions: вывести историю версий (первая страница).
• --limit <n>: максимальное число версий для вывода (1-100).
• --files: вывести файлы для выбранной версии.
• --file <path>: получить необработанное содержимое файла (только текстовые файлы; ограничение 200 КБ).
• --json: вывод в машиночитаемом формате.

package download <name>

• Разрешает версию пакета через GET /api/v1/packages/{name}/versions/{version}/artifact.
• Скачивает артефакт из downloadUrl резолвера.
• Проверяет ClawHub SHA-256 для всех артефактов.
• Для артефактов ClawPack npm-pack также проверяет целостность npm sha512, npm shasum и имя/версию в package.json архива tarball.
• Устаревшие ZIP-версии скачиваются через устаревший ZIP-маршрут.
• Флаги:
  • --version <version>: скачать конкретную версию.
  • --tag <tag>: скачать версию с тегом (по умолчанию: latest).
  • -o, --output <path>: выходной файл или каталог.
  • --force: перезаписать существующий выходной файл.
  • --json: вывод в машиночитаемом формате.

Примеры:

clawhub package download @openclaw/example-plugin --tag latestclawhub package download @openclaw/example-plugin --version 1.2.3 -o artifacts/

package verify <file>

• Вычисляет ClawHub SHA-256, целостность npm sha512 и npm shasum для локального артефакта.
• С --package разрешает ожидаемые метаданные из ClawHub и сравнивает локальный файл с опубликованными метаданными артефакта.
• С прямыми флагами дайджеста проверяет без сетевого запроса.
• Флаги:
  • --package <name>: имя пакета для разрешения ожидаемых метаданных артефакта.
  • --version <version> или --tag <tag>: ожидаемая версия пакета.
  • --sha256 <hex>: ожидаемый ClawHub SHA-256.
  • --npm-integrity <sri>: ожидаемая целостность npm.
  • --npm-shasum <sha1>: ожидаемый npm shasum.
  • --json: вывод в машиночитаемом формате.

Примеры:

clawhub package verify ./example-plugin-1.2.3.tgz --package @openclaw/example-plugin --version 1.2.3clawhub package verify ./example-plugin-1.2.3.tgz --sha256 <hex>

package validate <source>

• Запускает встроенный в ClawHub CLI инспектор Plugin для локальной папки пакета Plugin.
• По умолчанию выполняет автономную/статическую проверку, без поиска или импорта локальной рабочей копии OpenClaw.
• При критических ошибках совместимости команда завершается с ненулевым кодом. Замечания только уровня предупреждения выводятся, но команда завершается с нулевым кодом.
• Флаги:
  • --out <dir>: записать отчеты инспектора Plugin в этот каталог.
  • --openclaw <path>: проверять относительно явной локальной рабочей копии OpenClaw.
  • --runtime: включить захват среды выполнения; импортирует код Plugin.
  • --allow-execute: разрешить захват среды выполнения в изолированном рабочем пространстве.
  • --no-mock-sdk: отключить имитированный OpenClaw SDK во время захвата среды выполнения.
  • --json: вывод в машиночитаемом формате.

Пример:

clawhub package validate ./example-plugin

Если проверка сообщает о проблеме пакета, манифеста, импорта SDK или артефакта, см. исправления проверки Plugin, затем запустите команду повторно.

package delete <name>

• Без --version мягко удаляет пакет и все выпуски.
• --version <version> безвозвратно удаляет один принадлежащий владельцу выпуск, не являющийся последним, через маршрут для конкретной версии, который при сбое отказывает в доступе. Удаленные версии нельзя восстановить или опубликовать заново. Опубликуйте замену перед удалением текущей последней версии. Для этого потока только для версии требуется владелец пакета или администратор издателя организации; сотрудники платформы не обходят владение пакетом.
• Мягкое удаление всего пакета требует владельца пакета, владельца/администратора издателя организации, модератора платформы или администратора платформы.
• Флаги:
  • --version <version>: безвозвратно удалить одну версию, не являющуюся последней.
  • --yes: пропустить подтверждение.
  • --json: вывод в машиночитаемом формате.

Пример:

clawhub package delete @openclaw/example-plugin --yesclawhub package delete @openclaw/example-plugin --version 1.2.3 --yes

package undelete <name>

• Восстанавливает мягко удаленный пакет и выпуски.
• Восстановления версии нет; безвозвратно удаленные версии нельзя восстановить.
• Требуется владелец пакета, владелец/администратор издателя организации, модератор платформы или администратор платформы.
• Вызывает POST /api/v1/packages/{name}/undelete.
• Флаги:
  • --yes: пропустить подтверждение.
  • --json: вывод в машиночитаемом формате.

Пример:

clawhub package undelete @openclaw/example-plugin --yes

package transfer <name>

• Передает пакет другому издателю.
• Требуется административный доступ и к текущему владельцу пакета, и к целевому издателю, если действие не выполняется администратором платформы.
• Имена пакетов с областью должны передаваться соответствующему владельцу области.
• Вызывает POST /api/v1/packages/{name}/transfer.
• Флаги:
  • --to <owner>: имя целевого издателя.
  • --reason <text>: необязательная причина для аудита.
  • --json: вывод в машиночитаемом формате.

Пример:

clawhub package transfer @openclaw/example-plugin --to openclaw

package report

• Аутентифицированная команда для жалобы на пакет модераторам.
• Вызывает POST /api/v1/packages/{name}/report.
• Жалобы относятся к уровню пакета, при необходимости привязываются к версии и становятся видимыми модераторам для рассмотрения.
• Жалобы сами по себе не скрывают пакеты автоматически и не блокируют скачивания.
• Флаги:
  • --version <version>: необязательная версия пакета для прикрепления к жалобе.
  • --reason <text>: обязательная причина жалобы.
  • --json: вывод в машиночитаемом формате.

Пример:

clawhub package report @openclaw/example-plugin --version 1.2.3 --reason "suspicious native payload"

package moderation-status

• Команда владельца для проверки видимости модерации пакета.
• Вызывает GET /api/v1/packages/{name}/moderation.
• Показывает текущее состояние сканирования пакета, число открытых жалоб, состояние ручной модерации последнего выпуска, состояние блокировки скачивания и причины модерации.
• Флаги:
  • --json: вывод в машиночитаемом формате.

Пример:

clawhub package moderation-status @openclaw/example-plugin

package readiness <name>

• Проверяет, готов ли пакет к будущему использованию OpenClaw.
• Вызывает GET /api/v1/packages/{name}/readiness.
• Сообщает блокирующие факторы для официального статуса, доступности ClawPack, дайджеста артефакта, происхождения исходного кода, совместимости с OpenClaw, целевых сред хоста, метаданных окружения и состояния сканирования.
• Флаги:
  • --json: вывод в машиночитаемом формате.

Пример:

clawhub package readiness @openclaw/example-plugin

package migration-status <name>

• Показывает ориентированное на оператора состояние миграции для пакета, который может заменить встроенный OpenClaw plugin.
• Вызывает ту же вычисляемую конечную точку готовности, что и package readiness, но выводит состояние с фокусом на миграцию, последнюю версию, состояние официального пакета, проверки и блокирующие факторы.
• Флаги:
  • --json: вывод в машиночитаемом формате.

Пример:

clawhub package migration-status @openclaw/example-plugin

publisher create <handle>

• Создает издателя организации, принадлежащего аутентифицированному пользователю.
• Имя нормализуется к нижнему регистру и может передаваться с @ или без него.
• Новые издатели организаций по умолчанию не являются доверенными/официальными.
• Завершается ошибкой, если имя уже используется существующим издателем, пользователем или зарезервированным маршрутом.

clawhub publisher create opik --display-name "Opik"

package publish <source>

• Публикует кодовый плагин или пакетный плагин через POST /api/v1/packages.
• <source> принимает:
  • Путь к локальной папке: ./my-plugin
  • Локальный tarball npm-pack ClawPack: ./my-plugin-1.2.3.tgz
  • Репозиторий GitHub: owner/repo или owner/repo@ref
  • URL GitHub: https://github.com/owner/repo
• Метаданные автоматически определяются из package.json, openclaw.plugin.json и реальных маркеров пакета OpenClaw, таких как .codex-plugin/plugin.json, .claude-plugin/plugin.json и .cursor-plugin/plugin.json.
• Источники .tgz обрабатываются как ClawPack. CLI загружает точные байты npm-pack и использует извлеченное содержимое package/ только для проверки и предварительного заполнения метаданных.
• Папки кодовых плагинов упаковываются в npm-tarball ClawPack перед загрузкой, чтобы установки OpenClaw могли проверить точный артефакт. Папки пакетных плагинов по-прежнему используют путь публикации извлеченных файлов.
• Для источников GitHub атрибуция источника автоматически заполняется из репозитория, разрешенного коммита, ref и подпути.
• Для локальных папок атрибуция источника автоматически определяется из локального git, когда удаленный origin указывает на GitHub.
• Внешние кодовые плагины должны явно объявлять openclaw.compat.pluginApi и openclaw.build.openclawVersion. Верхнеуровневый package.json.version не используется как запасной вариант для проверки публикации.
• --dry-run предварительно показывает разрешенную полезную нагрузку публикации без загрузки.
• --json выводит машиночитаемый результат для CI.
• --owner <handle> публикует под handle издателя пользователя или организации, когда у действующего лица есть доступ издателя.
• Имена пакетов со scope должны соответствовать выбранному владельцу. См. docs/publishing.md.
• Существующие флаги (--family, --name, --version, --source-repo, --source-commit, --source-ref, --source-path) по-прежнему работают как переопределения.
• Для приватных репозиториев GitHub требуется GITHUB_TOKEN.

clawhub package publish ./plugin.tgz --owner openclaw

Рекомендуемый локальный процесс

Сначала используйте --dry-run, чтобы подтвердить разрешенные метаданные пакета и атрибуцию источника перед созданием реального выпуска:

npm packclawhub package publish ./my-plugin-1.2.3.tgz --family code-plugin --dry-runclawhub package publish ./my-plugin-1.2.3.tgz --family code-plugin

Процесс для локальной папки

Для кодовых плагинов публикация папки собирает и загружает артефакт ClawPack из папки пакета:

clawhub package publish ./my-plugin --family code-plugin --dry-runclawhub package publish ./my-plugin --family code-plugin

Минимальный package.json для --family code-plugin

Внешним кодовым плагинам требуется небольшой объем метаданных OpenClaw в package.json. Этого минимального манифеста достаточно для успешной публикации:

{  "name": "@myorg/openclaw-my-plugin",  "version": "1.0.0",  "type": "module",  "openclaw": {    "extensions": ["./index.ts"],    "compat": {      "pluginApi": ">=2026.3.24-beta.2"    },    "build": {      "openclawVersion": "2026.3.24-beta.2"    }  }}

Обязательные поля:

• openclaw.compat.pluginApi
• openclaw.build.openclawVersion

Примечания:

• package.json.version — это версия выпуска вашего пакета, но она не используется как запасной вариант для проверки совместимости/сборки OpenClaw.
• openclaw.hostTargets и openclaw.environment — необязательные метаданные. ClawHub может отображать их при наличии, но они не обязательны для публикации.
• openclaw.compat.minGatewayVersion и openclaw.build.pluginSdkVersion — необязательные дополнительные поля, если вы хотите опубликовать более подробные метаданные совместимости.
• Если вы используете более старый выпуск CLI clawhub, обновитесь перед публикацией, чтобы локальные предварительные проверки выполнялись до загрузки.
• Если проверка сообщает код исправления, см. Исправления проверки Plugin.

GitHub Actions

ClawHub также поставляет официальный переиспользуемый workflow по адресу /.github/workflows/package-publish.yml для репозиториев плагинов.

Типичная настройка вызывающего workflow:

name: Package Publish on:  pull_request:  workflow_dispatch:  push:    tags:      - "v*" jobs:  dry-run:    if: github.event_name == 'pull_request'    uses: openclaw/clawhub/.github/workflows/package-publish.yml@v0.12.0    with:      dry_run: true   publish:    if: github.event_name == 'workflow_dispatch' || startsWith(github.ref, 'refs/tags/')    permissions:      contents: read      id-token: write    uses: openclaw/clawhub/.github/workflows/package-publish.yml@v0.12.0    with:      dry_run: false    secrets:      clawhub_token: ${{ secrets.CLAWHUB_TOKEN }}

Примечания:

• Переиспользуемый workflow по умолчанию задает source как вызывающий репозиторий.
• Для монорепозиториев передайте source_path, чтобы workflow опубликовал папку пакета плагина, например source_path: extensions/codex.
• Закрепляйте переиспользуемый workflow на стабильном теге или полном SHA коммита. Не запускайте публикацию релиза из @main.
• pull_request должен использовать dry_run: true, чтобы CI не создавала загрязняющих изменений.
• Реальные публикации должны быть ограничены доверенными событиями, такими как workflow_dispatch или push тегов.
• Доверенная публикация без секрета работает только на workflow_dispatch; для push тегов по-прежнему нужен clawhub_token.
• Держите clawhub_token доступным для первой публикации, недоверенных пакетов или аварийных публикаций.
• Workflow загружает результат JSON как артефакт и предоставляет его как выходные данные workflow.

package trusted-publisher get <name>

• Показывает конфигурацию доверенного издателя GitHub Actions для пакета.
• Используйте это после задания конфигурации, чтобы подтвердить репозиторий, имя файла workflow и необязательную привязку environment.
• Флаги:
  • --json: машиночитаемый вывод.

Пример:

clawhub package trusted-publisher get @openclaw/example-plugin

package trusted-publisher set <name>

• Прикрепляет или заменяет конфигурацию доверенного издателя GitHub Actions для существующего пакета.
• Пакет сначала должен быть создан через обычную ручную или token-authenticated clawhub package publish.
• После задания конфигурации будущие поддерживаемые публикации GitHub Actions могут использовать OIDC/доверенную публикацию без долгоживущего токена ClawHub.
• --repository <repo> должен быть owner/repo.
• --workflow-filename <file> должен совпадать с именем файла workflow в .github/workflows/.
• --environment <name> необязателен. Если он настроен, environment GitHub Actions в утверждении OIDC должен точно совпадать.
• ClawHub проверяет настроенный репозиторий GitHub при выполнении этой команды. Публичные репозитории можно проверить через публичные метаданные GitHub. Для приватных репозиториев ClawHub должен иметь доступ GitHub к этому репозиторию, например через будущую установку GitHub App ClawHub или другую авторизованную интеграцию GitHub.
• Флаги:
  • --repository <repo>: репозиторий GitHub, например openclaw/example-plugin.
  • --workflow-filename <file>: имя файла workflow, например package-publish.yml.
  • --environment <name>: необязательный environment GitHub Actions с точным совпадением.
  • --json: машиночитаемый вывод.

Пример:

clawhub package trusted-publisher set @openclaw/example-plugin \  --repository openclaw/example-plugin \  --workflow-filename package-publish.yml \  --environment release

package trusted-publisher delete <name>

• Удаляет конфигурацию доверенного издателя из пакета.
• Используйте это как откат, если workflow, репозиторий или привязку environment нужно отключить или создать заново.
• Будущие реальные публикации должны использовать обычную аутентифицированную публикацию, пока конфигурация не будет задана снова.
• Флаги:
  • --json: машиночитаемый вывод.

Пример:

clawhub package trusted-publisher delete @openclaw/example-plugin

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

• Отправляется после clawhub install <slug> при выполненном входе, если только не задано CLAWHUB_DISABLE_TELEMETRY=1.
• Отправка выполняется по принципу best-effort. Команды установки не завершаются с ошибкой, если телеметрия недоступна.
• Подробности: docs/telemetry.md.