OpenClaw: self-hosted агент с доступом через мессенджеры

OpenClaw — self-hosted AI-ассистент с открытым кодом, который живёт на вашем сервере и отвечает в мессенджерах. Один Gateway соединяет Telegram, WhatsApp, Discord, Slack и ещё два десятка каналов с выбранной совместимой моделью — от Claude и GPT до локальных моделей через Ollama.

Что это

OpenClaw — это шлюз между мессенджерами и языковыми моделями. Один процесс на вашей машине или VPS принимает сообщения из подключённых каналов, передаёт их LLM-агенту и возвращает ответ туда же. Агент хранит историю сессий, может использовать настроенную долговременную память, вызывать инструменты и запускать задачи по расписанию.

Проект распространяется по лицензии MIT и развивается как некоммерческий Foundation 501(c)(3). Исходный код открыт, а Gateway и хранилище сессий работают на вашей инфраструктуре. Но при использовании облачной модели сообщения передаются её провайдеру, а мессенджеры обрабатывают их на своей стороне. OpenClaw поддерживает десятки каналов, включая Telegram, WhatsApp, Discord, Slack, Signal, iMessage, Matrix, Microsoft Teams, Google Chat, Zalo, LINE, IRC и другие.

Архитектурно OpenClaw напоминает обратный прокси: Gateway стоит между клиентами (мессенджерами) и внутренними сервисами (моделями, инструментами, памятью) и маршрутизирует запросы. Начать можно одной командой — npx openclaw@latest — а дальше онбординг сам найдёт доступные логины Claude Code или Codex и предложит подключить канал.

Ключевое правило: OpenClaw — инфраструктура, а не готовая «личность». Какие Skills и модели подключите, такой характер и получите.

Зачем нужно

• Постоянная память в мессенджере — агент помнит предпочтения между сессиями, не нужно каждый раз объяснять, кто вы и что любите.
• Работа через несколько каналов — один Gateway подключает разных мессенджеров. Общий контекст между ними зависит от маршрутизации, настроек сессий и связывания идентификаторов пользователя; он не гарантирован автоматически.
• Инструменты и Skills — агент может работать с браузером, командной строкой и файлами, а также запускать задачи по расписанию. Часть возможностей встроена, другие требуют настройки доступа, установки Skills или подключения внешних сервисов.
• Смена моделей под задачу — сегодня Claude, завтра GPT или локальная LLM; переключение на лету, плюс fallbacks на случай сбоя провайдера.
• Контроль инфраструктуры — конфигурация, локальные сессии и инструменты находятся под вашим управлением. Для конфиденциальной работы нужно отдельно оценить провайдера модели, мессенджер и права доступа агента.

Как устроено

Пять компонентов формируют стек OpenClaw. Gateway — единственная точка входа, остальное подключается к нему.

Конфиг живёт в ~/.openclaw/openclaw.json — JSON5 с комментариями. Для незнакомых отправителей в личных сообщениях обычно используется DM pairing, но реальные границы доступа зависят от настроек канала, инструментов и песочницы. openclaw triage — отдельная команда диагностики, а не механизм проверки каждого входящего сообщения. Веб-дашборд Control UI в OpenClaw 2.0 (v2026.8.1, август 2026) полностью переработан — там чат, конфиг, сессии и ноды. Мобильные ноды — парные iOS/Android-приложения с Canvas, камерой, голосом и push-to-talk.

Требования: Node.js 24.16+ на ветке 24.x или 26.1+ (рекомендуется 26.x; патчи безопасности — 24.22.1+ / 26.12.1+), достаточно ресурсов для Gateway и подключённых инструментов; конкретный объём RAM и диска зависит от сценария. ОС — macOS, Linux, Windows через WSL2 или нативную установку. Первичная установка может занять несколько минут, а настройка каналов и доступов — больше. OpenClaw ориентирован на персональные и самостоятельно администрируемые сценарии; готовых гарантий доступности или поддержки по SLA нет; без своего сервера или VPS ноутбук нужно держать включённым для режима 24/7; локальные модели могут работать и на CPU, но скорость и требования к памяти зависят от модели, квантования и длины контекста; для ресурсоёмких моделей обычно удобнее GPU — а gateway и Control UI по умолчанию слушают на локалхосте, для доступа извне нужен туннель или реверс-прокси.

Когда использовать

Пример

Соберём рабочий контур от нуля до первого сообщения в Telegram. Команды ниже ориентированы на официальную документацию OpenClaw, актуальную на 07.11.2026. Перед запуском проверьте установленную версию: интерфейс CLI и доступные модели могут меняться.

Шаг 1. Установка

Быстрый старт без глобальной установки пакета — для пробы (Node.js всё равно потребуется):

npx openclaw@latest
# выберите Quick start — подхватит логин Claude Code/Codex или ключ из окружения

Рекомендуемый способ — установочный скрипт (macOS / Linux / WSL2):

curl -fsSL https://openclaw.ai/install.sh | bash

 # Для Windows используйте PowerShell:
# iwr -useb https://openclaw.ai/install.ps1 | iex

# Альтернатива через npm, если Node уже стоит:
# npm install -g openclaw@latest

openclaw --version
node --version  # должно быть 24.16+ или 26.1+

Шаг 2. Онбординг и сервис

openclaw onboard
# или классический мастер:
# openclaw onboard --classic

# Поставить Gateway как системный сервис (чтобы работал 24/7 без открытого терминала):
openclaw gateway install
openclaw gateway start
openclaw gateway status  # running, uptime, PID, порт 18789

# Открыть веб-дашборд:
openclaw dashboard  # http://127.0.0.1:18789/

Шаг 3. Выбор модели

OpenClaw не привязан к одному провайдеру. Для некоторых провайдеров доступно автоматическое обнаружение моделей, но оно зависит от авторизации и настроек; не всякая новая модель появляется без дополнительных действий.

Anthropic напрямую. Для ключа API лучше использовать мастер настройки, чтобы не записывать секрет в пример конфигурации:

openclaw onboard
# в мастере выберите Anthropic API key
openclaw models list --provider anthropic
openclaw models set anthropic/claude-sonnet-4-6

Если модель уже авторизована, её можно задать в ~/.openclaw/openclaw.json:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6"
      }
    }
  }
}

Через агрегатор OpenRouter (один ключ для моделей разных провайдеров):

openclaw onboard --auth-choice openrouter-api-key
openclaw models set openrouter/auto

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

openclaw models list --provider openrouter
openclaw models set openrouter/anthropic/claude-sonnet-4-6

Для резервной модели предусмотрена отдельная команда openclaw models fallbacks add <provider/model>. Доступность конкретного идентификатора проверяйте в каталоге провайдера.

Локальная модель через Ollama. GPU необязателен, но на CPU генерация может быть заметно медленнее. Установите Ollama и убедитесь, что её сервер работает:

ollama pull gemma4
openclaw onboard
# выберите Ollama → Local only
openclaw models list --provider ollama
openclaw models set ollama/gemma4

OpenClaw использует нативный API Ollama. Если задаёте адрес сервера вручную, указывайте http://127.0.0.1:11434 без суффикса /v1: совместимый с OpenAI режим может нарушать вызов инструментов. Для автоматического обнаружения подходят не любые установленные модели: проверяются загрузка модели, поддержка инструментов и достаточный контекст.

Переключение на лету без перезапуска:

openclaw models list
openclaw models set anthropic/claude-sonnet-4-6
openclaw agent --message "Привет" --model openai/gpt-4o-mini

Шаг 4. Подключение Telegram

Создайте бота через @BotFather командой /newbot, скопируйте выданный токен и добавьте следующий фрагмент в ~/.openclaw/openclaw.json:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "ВАШ_ТОКЕН_БОТА",
      "dmPolicy": "pairing"
    }
  }
}

openclaw gateway restart
# напишите боту в Telegram → получите pairing-код →
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

# WhatsApp по QR:
openclaw channels login --channel whatsapp
# Discord, Slack, Signal и iMessage подключаются по собственным инструкциям; способы авторизации различаются
# Каталог каналов: https://docs.openclaw.ai/channels

Шаг 5. Первые команды и проверка

openclaw agent --message "Привет, расскажи что ты умеешь" --thinking high

# В чате мессенджера:
# /status        — состояние сессии и сведения об использовании
# /usage full    — подробные сведения о расходе токенов и стоимости, если доступны
# /model list    — список моделей
# /new           — новая сессия
# /reset         — сбросить сессию

openclaw doctor
openclaw triage  # диагностика с обезличенным промптом для починки

Альтернативы: Docker / Podman — docs.openclaw.ai/install/docker, Nix через flake, сборка из исходников через pnpm install && pnpm build && pnpm ui:build. Про обмен между сервисами — коротко в статье про API между сервисами, про класс решений — в разборе про AI-агентов, про роль шлюза — в материале про Agent Harness.

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

Ссылки

• Документация: OpenClaw Docs
• Репозиторий: openclaw/openclaw
• Сайт: openclaw.ai

По теме

• База знаний: AI-агенты: что это, как работают и зачем нужны
• База знаний: Agent Harness: как инфраструктура вокруг модели превращает её в автономного агента
• База знаний: API как язык между сервисами: что это, зачем нужно и как читать ответы