OpenClaw: análisis de la configuración, del primer bot a un sistema multiagente en Telegram

OpenClaw позволяет поднять AI-агента в Telegram буквально за один вечер: команда `openclaw onboard` настраивает Gateway и запускает первого бота. Большинство гайдов останавливаются именно на этой точке. Новый детальный туториал закрывает следующий уровень: как устроена вся конфигурация изнутри, как перейти от одного демо-бота к нормальной продакшн-системе с несколькими агентами и без лишнего расхода токенов.

Что внутри openclaw.json Конфиг openclaw.json — центральный управляющий файл всей системы.

Официальная документация OpenClaw покрывает его фрагментарно, поэтому разбор посекционно с живыми примерами особенно ценен. Ключевые секции конфига: gateway — адрес и порт для входящих запросов к агентам agents — список агентов с системными промптами и привязками к языковым моделям bindings — правила маршрутизации: какому агенту направить каждое входящее сообщение session_policy — управление памятью: когда сбрасывать контекст и как долго хранить историю * workspace — путь к рабочим файлам, которые подгружаются в контекст агента Тонкость с workspace: не всё, что лежит в директории, попадает в контекст автоматически. Агент видит только то, что явно объявлено в конфиге.

Это один из самых частых источников путаницы — когда агент «не знает» нужный контекст, хотя файлы физически на месте. В секции agents важно явно задать модель и её параметры для каждого агента — иначе применится дефолтная конфигурация Gateway, что в продакшн-среде может дать неожиданное поведение.

Heartbeat без холостого расхода Heartbeat — механизм периодического пробуждения агента.

Позволяет выполнять задачи автономно, без входящего сообщения: мониторить события, отправлять сводки, проверять состояние внешних сервисов. Типичная ловушка — включить heartbeat с коротким интервалом без условий активации. Агент начинает генерировать сотни пустых запросов к языковой модели и сжигает токены впустую. Рабочая настройка включает три обязательных элемента: разумный интервал — обычно не короче 5–10 минут для большинства сценариев условие активации — только при наличии новых событий или данных для обработки * отдельный heartbeat-промпт — не смешанный с основным системным промптом агента > «Heartbeat без guard conditions — это генератор расхода, а не фича», — из обсуждений сообщества OpenClaw. Правильно настроенный heartbeat работает незаметно и включается только тогда, когда есть реальная задача.

Multi-agent: bindings и топики

Переход от одного бота к нескольким агентам — самая нетривиальная часть конфигурации. OpenClaw поддерживает несколько схем распределения: по отдельным чатам (каждому агенту свой chat_id в Telegram), по топикам внутри одного группового чата, или комбинированно — часть агентов в личных переписках, часть в групповых чатах. За маршрутизацию отвечает секция `bindings`. Она связывает источник сообщения (chat_id + topic_id) с конкретным агентом. Если binding не задан — сообщение уходит дефолтному агенту, что в мультиагентной схеме почти всегда нарушает логику работы. Session_policy в групповых конфигурациях требует явного указания scope. Без него контексты разных пользователей одного чата могут перемешаться — агент начнёт «помнить» данные не тех людей.

Что это значит

OpenClaw хорошо справляется с быстрым запуском, но путь к продакшн-архитектуре требует понимания конфига в деталях. Туториал заполняет пробел между первым работающим ботом и нормальной мультиагентной системой — с разбором всех ключевых секций, рабочими примерами и объяснением подводных камней. Полезен всем, кто строит AI-инфраструктуру в Telegram и уже вышел за рамки одного демо-бота.