Почему OpenClaw-агенты ломаются и как это исправить: разбор 8 причин

«Почему OpenClaw-агенты постоянно ломаются?» — частый вопрос новичков и не только. Короткий ответ: они не «ломаются», а упираются в реальные ограничения, которые редко описывают в гайдах. В этой статье — топ-8 причин с конкретной диагностикой и фиксами.

1. Context overflow

Симптом: агент в середине задачи начинает «забывать» начало разговора, путает имена файлов, повторяется. Или падает с context overflow.

Причина: LLM имеет жёсткий лимит токенов (200k для Claude Sonnet 4.6, 1M в extended-режиме). При больших задачах OpenClaw начинает сжимать (compact) старую историю — теряет детали.

Фикс:

• Разбивайте задачу на меньшие сессии, передавайте контекст через AGENTS.md/Markdown-файлы, а не через чат.
• Включите более агрессивный .clawignore — исключите node_modules/, dist/, .git/objects/.
• Поднимите contextTokens ближе к contextWindow (но не равно). См. contextWindow vs contextTokens.

Подробно — context overflow в OpenClaw.

2. Прав не хватает

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

Причина: permissions deny / ask блокируют действие, а в чате не всегда видно подтверждающий промпт (например, в Telegram-режиме или при запуске через cron).

Фикс:

• Запустите задачу интерактивно в терминале — увидите, какое разрешение запрашивается.
• Добавьте конкретный паттерн в permissions.allow в ~/.openclaw/settings.json.
• Подробно — permissions, yolo и su-режим.

3. MCP-сервер упал

Симптом: агент говорит «инструмент query_database недоступен» или просто не использует ожидаемые тулы.

Причина: MCP-сервер падает молча (например, неправильный путь к БД, протух токен, OOM).

Фикс:

openclaw mcp list      # проверить статус
openclaw mcp logs <name>   # последние логи сервера

Если сервер не стартует — запустите его команду вручную, увидите реальную ошибку. См. подключение MCP.

4. Слишком общий промпт

Симптом: агент делает «что-то похожее на задачу, но не то».

Причина: «отрефактори код, сделай его лучше» — это не задача, а пожелание. Без чётких критериев успеха модель угадывает, и часто промахивается.

Фикс: формулируйте задачи с измеримым результатом, ограничениями и контекстом:

❌ «Отрефактори код, сделай его лучше»

✓ «В файле src/services/auth.ts функция verifyToken дублирует логику с validateSession. Извлеки общий код в приватный метод extractClaims. Не меняй public API, тесты должны продолжать проходить. Запусти npm test и покажи результат.»

5. Гонки между sub-агентами

Симптом: мульти-агентная задача даёт непредсказуемый результат — иногда один файл создан, иногда другой, иногда оба переписаны.

Причина: параллельные sub-агенты пишут в одну файловую область без блокировок.

Фикс:

• Каждому sub-агенту — свою папку для записи (изолируйте через allowedPaths).
• Сборку результатов делайте последовательно через отдельный writer-агент.
• Не запускайте параллельно sub-агентов, которые читают и пишут одни и те же файлы.

См. мульти-агентная оркестрация.

6. Версии модели не совпадают с возможностями

Симптом: агент игнорирует инструменты, плохо рассуждает, отвечает «как ChatGPT 3.5».

Причина: случайно выбрана старая или дешёвая модель (Haiku вместо Sonnet, GPT-3.5 вместо GPT-4). Особенно часто — у новичков с OpenRouter.

Фикс: проверьте текущую модель командой openclaw model или в настройках. Для серьёзных задач — Claude Sonnet 4.6+, Opus 4.7, GPT-4o, DeepSeek v4. Для черновой работы — можно дешевле.

7. Стоимость убивает энтузиазм

Симптом: «попробовал OpenClaw, за неделю $50 — больше не буду».

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

Фикс:

• .clawignore исключает мусор
• Двухуровневая стратегия: дешёвая модель для рутины, дорогая для сложного
• Кэширование промптов (auto в большинстве провайдеров)
• Локальные модели для приватных и повторяющихся задач

См. оптимизация стоимости токенов и калькулятор стоимости моделей.

8. Окружение разваливается между запусками

Симптом: в один день агент работает, в следующий — нет. Без видимой причины.

Причина:

• Обновили Node — слетели глобальные пакеты
• Сменили директорию — не подтянулся .openclaw/
• Обновился OpenClaw — поменялся формат конфига
• Слетел API-ключ из переменной окружения

Фикс:

• openclaw doctor — встроенная диагностика
• Версионируйте конфиг (.openclaw/ в репозитории, ~/.openclaw/ — нет)
• Привяжите Node-версию к проекту через .nvmrc
• При сложных проблемах — troubleshooting типичных ошибок

Чек-лист «агент сломался — что делать»

1. openclaw doctor — есть ли явные проблемы?
2. openclaw mcp list — все MCP подключены?
3. Логи последней сессии (openclaw logs --tail 100) — есть ли trace ошибки?
4. Запустить ту же задачу в чистой папке — воспроизводится ли?
5. Уменьшить scope задачи — может, упирается в context?
6. Проверить лимиты API у провайдера — не кончились ли кредиты?
7. Откатить последнее обновление OpenClaw (npm i -g openclaw@<prev>) — не баг ли новой версии?

Когда «ломается» — это нормально

OpenClaw — молодая платформа, релизы выходят регулярно (см. новости), API LLM-моделей тоже меняются. Часть «ломок» неизбежна и решается через сообщество.

Главное правило: не считайте, что агент должен работать как закрытое коробочное ПО. Он работает как живой джуниор-инженер: иногда ошибается, иногда требует уточнения, иногда — перезапуска.

Что дальше

• Troubleshooting типичных ошибок
• Context overflow и его решение
• Permissions и yolo-режим
• Оптимизация стоимости токенов
• FAQ OpenClaw