Устранение неполадок

clawhub login открывает браузер, но не завершается

CLI запускает кратковременный локальный сервер обратного вызова во время входа через браузер.

• Убедитесь, что браузер может открыть http://127.0.0.1:<port>/callback.
• Проверьте правила локального брандмауэра, VPN и прокси, если обратный вызов не приходит.
• В средах без графического интерфейса создайте API-токен в веб-интерфейсе ClawHub и выполните:

clawhub login --token clh_...

whoami или publish возвращает Unauthorized (401)

• Войдите снова с помощью clawhub login.
• Если вы используете пользовательский путь к конфигурации, убедитесь, что CLAWHUB_CONFIG_PATH указывает на файл, содержащий ваш текущий токен.
• Если вы используете API-токен, убедитесь, что он не был отозван в веб-интерфейсе.

Поиск или установка возвращает Rate limit exceeded (429)

Прочитайте информацию о повторной попытке в ответе:

• Retry-After: сколько секунд ждать перед повторной попыткой.
• RateLimit-Limit: лимит, примененный к этому запросу.
• RateLimit-Remaining: ваш точный оставшийся бюджет, если заголовок присутствует. При 429 он равен 0.
• RateLimit-Reset или X-RateLimit-Reset: время сброса.

Если много пользователей используют один исходящий IP-адрес, анонимные IP-лимиты могут сработать, даже когда каждый человек отправляет только несколько запросов. По возможности войдите в систему и повторите попытку после указанной задержки.

Поиск или установка не работает за прокси

CLI учитывает стандартные переменные прокси:

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

Поддерживаемые имена включают HTTPS_PROXY, HTTP_PROXY, https_proxy и http_proxy.

Навык не отображается в поиске

• Проверьте точный slug или страницу владельца, если они вам известны.
• Убедитесь, что релиз публичный и не удерживается сканированием или модерацией.
• Если вы владеете навыком, войдите в систему и проверьте его:

clawhub inspect @openclaw/demo

Диагностика, видимая владельцу, может объяснить состояние сканирования, ограничения загрузки или модерации.

Публикация не удается из-за отсутствия обязательных метаданных

Для навыков проверьте frontmatter в SKILL.md. Обязательные переменные окружения и инструменты должны быть объявлены, чтобы пользователи и сканеры могли понять пакет.

Для Plugin проверьте метаданные совместимости в package.json. Публикациям code-plugin нужны поля совместимости OpenClaw, такие как openclaw.compat.pluginApi и openclaw.build.openclawVersion.

Сначала просмотрите полезную нагрузку публикации:

clawhub package publish <source> --family code-plugin --dry-run

Публикация не удается из-за ошибки владельца GitHub или источника

ClawHub использует идентичность GitHub и атрибуцию источника, чтобы связывать пакеты с их издателями.

• Убедитесь, что вы вошли с учетной записью GitHub, которая владеет пакетом или может его публиковать.
• Проверьте, что URL источника публичен или доступен для ClawHub.
• Для источников GitHub используйте owner/repo, owner/repo@ref или полный URL GitHub.

Публикация не удается, потому что пространство имен занято или зарезервировано

Если публикация не удается, потому что идентификатор владельца, пространство имен организации, область пакета, slug навыка или имя пакета уже заняты или зарезервированы, сначала убедитесь, что вы публикуете от имени владельца, соответствующего пространству имен. Для пакетов Plugin имена с областью, такие как @example-org/example-plugin, должны публиковаться от имени соответствующего владельца example-org.

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

sync сообщает, что навыки не найдены

sync ищет папки, содержащие SKILL.md или skill.md.

Укажите корневые папки, которые нужно просканировать:

clawhub sync --root /path/to/skills

Если вы не уверены, что будет опубликовано, сначала выполните предварительный просмотр:

clawhub sync --all --dry-run --no-input

update отказывается выполняться из-за локальных изменений

Локальные файлы не совпадают ни с одной версией, известной ClawHub. Выберите один вариант:

• Сохранить локальные правки и пропустить обновление.
• Перезаписать опубликованной версией:

clawhub update @openclaw/demo --force

• Опубликовать отредактированную копию с новым slug или как форк.

Установка Plugin в OpenClaw завершается ошибкой

• Используйте явный источник ClawHub:

openclaw plugins install clawhub:<package>

• Проверьте страницу сведений о пакете на наличие статуса сканирования и метаданных совместимости.
• Убедитесь, что ваша версия OpenClaw удовлетворяет заявленному пакетом диапазону совместимости.
• Если пакет скрыт, удерживается или заблокирован, он может быть недоступен для установки, пока владелец не решит проблему.

Запросы к публичному API завершаются ошибкой

• Учитывайте заголовки повторной попытки 429 и кэшируйте ответы публичных списков и поиска.
• Направляйте пользователей обратно к каноническому листингу ClawHub.
• Не зеркалируйте скрытый, приватный, удерживаемый или заблокированный модерацией контент вне публичной поверхности API.

См. HTTP API для подробностей об эндпоинтах.