OpenClaw: Четыре критических вопроса, которые необходимо знать разработчикам

Недавнее сканирование открытых issues в репозитории OpenClaw (366k звезд) выявило четыре ошибки и недостающие функции, которые активно влияют на производственные развертывания. Две из них — ошибки, вызывающие тихие сбои, а две — отсутствующие функции, которые сообщество запрашивало. Вот разбор каждой из них.

1. Изображения, отправленные через каналы, никогда не доходят до модели

Когда пользователь отправляет изображение через Discord, Telegram, Feishu или OpenWebUI, адаптер канала отбрасывает изображение и передает модели только текст. Модели, способные обрабатывать изображения, либо отвечают так, как будто изображения не было, либо галлюцинируют описания. Коренная причина в том, что интерфейс адаптера канала не распространяет URL изображений или полезные нагрузки base64. Исправление требует расширения интерфейса адаптера для передачи этих представлений изображений. Несколько issues отслеживают это, наиболее ясное резюме — #23452.

2. WhatsApp и Telegram навсегда умирают при кратковременном сбое DNS

Логика повторного подключения в адаптерах каналов WhatsApp и Telegram обрабатывает только разрывы в середине сессии. Если сбой DNS происходит во время первоначального подключения, ошибка полностью выходит из цикла повторных попыток, и канал завершает работу без дальнейших попыток подключения. Шлюз продолжает работать, но канал фактически мертв. Пользователи сообщают, что запускают внешние скрипты-наблюдатели для его перезапуска. Смотрите issues #2198 и #13506.

3. Нет способа увидеть, что удерживает блокировку сессии

Хранилище сессий использует файлы .jsonl.lock, которые регулярно зависают из-за больших сессий, нагрузки от cron, параллельных агентов или перезагрузки конфигурации. Когда блокировка зависает, все модели выдают ошибку session file locked (timeout 10000ms). Единственный выход — вручную убить файл блокировки или перезапустить шлюз. Файл блокировки уже содержит метаданные pid и createdAt, но нет команды CLI, чтобы их показать. Предложенная команда openclaw locks будет считывать эти метаданные и показывать активных ожидающих, давая операторам полезную информацию. Смотрите issues #31489 и #11950.

4. Нет параллельной координации между агентами

Текущие инструменты session_spawn и send поддерживают только иерархическое делегирование — один агент передает работу вниз и ждет. Нет возможности нескольким агентам сотрудничать над задачей одновременно или обмениваться состоянием. Issue #43367 документирует попытки пользователей запускать параллельных агентов кодирования, сталкивающихся с перезаписью конфигурации и конкуренцией за блокировки в дополнение к архитектурным ограничениям.

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