> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Cli # CLI Пакет CLI: `clawhub`, bin: `clawhub`. Установите его глобально с помощью npm или pnpm: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} npm i -g clawhub # or pnpm add -g clawhub ``` Затем проверьте его: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub --help clawhub login clawhub whoami ``` ## Глобальные флаги * `--workdir `: рабочий каталог (по умолчанию: cwd; откатывается к рабочей области Clawdbot, если она настроена) * `--dir `: каталог установки внутри workdir (по умолчанию: `skills`) * `--site `: базовый URL для входа через браузер (по умолчанию: `https://clawhub.ai`) * `--registry `: базовый 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 с доступом в интернет только через прокси, корпоративные межсетевые экраны). Пример: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} export HTTPS_PROXY=http://proxy.example.com:3128 export NO_PROXY=localhost,127.0.0.1 clawhub 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` * По умолчанию: открывает браузер на `/cli/auth` и завершает вход через callback loopback. * Headless: `clawhub login --token clh_...` * Удаленный/headless интерактивный режим: `clawhub login --device` печатает код и ожидает, пока вы авторизуете его на `/cli/device`. ### `whoami` * Проверяет сохраненный токен через `/api/v1/whoami`. ### `token` * Печатает сохраненный API-токен в stdout. * Полезно для передачи локального токена входа в команды настройки секретов CI через pipe. ### `star ` / `unstar ` * Добавляет/удаляет skill из ваших избранных. * Вызывает `POST /api/v1/stars/` и `DELETE /api/v1/stars/`. * `--yes` пропускает подтверждение. ### `search ` * Вызывает `/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 ` (1-200, по умолчанию: 25) * `--sort newest|updated|rating|downloads|trending` (по умолчанию: newest). Устаревшие псевдонимы сортировки установки по-прежнему работают для совместимости. * `--json` (машиночитаемый вывод) * Вывод: ` v ` (summary обрезается до 50 символов). ### `inspect @owner/slug` * Получает метаданные skill и файлы версии без установки. * `--version `: проверить конкретную версию (по умолчанию: latest). * `--tag `: проверить версию с тегом (например, `latest`). * `--versions`: вывести историю версий (первая страница). * `--limit `: максимальное число версий в списке (1-200). * `--files`: вывести список файлов для выбранной версии. * `--file `: получить исходное содержимое файла (только текстовые файлы; лимит 200 КБ). * `--json`: машиночитаемый вывод. ### `install @owner/slug` * Определяет последнюю версию для указанного владельца и skill. * Загружает zip через `/api/v1/download`. * Извлекает в `//`. * Отказывается перезаписывать закрепленные skills; сначала выполните `clawhub unpin `. * Записывает: * `/.clawhub/lock.json` (устаревший `.clawdhub`) * `/.clawhub/origin.json` (устаревший `.clawdhub`) ### `uninstall ` * Удаляет `//` и удаляет запись из lockfile. * Отправляет телеметрию best-effort, если выполнен вход, чтобы текущие счетчики установок можно было деактивировать. * Интерактивный режим: запрашивает подтверждение. * Неинтерактивный режим (`--no-input`): требует `--yes`. ### `list` * Читает `/.clawhub/lock.json` (устаревший `.clawdhub`). * Показывает `pinned` рядом со skills, замороженными через `clawhub pin`, включая необязательную причину. ### `pin ` * Помечает установленный skill как закрепленный в lockfile. * `--reason ` записывает, почему skill заморожен. * Закрепленные skills пропускаются `update --all` и отклоняются прямым `update `. * Закрепленные skills также отклоняют `install --force`, чтобы локальные байты нельзя было случайно заменить. ### `unpin ` * Удаляет закрепление из lockfile для установленного skill, чтобы будущие обновления могли его изменить. ### `update [@owner/slug]` / `update --all` * Вычисляет fingerprint из локальных файлов. * Если fingerprint совпадает с известной версией: без запроса. * Если fingerprint не совпадает: * отказывается по умолчанию * перезаписывает с `--force` (или по запросу, если интерактивно) * Закрепленные skills никогда не обновляются через `--force`. * `update ` быстро завершается с ошибкой для закрепленных skills и предлагает сначала выполнить `clawhub unpin `. * `update --all` пропускает закрепленные slug и печатает сводку о том, что осталось замороженным. ### `skill publish ` * Сравнивает fingerprint локального bundle с ClawHub и успешно завершается, когда содержимое уже опубликовано. * Для новых skills по умолчанию используется `1.0.0`; для измененных skills по умолчанию используется следующая patch version. * `--version ` явно выбирает версию и публикует, даже когда содержимое совпадает с существующей версией. * `--dry-run` выполняет разрешение публикации без загрузки; `--json` печатает машиночитаемый результат. * `--owner ` публикует под handle издателя организации/пользователя, когда actor имеет доступ издателя. * `--migrate-owner` переносит существующий skill в `--owner`, одновременно публикуя новую версию. Требует доступа admin/owner у обоих издателей. * Поведение владельца и ревью объясняется в `docs/publishing.md`. * Публикация skill означает, что он выпускается на ClawHub под `MIT-0`. * Опубликованные skills можно свободно использовать, изменять и распространять без указания авторства. * ClawHub не поддерживает платные skills или pricing для отдельных skills. * Устаревший псевдоним: `publish `. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub skill publish ./my-skill --dry-run clawhub skill publish ./my-skill clawhub skill publish ./my-skill --version 2.0.0 ``` #### GitHub Actions Переиспользуемый workflow ClawHub [`skill-publish.yml`](https://github.com/openclaw/clawhub/blob/main/.github/workflows/skill-publish.yml) вызывает `skill publish` для одного `skill_path` или для каждой непосредственной папки skill под `root` (по умолчанию: `skills`). Он пропускает неизмененные skills и использует то же поведение автоматической patch-версии. Установите `dry_run: true` для предварительного просмотра без токена. Реальные публикации требуют секрет `clawhub_token`. ### `sync` * Сканирует текущий workdir, настроенный каталог skills и любые папки `--root ` на наличие локальных папок 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 издателя организации/пользователя, когда actor имеет доступ издателя. * `sync` — только односторонняя публикация. Он не устанавливает, не обновляет, не скачивает и не сообщает телеметрию установок/скачиваний. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub sync --all --dry-run clawhub sync --all clawhub sync --root ./skills --owner openclaw --bump minor ``` ### `scan --slug ` * Требует `clawhub login`. * Запускает ClawHub ClawScan через `POST /api/v1/skills/-/scan`, затем опрашивает до терминального состояния сканирования. * Сканирования асинхронны и могут занимать время. Пока задача в очереди, terminal spinner показывает текущую приоритетную позицию сканирования и сколько сканирований впереди. * Опубликованные сканирования требуют права собственности или управленческого доступа издателя. Модераторы/admins могут использовать тот же backend через `clawhub-admin`. * `--update` допустим только с `--slug`; он записывает успешные результаты опубликованного сканирования обратно в выбранную версию. * `--output ` скачивает полный архив отчета с `manifest.json`, `clawscan.json`, `skillspector.json`, `static-analysis.json`, `virustotal.json` и `README.md`. * `--json` печатает полный ответ опроса для автоматизации. * Сканирования локального пути больше не поддерживаются. Загрузите новую версию, затем используйте `scan download`, чтобы получить сохраненные результаты сканирования для этой отправленной версии. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub scan --slug gifgrep clawhub scan --slug gifgrep --version 1.2.3 clawhub scan --slug gifgrep --update --output report.zip ``` ### `scan download ` * Требует `clawhub login`. * Скачивает сохраненный ZIP-отчет сканирования для отправленной версии skill или plugin, включая версии, заблокированные или скрытые проверками безопасности ClawHub. * Загрузки skill используют slug skill и по умолчанию `--kind skill`. * Загрузки plugin используют имя пакета и требуют `--kind plugin`. * `--version` обязателен, чтобы авторы проверяли точную отправленную версию, которую ClawHub заблокировал. * `--output ` выбирает путь назначения. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub scan download gifgrep --version 1.2.3 clawhub scan download @scope/demo --version 2.0.0 --kind plugin --output report.zip ``` #### GitHub Actions ClawHub поставляет официальный переиспользуемый workflow по адресу [`/.github/workflows/skill-publish.yml`](https://github.com/openclaw/clawhub/blob/f96ae4a54ec9b72177220d4db601ebc0ddf5a1fd/.github/workflows/skill-publish.yml) для репозиториев skills и каталогов. Типичная настройка каталога: ```yaml theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 ` * Без `--version` мягко удаляет навык (владелец, модератор или администратор). * Вызывает `DELETE /api/v1/skills/{slug}`. * Мягкие удаления, инициированные владельцем, резервируют короткое имя на 30 дней; команда выводит время истечения срока. * `--version ` безвозвратно удаляет одну принадлежащую владельцу версию, не являющуюся последней, через маршрут для конкретной версии, который при сбое отказывает в доступе. Удаленные версии нельзя восстановить или опубликовать заново. Опубликуйте замену перед удалением текущей последней версии. Сотрудники платформы не обходят проверку владения для этого потока только для версии. * `--reason ` записывает модераторскую заметку для мягкого удаления всего навыка и журнала аудита. * `--note ` является псевдонимом для `--reason`. * `--yes` пропускает подтверждение. ### `undelete ` * Восстановить скрытый навык (владелец, модератор или администратор). * Восстановления версии нет; безвозвратно удаленные версии нельзя восстановить. * Вызывает `POST /api/v1/skills/{slug}/undelete`. * `--reason ` записывает модераторскую заметку для навыка и журнала аудита. * `--note ` является псевдонимом для `--reason`. * `--yes` пропускает подтверждение. ### `hide ` * Скрыть навык (владелец, модератор или администратор). * Псевдоним для `delete`. ### `unhide ` * Отобразить навык (владелец, модератор или администратор). * Псевдоним для `undelete`. ### `skill rename ` * Переименовать принадлежащий владельцу навык и сохранить прежнее короткое имя как псевдоним перенаправления. * Вызывает `POST /api/v1/skills/{slug}/rename`. * `--yes` пропускает подтверждение. ### `skill merge ` * Объединить один принадлежащий владельцу навык с другим принадлежащим владельцу навыком. * Исходное короткое имя перестает отображаться публично и становится псевдонимом перенаправления на целевой навык. * Вызывает `POST /api/v1/skills/{sourceSlug}/merge`. * `--yes` пропускает подтверждение. ### `transfer` * Рабочий процесс передачи владения. * Передачи на пользовательские имена создают ожидающий запрос, который получатель принимает. * Передачи на имена организаций/издателей применяются сразу только когда у действующего пользователя есть административный доступ и к текущему владельцу, и к целевому издателю. * Подкоманды: * `transfer request [--message "..."] [--yes]` * `transfer list [--outgoing]` * `transfer accept [--yes]` * `transfer reject [--yes]` * `transfer cancel [--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 `, `--os `, `--arch `, `--libc ` * `--requires-browser`, `--requires-desktop`, `--requires-native-deps` * `--requires-external-service`, `--external-service ` * `--binary `, `--os-permission ` * `--artifact-kind legacy-zip|npm-pack` * `--npm-mirror` * `--limit ` (1-100, по умолчанию: 25) * `--json` Примеры: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package explore --family code-plugin clawhub package explore --family code-plugin --os darwin --requires-desktop clawhub package explore --family code-plugin --artifact-kind npm-pack clawhub package explore --npm-mirror clawhub package explore episodic-claw --family code-plugin ``` ### `package inspect ` * Получает метаданные пакета без установки. * Используйте это для метаданных Plugin, совместимости, проверки, исходного кода и просмотра версий/файлов. * `--version `: проверить конкретную версию (по умолчанию: последнюю). * `--tag `: проверить версию с тегом (например, `latest`). * `--versions`: вывести историю версий (первая страница). * `--limit `: максимальное число версий для вывода (1-100). * `--files`: вывести файлы для выбранной версии. * `--file `: получить необработанное содержимое файла (только текстовые файлы; ограничение 200 КБ). * `--json`: вывод в машиночитаемом формате. ### `package download ` * Разрешает версию пакета через `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 `: скачать конкретную версию. * `--tag `: скачать версию с тегом (по умолчанию: `latest`). * `-o, --output `: выходной файл или каталог. * `--force`: перезаписать существующий выходной файл. * `--json`: вывод в машиночитаемом формате. Примеры: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package download @openclaw/example-plugin --tag latest clawhub package download @openclaw/example-plugin --version 1.2.3 -o artifacts/ ``` ### `package verify ` * Вычисляет ClawHub SHA-256, целостность npm `sha512` и npm shasum для локального артефакта. * С `--package` разрешает ожидаемые метаданные из ClawHub и сравнивает локальный файл с опубликованными метаданными артефакта. * С прямыми флагами дайджеста проверяет без сетевого запроса. * Флаги: * `--package `: имя пакета для разрешения ожидаемых метаданных артефакта. * `--version ` или `--tag `: ожидаемая версия пакета. * `--sha256 `: ожидаемый ClawHub SHA-256. * `--npm-integrity `: ожидаемая целостность npm. * `--npm-shasum `: ожидаемый npm shasum. * `--json`: вывод в машиночитаемом формате. Примеры: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package verify ./example-plugin-1.2.3.tgz --package @openclaw/example-plugin --version 1.2.3 clawhub package verify ./example-plugin-1.2.3.tgz --sha256 ``` ### `package validate ` * Запускает встроенный в ClawHub CLI инспектор Plugin для локальной папки пакета Plugin. * По умолчанию выполняет автономную/статическую проверку, без поиска или импорта локальной рабочей копии OpenClaw. * При критических ошибках совместимости команда завершается с ненулевым кодом. Замечания только уровня предупреждения выводятся, но команда завершается с нулевым кодом. * Флаги: * `--out `: записать отчеты инспектора Plugin в этот каталог. * `--openclaw `: проверять относительно явной локальной рабочей копии OpenClaw. * `--runtime`: включить захват среды выполнения; импортирует код Plugin. * `--allow-execute`: разрешить захват среды выполнения в изолированном рабочем пространстве. * `--no-mock-sdk`: отключить имитированный OpenClaw SDK во время захвата среды выполнения. * `--json`: вывод в машиночитаемом формате. Пример: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package validate ./example-plugin ``` Если проверка сообщает о проблеме пакета, манифеста, импорта SDK или артефакта, см. [исправления проверки Plugin](/ru/clawhub/plugin-validation-fixes), затем запустите команду повторно. ### `package delete ` * Без `--version` мягко удаляет пакет и все выпуски. * `--version ` безвозвратно удаляет один принадлежащий владельцу выпуск, не являющийся последним, через маршрут для конкретной версии, который при сбое отказывает в доступе. Удаленные версии нельзя восстановить или опубликовать заново. Опубликуйте замену перед удалением текущей последней версии. Для этого потока только для версии требуется владелец пакета или администратор издателя организации; сотрудники платформы не обходят владение пакетом. * Мягкое удаление всего пакета требует владельца пакета, владельца/администратора издателя организации, модератора платформы или администратора платформы. * Флаги: * `--version `: безвозвратно удалить одну версию, не являющуюся последней. * `--yes`: пропустить подтверждение. * `--json`: вывод в машиночитаемом формате. Пример: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package delete @openclaw/example-plugin --yes clawhub package delete @openclaw/example-plugin --version 1.2.3 --yes ``` ### `package undelete ` * Восстанавливает мягко удаленный пакет и выпуски. * Восстановления версии нет; безвозвратно удаленные версии нельзя восстановить. * Требуется владелец пакета, владелец/администратор издателя организации, модератор платформы или администратор платформы. * Вызывает `POST /api/v1/packages/{name}/undelete`. * Флаги: * `--yes`: пропустить подтверждение. * `--json`: вывод в машиночитаемом формате. Пример: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package undelete @openclaw/example-plugin --yes ``` ### `package transfer ` * Передает пакет другому издателю. * Требуется административный доступ и к текущему владельцу пакета, и к целевому издателю, если действие не выполняется администратором платформы. * Имена пакетов с областью должны передаваться соответствующему владельцу области. * Вызывает `POST /api/v1/packages/{name}/transfer`. * Флаги: * `--to `: имя целевого издателя. * `--reason `: необязательная причина для аудита. * `--json`: вывод в машиночитаемом формате. Пример: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package transfer @openclaw/example-plugin --to openclaw ``` ### `package report` * Аутентифицированная команда для жалобы на пакет модераторам. * Вызывает `POST /api/v1/packages/{name}/report`. * Жалобы относятся к уровню пакета, при необходимости привязываются к версии и становятся видимыми модераторам для рассмотрения. * Жалобы сами по себе не скрывают пакеты автоматически и не блокируют скачивания. * Флаги: * `--version `: необязательная версия пакета для прикрепления к жалобе. * `--reason `: обязательная причина жалобы. * `--json`: вывод в машиночитаемом формате. Пример: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package report @openclaw/example-plugin --version 1.2.3 --reason "suspicious native payload" ``` ### `package moderation-status` * Команда владельца для проверки видимости модерации пакета. * Вызывает `GET /api/v1/packages/{name}/moderation`. * Показывает текущее состояние сканирования пакета, число открытых жалоб, состояние ручной модерации последнего выпуска, состояние блокировки скачивания и причины модерации. * Флаги: * `--json`: вывод в машиночитаемом формате. Пример: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package moderation-status @openclaw/example-plugin ``` ### `package readiness ` * Проверяет, готов ли пакет к будущему использованию OpenClaw. * Вызывает `GET /api/v1/packages/{name}/readiness`. * Сообщает блокирующие факторы для официального статуса, доступности ClawPack, дайджеста артефакта, происхождения исходного кода, совместимости с OpenClaw, целевых сред хоста, метаданных окружения и состояния сканирования. * Флаги: * `--json`: вывод в машиночитаемом формате. Пример: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package readiness @openclaw/example-plugin ``` ### `package migration-status ` * Показывает ориентированное на оператора состояние миграции для пакета, который может заменить встроенный OpenClaw plugin. * Вызывает ту же вычисляемую конечную точку готовности, что и `package readiness`, но выводит состояние с фокусом на миграцию, последнюю версию, состояние официального пакета, проверки и блокирующие факторы. * Флаги: * `--json`: вывод в машиночитаемом формате. Пример: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package migration-status @openclaw/example-plugin ``` ### `publisher create ` * Создает издателя организации, принадлежащего аутентифицированному пользователю. * Имя нормализуется к нижнему регистру и может передаваться с `@` или без него. * Новые издатели организаций по умолчанию не являются доверенными/официальными. * Завершается ошибкой, если имя уже используется существующим издателем, пользователем или зарезервированным маршрутом. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub publisher create opik --display-name "Opik" ``` ### `package publish ` * Публикует кодовый плагин или пакетный плагин через `POST /api/v1/packages`. * `` принимает: * Путь к локальной папке: `./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 издателя пользователя или организации, когда у действующего лица есть доступ издателя. * Имена пакетов со scope должны соответствовать выбранному владельцу. См. `docs/publishing.md`. * Существующие флаги (`--family`, `--name`, `--version`, `--source-repo`, `--source-commit`, `--source-ref`, `--source-path`) по-прежнему работают как переопределения. * Для приватных репозиториев GitHub требуется `GITHUB_TOKEN`. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package publish ./plugin.tgz --owner openclaw ``` #### Рекомендуемый локальный процесс Сначала используйте `--dry-run`, чтобы подтвердить разрешенные метаданные пакета и атрибуцию источника перед созданием реального выпуска: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} npm pack clawhub package publish ./my-plugin-1.2.3.tgz --family code-plugin --dry-run clawhub package publish ./my-plugin-1.2.3.tgz --family code-plugin ``` #### Процесс для локальной папки Для кодовых плагинов публикация папки собирает и загружает артефакт ClawPack из папки пакета: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package publish ./my-plugin --family code-plugin --dry-run clawhub package publish ./my-plugin --family code-plugin ``` #### Минимальный `package.json` для `--family code-plugin` Внешним кодовым плагинам требуется небольшой объем метаданных OpenClaw в `package.json`. Этого минимального манифеста достаточно для успешной публикации: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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](/ru/clawhub/plugin-validation-fixes). #### GitHub Actions ClawHub также поставляет официальный переиспользуемый workflow по адресу [`/.github/workflows/package-publish.yml`](https://github.com/openclaw/clawhub/blob/f96ae4a54ec9b72177220d4db601ebc0ddf5a1fd/.github/workflows/package-publish.yml) для репозиториев плагинов. Типичная настройка вызывающего workflow: ```yaml theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 ` * Показывает конфигурацию доверенного издателя GitHub Actions для пакета. * Используйте это после задания конфигурации, чтобы подтвердить репозиторий, имя файла workflow и необязательную привязку environment. * Флаги: * `--json`: машиночитаемый вывод. Пример: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package trusted-publisher get @openclaw/example-plugin ``` ### `package trusted-publisher set ` * Прикрепляет или заменяет конфигурацию доверенного издателя GitHub Actions для существующего пакета. * Пакет сначала должен быть создан через обычную ручную или token-authenticated `clawhub package publish`. * После задания конфигурации будущие поддерживаемые публикации GitHub Actions могут использовать OIDC/доверенную публикацию без долгоживущего токена ClawHub. * `--repository ` должен быть `owner/repo`. * `--workflow-filename ` должен совпадать с именем файла workflow в `.github/workflows/`. * `--environment ` необязателен. Если он настроен, environment GitHub Actions в утверждении OIDC должен точно совпадать. * ClawHub проверяет настроенный репозиторий GitHub при выполнении этой команды. Публичные репозитории можно проверить через публичные метаданные GitHub. Для приватных репозиториев ClawHub должен иметь доступ GitHub к этому репозиторию, например через будущую установку GitHub App ClawHub или другую авторизованную интеграцию GitHub. * Флаги: * `--repository `: репозиторий GitHub, например `openclaw/example-plugin`. * `--workflow-filename `: имя файла workflow, например `package-publish.yml`. * `--environment `: необязательный environment GitHub Actions с точным совпадением. * `--json`: машиночитаемый вывод. Пример: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package trusted-publisher set @openclaw/example-plugin \ --repository openclaw/example-plugin \ --workflow-filename package-publish.yml \ --environment release ``` ### `package trusted-publisher delete ` * Удаляет конфигурацию доверенного издателя из пакета. * Используйте это как откат, если workflow, репозиторий или привязку environment нужно отключить или создать заново. * Будущие реальные публикации должны использовать обычную аутентифицированную публикацию, пока конфигурация не будет задана снова. * Флаги: * `--json`: машиночитаемый вывод. Пример: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package trusted-publisher delete @openclaw/example-plugin ``` ### Телеметрия установки * Отправляется после `clawhub install ` при выполненном входе, если только не задано `CLAWHUB_DISABLE_TELEMETRY=1`. * Отправка выполняется по принципу best-effort. Команды установки не завершаются с ошибкой, если телеметрия недоступна. * Подробности: `docs/telemetry.md`.