Что такое OpenClaw и как он работает: полный гайд по AI-агенту
Почему весь интернет обсуждает OpenClaw
OpenClaw — open-source AI-агент, который работает на вашем компьютере или сервере 24/7 и подключается к мессенджерам: Telegram, WhatsApp, Slack, Discord, Signal и ещё более 15 платформам. Это не чат-бот в браузере — это полноценный агентный рантайм с доступом к файловой системе, терминалу, браузеру, cron-задачам и вебхукам.
За 84 дня после публичного запуска проект набрал 200 000 звёзд на GitHub — быстрее, чем React, Linux и Kubernetes. Первая тысяча звёзд появилась только 24 января 2026 года. Через два дня — 26 января — проект получил 25 310 звёзд за одни сутки, побив все предыдущие рекорды GitHub. С тех пор средний темп — более 1 000 звёзд в день.
Создатель проекта — Peter Steinberger, основатель PSPDFKit. В феврале 2026 года он объявил о переходе в OpenAI и передаче проекта независимому open-source фонду. Андрей Карпатый сравнил траекторию OpenClaw с научной фантастикой, а Илон Маск — с «началом сингулярности».
Проект три раза менял имя: Clawdbot → Moltbot → OpenClaw. Первое название — игра слов от Claude + claw (коготь). Anthropic попросили сменить его из-за сходства с брендом. Moltbot продержался несколько дней. Финальное имя — OpenClaw — подчёркивает open-source природу и сохраняет «коготь» как дань оригиналу.
Как устроен OpenClaw: архитектура
Главное, что нужно понять: OpenClaw — это не Claude Code под капотом. Это оркестрационный слой, который может работать с разными LLM: Claude, GPT, Gemini, DeepSeek, локальные модели через Ollama.
Автор статьи на Хабре точно описал разницу: «Если Claude Code на вашем Mac — это молоток, который вы берёте в руки, когда нужно, то OpenClaw — это молоток с ногами и руками, который сам приходит и спрашивает, не пора ли что-нибудь прибить».
Четыре ключевых компонента
Gateway — фоновый демон на Node.js, который держит подключения ко всем мессенджерам. Это WebSocket control plane с TypeBox schema validation — постоянно работающий сервер, который маршрутизирует сообщения из каналов в сессии. Когда вы пишете боту в Telegram, сообщение попадает именно сюда. Gateway слушает на порту 18789 и отдаёт веб-интерфейс для управления.
Agent Runtime — модель-агностичный LLM-цикл с JSONL-стейтом. Именно здесь происходит «мышление»: агент загружает контекст и скиллы для текущей сессии, отправляет разговор в LLM, выполняет запрошенные инструменты, стримит ответ обратно в канал и записывает разговор и память в workspace.
Skills — модульные возможности агента. Каждый скилл — это файл SKILL.md с YAML front matter плюс опциональные скрипты, бинарники и шаблоны конфигов. На момент написания статьи в ClawHub — маркетплейсе скиллов — более 10 000 расширений от комьюнити. Skills используют стандарт AgentSkills, разработанный Anthropic и принятый несколькими AI-кодинг-ассистентами.
Memory — персистентное хранилище в обычных Markdown-файлах. Гибридная память, которая работает на любом LLM-провайдере. Можно читать и редактировать руками. Архитектура памяти включает:
- Короткая память — папка
memory, файлы по датам. Бот читает за сегодня и вчера - Долгая память —
MEMORY.md, «золотые правила» и важные выводы - Данные о пользователе —
USER.md
Canvas & A2UI — отдельный слой, который позволяет агенту создавать интерактивные HTML-интерфейсы прямо из мессенджера. Это относительно новая функция, которая превращает OpenClaw из текстового помощника в визуальный инструмент.
OpenClaw vs Claude Code: в чём разница
Это самый частый вопрос, и ответ простой: разные инструменты для разных задач.
Лучшие инженеры комбинируют оба: OpenClaw для повседневной автоматизации, Claude Code для разработки. Можно даже из Telegram написать OpenClaw-агенту «fix tests» — он запустит Claude Code, а потом отправит отчёт.
Для серьёзной разработки OpenClaw через мессенджер — не лучший выбор. Он слишком автономный, не спрашивает в ключевых точках, не показывает промежуточные результаты. Для кодинга лучше Claude Code или Codex — там контроль процесса встроен в UX.
Простой критерий: «Могу ли я описать задачу в одном сообщении и не контролировать процесс?» Если да — OpenClaw. Если нужно смотреть, корректировать, итерировать — другой инструмент.
Что умеет OpenClaw: интеграции и возможности
OpenClaw поддерживает 15+ мессенджеров из коробки:
- Telegram, WhatsApp, Slack, Discord, Signal, iMessage
- Matrix, IRC, XMPP
- Email (IMAP/SMTP)
- Webhooks для кастомных интеграций
700+ готовых скиллов в ClawHub покрывают основные сценарии:
- Google Workspace — управление календарём, почтой, документами
- GitHub — мониторинг PR, issues, автоматизация workflow
- Home Assistant — управление умным домом
- Notion / Todoist — управление задачами
- Spotify — управление музыкой
- Whoop / Apple Health — мониторинг здоровья
- Браузер — веб-скрапинг, поиск информации
- Файловая система — работа с файлами и папками
- Терминал — выполнение команд
Что нужно для запуска OpenClaw
Минимальные требования скромные:
- RAM: 1 GB (рекомендовано 4 GB)
- Диск: 500 MB
- Node.js: версия 22+
- ОС: macOS, Linux, Windows (через WSL2)
- API-ключ одного из провайдеров (Anthropic, OpenAI, Google) или локальная модель через Ollama
Работает даже на Raspberry Pi 4 с 4 GB RAM.
Варианты развёртывания
VPS за $5/месяц — оптимальный вариант. DigitalOcean, Vultr, Timeweb — что угодно с Linux. Автор статьи на Хабре две недели работал на 2 vCPU / 4 GB RAM и ни разу не упёрся в ресурсы. Основная работа происходит на стороне LLM-провайдера, локально крутится только оркестрация.
Для использования в России самый лучший вариант по цене/качество/доступность и скорость, кроме того нет проблем с оплатй TimeWebЛичный компьютер — проще всего для старта. OpenClaw запускается как фоновый сервис: на macOS через LaunchAgent, на Linux через systemd.
Mac Mini — хайп, от которого предостерегает сам создатель. Peter Steinberger писал в Twitter: «Пожалуйста, не покупайте Mac Mini, а спонсируйте одного из многочисленных разработчиков OpenClaw. Вы можете развернуть его на бесплатном тарифе Amazon».
Docker — для серверов. Два тома (конфиг + песочница), один порт. Запустил и забыл.
AWS Free Tier — бесплатно на год.
VPS даже безопаснее личного Mac. OpenClaw имеет доступ к файловой системе и может выполнять команды. На изолированном сервере худшее, что случится при баге — он снесёт свои собственные файлы. На рабочем Mac у одного пользователя бот «случайно» удалил проект, над которым тот работал неделю.
Установка OpenClaw: пошаговая инструкция
Шаг 1: Установка Node.js
bash# Устанавливаем nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# Применяем изменения
\. "$HOME/.nvm/nvm.sh"
# Устанавливаем Node.js 22
nvm install 22
# Проверяем
node -v # Должно вывести v22.x.x
Шаг 2: Установка OpenClaw
bash# Вариант 1: one-liner
curl -fsSL https://openclaw.ai/install.sh | bash
# Вариант 2: через npm
npm install -g openclaw@latest
# Проверяем
openclaw --version # v2026.1.29 или новее
Шаг 3: Мастер настройки
bashopenclaw onboard --install-daemon
Мастер проведёт через четыре этапа:
- Предупреждение о безопасности — «I understand this is powerful and inherently risky. Continue?» → Yes
- Режим настройки — выбираем QuickStart (безопасные дефолты)
- Провайдер AI — выбираем Anthropic, OpenAI, Google или Ollama (локальный)
- Подключение каналов — можно пропустить и настроить позже
Шаг 4: Подключение Telegram
Самый популярный канал. Три шага, две минуты:
- Откройте Telegram → найдите @BotFather → отправьте
/newbot - Дайте боту имя и username (должен оканчиваться на
_bot) - Скопируйте токен и вставьте в терминал OpenClaw
После первого сообщения боту в Telegram он выдаст Pairing code. Подтвердите на сервере:
bashopenclaw pairing approve telegram
Шаг 5: Проверка и диагностика
bash# Полная проверка
openclaw doctor
# Автоматическое исправление проблем
openclaw doctor --fix
# Статус Gateway
openclaw gateway status
# Логи в реальном времени
openclaw gateway logs --follow
# Веб-интерфейс
openclaw dashboard # Откроет http://127.0.0.1:18789/
Шаг 6: Настройка веб-поиска
bashopenclaw configure --section web
Выберите «Enable web-search (Brave Search)» → Yes, введите API-ключ Brave Search. С 12 февраля Brave убрали бесплатный тариф для новых пользователей — теперь $5 за 1000 запросов, но дают $5 кредита при привязке карты.
Безопасность: о чём молчат хайповые треды
OpenClaw имеет полный доступ к файловой системе и может выполнять произвольные команды. Это делает его мощным — и опасным.
Что уже случилось
- 341 вредоносный скилл был найден в ClawHub — маркетплейсе расширений. Скиллы распространяли malware
- Критическая уязвимость CVE-2026-25253 — закрыта патчем в конце января
- Фейковые версии — в VS Code Marketplace обнаружено поддельное расширение
- Крипто-скам — через часы после взлёта проекта появился фейковый токен $CLAWD на домене clawdbot.xyz
- Баны аккаунтов — Google массово банит аккаунты за использование OAuth-токенов Antigravity через OpenClaw, включая Ultra-подписчиков за $250/мес
Базовые правила
- Устанавливайте только с официального GitHub:
github.com/openclaw/openclaw - Регулярно обновляйтесь:
openclaw update - Не запускайте под root — создайте отдельного пользователя
- На VPS: настройте firewall (ufw), fail2ban, SSH по ключам
- Всегда читайте, что предлагает агент — особенно
rm,chmod, конфиги, рестарты сервисов
Структура файлов и конфигурация
После установки OpenClaw создаёт директорию ~/.openclaw/ со следующей структурой:
text~/.openclaw/
├── openclaw.json # Основной конфиг (модели, провайдеры)
├── credentials/ # API-ключи и токены
├── workspace/
│ ├── USER.md # Кто вы, предпочтения
│ ├── AGENTS.md # Роль и правила агента
│ ├── HEARTBEAT.md # Настройки проверки состояния
│ ├── MEMORY.md # Долгосрочная память
│ ├── SOUL.md # Характер и тон общения
│ ├── memory/ # Короткая память (по датам)
│ ├── skills/ # Локальные скиллы
│ └── state/ # Файлы состояния
Конфиг модели в openclaw.json:
json{
"model": "anthropic/claude-opus-4-6",
"fallback_model": "anthropic/claude-sonnet-4-6",
"providers": {
"anthropic": { "api_key": "sk-ant-..." }
}
}
anthropic/claude-opus-4-6— лучший для длинного контекстаanthropic/claude-sonnet-4-6— дешевле, быстрееopenai/gpt-4o— если нет ключа Anthropicollama/...— локальные модели бесплатно
Реальные кейсы использования
Это не скриншоты из демо — это то, что люди реально используют каждый день.
Утренний брифинг
Самый популярный use case. По cron-задаче агент каждое утро собирает: данные о сне (Whoop/Apple Health), погоду, расписание встреч из календаря, важные письма, новости по интересующим темам — и присылает одним сообщением в Telegram.
Email на автопилоте
Бот сортирует входящие, выделяет важное, остальное архивирует. Один из пользователей написал: «Теперь я вообще не проверяю почту, потому что OpenClaw сам поднимает важное».
Умный дом
Интеграция с Home Assistant — полное управление устройствами через мессенджер. Один пользователь подключил очиститель воздуха к данным о здоровье: бот мониторит показатели и автоматически регулирует качество воздуха.
Мульти-агентная оркестрация
OpenClaw берёт задачу, управляет Claude Code и Codex, они автономно дебатят код-ревью, и агент сообщает, когда готово. Один пользователь описал: «Целая фича задеплоена, пока я гулял».
AI устанавливает AI
Один из самых вирусных кейсов: OpenClaw сам установил Ollama, чтобы простые задачи делать локально и экономить на API. AI оптимизирует собственную инфраструктуру без участия человека.
8 проблем, с которыми вы столкнётесь
Эти грабли проверены комьюнити — лучше знать о них заранее.
1. Слишком автономный
По умолчанию OpenClaw настроен на максимальную автономность. Там, где Claude Code остановится и спросит, OpenClaw просто сделает. Один пользователь обнаружил, что бот автоматически отвечает на спам-письма.
Решение: добавить в AGENTS.md правило: «Перед любым действием предоставь план и дождись подтверждения». Прописывать несколько раз в разных формулировках — LLM любят «забывать» ограничения.
2. Вопрос = команда
Спросили «как у тебя работает text-to-speech?» — он пошёл ставить Whisper. Спросили «расскажи про свою память» — начал переписывать MEMORY.md. Любой вопрос интерпретируется как «сделай это».
Решение: в AGENTS.md добавить: «Вопрос — это вопрос, не команда. Отвечай словами, не действиями».
3. Ghosting
Пишете сообщение — тишина. Минута, две, пять. Потом: «Я тут, просто размышлял». Причины не всегда ясны.
Решение: написать «ты тут?» через пару минут или сменить модель.
4. Бесконечные циклы
Агент бродит по папкам, ищет что-то, не может найти, но и остановиться не может.
Решение: перезапуск OpenClaw или ребут. Добавить в скиллы правила против зацикливания.
5. Cron не будит сессию
Cron срабатывает, в логах всё ок, но сообщение в Telegram не приходит.
Решение: cron создаёт субагента, субагент явно будит основную сессию и отправляет сообщение.
6. UX-ад в настройках
Веб-интерфейс — сотни опций, непонятно, что важно.
Решение: не пытаться настроить всё сразу. В начале февраля добавили Agents Dashboard — стало удобнее.
7. Память не сохраняется
Два дня переписки испарились. Попросил «сохрани в память» — бот ответил «сохранил», но ничего не записал. У моделей с большим контекстом бот не чувствует необходимости сохранять.
Решение: добавить триггер в AGENTS.md: фраза «хочу начать новый чат» = немедленно сохранить всё важное.
8. Пожиратель токенов
Автономность = много запросов к LLM. Каждое действие = токены. Без контроля — недельный бюджет за день.
Решение: использовать подписку вместо API с оплатой за токены, либо настроить многоуровневую маршрутизацию моделей (дешёвая для рутины, дорогая по запросу).
Провайдеры: как подключить через подписку
Если не хотите платить за API по токенам, можно использовать существующие подписки:
Anthropic (Claude Pro/Max)
В списке провайдеров → Anthropic → Anthropic Token (не API key). Wizard покажет команду claude setup-token — она откроет браузер для авторизации. Копируете токен обратно в терминал.
⚠️ Риск: Anthropic негативно относится к использованию подписки вне своей экосистемы. Есть упоминания о банах.
OpenAI (ChatGPT Plus/Pro)
В списке → OpenAI → OpenAI Codex (не API key). Wizard даст ссылку для авторизации в браузере.
Google (Antigravity/Gemini CLI)
В списке → Google → Google Antigravity или Google Gemini CLI.
⚠️ Риск: Google начал массово банить аккаунты за использование OAuth-токенов через OpenClaw. Блокируют даже Ultra-подписчиков ($250/мес). Если забанили — писать на gemini-code-assist-user-feedback@google.com.
Ollama (бесплатно, локально)
bashopenclaw configure --section auth
# Выбрать "Ollama (локальный)"
# Ввести endpoint: http://localhost:11434
# Выбрать модель
Итог: для кого OpenClaw
OpenClaw — это инструмент, а не магия. Как точно написал один пользователь: «Ощущение, как запускать Linux vs Windows 20 лет назад. Ты контролируешь, можешь хакнуть, сделать своим — вместо того, чтобы зависеть от техногиганта».
OpenClaw для вас, если:
- Вам нравится self-hosting и вы не боитесь терминала
- Хотите автоматизировать рутину, а не делегировать мышление
- Готовы потратить вечер на настройку и пару недель на притирку
- Понимаете разницу между «AI, который думает за вас» и «AI, который всегда рядом»
OpenClaw не для вас, если:
- Хотите «поставил и работает» без настройки
- Ищете замену Claude Code для серьёзной разработки
- Не готовы разбираться в конфигах и промптах
- Ждёте, что AI будет думать за вас
