OpenClaw
Мультиканальный gateway для персонального AI-агента: один self-hosted процесс связывает Telegram, Signal, WhatsApp и еще десяток мессенджеров с вашим агентом. Отправил сообщение - получил ответ агента из кармана. Развернули у себя и честно разобрали, почему из России нужен исходящий прокси.
Вердикт
- личный AI-агент, которому пишешь из привычного мессенджера, а не из терминала
- одна точка входа к агенту из Telegram, Signal, WhatsApp, Slack, Discord и других каналов
- своя модель без привязки к вендору (BYOM), персона агента и память между сессиями, данные локально
- нужен готовый zero-config SaaS-чатбот без терминала
- сервер не может достучаться до LLM и прокси не поднять
- неприемлем CLI-first контроль над установкой и конфигом
Что это и какую задачу решает
OpenClaw - self-hosted мультиканальный gateway для персонального AI-агента с открытым кодом под лицензией MIT. Один Gateway-процесс вы запускаете на своей машине или сервере, и он становится мостом между вашими мессенджерами и всегда доступным агентом. Смысл простой: отправил сообщение из привычного чата - получил ответ агента из кармана, без отдельного приложения и без облака вендора.
Один Gateway одновременно обслуживает встроенные каналы и плагины каналов - Telegram, Signal, WhatsApp, Slack, Discord, iMessage, Matrix, Microsoft Teams, Google Chat, Zalo и другие, - а также веб-дашборд WebChat и мобильные ноды. За каналами стоит агент со своей персоной, памятью между сессиями, навыками, сессиями и маршрутизацией между несколькими агентами. Модель на выбор (BYOM): ключ Anthropic, OpenAI, Google и других провайдеров. Данные и конфиг хранятся локально на вашем хосте.
Чем отличается от платных SaaS-ботов и от обычных CLI-агентов
Сравнение по тому, что влияет на выбор шлюза к агенту, без снисходительности к конкурентам.
| Параметр | OpenClaw | SaaS-чатбот / обычный CLI-агент |
|---|---|---|
| Лицензия | MIT, открытый код | подписка / закрытый |
| Хостинг | self-hosted на своем железе, любая ОС | облако вендора |
| Каналы | один Gateway: Telegram, Signal, WhatsApp, Slack, Discord и др. | один канал или только терминал |
| Модель | своя модель (BYOM): Anthropic, OpenAI, Google и др. | часто привязка к одному вендору |
| Память и персона | персона агента + память между сессиями | обычно нет |
| Где данные | локально, на вашем хосте | в облаке вендора |
Тех-стек и архитектура
OpenClaw написан на TypeScript и работает на Node.js (рекомендуется Node 24, поддерживается 22.19+). Ставится npm-пакетом openclaw - это не docker-compose, а обычная установка через npm; Docker при желании тоже есть (образ ghcr.io/openclaw/openclaw), но по умолчанию он не требуется. Центральный компонент - Gateway-процесс: он держит подключения к каналам, маршрутизирует сообщения к агенту и обратно и на сервере поднимается как systemd user-сервис (openclaw-gateway.service).
Рядом с Gateway живет веб-дашборд WebChat на порту 18789 - через него удобны чат с агентом, правка конфига и просмотр сессий. По умолчанию он слушает только loopback (127.0.0.1), наружу выставляется отдельно за обратным прокси. Модель подключается по схеме BYOM: онбординг спрашивает провайдера и ключ (Anthropic, OpenAI, Google и др.). Каналы (Telegram, Signal, WhatsApp, Slack, Discord, iMessage, Matrix, Teams, Google Chat, Zalo и др.) подключаются как встроенные или как плагины каналов.
Минимальная конфигурация
Gateway - всегда-включенный процесс (systemd user-сервис), но по железу нетребовательный.
| Класс | Gateway-процесс на Node.js (systemd user-сервис) |
| Вес установки | ~375 МБ (npm-global) + ~1 МБ состояние |
| RAM в простое | ~510 МБ (процесс gateway, node) |
| Порт | 18789 (gateway + дашборд, по умолчанию loopback) |
| Рекомендуем тариф | CPU2-RAM4-DISK50 |
| Тариф Fatmetal | CPU2-RAM4-DISK50 - 500 руб/мес |
Главное про ресурсы. Gateway держит подключения к каналам постоянно, поэтому в простое он занимает около 510 МБ RAM - это укладывается в тариф CPU2-RAM4-DISK50 с запасом. Сама установка легкая (~375 МБ npm-global). Основная переменная стоимости - не сервер, а токены LLM-провайдера: агент отвечает на вашем ключе BYOM.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.
Рекомендуемая конфигурация: CPU2-RAM4-DISK50
Развертывание на Fatmetal Cloud Server
Базовый путь - Cloud Server + Ubuntu 24.04, одна команда установки.
Создать сервер
тариф CPU2-RAM4-DISK50, Ubuntu 24.04. Docker не нужен - установка идет через npm.
Поставить OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bashСкрипт при необходимости ставит Node (реком. 24) и сам пакет
openclawчерез npm-global, затем предлагает онбординг. Флаг--no-onboardпропускает мастер, если хотите настроить руками.Проверить окружение и подключить провайдера
openclaw doctor # проверка окружения openclaw onboard # выбор LLM-провайдера (BYOM) и каналаОнбординг спрашивает провайдера и ключ (Anthropic, OpenAI, Google и др.) и подключает канал, например Telegram. На российском хосте перед этим настройте исходящий прокси к провайдеру (см. «Где может сломаться»).
Запустить Gateway как сервис
openclaw gateway install systemctl --user start openclaw-gateway.service openclaw gateway statusGateway поднимается как systemd user-сервис и слушает порт
18789на loopback. Дальше можно писать агенту из подключенного мессенджера или открыть дашбордhttp://127.0.0.1:18789/.
Что измерили после запуска
Цифры со свежей установки на тарифе CPU2-RAM4-DISK50 (2 vCPU, 4 GiB RAM, Ubuntu 24.04). Только реальные замеры.
| Время установки | 102 c |
| Вес установки | ~375 МБ (npm-global) + ~1 МБ состояние |
| RAM gateway в простое | ~510 МБ (процесс node) |
| Node / версия OpenClaw | v24.18.0 / v2026.6.11 |
| Порт / контейнеры | 18789 (loopback) / 0 контейнеров |
Главное: установка занимает около 102 секунд (npm при необходимости тянет Node 24 и сам пакет) и весит примерно 375 МБ. Gateway - всегда-включенный процесс: в простое он держит около 510 МБ RAM, что укладывается в тариф CPU2-RAM4-DISK50. Docker не используется - контейнеров ноль.
Проверено на версии v2026.6.11, июль 2026. На новых версиях результаты могут отличаться.
Где может сломаться
Реальные грабли, на которые наткнулись при запуске на российском хосте.
Геоблок LLM-провайдера с российского IP - главный камень. Сам OpenClaw ставится и Gateway работает, но модель без исходящего прокси на RU-хосте недоступна: без ключа и прокси агент просто не отвечает. LLM-провайдеры (Anthropic, OpenAI и др.) блокируют российские IP - прямой запрос отдает 403 за доли секунды. Лечится исходящим прокси к провайдеру. Именно поэтому живой диалог с моделью требует клиентского ключа BYOM и прокси, и скрин живого чата в этой статье мы не приводим - показываем реальные экраны CLI.
Причина. LLM-провайдер геоблокирует запрос с российского IP - ответ приходит за доли секунды, до какой-либо обработки.
Решение. Настроить исходящий прокси к провайдеру, чтобы запросы OpenClaw к модели шли не с российского IP. Без прокси Gateway запускается и каналы подключаются, но агент не может достучаться до модели.
Нужен LLM-ключ (BYOM). Без ключа провайдера агент остается «пустым»: каналы работают, но осмысленного ответа не будет. Ключ подключается на онбординге.
Молодой проект, быстрые релизы. Есть stable-канал (v2026.6.11) и beta (2026.7.1-beta.5, по умолчанию не ставится). Команды и опции могут меняться между версиями - фиксируйте версию и закладывайте сопровождение.
Владелец команд не задан. После установки openclaw doctor предупреждает, что command owner не настроен: привилегированные команды выполнять некому. Задайте commands.ownerAllowFrom на свой идентификатор в канале до открытия бота.
Безопасность и обновления
Данные, конфиг и ключи хранятся локально в каталоге состояния (~/.openclaw/), Gateway по умолчанию слушает только loopback. Встроенная диагностика openclaw doctor проверяет окружение и отдельно предупреждает о безопасности: например, что не задан владелец команд (command owner), которому разрешены привилегированные действия. Обновление ставится через npm (stable-канал по умолчанию):
npm install -g openclaw@latest
openclaw --version
Что закрыть перед продом: задать commands.ownerAllowFrom на свой идентификатор в канале, чтобы привилегированные команды и одобрение опасных действий были только у вас; хранить ключ LLM-провайдера в защищенном месте, а не в общей истории shell; для каждого канала - отдельные токены ботов и контроль, кто может писать агенту; дашборд не выставлять наружу «в лоб», а только за обратным прокси с авторизацией; на RU-хосте держать исходящий прокси к LLM-провайдеру как управляемую зависимость.
Веб-панель за обратным прокси
Кроме мессенджеров у OpenClaw есть веб-дашборд WebChat - openclaw dashboard печатает его адрес (по умолчанию http://127.0.0.1:18789/). Через него удобны чат с агентом, правка конфига и просмотр сессий. По умолчанию дашборд слушает только loopback. Задача - отдать его наружу через ваш периметр (Traefik, nginx, любой) с TLS и паролем, не открывая порт напрямую. Дашборд родственный панели Hermes, поэтому грабли те же, и все всплывают только на живом стенде: любая одна роняет панель в белый экран или 400.
Выставить его наружу «в лоб» мешают четыре независимые тонкости, пройти надо все четыре.
1. Проверка Host (защита от DNS-rebinding)
На loopback-бинде дашборд принимает только свой Host (localhost / 127.0.0.1) и отбивает чужой. В этом режиме панель работает как доверенный оператор и своей авторизации не требует - замком служит пароль на периметре. Бинд на 0.0.0.0 снимает проверку Host, но тогда включается собственная авторизация Gateway и порт торчит на всех интерфейсах.
2. WebSocket
Встроенный чат ходит по WebSocket. Тупой TCP-форвард (например socat) или обратный прокси без проброса WebSocket дают «немой» интерфейс: панель открывается, а окно диалога молчит. В прокси обязательно включите проброс WS (Upgrade/Connection).
3. Доверенный прокси и публичный адрес
Раз панель спрятана за localhost, она считает свой адрес локальным и на чужой Host не пускает. Штатный способ отдать ее наружу - режим доверенного прокси: gateway.auth.mode: "trusted-proxy" плюс список gateway.trustedProxies; для локального прокси на том же хосте нужен еще gateway.auth.trustedProxy.allowLoopback = true. Тогда авторизацию берет на себя ваш периметр, а Gateway доверяет пришедшим от него заголовкам.
4. Матчинг Host у промежуточного прокси
Та грабля, что ищут дольше всего. Если промежуточный прокси настроен на конкретный адрес-с-хостом (http://ВНУТРЕННИЙ_IP:порт { … }), он отвечает только на этот Host. А периметр присылает Host вашего домена - совпадения нет, и прокси отдает пустой 200: белый экран, при этом в Network все «200», тело 0 байт. Адрес сайта должен матчить любой Host.
Рабочая схема (обобщенно, без наших доменов и IP): периметр терминирует TLS и вешает basic-auth, за ним - промежуточный прокси на внутреннем интерфейсе с подменой Host и пробросом WebSocket, за ним - дашборд на loopback:
Периметр (Traefik): TLS + basic-auth
-> промежуточный прокси на внутреннем интерфейсе (любой Host):
header_up Host localhost # проходит проверку Host дашборда
reverse_proxy 127.0.0.1:18789 # проброс WebSocket обязателен
-> openclaw dashboard на 127.0.0.1:18789 (loopback)
Плюс на Gateway включен режим доверенного прокси (gateway.auth.mode: "trusted-proxy" + trustedProxies). Итог: TLS и пароль на периметре, дашборд сидит на loopback и не светит порт наружу, чат по WebSocket работает.
Заложите полчаса. Тут четыре независимые проверки - Host дашборда, WebSocket, режим доверенного прокси и матчинг Host на промежуточном прокси, - и любая одна роняет в белый экран или 400. Диагностический ориентир: если панель отдает «200», но тело 0 байт - это почти всегда пункт 4, промежуточный прокси не матчит присланный Host.
Связь с другими стеками
- Paperclip - оркестратор: может звать OpenClaw как управляемого воркера-рантайма. Разные слои, не конкуренты.
- Hermes - сосед по категории ai-ops: тоже персональный агент-рантайм с работой из мессенджеров и BYOM.
- Claude Code - еще один рантайм-воркер рядом в экосистеме; OpenClaw умеет запускать ACP-совместимых кодинг-агентов.
- Исходящий прокси - на RU-хосте обязателен для доступа к LLM-провайдеру (геоблок 403).
Когда это НЕ ваш выбор
Нужен готовый zero-config SaaS-чатбот без терминала
OpenClaw - self-hosted инструмент: установка, онбординг провайдера и настройка каналов идут из терминала. Если нужен готовый веб-чатбот из коробки без своего сервера, это другой класс продуктов.
Сервер не может достучаться до LLM и прокси не поднять
На российском хосте без исходящего прокси LLM-провайдер геоблокируется. Если поднять прокси нельзя, агент останется без работающей модели - Gateway и каналы будут, а ответов нет.
Неприемлем CLI-first контроль
Основной контроль над OpenClaw - через терминал, команды и конфиг. Веб-дашборд есть, но установка и базовая настройка предполагают SSH и CLI. Если это неприемлемо, стоит выбрать другой подход.
Частые вопросы
Нужен ли Docker?
Нет. Базовая установка идет через npm (пакет openclaw на Node.js), контейнеров ноль. Docker-вариант есть (образ ghcr.io/openclaw/openclaw), но по умолчанию не требуется.
Хватит ли тарифа?
Да. На CPU2-RAM4-DISK50 ставится с запасом: установка около 102 c и ~375 МБ, Gateway в простое держит ~510 МБ RAM.
Почему агент не отвечает на российском сервере?
Нужен LLM-ключ (BYOM), а провайдеры геоблокируют российские IP - прямой запрос отдает 403. Нужен исходящий прокси к провайдеру; после этого диалог работает.
Какие каналы поддерживаются?
Telegram, Signal, WhatsApp, Slack, Discord, iMessage, Matrix, Microsoft Teams, Google Chat, Zalo и другие - как встроенные каналы или плагины. Один Gateway обслуживает их одновременно.
Можно принести свою модель?
Да, схема BYOM: ключ Anthropic, OpenAI, Google и других провайдеров. Провайдер выбирается на онбординге (openclaw onboard).
Как обновлять?
npm install -g openclaw@latest (stable-канал по умолчанию; beta ставится явно).
Какая лицензия?
MIT.
Итог
OpenClaw - удобный self-hosted мост между вашими мессенджерами и персональным AI-агентом: один Gateway на MIT-лицензии связывает Telegram, Signal, WhatsApp, Slack, Discord и другие каналы с агентом, у которого своя персона, память между сессиями и навыки. Ставится за ~102 секунды одной командой через npm, без Docker, весит около 375 МБ, а Gateway в простое держит примерно 510 МБ RAM - тарифа CPU2-RAM4-DISK50 хватает. Главная оговорка для развертывания у себя в РФ: нужен LLM-ключ (BYOM), а провайдеры геоблокируют российские IP, поэтому без исходящего прокси агент не отвечает. Сам Gateway при этом ставится и работает. Проект молодой, релизы частые - фиксируйте версию и закладывайте сопровождение.
Этот шлюз мы разворачивали на тарифе CPU2-RAM4-DISK50 Fatmetal Cloud Server. Нашли неточность в гайде - напишите, поправим в течение дня.