> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ClawHub

# ClawHub

ClawHub — это **публичный реестр Skills для OpenClaw**. Это бесплатный сервис: все Skills являются публичными, открытыми и видимыми для всех — для обмена и повторного использования. Skill — это просто папка с файлом `SKILL.md` (плюс вспомогательные текстовые файлы). Вы можете просматривать Skills в веб‑приложении или использовать CLI для поиска, установки, обновления и публикации Skills.

Сайт: [clawhub.ai](https://clawhub.ai)

## Что такое ClawHub

* Публичный реестр Skills для OpenClaw.
* Версионируемое хранилище бандлов Skills и метаданных.
* Поверхность обнаружения для поиска, тегов и сигналов использования.

## Как это работает

1. Пользователь публикует бандл Skill (файлы + метаданные).
2. ClawHub сохраняет бандл, разбирает метаданные и назначает версию.
3. Реестр индексирует Skill для поиска и обнаружения.
4. Пользователи просматривают, загружают и устанавливают Skills в OpenClaw.

## Что вы можете делать

* Публиковать новые Skills и новые версии существующих Skills.
* Находить Skills по имени, тегам или поиску.
* Загружать бандлы Skills и просматривать их файлы.
* Сообщать о Skills, которые являются злоупотребляющими или небезопасными.
* Если вы модератор — скрывать, показывать, удалять или блокировать.

## Для кого это (подходит для начинающих)

Если вы хотите добавить новые возможности своему агенту OpenClaw, ClawHub — самый простой способ найти и установить Skills. Вам не нужно разбираться в устройстве бэкенда. Вы можете:

* Искать Skills на естественном языке.
* Устанавливать Skill в своё рабочее пространство.
* Обновлять Skills позже одной командой.
* Делать резервные копии собственных Skills, публикуя их.

## Быстрый старт (без технических деталей)

1. Установите CLI (см. следующий раздел).
2. Найдите то, что вам нужно:
   * `clawhub search "calendar"`
3. Установите Skill:
   * `clawhub install <skill-slug>`
4. Запустите новый сеанс OpenClaw, чтобы он подхватил новый Skill.

## Установка CLI

Выберите один вариант:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm i -g clawhub
```

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm add -g clawhub
```

## Как это вписывается в OpenClaw

По умолчанию CLI устанавливает Skills в `./skills` в вашем текущем рабочем каталоге. Если настроено рабочее пространство OpenClaw, `clawhub` использует его как резервный вариант, если вы не переопределили `--workdir` (или `CLAWHUB_WORKDIR`). OpenClaw загружает Skills рабочего пространства из `<workspace>/skills` и подхватывает их в **следующем** сеансе. Если вы уже используете `~/.openclaw/skills` или Skills из комплекта, Skills рабочего пространства имеют приоритет.

Для более подробной информации о том, как Skills загружаются, совместно используются и ограничиваются, см. [Skills](/tools/skills).

## Обзор системы Skills

Skill — это версионируемый бандл файлов, который обучает OpenClaw выполнению конкретной задачи. Каждая публикация создаёт новую версию, а реестр хранит историю версий, чтобы пользователи могли аудировать изменения.

Типичный Skill включает:

* Файл `SKILL.md` с основным описанием и инструкциями по использованию.
* Необязательные конфиги, скрипты или вспомогательные файлы, используемые Skill.
* Метаданные, такие как теги, краткое описание и требования к установке.

ClawHub использует метаданные для обеспечения обнаружения и безопасного раскрытия возможностей Skills.
Реестр также отслеживает сигналы использования (например, звёзды и загрузки) для улучшения ранжирования и видимости.

## Что предоставляет сервис (возможности)

* **Публичный просмотр** Skills и их содержимого `SKILL.md`.
* **Поиск** на базе эмбеддингов (векторный поиск), а не только по ключевым словам.
* **Версионирование** с semver, журналами изменений и тегами (включая `latest`).
* **Загрузки** в виде zip для каждой версии.
* **Звёзды и комментарии** для обратной связи от сообщества.
* **Инструменты модерации** для утверждений и аудитов.
* **API, дружественный к CLI**, для автоматизации и скриптов.

## Безопасность и модерация

ClawHub по умолчанию открыт. Любой может загружать Skills, однако для публикации учётная запись GitHub должна быть не младше одной недели. Это помогает замедлить злоупотребления, не блокируя добросовестных участников.

Сообщения и модерация:

* Любой вошедший пользователь может пожаловаться на Skill.
* Причины жалоб обязательны и фиксируются.
* У каждого пользователя может быть до 20 активных жалоб одновременно.
* Skills с более чем 3 уникальными жалобами автоматически скрываются по умолчанию.
* Модераторы могут просматривать скрытые Skills, показывать их, удалять или блокировать пользователей.
* Злоупотребление функцией жалоб может привести к блокировке аккаунта.

Хотите стать модератором? Спросите в Discord OpenClaw и свяжитесь с модератором или мейнтейнером.

## Команды и параметры CLI

Глобальные параметры (применяются ко всем командам):

* `--workdir <dir>`: Рабочий каталог (по умолчанию: текущий каталог; с резервным переходом к рабочему пространству OpenClaw).
* `--dir <dir>`: Каталог Skills, относительно workdir (по умолчанию: `skills`).
* `--site <url>`: Базовый URL сайта (вход через браузер).
* `--registry <url>`: Базовый URL API реестра.
* `--no-input`: Отключить запросы (неинтерактивный режим).
* `-V, --cli-version`: Вывести версию CLI.

Аутентификация:

* `clawhub login` (через браузер) или `clawhub login --token <token>`
* `clawhub logout`
* `clawhub whoami`

Параметры:

* `--token <token>`: Вставить токен API.
* `--label <label>`: Метка, сохраняемая для токенов входа через браузер (по умолчанию: `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 publish <path>`
* `--slug <slug>`: Slug Skill.
* `--name <name>`: Отображаемое имя.
* `--version <version>`: Версия semver.
* `--changelog <text>`: Текст журнала изменений (может быть пустым).
* `--tags <tags>`: Теги через запятую (по умолчанию: `latest`).

Удаление/восстановление (только владелец/администратор):

* `clawhub delete <slug> --yes`
* `clawhub undelete <slug> --yes`

Синхронизация (сканирование локальных Skills + публикация новых/обновлённых):

* `clawhub sync`
* `--root <dir...>`: Дополнительные корни сканирования.
* `--all`: Загрузить всё без запросов.
* `--dry-run`: Показать, что будет загружено.
* `--bump <type>`: `patch|minor|major` для обновлений (по умолчанию: `patch`).
* `--changelog <text>`: Журнал изменений для неинтерактивных обновлений.
* `--tags <tags>`: Теги через запятую (по умолчанию: `latest`).
* `--concurrency <n>`: Проверки реестра (по умолчанию: 4).

## Часто используемые рабочие процессы для агентов

### Поиск Skills

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub search "postgres backups"
```

### Загрузка новых Skills

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub install my-skill-pack
```

### Обновление установленных Skills

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub update --all
```

### Резервное копирование ваших Skills (публикация или синхронизация)

Для одной папки Skill:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
```

Для сканирования и резервного копирования множества Skills одновременно:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub sync --all
```

## Дополнительные сведения (технические)

### Версионирование и теги

* Каждая публикация создаёт новую **semver** `SkillVersion`.
* Теги (например, `latest`) указывают на версию; перемещение тегов позволяет откатываться.
* Журналы изменений привязываются к каждой версии и могут быть пустыми при синхронизации или публикации обновлений.

### Локальные изменения и версии реестра

Обновления сравнивают локальное содержимое Skill с версиями реестра с использованием хэша содержимого. Если локальные файлы не соответствуют ни одной опубликованной версии, CLI запрашивает подтверждение перед перезаписью (или требует `--force` в неинтерактивных запусках).

### Сканирование при синхронизации и резервные корни

`clawhub sync` сначала сканирует текущий workdir. Если Skills не найдены, используется резервный переход к известным устаревшим расположениям (например, `~/openclaw/skills` и `~/.openclaw/skills`). Это сделано для обнаружения старых установок Skills без дополнительных флагов.

### Хранилище и lockfile

* Установленные Skills записываются в `.clawhub/lock.json` в вашем workdir.
* Токены аутентификации хранятся в конфиге CLI ClawHub (переопределяется через `CLAWHUB_CONFIG_PATH`).

### Телеметрия (счётчики установок)

Когда вы запускаете `clawhub sync` в состоянии входа, CLI отправляет минимальный снимок для расчёта количества установок. Вы можете полностью отключить это:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export CLAWHUB_DISABLE_TELEMETRY=1
```

## Переменные окружения

* `CLAWHUB_SITE`: Переопределить URL сайта.
* `CLAWHUB_REGISTRY`: Переопределить URL API реестра.
* `CLAWHUB_CONFIG_PATH`: Переопределить место хранения токена/конфига CLI.
* `CLAWHUB_WORKDIR`: Переопределить рабочий каталог по умолчанию.
* `CLAWHUB_DISABLE_TELEMETRY=1`: Отключить телеметрию для `sync`.