Start here

Общее устранение неполадок

Если у вас есть только 2 минуты, используйте эту страницу как входную точку для триажа.

Первые 60 секунд

Выполните эту точную последовательность по порядку:

bash

openclaw statusopenclaw status --allopenclaw gateway probeopenclaw gateway statusopenclaw doctoropenclaw channels status --probeopenclaw logs --follow

Хороший вывод в одну строку:

openclaw status → показывает настроенные каналы и отсутствие очевидных ошибок аутентификации.
openclaw status --all → полный отчет присутствует и им можно поделиться.
openclaw gateway probe → ожидаемая цель Gateway доступна (Reachable: yes). Capability: ... показывает, какой уровень аутентификации смог подтвердить пробный запрос, а Read probe: limited - missing scope: operator.read означает ограниченную диагностику, а не сбой подключения.
openclaw gateway status → Runtime: running, Connectivity probe: ok и правдоподобная строка Capability: .... Используйте --require-rpc, если также нужно подтверждение RPC с областью чтения.
openclaw doctor → нет блокирующих ошибок конфигурации или сервиса.
openclaw channels status --probe → доступный Gateway возвращает живое состояние транспорта для каждой учетной записи, а также результаты проверки/аудита, такие как works или audit ok; если Gateway недоступен, команда переходит к сводкам только по конфигурации.
openclaw logs --follow → стабильная активность, нет повторяющихся фатальных ошибок.

Ассистент кажется ограниченным или не видит инструменты

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

bash

openclaw statusopenclaw status --allopenclaw doctor

Частые причины:

tools.profile: "messaging" намеренно узкий для агентов только с чатом.
tools.profile: "coding" — обычный профиль для рабочих процессов с репозиторием, файлами, shell и средой выполнения.
tools.profile: "full" открывает самый широкий набор инструментов и должен быть ограничен доверенными агентами под контролем оператора.
Переопределения agents.list[].tools для отдельных агентов могут сужать или расширять корневой профиль для одного агента.

Измените корневой профиль инструментов или профиль отдельного агента, затем перезапустите или перезагрузите Gateway и снова выполните openclaw status --all. См. Инструменты, чтобы узнать о модели профилей и переопределениях разрешений/запретов.

Длинный контекст Anthropic 429

Если вы видите: HTTP 429: rate_limit_error: Extra usage is required for long context requests, перейдите к /gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context.

Локальный OpenAI-совместимый бэкенд работает напрямую, но дает сбой в OpenClaw

Если ваш локальный или самостоятельно размещенный бэкенд /v1 отвечает на небольшие прямые проверки /v1/chat/completions, но дает сбой при openclaw infer model run или обычных ходах агента:

Если ошибка упоминает, что messages[].content ожидает строку, задайте models.providers.<provider>.models[].compat.requiresStringContent: true.
Если бэкенд по-прежнему дает сбой только на ходах агента OpenClaw, задайте models.providers.<provider>.models[].compat.supportsTools: false и повторите попытку.
Если крошечные прямые вызовы по-прежнему работают, но более крупные промпты OpenClaw приводят к падению бэкенда, считайте оставшуюся проблему ограничением вышестоящей модели/сервера и продолжайте по подробному регламенту: /gateway/troubleshooting#local-openai-compatible-backend-passes-direct-probes-but-agent-runs-fail

Установка Plugin завершается с ошибкой из-за отсутствующих расширений openclaw

Если установка завершается с ошибкой package.json missing openclaw.extensions, пакет plugin использует старую форму, которую OpenClaw больше не принимает.

Исправьте в пакете plugin:

Добавьте openclaw.extensions в package.json.
Направьте записи на собранные файлы среды выполнения, обычно ./dist/index.js.
Опубликуйте plugin заново и снова выполните openclaw plugins install <package>.

Пример:

json

{  "name": "@openclaw/my-plugin",  "version": "1.2.3",  "openclaw": {    "extensions": ["./dist/index.js"]  }}

Справка: Архитектура Plugin

Политика установки блокирует установки или обновления plugin

Если обновление завершается, но plugins остаются устаревшими, отключенными или показывают сообщения вроде blocked by install policy, install policy failed closed или Disabled "<plugin>" after plugin update failure, проверьте security.installPolicy.

Политика установки выполняется при установках и обновлениях plugin. Версии plugin, принадлежащих OpenClaw, обычно меняются вместе с выпуском OpenClaw, поэтому обновлению OpenClaw также могут потребоваться соответствующие обновления plugin @openclaw/* во время синхронизации после обновления.

Избегайте этих широких форм политик, если вы также не поддерживаете соответствующее правило обновления:

Заморозка plugin, принадлежащих OpenClaw, на одной точной старой версии, например разрешение только @openclaw/*@2026.5.3.
Блокировка только по типу источника, например каждый запрос plugin из npm, сети или с request.mode: "update".
Отношение к команде политики как к необязательной. Когда security.installPolicy включена, отсутствующий, медленный, нечитаемый или заблокированный правами исполняемый файл политики приводит к закрытому отказу.
Одобрение версий plugin без учета openclawVersion в запросе политики и метаданных кандидата plugin.

Более безопасные правила политики разрешают доверенные обновления plugin, принадлежащих OpenClaw, когда кандидат совместим с текущим хостом OpenClaw, вместо закрепления одного выпуска навсегда. Если вы блокируете npm по умолчанию, сделайте узкое исключение для доверенных пакетов plugin @openclaw/* или используемых вами идентификаторов plugin. Если вы различаете запросы установки и обновления, применяйте то же правило доверия к request.mode: "update".

Восстановление:

bash

openclaw doctor --deepopenclaw plugins update --allopenclaw status --all

Если политика намеренно строгая, ослабьте ее на доверенное окно обновления OpenClaw, снова выполните openclaw plugins update --all, затем восстановите более строгое правило. Если plugin был отключен после сбоя обновления, проверьте его и включайте заново только после успешного обновления:

bash

openclaw plugins inspect <plugin-id> --runtime --jsonopenclaw plugins enable <plugin-id>

Справка: Политика установки оператора

Plugin присутствует, но заблокирован из-за подозрительного владельца

Если openclaw doctor, настройка или предупреждения при запуске показывают:

text

blocked plugin candidate: suspicious ownership (... uid=1000, expected uid=0 or root)plugin present but blocked

файлы plugin принадлежат другому пользователю Unix, а не процессу, который их загружает. Не удаляйте конфигурацию plugin. Исправьте владельца файлов или запускайте OpenClaw от имени того же пользователя, которому принадлежит каталог состояния.

Установки Docker обычно запускаются как node (uid 1000). Для стандартной настройки Docker исправьте bind mounts хоста:

bash

sudo chown -R 1000:1000 /path/to/openclaw-config /path/to/openclaw-workspaceopenclaw doctor --fix

Если вы намеренно запускаете OpenClaw от root, вместо этого исправьте управляемый корень plugin на владельца root:

bash

sudo chown -R root:root /path/to/openclaw-config/npmopenclaw doctor --fix

Подробная документация:

Дерево решений

flowchart TD
  A[OpenClaw is not working] --> B{What breaks first}
  B --> C[No replies]
  B --> D[Dashboard or Control UI will not connect]
  B --> E[Gateway will not start or service not running]
  B --> F[Channel connects but messages do not flow]
  B --> G[Cron or heartbeat did not fire or did not deliver]
  B --> H[Node is paired but camera canvas screen exec fails]
  B --> I[Browser tool fails]

  C --> C1[/No replies section/]
  D --> D1[/Control UI section/]
  E --> E1[/Gateway section/]
  F --> F1[/Channel flow section/]
  G --> G1[/Automation section/]
  H --> H1[/Node tools section/]
  I --> I1[/Browser section/]

Нет ответов

bash

openclaw statusopenclaw gateway statusopenclaw channels status --probeopenclaw pairing list --channel <channel> [--account <id>]openclaw logs --follow

Хороший вывод выглядит так:

Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable или admin-capable
Ваш канал показывает, что транспорт подключен, а там, где поддерживается, works или audit ok в channels status --probe
Отправитель выглядит одобренным, либо политика DM открыта/использует allowlist

Частые сигнатуры журналов:

drop guild message (mention required → фильтр упоминаний заблокировал сообщение в Discord.
pairing request → отправитель не одобрен и ожидает одобрения сопряжения в DM.
blocked / allowlist в журналах канала → отправитель, комната или группа отфильтрованы.

Подробные страницы:

Панель мониторинга или Control UI не подключается

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Хороший вывод выглядит так:

Dashboard: http://... показан в openclaw gateway status
Connectivity probe: ok
Capability: read-only, write-capable или admin-capable
В журналах нет цикла аутентификации

Частые сигнатуры журналов:

device identity required → HTTP/небезопасный контекст не может завершить аутентификацию устройства.
origin not allowed → браузерный Origin не разрешен для цели Gateway Control UI.
AUTH_TOKEN_MISMATCH с подсказками о повторе (canRetryWithDeviceToken=true) → одна доверенная повторная попытка с device-token может произойти автоматически.
Этот повтор с кэшированным токеном повторно использует кэшированный набор областей, сохраненный вместе с сопряженным токеном устройства. Вызывающие стороны с явным deviceToken / явными scopes сохраняют вместо этого свой запрошенный набор областей.
На асинхронном пути Control UI Tailscale Serve неудачные попытки для одного и того же {scope, ip} сериализуются до того, как ограничитель зафиксирует сбой, поэтому вторая одновременная неверная повторная попытка уже может показать retry later.
too many failed authentication attempts (retry later) из браузерного источника localhost → повторные сбои из того же Origin временно заблокированы; другой источник localhost использует отдельную корзину.
повторяющееся unauthorized после этого повтора → неправильный токен/пароль, несоответствие режима аутентификации или устаревший сопряженный токен устройства.
gateway connect failed: → UI указывает на неправильный URL/порт или недоступный Gateway.

Подробные страницы:

Gateway не запускается или сервис установлен, но не работает

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Хороший вывод выглядит так:

Service: ... (loaded)
Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable или admin-capable

Частые сигнатуры журналов:

Gateway start blocked: set gateway.mode=local или existing config is missing gateway.mode → режим Gateway удаленный, либо в файле конфигурации отсутствует отметка локального режима и его нужно исправить.
refusing to bind gateway ... without auth → привязка не к local loopback без допустимого пути аутентификации Gateway: токен/пароль или trusted-proxy, если настроено.
another gateway instance is already listening или EADDRINUSE → порт уже занят.

Подробные страницы:

Канал подключается, но сообщения не проходят

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Хороший вывод выглядит так:

Транспорт канала подключен.
Проверки сопряжения/списка разрешенных проходят.
Упоминания обнаруживаются там, где они требуются.

Распространенные сигнатуры логов:

mention required → обработка заблокирована из-за требования упоминания в группе.
pairing / pending → отправитель DM еще не одобрен.
not_in_channel, missing_scope, Forbidden, 401/403 → проблема с токеном разрешений канала.

Подробные страницы:

Cron или Heartbeat не сработал или не доставил сообщение

bash

openclaw statusopenclaw gateway statusopenclaw cron statusopenclaw cron listopenclaw cron runs --id <jobId> --limit 20openclaw logs --follow

Хороший вывод выглядит так:

cron.status показывает, что Cron включен и есть следующее пробуждение.
cron runs показывает недавние записи ok.
Heartbeat включен и не находится вне активных часов.

Распространенные сигнатуры логов:

cron: scheduler disabled; jobs will not run automatically → Cron отключен.
heartbeat skipped с reason=quiet-hours → вне настроенных активных часов.
heartbeat skipped с reason=empty-heartbeat-file → HEARTBEAT.md существует, но содержит только пустые строки, комментарий, заголовок, ограждение блока или заготовку пустого списка задач.
heartbeat skipped с reason=no-tasks-due → режим задач HEARTBEAT.md активен, но ни один из интервалов задач еще не наступил.
heartbeat skipped с reason=alerts-disabled → вся видимость Heartbeat отключена (showOk, showAlerts и useIndicator выключены).
requests-in-flight → основная линия занята; пробуждение Heartbeat было отложено.
unknown accountId → целевая учетная запись доставки Heartbeat не существует.

Подробные страницы:

Node сопряжен, но инструмент camera canvas screen exec не работает

bash

openclaw statusopenclaw gateway statusopenclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw logs --follow

Хороший вывод выглядит так:

Node указан как подключенный и сопряженный для роли node.
Для вызываемой команды существует возможность.
Состояние разрешений для инструмента: предоставлено.

Распространенные сигнатуры логов:

NODE_BACKGROUND_UNAVAILABLE → переведите приложение узла на передний план.
*_PERMISSION_REQUIRED → разрешение ОС было отклонено или отсутствует.
SYSTEM_RUN_DENIED: approval required → ожидается одобрение exec.
SYSTEM_RUN_DENIED: allowlist miss → команды нет в списке разрешенных exec.

Подробные страницы:

Exec внезапно запрашивает одобрение

bash

openclaw config get tools.exec.hostopenclaw config get tools.exec.securityopenclaw config get tools.exec.askopenclaw gateway restart

Что изменилось:

Если tools.exec.host не задан, по умолчанию используется auto.
host=auto разрешается в sandbox, когда активна среда выполнения песочницы, иначе в gateway.
host=auto отвечает только за маршрутизацию; поведение "YOLO" без запросов подтверждения определяется security=full плюс ask=off на gateway/node.
На gateway и node незаданный tools.exec.security по умолчанию равен full.
Незаданный tools.exec.ask по умолчанию равен off.
Итог: если вы видите запросы одобрения, какая-то локальная для хоста или посеансовая политика ужесточила exec относительно текущих значений по умолчанию.

Восстановить текущее поведение по умолчанию без одобрений:

bash

openclaw config set tools.exec.host gatewayopenclaw config set tools.exec.security fullopenclaw config set tools.exec.ask offopenclaw gateway restart

Более безопасные альтернативы:

Задайте только tools.exec.host=gateway, если вам нужна только стабильная маршрутизация хоста.
Используйте security=allowlist с ask=on-miss, если вам нужен exec на хосте, но вы все еще хотите проверку при промахах по списку разрешенных.
Включите режим песочницы, если хотите, чтобы host=auto снова разрешался в sandbox.

Распространенные сигнатуры логов:

Approval required. → команда ожидает /approve ....
SYSTEM_RUN_DENIED: approval required → ожидается одобрение exec на узле-хосте.
exec host=sandbox requires a sandbox runtime for this session → выбран sandbox неявно или явно, но режим песочницы выключен.

Подробные страницы:

Инструмент Browser не работает

bash

openclaw statusopenclaw gateway statusopenclaw browser statusopenclaw logs --followopenclaw doctor

Хороший вывод выглядит так:

Статус Browser показывает running: true и выбранный браузер/профиль.
openclaw запускается, или user видит локальные вкладки Chrome.

Распространенные сигнатуры логов:

unknown command "browser" или unknown command 'browser' → plugins.allow задан и не включает browser.
Failed to start Chrome CDP on port → не удалось запустить локальный браузер.
browser.executablePath not found → настроенный путь к бинарному файлу неверен.
browser.cdpUrl must be http(s) or ws(s) → настроенный URL CDP использует неподдерживаемую схему.
browser.cdpUrl has invalid port → настроенный URL CDP содержит неверный или выходящий за диапазон порт.
No Chrome tabs found for profile="user" → профиль подключения Chrome MCP не имеет открытых локальных вкладок Chrome.
Remote CDP for profile "<name>" is not reachable → настроенная удаленная конечная точка CDP недоступна с этого хоста.
Browser attachOnly is enabled ... not reachable или Browser attachOnly is enabled and CDP websocket ... is not reachable → у профиля только для подключения нет живой цели CDP.
устаревшие переопределения области просмотра / темного режима / локали / офлайн-режима в профилях только для подключения или удаленного CDP → выполните openclaw browser stop --browser-profile <name>, чтобы закрыть активный сеанс управления и освободить состояние эмуляции без перезапуска gateway.

Подробные страницы:

Связанные материалы

FAQ — часто задаваемые вопросы
Устранение неполадок Gateway — проблемы, специфичные для Gateway
Doctor — автоматические проверки работоспособности и исправления
Устранение неполадок каналов — проблемы с подключением каналов
Устранение неполадок автоматизации — проблемы Cron и Heartbeat

Was this useful?

Общее устранение неполадок

Первые 60 секунд

Ассистент кажется ограниченным или не видит инструменты

Длинный контекст Anthropic 429

Локальный OpenAI-совместимый бэкенд работает напрямую, но дает сбой в OpenClaw

Установка Plugin завершается с ошибкой из-за отсутствующих расширений openclaw

Политика установки блокирует установки или обновления plugin

Plugin присутствует, но заблокирован из-за подозрительного владельца

Дерево решений

Связанные материалы

On this page

Molty