OpenClaw — self-hosted AI-агент с открытым кодом (MIT). Один процесс Gateway соединяет мессенджеры с LLM и инструментами, память и Skills расширяются. Полный контроль остаётся у тебя.

Что это

OpenClaw — это локальный шлюз (Gateway) для AI-агентов. Один процесс на твоей машине соединяет мессенджеры (Telegram, WhatsApp, Discord, Slack, Signal, iMessage, Matrix, Teams и другие) с LLM-моделями и инструментами. Агент отвечает в чате, помнит контекст, вызывает инструменты, выполняет задачи.

Отличие от облачных ассистентов: всё работает на твоём железе или VPS. Данные не уходят к вендору агента, API-ключи моделей — твои. Лицензия MIT — код открыт, можно форкать и дописывать.

Ключевое правило: OpenClaw — это инфраструктурный слой (Gateway), а не готовая «коробочная личность». Какие Skills подключишь, какую модель поставишь — то и получишь.

Зачем нужно

  • Постоянный контекст — агент помнит твои предпочтения между сессиями, не нужно каждый раз объяснять «кто я и что люблю».
  • Один агент на все каналы — пишешь в Telegram, отвечает и в Telegram. Переключился в WhatsApp — там тот же контекст, та же память.
  • Инструменты без кода — браузер, shell, файлы, cron, календарь — подключаются как Skills, не нужно писать интеграции руками.
  • Смена моделей под задачу — подключай Claude, GPT, локальную LLM или дешёвую модель для рутины.
  • Полный контроль безопасности — sandbox-режим для незнакомых Skills, allowlist для отправителей, отдельный sandbox для банковских операций.

Как устроено

Один Gateway — это control plane, к которому подключаются каналы, LLM, инструменты и mobile-ноды (iOS/Android).

GatewayОдин процесс-оркестратор: сессии, маршрутизация, каналы, инструменты, события. Точка входа всего.
ChannelsTelegram, WhatsApp, Discord, Slack, Signal, iMessage, Matrix, Teams, Google Chat, IRC, Feishu, LINE, Mattermost, Zalo, WebChat и другие.
AgentLLM-агент с tool use, памятью и multi-agent routing. По умолчанию — bundled runtime с сессиями per-sender.
CLIКоманды openclaw gateway, openclaw onboard, openclaw doctor, openclaw agent --message "…".
Web Control UIБраузерный дашборд http://127.0.0.1:18789/ — чат, конфиг, сессии, ноды.
Mobile nodesПарные iOS/Android-приложения: Canvas, камера, голос, push-to-talk.
SkillsПлагины для инструментов и интеграций. Каталог — ClawHub.

Конфиг живёт в ~/.openclaw/openclaw.json — JSON5 с комментариями. По умолчанию всё безопасно (DM pairing, sandbox для non-main сессий), но это меняется флагами.

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

Нужен личный AI-ассистент в мессенджереДаMulti-channel, постоянная память, пишешь с любого устройства
Хочу контролировать данные и не платить Saaсу за хранениеДаSelf-hosted, MIT, свои API-ключи
Строю команду автономных агентов под разные задачиДаMulti-agent routing, изолированные сессии per-agent
Нужен production-чат-бот для бизнеса с SLAНетЭто персональный ассистент, не корпоративный бот с поддержкой
Нет своего сервера и не хочется разбираться с VPSОграниченноПоднимется на ноутбуке/Mac Mini, но VPS удобнее для 24/7

Пример

Установка и запуск с нуля занимают 5–15 минут. Ниже — полный путь: от Node.js до первого сообщения агенту в мессенджере.

Шаг 1. Требования к системе

Node.js22.19+ LTS24 LTS
ОСmacOS, Linux, Windows (через WSL2)macOS, Linux
Оперативная память1 ГБ2–4 ГБ (с mobile nodes)
Жёсткий диск2 ГБ5+ ГБ (с Skills и логами)

Проверить версию Node:

node --version

Должно быть v22.19.0 или выше. Если ниже — обнови: nodejs.org или nvm install 24.

Шаг 2. Установка OpenClaw

Через npm (глобально):

npm install -g openclaw@latest

Альтернативы — pnpm или bun (если установлены):

pnpm add -g openclaw@latest
bun add -g openclaw@latest

Проверить, что команда доступна:

openclaw --version

Шаг 3. Онбординг и установка сервиса

openclaw onboard — пошаговый мастер: спросит про модель, каналы, workspace. Ключ --install-daemon ставит Gateway как системный сервис (launchd на macOS, systemd user service на Linux), чтобы агент работал 24/7 без открытого терминала.

openclaw onboard --install-daemon

Мастер предложит:

  • выбрать провайдера модели (Anthropic, OpenAI, OpenRouter, локальная)
  • ввести API-ключ
  • выбрать каналы для подключения
  • создать workspace для Skills и памяти

Совет: если не хочешь выбирать модель в мастере — оставь провайдера по умолчанию и настрой позже в ~/.openclaw/openclaw.json.

Проверить, что daemon запустился:

openclaw gateway status

Ожидаемый результат: статус running, uptime, PID процесса.

Шаг 4. Выбор провайдера модели

OpenClaw поддерживает любого провайдера, для которого есть API-ключ или OAuth-подключение. Привязки к одному вендору нет. Три основных пути — выбирай под свой бюджет, требования к приватности и железо:

Прямой провайдер (Anthropic, OpenAI, Google)Нужна максимальная скорость ответа, официальная поддержка, флагманская модельAPI-ключ провайдера + оплата по тарифу
Агрегатор (OpenRouter и аналоги)Хочешь один ключ и десятки моделей; рутину гонять на дешёвой, сложные задачи — на флагмане; проще сравниватьAPI-ключ агрегатора + оплата по тарифу
OAuth к подписке (ChatGPT, Claude Pro)Уже есть платная подписка, не хочешь платить второй разПодписка провайдера + OAuth-токен
Локальная модель (Ollama, LM Studio, llama.cpp)Данные не должны уходить во внешние сервисы; есть GPU или мощный CPUЖелезо (GPU 12+ ГБ VRAM для 7B, 24+ ГБ для 30B+) + установленный рантайм

Ключевое правило: начинай с того, что уже есть под рукой — подписка ChatGPT/Claude Pro через OAuth, локальная модель на домашнем GPU, прямой API-ключ Anthropic/OpenAI, или OpenRouter как агрегатор. OpenClaw не диктует выбор — диктует задача.

Открой ~/.openclaw/openclaw.json и добавь провайдера в providers:

{
  "providers": {
    "anthropic": {
      "apiKey": "sk-ant-..."
    }
  },
  "models": {
    "default": "anthropic/claude-sonnet-4.5",
    "fallbacks": ["anthropic/claude-haiku-4.5"]
  }
}
{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-..."
    }
  },
  "models": {
    "default": "openrouter/anthropic/claude-sonnet-4.5",
    "fallbacks": [
      "openrouter/openai/gpt-4o-mini",
      "openrouter/google/gemini-flash"
    ]
  }
}

Ключ OpenRouter получаешь на openrouter.ai (регистрация + пополнение баланса от $5). Полный список моделей — на openrouter.ai/models. Формат имени: <провайдер>/<вендор>/<модель>.

Запусти локальный сервер Ollama, скачай модель:

ollama serve
ollama pull llama3.1:8b

В конфиге OpenClaw укажи endpoint Ollama как провайдера:

{
  "providers": {
    "ollama": {
      "baseUrl": "http://127.0.0.1:11434/v1"
    }
  },
  "models": {
    "default": "ollama/llama3.1:8b"
  }
}

Важно: для локальных моделей нужно много железа — 7B модель требует 12+ ГБ VRAM, 30B — 24+ ГБ. Без GPU ответы будут медленными. Для серьёзных задач (агенты с длинным контекстом, длинные диалоги) локальные модели уступают облачным флагманам. Если железа не хватает — дешевле и быстрее взять облачную модель начального уровня (Haiku, GPT-4o-mini, Gemini Flash), чем гонять локальную на CPU.

Смена — на лету, без перезапуска Gateway:

openclaw model list                              # список доступных
openclaw model set anthropic/claude-haiku-4.5   # переключить по умолчанию
openclaw agent --message "Привет" --model openai/gpt-4o-mini   # разовая задача

Настрой fallbacks — если основная модель упала или превысила лимит, Gateway автоматически попробует следующую по списку.

Шаг 5. Запуск Control UI

openclaw dashboard

Откроется браузер на http://127.0.0.1:18789/ — там чат с агентом, список сессий, настройки. Можно писать агенту прямо из дашборда, не подключая мессенджеры.

Шаг 6. Подключение мессенджера

Telegram (самый быстрый):

  1. Открыть @BotFather в Telegram, отправить /newbot, задать имя и username
  2. Скопировать токен бота
  3. Указать токен в ~/.openclaw/openclaw.json:
{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456:ABC-DEF...",
      "dmPolicy": "pairing"
    }
  }
}
  1. Перезапустить Gateway: openclaw gateway restart
  2. Написать боту любое сообщение — он пришлёт pairing-код
  3. Подтвердить: openclaw pairing approve
  4. Готово — пишешь боту, отвечает агент

WhatsApp (через QR):

openclaw channels login whatsapp

Откроется QR-код — сканируешь в приложении WhatsApp → Связанные устройства.

Discord / Slack / Signal / iMessage — аналогично, настройки в channels.<имя> секции конфига. Полные инструкции по каждому каналу — в официальной документации.

Шаг 7. Первые команды агенту

Через CLI:

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

Через мессенджер (например Telegram) — просто пишешь боту:

  • «Привет, я новичок. Расскажи что ты умеешь и настройся под меня»
  • «Сделай ежедневный брифинг в 9 утра»
  • «Найди самую дешёвую перелётную цену в Лиссабон на следующей неделе»
  • «Создай skill для отслеживания курса доллара»

Полезные slash-команды в чате:

/statusСколько стоит последний ответ
/usage fullДетальная статистика расходов по моделям
/model listСписок доступных моделей
/model set <name>Сменить модель на лету
/newНовая сессия (чистый контекст)
/resetСбросить текущую сессию
/restartПерезапустить Gateway

Шаг 8. Проверка здоровья

openclaw doctor

Команда проверяет: версии Node, состояние daemon, рискованные DM-политики, конфиг-ошибки, доступность моделей. Запускай после каждого изменения конфига и раз в неделю для профилактики.

Альтернативные способы установки

  • Docker / Podman — официальный образ для запуска в контейнере. Документация: docs.openclaw.ai/install/docker
  • Cloudflare Workers — запуск Gateway на free tier Cloudflare. Подходит для лёгких сценариев без тяжёлых Skills.
  • Source checkout (для контрибьюторов):
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm openclaw setup
pnpm gateway:watch   # dev loop с auto-reload

pnpm обязателен для работы с исходниками — репозиторий это pnpm-workspace.

Ограничения

ОграничениеПояснение
По умолчанию агент работает с полным доступом к системе.В main-сессии это удобно (если работаешь один), но опасно для Skills из непроверенных источников.
Self-hosted = ты отвечаешь за uptime.Если ноутбук спит — агент не отвечает. Для 24/7 нужен VPS, Mac Mini или Raspberry Pi 5.
OAuth к подпискам (ChatGPT, Claude Pro) поддерживается, но не всеми провайдерами одинаково.Проверяй список в документации моделей.
Стоимость LLM ложится на тебя.Подписка OpenAI/Anthropic, оплата по API, или тариф агрегатора. Локальные модели бесплатны, но требуют GPU.
Mobile nodes требуют pairing через WebSocket Gatewayне работают, если Gateway выключен.
Inbox-каналы = untrusted input. Любой присланный файл или команда — потенциальный prompt injection. Документация прямо предупреждает:относись к inbound DM как к ненадёжным данным.

Антипаттерны

АнтипаттернПочему опасно
Не делать:запускать агента в main-режиме с Skills из непроверенных источников. Один неаккуратный Skill — и он получит доступ к shell. Используй agents.defaults.sandbox.mode: "non-main" для незнакомых плагинов.
Не делать:давать агенту банковские пароли или доступ к production-базам без отдельного sandbox. Sandbox по умолчанию режет browser, canvas, nodes, cron, discord, gateway — для финансов этого мало, нужен свой jail.
Не делать:ставить dmPolicy: "open" для канала, к которому подключены чужие пользователи. Сначала dmPolicy: "pairing", потом явный opt-in.
Не делать:заливать конфиденциальные файлы в общую папку workspace и ждать, что агент «поймёт» что нельзя трогать. Настрой allowFrom для конкретных пользователей и изолируй workspace per-agent.
Не делать:игнорировать openclaw doctor. Эта команда показывает рискованные DM-политики и конфиг-ошибки до того, как они выстрелят.

Чеклист

Node 24 или 22.19+ LTSnode --version — должно быть ≥22.19
Gateway работает как daemonopenclaw onboard --install-daemon
Модель подключенаAPI-ключ прямого провайдера, OAuth-токен подписки, ключ агрегатора (OpenRouter и т.п.), или локальный endpoint (Ollama) в ~/.openclaw/openclaw.json
Telegram подключёнБот через @BotFather → openclaw pairing approve
DM-политика безопаснаПо умолчанию dmPolicy: "pairing", allowlist для known senders
Sandbox для Skillsagents.defaults.sandbox.mode: "non-main" в конфиге
Регулярный аудитopenclaw doctor после изменения конфига
Бэкап конфига~/.openclaw/openclaw.json в системе контроля версий или облаке

Технические детали, версии, команды, ограничения и ссылки проверены по официальным источникам OpenClaw (docs.openclaw.ai и github.com/openclaw/openclaw) на 01.06.2026. Если найдёшь расхождение — ориентируйся на официальную документацию.

Ссылки

По теме