OpenClaw не отвечает: диагностика типовых ошибок за пятнадцать минут

Агент, который перестал отвечать посреди рабочего дня, стоит дороже, чем кажется: пока вы разбираетесь, задачи копятся, а дежурные проверки не выполняются. Хорошая новость в том, что 90% случаев укладываются в четыре причины, и каждая проверяется одной командой.

Мы собрали ошибки, с которыми сталкивались сами и которые чаще всего ищут в поиске: access not configured, not found, обрывы гейтвея и проблемы после обновления. Ниже — порядок диагностики от быстрого к долгому.

👉 Проверить баланс модели и пополнить его в рублях

Сначала проверяем агента, потом гейтвей, потом провайдера, и только затем читаем логи.

`--version` отвечает на вопрос, установлен ли агент вообще и та ли это версия, которую вы ждёте. Если команда не находится — проблема в установке или в PATH, а не в работе агента.

`doctor` — главная команда. Она проверяет Node.js, конфигурацию, доступность гейтвея и настройку провайдера, после чего показывает, что именно не сходится.

`gateway status` отвечает, жив ли гейтвей: без него не работают ни панель, ни мессенджер, ни мобильный клиент.

`logs` нужен последним. Логи полезны, когда три предыдущие команды говорят «всё в порядке», а агент всё равно ведёт себя странно.

Порядок важен: логи читают последними, когда простые проверки ничего не дали.

Промежуточный вывод: диагностика идёт от общего к частному, и в большинстве случаев заканчивается на второй команде.

Провайдер модели не настроен, ключ не принят или подписка не покрывает программное использование.

Это самая частая ошибка, и она про доступ, а не про поломку. Проверять нужно по порядку:

Проверяется всё это в кабинете провайдера за минуту. Если баланс пуст — это не техническая проблема, а вопрос пополнения: российская карта у провайдеров не проходит, и агент встаёт ровно в тот момент, когда закончились деньги.

👉 Пополнить баланс провайдера в рублях

Команда `openclaw` не находится — значит, установка не завершилась или бинарник не попал в PATH.

Три типовые причины:

Проверить, где лежит бинарник, проще всего через openclaw doctor: он покажет расхождение между ожидаемым и фактическим расположением.

Три причины: занятый порт, отсутствие автозапуска и блокировка со стороны корпоративной защиты.

Занятый порт. Гейтвей слушает конкретный порт, и если его занял другой процесс, запуск падает. Сменить порт можно в конфиге.

Нет автозапуска. Классический сценарий на сервере: агент работал, машина перезагрузилась, служба не поднялась. Лечится флагом --install-daemon при онбординге, а проверяется командой openclaw gateway status после перезагрузки.

Корпоративная защита. На рабочей машине антивирус или системная политика могут блокировать локальный сервер. Это решается не отключением защиты, а согласованием с администратором — самовольное снятие ограничений обычно нарушает регламент.

Отдельный симптом — гейтвей поднимается, но мобильный клиент к нему не подключается. Напомним архитектуру: приложение на телефоне — это клиент к гейтвею на компьютере или сервере, а не самостоятельный агент. Если гейтвей доступен только локально, снаружи к нему никто и не должен подключаться.

Если `doctor` молчит, а агент не отвечает, проблема почти всегда в модели или в свежем обновлении.

Проверьте версию, статус гейтвея и конфиг — в таком порядке.

Обновления меняют формат конфигурации и требования к окружению. Порядок действий после обновления:

config validate покажет, если в конфиге остались параметры, которые новая версия не понимает. Это частая причина поведения «агент запускается, но не делает то, что делал вчера».

Если проблема появилась сразу после обновления и не чинится за десять минут, откат к предыдущей версии — законный шаг. Рабочий процесс важнее, чем свежая версия, а разбираться удобнее не в момент, когда команда ждёт отчёт.

Промежуточный вывод: после каждого обновления имеет смысл прогонять три команды — это полминуты, которые экономят час.

Переустановка чинит битую установку и не чинит проблемы с доступом, деньгами и конфигурацией.

Полное удаление имеет смысл в двух случаях: установка повреждена — например, прервалась на середине, — или вы переносите агента на другую машину и хотите чистое состояние.

Во всех остальных случаях переустановка бесполезна: если у вас пустой баланс, неверный ключ или закрытый порт, чистая установка приведёт ровно к той же ошибке. Зато вы потеряете конфигурацию, подключённые каналы и настроенные скиллы.

Перед удалением стоит сохранить конфиг — это обычный файл в домашней директории. Тогда восстановление после переустановки займёт минуту вместо часа.

Переустановка — инструмент против битой установки, а не универсальный ответ на любую ошибку.

Считать простой удобно не в часах, а в задачах, которые он не выполнил.

Для дежурного сценария это заметно сразу: агент не проверил очередь — заявки лежат. Для отчётного — сводка не собралась, и кто-то делает её руками сорок минут. Для рутинного — почта не разобрана, и час уходит на то, что обычно занимало пять минут.

Отсюда практический вывод, который экономит больше, чем любая оптимизация: у круглосуточного агента должен быть простейший мониторинг живости. Один статус в чат раз в сутки — и вы узнаёте о поломке в тот же день, а не через неделю.

Второе по важности — предоплаченный баланс с запасом. Половина «поломок», которые мы разбирали у коллег, оказывались нулевым балансом у провайдера в неудачный момент.

Цена простоя измеряется не минутами недоступности, а объёмом вернувшейся ручной работы.

С openclaw doctor. Команда проверяет окружение целиком и в большинстве случаев сразу называет причину.

Провайдер модели не настроен, ключ не принят или закончились деньги либо квота подписки. Это вопрос доступа, а не поломки агента.

Скорее всего, установка прошла без флага --allow-scripts openclaw, и часть шагов не выполнилась. Помогает переустановка пакета с флагом.

Нет. Обновление ставится поверх. Удаление имеет смысл только при повреждённой установке или переезде.

Если doctor и gateway status показывают, что всё в порядке, а любой запрос возвращает ошибку доступа — дело в провайдере: ключ, баланс или квота.