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

Это подробное руководство. Для быстрой первичной диагностики сначала перейдите к разделу /help/troubleshooting.

Последовательность команд

Выполняйте в следующем порядке:

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

Признаки исправной работы:

• openclaw gateway status показывает Runtime: running, Connectivity probe: ok и строку Capability: ....
• openclaw doctor не сообщает о блокирующих проблемах конфигурации или службы.
• openclaw channels status --probe показывает актуальное состояние транспорта для каждой учётной записи и, где поддерживается, works или audit ok.

После обновления

Используйте этот раздел, если обновление завершилось, но Gateway не работает, каналы пусты или вызовы моделей завершаются ошибками 401.

openclaw status --allopenclaw update status --jsonopenclaw gateway status --deepopenclaw doctor --fixopenclaw gateway restart

Проверьте следующее:

• Update restart в openclaw status / openclaw status --all. Для ожидающих или неудачных передач указывается следующая команда, которую нужно выполнить.
• plugin load failed: dependency tree corrupted; run openclaw doctor --fix в разделе Channels: конфигурация канала по-прежнему существует, но регистрация плагина завершилась ошибкой до загрузки канала.
• Ошибки 401 провайдера после повторной аутентификации: openclaw doctor --fix проверяет устаревшие локальные для агентов копии данных OAuth-аутентификации и удаляет их, чтобы все агенты использовали текущий общий профиль.

Конфликтующие установки и защита от более новой конфигурации

Используйте этот раздел, если служба Gateway неожиданно останавливается после обновления или журналы показывают, что один исполняемый файл openclaw старее версии, которая последней записала openclaw.json.

OpenClaw помечает записи конфигурации значением meta.lastTouchedVersion. Команды только для чтения могут просматривать конфигурацию, записанную более новой версией OpenClaw, однако более старый исполняемый файл отказывается выполнять изменения процессов и служб. Блокируются следующие действия: запуск, остановка, перезапуск и удаление службы Gateway, принудительная переустановка службы, запуск Gateway в режиме службы и очистка порта gateway --force.

which openclawopenclaw --versionopenclaw gateway status --deepopenclaw config get meta.lastTouchedVersion

openclaw gateway install --forceopenclaw gateway restart

Несоответствие протокола после отката

Используйте этот раздел, если после перехода на более раннюю версию или отката в журналах продолжает появляться protocol mismatch. Работает более старый Gateway, но более новый локальный клиентский процесс продолжает переподключаться с диапазоном версий протокола, который этот Gateway не поддерживает.

openclaw --versionwhich -a openclawopenclaw gateway status --deepopenclaw doctor --deepopenclaw logs --follow

Проверьте следующее:

• protocol mismatch ... client=... v<version> min=<n> max=<n> expected=<n> в журналах Gateway.
• Established clients: в openclaw gateway status --deep или Gateway clients в openclaw doctor --deep: активные TCP-клиенты, подключённые к порту Gateway, с PID и командными строками, если операционная система позволяет их получить.
• Клиентский процесс, командная строка которого указывает на более новую установку или обёртку OpenClaw, с которой был выполнен откат.

Исправление:

1. Остановите или перезапустите устаревший клиентский процесс OpenClaw, указанный в gateway status --deep.
2. Перезапустите приложения или обёртки со встроенным OpenClaw: локальные панели управления, редакторы, вспомогательные процессы серверов приложений или длительно работающие оболочки openclaw logs --follow.
3. Повторно выполните openclaw gateway status --deep или openclaw doctor --deep и убедитесь, что PID устаревшего клиента исчез.

Не пытайтесь заставить более старый Gateway принимать более новый несовместимый протокол. Повышение версии протокола защищает контракт обмена данными; восстановление после отката требует очистки процессов и версий.

Символическая ссылка на Skill пропущена как выход за пределы пути

Используйте этот раздел, если журналы содержат:

Пропуск пути Skill за пределами настроенного корневого каталога: ... причина=symlink-escape

Каждый корневой каталог Skill является границей изоляции. Символическая ссылка в ~/.agents/skills, <workspace>/.agents/skills, <workspace>/skills или ~/.openclaw/skills пропускается, если её фактическая цель находится за пределами этого корневого каталога, кроме случаев, когда цель явно объявлена доверенной.

Проверьте ссылку:

ls -l ~/.agents/skills/<name>realpath ~/.agents/skills/<name>openclaw config get skills.load

Если цель указана намеренно, настройте как непосредственный корневой каталог Skill, так и разрешённую цель символической ссылки:

{  skills: {    load: {      extraDirs: ["~/Projects/manager/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],    },  },}

Затем начните новый сеанс или дождитесь обновления от наблюдателя Skills. Перезапустите Gateway, если работающий процесс был запущен до изменения конфигурации.

Не используйте слишком широкие цели, например ~, / или всю синхронизируемую папку проекта. Ограничьте allowSymlinkTargets фактическим корневым каталогом Skill, содержащим доверенные каталоги SKILL.md.

Если применение изменений в Skill Workshop также должно выполнять запись через эти доверенные символические ссылки на пути Skills в рабочем пространстве, включите skills.workshop.allowSymlinkTargetWrites. Оставьте этот параметр отключённым для общих корневых каталогов Skills, доступных только для чтения.

См. также:

• Конфигурация Skills
• Примеры конфигурации

Для длинного контекста Anthropic требуется дополнительное использование при ошибке 429

Используйте этот раздел, если журналы или сообщения об ошибках содержат: HTTP 429: rate_limit_error: Extra usage is required for long context requests.

openclaw logs --followopenclaw models statusopenclaw config get agents.defaults.models

Проверьте следующее:

• Выбранная модель Anthropic поддерживает общедоступный контекст 1M для Claude 4.x (Opus 4.6/4.7/4.8, Sonnet 4.6) либо конфигурация модели всё ещё содержит устаревший параметр params.context1m: true.
• Текущие учётные данные Anthropic не дают права использовать длинный контекст.
• Запросы завершаются ошибкой только в длинных сеансах или запусках модели, которым требуется контекст 1M.

Варианты исправления:

См. также:

• Anthropic
• Использование токенов и затраты
• Почему Anthropic возвращает HTTP 429?

Блокировка ответов 403 вышестоящей системой

Используйте этот раздел, если вышестоящий поставщик LLM возвращает общую ошибку 403, например Your request was blocked.

Не предполагайте, что причина всегда заключается в конфигурации OpenClaw. Ответ может поступать от вышестоящего уровня безопасности, например CDN, WAF, правила управления ботами или обратного прокси перед конечной точкой, совместимой с OpenAI.

openclaw statusopenclaw gateway statusopenclaw logs --follow

Проверьте следующее:

• Несколько моделей одного поставщика завершаются одинаковой ошибкой.
• Вместо обычной ошибки API поставщика возвращается HTML или общий текст системы безопасности.
• На стороне поставщика зарегистрированы события безопасности с тем же временем запроса.
• Минимальный прямой запрос curl выполняется успешно, а обычные запросы в формате SDK завершаются ошибкой.

Если данные указывают на блокировку WAF/CDN, сначала исправьте фильтрацию на стороне поставщика. Предпочтительно настроить узкое правило разрешения или пропуска для пути API, который использует OpenClaw, и не отключать защиту для всего сайта.

См. также:

• Конечные точки, совместимые с OpenAI
• Настройка поставщиков
• Журналы

Локальный сервер, совместимый с OpenAI, проходит прямые проверки, но запуски агента завершаются ошибкой

Используйте этот раздел, если:

• curl ... /v1/models работает.
• Минимальные прямые вызовы /v1/chat/completions работают.
• Запуски моделей OpenClaw завершаются ошибкой только при обычных шагах агента.

curl http://127.0.0.1:1234/v1/modelscurl http://127.0.0.1:1234/v1/chat/completions \  -H 'content-type: application/json' \  -d '{"model":"<id>","messages":[{"role":"user","content":"привет"}],"stream":false}'openclaw infer model run --model <provider/model> --prompt "привет" --jsonopenclaw logs --follow

Проверьте следующее:

• Минимальные прямые вызовы выполняются успешно, но запуски OpenClaw завершаются ошибкой только при более крупных запросах.
• Ошибки model_not_found или 404, хотя прямой запрос /v1/chat/completions работает с тем же идентификатором модели без префикса.
• Ошибки сервера о том, что messages[].content должен быть строкой.
• Периодические предупреждения incomplete turn detected ... stopReason=stop payloads=0 при использовании локального сервера, совместимого с OpenAI.
• Сбои сервера, возникающие только при большом числе токенов запроса или полных запросах среды выполнения агента.

См. также:

• Конфигурация
• Локальные модели
• OpenAI-совместимые конечные точки

Нет ответов

Если каналы работают, но ничего не отвечает, проверьте маршрутизацию и политики, прежде чем что-либо переподключать.

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

Проверьте:

• Ожидание сопряжения для отправителей личных сообщений.
• Ограничение по упоминанию в группе (requireMention, mentionPatterns).
• Несоответствия спискам разрешений канала или группы.

Распространённые признаки:

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

См. также:

• Устранение неполадок каналов
• Группы
• Сопряжение

Подключение панели управления и интерфейса управления

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

openclaw gateway statusopenclaw statusopenclaw logs --followopenclaw doctoropenclaw gateway status --json

Проверьте:

• Правильность URL проверки и URL панели управления.
• Несоответствие режима аутентификации или токена между клиентом и Gateway.
• Использование HTTP там, где требуется идентификация устройства.

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

openclaw gateway restartlsof -i :18789curl http://127.0.0.1:18789

Если curl возвращает HTML OpenClaw, Gateway работает, а оставшаяся проблема, вероятно, связана с кешем браузера, старой глубокой ссылкой или устаревшим состоянием вкладки. Откройте http://127.0.0.1:18789 напрямую и переходите со страницы панели управления. Если после перезапуска служба не остаётся запущенной, выполните openclaw gateway start и снова проверьте openclaw gateway status.

Краткая карта кодов подробностей аутентификации

Используйте error.details.code из неудачного ответа connect, чтобы выбрать следующее действие:

Проверка миграции аутентификации устройств v2:

openclaw --versionopenclaw doctoropenclaw gateway status

Если в журналах отображаются ошибки одноразового значения или подписи, обновите подключающийся клиент и проверьте его:

Если доступ к openclaw devices rotate / revoke / remove неожиданно отклонён:

• Сеансы с токеном сопряжённого устройства могут управлять только собственным устройством, если вызывающая сторона также не имеет operator.admin.
• openclaw devices rotate --scope ... может запрашивать только те операторские области доступа, которыми уже обладает сеанс вызывающей стороны.

См. также:

• Конфигурация (режимы аутентификации Gateway)
• Интерфейс управления
• Устройства
• Удалённый доступ
• Аутентификация через доверенный прокси

Служба Gateway не запущена

Используйте этот раздел, если служба установлена, но процесс не остаётся запущенным.

openclaw gateway statusopenclaw statusopenclaw logs --followopenclaw doctoropenclaw gateway status --deep   # также сканировать службы системного уровня

Проверьте:

• Runtime: stopped с подсказками о завершении.
• Несоответствие конфигурации службы (Config (cli) и Config (service)).
• Конфликты портов или прослушивателей.
• Дополнительные установки launchd/systemd/schtasks при использовании --deep.
• Подсказки по очистке Other gateway-like services detected (best effort).

См. также:

• Фоновое выполнение и инструмент процессов
• Конфигурация
• Doctor

Gateway в macOS незаметно перестаёт отвечать, а затем возобновляет работу после взаимодействия с панелью управления

Используйте этот раздел, если каналы (Telegram, WhatsApp и т. д.) на хосте macOS перестают отвечать на время от нескольких минут до нескольких часов, а Gateway, судя по всему, возобновляет работу сразу после открытия Control UI, подключения по SSH или иного взаимодействия с хостом. Обычно в openclaw status нет явных признаков проблемы, поскольку к моменту проверки Gateway уже снова работает.

ls ~/.openclaw/logs/stability/ | tail -5openclaw gateway stability --bundle latestpmset -g log | grep -iE "sleep|wake|maintenance" | tail -50launchctl print gui/$UID/ai.openclaw.gateway | grep -E "state|last exit|runs"

Обратите внимание на следующее:

• Один или несколько пакетов *-uncaught_exception.json в ~/.openclaw/logs/stability/, где для error.code указан временный код сетевой ошибки, например ENETDOWN, ENETUNREACH, EHOSTUNREACH или ECONNREFUSED.
• Строки pmset -g log, например Entering Sleep state due to 'Maintenance Sleep' или en0 driver is slow (msg: WillChangeState to 0), совпадающие по времени с аварийными завершениями. Power Nap / Maintenance Sleep ненадолго переводит драйвер Wi-Fi в состояние 0; любой исходящий запрос connect(), попавший в этот интервал, может завершиться ошибкой ENETDOWN даже на хосте, который в остальное время имеет полноценное сетевое подключение.
• Вывод launchctl print, показывающий state = not running с несколькими недавними runs и кодом выхода, особенно если интервал между аварийным завершением и следующим запуском составляет около часа, а не несколько секунд. После серии аварийных завершений launchd в macOS применяет недокументированный механизм защиты от повторных запусков, из-за которого KeepAlive=true может игнорироваться до тех пор, пока внешний триггер — например интерактивный вход, подключение панели управления или launchctl kickstart — не активирует его повторно.

Типичные признаки:

• Пакет стабильности, в котором значение error.code равно ENETDOWN или родственному коду, а стек вызовов указывает на Node net lookupAndConnect / Socket.connect. OpenClaw 2026.5.26 и более новых версий классифицирует такие ошибки как безопасные временные сетевые ошибки, поэтому они больше не передаются необработанному обработчику верхнего уровня; если вы используете более старую версию, сначала обновитесь.
• Длительные периоды бездействия, которые заканчиваются сразу после подключения к Control UI или входа на хост по SSH: именно видимая пользователю активность повторно запускает механизм повторного запуска launchd, а не какие-либо действия панели управления с Gateway.
• Счётчик runs, увеличивающийся в течение дня без соответствующей строки received SIG*; shutting down в ~/Library/Logs/openclaw/gateway.log: при штатном завершении регистрируется сигнал, а при временных аварийных завершениях — нет.

Что делать:

1. Обновите Gateway, если используете версию старше 2026.5.26. После обновления последующие ошибки ENETDOWN будут регистрироваться как предупреждения, а не завершать процесс.

2. Сократите активность режима обслуживания во сне на Mac mini и настольных хостах, предназначенных для постоянной работы в качестве серверов:

   sudo pmset -a sleep 0 disksleep 0 standby 0 powernap 0

   Это значительно уменьшает, но не устраняет полностью, нестабильность драйвера. Независимо от этих флагов система всё ещё может выполнять некоторые переходы в режим обслуживания во сне для поддержки TCP keepalive и mDNS.

3. Добавьте сторожевую проверку работоспособности, чтобы в будущем быстро обнаруживать серии аварийных завершений, после которых launchd прекращает повторные запуски:

   # Пример проверки работоспособности с учётом launchd, подходящей для cron или LaunchAgent с интервалом 5 минутstate=$(launchctl print gui/$UID/ai.openclaw.gateway 2>/dev/null | awk -F'= ' '/state =/ {print $2; exit}')if [ "$state" != "running" ]; then  launchctl kickstart -k gui/$UID/ai.openclaw.gatewayfi

   Задача состоит в том, чтобы извне повторно активировать механизм повторного запуска; одного KeepAlive=true после серии аварийных завершений в macOS недостаточно.

См. также:

• Примечания о платформе macOS
• Журналирование
• Doctor

Цикл супервизора launchd в macOS при дублирующихся LaunchAgent для Gateway и Node

Используйте этот раздел, если установка в macOS перезапускается каждые несколько секунд, проверки работоспособности openclaw попеременно показывают доступность и недоступность, а отправка сообщений через каналы останавливается, хотя служба, судя по всему, работает.

Такое наблюдалось в старых установках, где одновременно были активны LaunchAgent ai.openclaw.gateway и ai.openclaw.node, каждый из которых внедрял OPENCLAW_LAUNCHD_LABEL. В таком состоянии OpenClaw может обнаружить управление со стороны launchd, попытаться передать перезапуск обратно launchd и попасть в быстрый цикл EADDRINUSE/повторного запуска вместо работы одного стабильного процесса Gateway.

for i in 1 2 3 4; do  ps aux | grep 'openclaw.*index.js' | grep -v grep | awk '{print $2}'  sleep 10done openclaw gateway status --deepopenclaw node statuslaunchctl print gui/$UID/ai.openclaw.gateway | grep -E 'state|last exit|runs'tail -n 80 ~/Library/Logs/openclaw/gateway.log

Обратите внимание на следующее:

• Несколько PID Gateway в течение 30-секундной выборки вместо одного стабильного процесса.
• EADDRINUSE, another gateway instance is already listening или повторяющиеся строки перезапуска/передачи управления в gateway.log.
• Одновременно загружены ~/Library/LaunchAgents/ai.openclaw.gateway.plist и ~/Library/LaunchAgents/ai.openclaw.node.plist на хосте, где должна работать только одна управляемая служба Gateway.

Что делать:

1. Если на этом хосте должна работать только служба Gateway, удалите управляемую службу Node с помощью OpenClaw. Пропустите этот шаг, если вы активно используете службу Node для удалённых функций Node: её удаление остановит работу этих функций на данном хосте:

   openclaw node uninstall

2. Установите постоянную оболочку Gateway, которая очищает унаследованные маркеры launchd перед запуском OpenClaw. Используйте поддерживаемый параметр --wrapper; не редактируйте сгенерированный файл в ~/.openclaw/service-env/, поскольку при переустановке и обновлении службы, а также восстановлении через Doctor этот файл создаётся заново:

   mkdir -p ~/.local/bincat >~/.local/bin/openclaw-launchd-workaround <<'EOF'#!/bin/shset -euunset OPENCLAW_LAUNCHD_LABEL LAUNCH_JOB_LABEL LAUNCH_JOB_NAME XPC_SERVICE_NAME || trueexec openclaw "$@"EOFchmod 700 ~/.local/bin/openclaw-launchd-workaround openclaw gateway install \  --wrapper ~/.local/bin/openclaw-launchd-workaround \  --force

   gateway install сохраняет путь к оболочке при принудительных переустановках, обновлениях и восстановлении через Doctor.

3. Убедитесь, что Gateway работает стабильно и обслуживает RPC, а не просто прослушивает порт:

   openclaw gateway status --deep --require-rpc for i in 1 2 3 4; do  ps aux | grep 'openclaw.*index.js' | grep -v grep | awk '{print $2}'  sleep 10done

   В выборке PID должен отображаться один стабильный процесс вместо постоянно сменяющегося набора PID, а обработка входящих сообщений каналов должна возобновиться.

4. После обновления до версии, в которой исправлен основной цикл с двумя LaunchAgent, удалите обходное решение и переустановите обычную управляемую службу:

   OPENCLAW_WRAPPER= openclaw gateway install --forcerm ~/.local/bin/openclaw-launchd-workaround

См. также:

• Примечания о платформе macOS
• Doctor
• CLI Gateway

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

Используйте этот раздел, если Gateway исчезает под нагрузкой, супервизор сообщает о перезапуске в стиле OOM или в журналах упоминается critical memory pressure bundle written.

openclaw gateway status --deepopenclaw logs --followopenclaw gateway stability --bundle latestopenclaw gateway diagnostics export

Обратите внимание на следующее:

• Reason: diagnostic.memory.pressure.critical в последнем пакете стабильности.
• Memory pressure: с critical/rss_threshold, critical/heap_threshold или critical/rss_growth.
• Значения V8 heap:, близкие к пределу кучи.
• Записи Largest session files:, например agents/<agent>/sessions/<session>.jsonl или sessions/<session>.jsonl.
• Счётчики памяти cgroup Linux, если Gateway работает внутри контейнера или службы с ограничением памяти.

Типичные признаки:

• critical memory pressure bundle written появляется незадолго до перезапуска → OpenClaw сохранил пакет стабильности перед OOM. Проверьте его с помощью openclaw gateway stability --bundle latest.
• memory pressure: level=critical ... memoryPressureSnapshot=disabled появляется в журналах Gateway → OpenClaw обнаружил критическую нехватку памяти, но создание снимка стабильности перед OOM отключено.
• Largest session files: указывает на очень большой отредактированный путь к расшифровке → сократите сохраняемую историю сеансов, проверьте рост сеансов или переместите старые расшифровки из активного хранилища перед перезапуском.
• Количество использованных байтов V8 heap: близко к пределу кучи → снизьте нагрузку от запросов и сеансов, сократите количество параллельных задач или увеличьте предел кучи Node только после подтверждения ожидаемого характера нагрузки.
• Memory pressure: critical/rss_growth → объём памяти быстро увеличился в пределах одного интервала выборки. Проверьте последние журналы на наличие крупного импорта, неконтролируемого вывода инструмента, повторяющихся попыток или пакета поставленных в очередь задач агента.
• В журналах появляется критическая нехватка памяти, но пакет отсутствует → это поведение по умолчанию. Установите diagnostics.memoryPressureSnapshot: true, чтобы при будущих событиях критической нехватки памяти сохранялся пакет стабильности перед OOM.

Пакет стабильности не содержит полезной нагрузки. Он включает эксплуатационные сведения о памяти и отредактированные относительные пути к файлам, но не текст сообщений, тела Webhook, учётные данные, токены, файлы cookie или необработанные идентификаторы сеансов. Вместо копирования необработанных журналов прикладывайте к отчётам об ошибках экспорт диагностики.

См. также:

• Состояние Gateway
• Экспорт диагностики
• Сеансы

Gateway отклонил недопустимую конфигурацию

Используйте этот раздел, если запуск Gateway завершается с ошибкой Invalid config или в журналах горячей перезагрузки указано, что недопустимое изменение было пропущено.

openclaw logs --followopenclaw config fileopenclaw config validateopenclaw doctor

Обратите внимание на следующее:

• Invalid config at ...
• config reload skipped (invalid config): ...
• Config write rejected: ...
• Файл openclaw.json.rejected.* с меткой времени рядом с активной конфигурацией.
• Файл openclaw.json.clobbered.* с меткой времени, если doctor --fix исправил некорректное прямое изменение.
• OpenClaw сохраняет последние 32 файла .clobbered.* для каждого пути конфигурации и удаляет более старые при ротации.

CONFIG="$(openclaw config file)"ls -lt "$CONFIG".clobbered.* "$CONFIG".rejected.* 2>/dev/null | headdiff -u "$CONFIG" "$(ls -t "$CONFIG".clobbered.* 2>/dev/null | head -n 1)"openclaw config validateopenclaw doctor

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

• Конфигурация
• Конфигурация: горячая перезагрузка
• Конфигурация: строгая проверка
• Doctor

Предупреждения проверки Gateway

Используйте этот раздел, если openclaw gateway probe достигает какого-либо адреса, но по-прежнему выводит блок предупреждений.

openclaw gateway probeopenclaw gateway probe --jsonopenclaw gateway probe --ssh user@gateway-host

Проверьте:

• warnings[].code и primaryTargetId в выводе JSON.
• Относится ли предупреждение к резервному подключению через SSH, нескольким шлюзам, отсутствующим областям доступа или неразрешённым ссылкам аутентификации.

Распространённые признаки:

• SSH tunnel failed to start; falling back to direct probes. → настройка SSH завершилась ошибкой, но команда всё равно попыталась использовать непосредственно настроенные адреса или адреса обратной петли.
• multiple reachable gateway identities detected → ответили разные шлюзы либо OpenClaw не удалось доказать, что доступные адреса ведут к одному шлюзу. SSH-туннель, URL прокси или настроенный удалённый URL к одному и тому же шлюзу считается одним шлюзом с несколькими транспортами, даже если порты транспортов различаются.
• Read-probe diagnostics are limited by gateway scopes (missing operator.read) → подключение установлено, но подробный RPC ограничен областью доступа; выполните сопряжение идентификатора устройства или используйте учётные данные с operator.read.
• Gateway accepted the WebSocket connection, but follow-up read diagnostics failed → подключение установлено, но полный набор диагностических RPC завершился по тайм-ауту или с ошибкой. Считайте Gateway доступным, но с ограниченной диагностикой; сравните connect.ok и connect.rpcOk в выводе --json.
• Capability: pairing-pending или gateway closed (1008): pairing required → шлюз ответил, но этому клиенту всё ещё требуется сопряжение или одобрение перед получением обычного операторского доступа.
• Текст предупреждения о неразрешённой ссылке SecretRef gateway.auth.* / gateway.remote.* → данные аутентификации были недоступны в этом пути выполнения команды для целевого адреса, подключение к которому завершилось ошибкой.

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

• Gateway
• Несколько шлюзов на одном хосте
• Удалённый доступ

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

Если канал подключён, но обмен сообщениями не работает, сосредоточьтесь на политиках, разрешениях и правилах доставки конкретного канала.

openclaw channels status --probeopenclaw pairing list --channel <channel> [--account <id>]openclaw status --deepopenclaw logs --followopenclaw config get channels

Проверьте:

• Политику личных сообщений (pairing, allowlist, open, disabled).
• Список разрешённых групп и требования к упоминаниям.
• Отсутствующие разрешения или области доступа API канала.

Распространённые признаки:

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

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

• Устранение неполадок каналов
• Discord
• Telegram
• WhatsApp

Доставка Cron и Heartbeat

Если Cron или Heartbeat не выполнился либо не доставил сообщение, сначала проверьте состояние планировщика, а затем целевой адрес доставки.

openclaw cron statusopenclaw cron listopenclaw cron runs --id <jobId> --limit 20openclaw system heartbeat lastopenclaw logs --follow

Проверьте:

• Включён ли Cron и указано ли время следующего пробуждения.
• Состояние истории запусков задания (ok, skipped, error).
• Причины пропуска Heartbeat (quiet-hours, requests-in-flight, cron-in-progress, lanes-busy, alerts-disabled, empty-heartbeat-file, no-tasks-due).

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

• Heartbeat
• Запланированные задачи
• Запланированные задачи: устранение неполадок

Node сопряжён, но инструмент не работает

Если Node сопряжён, но инструменты не работают, отдельно проверьте состояние переднего плана, разрешений и одобрений.

openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>openclaw logs --followopenclaw status

Проверьте:

• Находится ли Node в сети и предоставляет ли ожидаемые возможности.
• Предоставлены ли разрешения ОС на доступ к камере, микрофону, местоположению и экрану.
• Состояние одобрений выполнения и списка разрешённых команд.

Распространённые признаки:

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

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

• Одобрения выполнения
• Устранение неполадок Node
• Узлы

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

Используйте этот раздел, если действия инструмента браузера завершаются ошибкой, хотя сам Gateway исправен.

openclaw browser statusopenclaw browser start --browser-profile openclawopenclaw browser profilesopenclaw logs --followopenclaw doctor

Проверьте:

• Задано ли значение plugins.allow и включает ли оно browser.
• Допустим ли путь к исполняемому файлу браузера.
• Доступен ли профиль CDP.
• Доступен ли локальный Chrome для профилей existing-session / user.

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

• Браузер под управлением OpenClaw
• Устранение неполадок браузера

Если после обновления что-то внезапно перестало работать

Большинство неполадок после обновления связано с расхождением конфигурации или с тем, что теперь применяются более строгие значения по умолчанию.

openclaw gateway statusopenclaw config get gateway.modeopenclaw config get gateway.remote.urlopenclaw config get gateway.auth.mode

openclaw config get gateway.bindopenclaw config get gateway.auth.modeopenclaw config get gateway.auth.tokenopenclaw gateway statusopenclaw logs --follow

openclaw devices listopenclaw pairing list --channel <channel> [--account <id>]openclaw logs --followopenclaw doctor

Если после проверок конфигурация сервиса и среда выполнения по-прежнему не согласованы, переустановите метаданные сервиса из того же каталога профиля и состояния:

openclaw gateway install --forceopenclaw gateway restart

См. также:

• Аутентификация
• Фоновое выполнение и инструмент управления процессами
• Сопряжение Node

См. также

• Doctor
• Часто задаваемые вопросы
• Руководство по эксплуатации Gateway