Как пользоваться этим разделом
Здесь семьдесят разборов, названных по машинному тексту ошибки, а не по пересказу. Если сообщение у вас перед глазами, самый короткий путь — скопировать его целиком и поискать по сайту: страница с этим текстом либо есть, либо нет, и выяснится это за секунду.
Если точного совпадения не нашлось, идите от группы. Почти всё, что ломается, укладывается в семь: установка, авторизация, шлюз, пропавшие инструменты, контекст, каналы и модель. Карта с порядком проверки внутри каждой — ошибки OpenClaw: 7 групп.
Что определить в первую очередь
Один вопрос экономит больше времени, чем любой гайд: на каком уровне поломка.
- Не запускается вовсе — окружение и установка. До логов дело не доходит.
- Запускается, но не отвечает или теряет инструменты — шлюз, соединение, сессия.
- Отвечает, но неправильно — модель, провайдер или права.
Сообщение почти всегда звучит страшнее своего уровня. «Tool not found» выглядит как сломанный агент, а означает обычно, что шлюз потерял соединение и инструменты перестали регистрироваться.
Что стоит проверить до чтения разбора
Версию. Заметная часть ошибок здесь привязана к конкретным сборкам: появилась в одном релизе, ушла в следующем. Если поломка возникла сразу после обновления — это первая гипотеза, а не последняя.
Логи целиком. Настоящая причина обычно на несколько строк выше того сообщения, которое попадает в поиск.
Одно изменение за раз. Три правки одновременно — это три новых переменных и ни одного вывода о том, что помогло.
Чего в этом разделе нет
Советов вида «выдайте полные права» и «отключите проверки». Они снимают симптом и оставляют проблему — уже вашу и уже дороже. Что действительно можно и нельзя отдавать агенту — в разборе разрешений и доступа.