Как запустить и пользоваться OpenClaw: пошаговая инструкция
OpenClaw — это полноценный автономный ИИ-агент и оркестратор с открытым исходным кодом. В отличие от обычных чат-ботов, эта система взаимодействует с операционной системой и связывает большие языковые модели (LLM) с внешними сервисами. OpenClaw функционирует как оркестрационный слой: он может работать в фоновом режиме, выполняя задачи без постоянного участия пользователя.
Главная особенность проекта — модель «Bring Your Own Key» (BYOK). Пользователь может подключить собственный API-ключ, а OpenClaw автоматизирует работу браузера, файловой системы и мессенджеров, включая Telegram, WhatsApp*, Slack, Discord и iMessage. Система использует «навыки» для управления цифровой средой, превращая LLM в активного ассистента.
OpenClaw: что это и откуда появился
OpenClaw работает как связующее звено между LLM и инструментами ОС. Оркестратор позволяет настраивать цепочки действий, где ИИ самостоятельно выбирает инструмент для достижения цели. Если нужно проанализировать документы в папке и отправить сводку в Slack, агент сделает это автономно. Проект ориентирован на то, чтобы автоматизировать рутинные действия через команды на естественном языке, еще и в удобном формате чата в мессенджере.
Автономность позволяет системе работать в фоновом режиме, принимая решения на основе заданных параметров. Это подходит для массы задач — от мониторинга цен до сборки регулярных отчетов. Благодаря открытому коду пользователи могут добавлять новые навыки или интеграцию специфические сервисы.
История создания
Проект официально стартовал в ноябре 2025 года под названием Clawdbot. Создатель проекта, Питер Штайнбергер (кстати, создатель PSPDFKit), стремился создать инструмент, который понимает контекст работы пользователя и взаимодействует с интерфейсами программ. В основе лежит модульная архитектура, где каждый новый навык расширяет возможности агента.
Идея автономности привлекла сообщество энтузиастов, начавших разработку плагинов и расширений. Открытость позволила проекту расти быстрее коммерческих аналогов, ограниченных рамками одной экосистемы.
В конце января название пришлось поменять, потому что Anthropic выдвинула претензии к товарному знаку, посчитав, что название Clawdbot слишком похоже на Claude. Чтобы избежать судебных разбирательств, проект пару дней назывался Moltbot, а с 30 января окончательно получил имя OpenClaw.
Новое название подчеркивает философию открытого исходного кода и доступности. Ну или тот факт, что это как бы «универсальная клешня» для выполнения любых задач.
Бум популярности
Проект завирусился примерно с конца января. Он стал настолько популярным, что западные соцсети заполонили видео, как разработчики скупают недорогие Mac Mini, чтобы локально запускать на них ассистента.
К началу марта 2026 года проект набрал более 250 000 звезд на GitHub, а темпы роста OpenClaw превзошли показатели Linux.
В середине февраля он фактически стал частью OpenAI — теперь компания выступает финансовым и технологическим спонсором. Сам Питер Штайнбергер в середине февраля перешел в OpenAI, и там возглавил направление разработки персональных агентов.
При этом проект был передан независимому фонду, он сохранил открытый исходный код и остался бесплатным, а его разработкой управляет сообщество.
Какие задачи может выполнять OpenClaw
OpenClaw выступает в роли оркестратора, который использует возможности современных нейросетей (GPT, Claude) для взаимодействия с реальным миром. Агент самостоятельно принимает решения, выбирает инструменты и доводит задачи до конца.
Автономный ИИ-агент
Это базовая возможность — при помощи OpenClaw можно создать своего ИИ-агента, который сможет анализировать сложные запросы и разбивать их на цепочки действий.
Агент понимает, когда нужно использовать браузер, а когда — изменить конфигурацию в файловой системе. Способность принимать решения позволяет ему адаптироваться к меняющимся условиям, например, искать обходные пути при столкновении с капчей или неработающими ссылками.
Например, OpenClaw может взять на себя функции секретаря:
- разбирать почту,
- планировать встречи,
- управлять напоминаниями,
- синхронизироваться с календарями.
Агент работает с файловой системой и выполняет команды Shell, что позволяет автоматизировать установку ПО или поиск файлов по сложным критериям.
В чате можно одновременно выдать рабочие задания и включить музыку / Источник: macstories.net
Веб-автоматизация реализована через OpenClaw Browser с использованием Chrome DevTools Protocol (CDP). Это позволяет агенту взаимодействовать со страницами аналогично человеку.
Иными словами, он умеет буквально нажимать на кнопки в определенных местах в определенное время и анализировать ответ.
Функции для разработчиков
OpenClaw не стал бы настолько популярным, если бы не умел в продвинутые функции для инженеров и DevOps-специалистов.
Приложив относительно немного усилий, можно поручить OpenClaw такие задачи, как:
- Автономный Code Review: агент может сканировать Pull Requests, проверять соответствие стайл-гайдам и искать потенциальные утечки памяти.
- Генерация Unit-тестов: автоматическое создание тестовых покрытий для существующих функций на Python, JavaScript или Go.
- Управление инфраструктурой (IaC): выполнение команд Terraform или Ansible для развертывания окружений на основе текстового описания.
- Интерактивный дебаггинг: агент запускает код в изолированном контейнере, анализирует логи ошибок и предлагает исправленные версии файлов.
- Документирование: автоматическое создание JSDoc, Swagger-спецификаций или README на основе анализа структуры проекта.
Агент может быть проактивным, например, создавая утренний дайджест новостей и курсов валют к моменту пробуждения пользователя.
Дополнительные возможности AgentSkills
Функциональность расширяется через AgentSkills — плагины для подключения внешних сервисов. Маркетплейс навыков ClawHub уже содержит более 22 тысяч модулей. Они позволяют интегрировать OpenClaw с Google, Slack, Discord и GitHub.
Так выглядят подключенные skills в OpenClaw / Источник: macstories.net
Возможности для специалистов:
- Кодинг: помощь в написании кода, поиске багов и развертывании проектов.
- Контент: создание постов для мессенджеров, генерация изображений и автопостинг.
- Исследования: глубокий поиск информации и аудит безопасности.
Что нужно, чтобы запустить OpenClaw
OpenClaw — сам по себе бесплатный инструмент, но чтобы его запустить, нужно подготовить аппаратную и программную среду, а также иметь доступ к языковым моделям. Требования к ресурсам, конечно, не такие, как для локального развертывания LLM, но самое дешевое железо не подойдет.
Ассистент поддерживает три основные ОС:
- Linux: рекомендуются Ubuntu 20.04+, Debian 11+.
- macOS: 12 и выше (то есть, MacBook старше 2016 года может не подойти)
- Windows: можно запускать на Windows 10 и новее, но рекомедуется делать это через WSL2 ради стабильности (то есть, Linux-версию через пакет совместимости).
Обязательно нужен стабильный доступ к сети, а в России стоит дополнительно проверить, что есть доступ к ИИ-модели по API.
Что касается железа, требования такие:
- Процессор: минимум 4 ядра, но лучше 8 (уровня Intel i7, AMD Ryzen 7).
- Оперативная память: минимум 16 ГБ, рекомендуется 32 ГБ.
- Накопитель: SSD от 256 ГБ (NVMe SSD с 40-80 ГБ свободного места).
- Видеокарта (если запускать LLM локально): решения от NVIDIA с поддержкой CUDA. Минимум 12 ГБ VRAM для моделей 7-8B, от 24 ГБ VRAM для моделей 13B+.
То есть, запуск на устройствах уровня Raspberry Pi с малым объемом памяти не рекомендуется из-за нехватки ресурсов для базовых зависимостей.
Необходимое программное обеспечение:
- Git для управления репозиторием.
- Docker Desktop или Docker Engine 20.10+ с Docker Compose.
- Node.js версии 22+.
Для предотвращения ложных срабатываний стоит настроить исключения в антивирусном ПО.
И главное — доступ к LLM. OpenClaw может работать по API с Claude, GPT, Gemini, DeepSeek, Mistral, но при желании можно развернуть модель локально, например, через Ollama (как это сделать — читайте здесь).
Как получить API-ключ бесплатно, можно почитать в этой статье.
Ну и есть вариант запустить OpenClaw на VPS. Это платно, но не очень дорого — есть варианты от 5-10 долларов в месяц. Зато удобнее в том плане, что нет необходимости оставлять включенным свой компьютер (а еще ИИ не удалит с него ничего важного).
Пошаговая инструкция по установке и базовой настройке OpenClaw
Процесс установки хорошо автоматизирован, и даже подробно описан разработчиком. Но чтобы все заработало, стоит соблюдать последовательность действий.
Шаг 1: Подготовка среды и установка CLI
Перед началом убедитесь, что в вашей системе установлены Node.js (версии 22 или выше) и Python 3.10+. Если нет — заранее установите. Для пользователей Windows крайне рекомендуется использовать терминал WSL2 (Ubuntu).
Дальше процедура такая:
- Выполните глобальную установку: Откройте терминал и введите команду
curl -fsSL https://openclaw.ai/install.sh | bash. Если возникли ошибки доступа, используйтеsudo(для Linux/macOS). - Проверка: Введите
openclaw --version. Если команда возвращает номер версии, установка прошла успешно. - Запуск мастера настройки: Введите
openclaw onboard --install-daemon. Эта команда не только создаст необходимые папки конфигурации, но и установит фоновую службу (демон), которая будет поддерживать работу агента даже после закрытия терминала. - Взаимодействие: В процессе установки CLI может запросить путь к директории данных. Нажмите Enter, чтобы оставить значение по умолчанию (обычно
~/.openclaw).
Шаг 2: Настройка шлюза и безопасности
После установки демона система предложит настроить параметры безопасности.
- Генерация токена: CLI сгенерирует уникальный Gateway Token. Обязательно сохраните его в менеджере паролей. Он понадобится для подключения мобильных приложений или веб-интерфейса к вашему агенту.
- Настройка портов: По умолчанию используется порт 8080. Если он занят, мастер предложит ввести альтернативный (например, 8081).
- Проверка: После завершения шага введите
openclaw status. Вы должны увидеть сообщение Daemon is running.
Шаг 3: Подключение мессенджера на примере Telegram
Мессенджер станет основным интерфейсом общения с вашим ИИ-агентом.
- Создание бота: Найдите в Telegram @BotFather, отправьте команду
/newbot, следуйте инструкциям и получите API Token. - Привязка: В терминале выберите пункт Connect Messenger (используйте стрелки на клавиатуре для навигации и Enter для выбора) и выберите Telegram.
- Ввод данных: Вставьте скопированный токен в поле Enter Bot Token.
- Авторизация владельца: Отправьте любое сообщение вашему новому боту в Telegram. OpenClaw в терминале отобразит ваш ID и спросит: Set this user as Admin? (y/n). Нажмите y. Это гарантирует, что только вы сможете управлять агентом.
Все это работает не только через Telegram, можно выбрать WhatsApp**, Discord, Slack, Signal и iMessage — можно выбрать вариант, который у вас пока еще не заблокирован.
Шаг 4: Конфигурация LLM
На этом этапе вы определяете, какую нейросеть будет использовать OpenClaw для обработки запросов.
В меню мастера выберите Configure LLM. Вам будут предложены варианты с OpenAI, Anthropic и другими моделями, OpenRouter или Local (Ollama):
- Облачный вариант: Если вы выбрали Anthropic, вставьте ваш API-ключ.
- Локальный вариант: Выберите Local Ollama. Убедитесь, что приложение Ollama запущено на вашем ПК. Мастер сам обнаружит доступные модели (например, Llama 3 или Mistral).
Для проверки связи нажмите кнопку Test Connection. Если всё настроено верно, вы увидите зеленую галочку и сообщение LLM is reachable.
Шаг 5: Активация базовых навыков (Skills)
Чтобы агент мог не только говорить, но и делать, нужно активировать модули управления.
- Доступ к файлам: Включите навык FileSystem. Система спросит, к каким папкам разрешить доступ. Рекомендуется создать отдельную папку (например,
~/openclaw_workspace) и указать путь к ней, чтобы агент не имел доступа ко всей системе. - Браузер: Активируйте WebBrowser. Это позволит агенту гуглить информацию и заходить на сайты.
- Завершение: Введите команду
openclaw start. Теперь вы можете написать своему боту в Telegram: «Привет, создай текстовый файл со списком дел на сегодня». Если файл появился в рабочей папке — настройка завершена успешно!
Примеры использования OpenClaw
Агент может самостоятельно посещать сайты, скачивать отчеты и отправлять выжимки в мессенджер. Но на самом деле ассистент может гораздо больше.
Можно использовать OpenClaw и для личных, и для рабочих целей:
- Личный секретарь: мониторинг сообщений, создание напоминаний, организация поездок.
- Аналитик: сбор тезисов из множества источников, трекинг здоровья на основе фото еды и заказ продуктов.
- Голосовой помощник: использование Whisper для расшифровки заметок и превращения их в планы действий.
- ИИ-ассистент: управление инфраструктурой на AWS или Azure через Shell, модерация стримов, корпоративный Slack-бот.
- Подготовка к встречам: сбор контекста по участникам и подготовка брифов. Сложные процессы рекомендуется дробить на задачи по 4-6 шагов.
Более продвинутые варианты:
- Автоматический рефакторинг легаси-кода: Реализуется через навык FileSystem и Shell. Агент читает файлы проекта, анализирует их на соответствие современным стандартам (например, перевод с ES5 на ES6+) и создает новую ветку в Git с изменениями.
- CI/CD мониторинг: Реализуется через интеграцию с GitHub Actions API. Агент отслеживает статус сборки; в случае падения он запрашивает логи, анализирует причину ошибки и присылает в Telegram краткий отчет с предложением фикса.
- Парсинг конкурентов и цен: Реализуется через WebBrowser (CDP). Агент по расписанию заходит на сайты конкурентов, обходит динамическую подгрузку контента, собирает цены в таблицу CSV и загружает её в Google Drive.
- Умный поиск по локальной базе знаний: Реализуется через индексацию папки с Markdown-файлами. Агент использует векторный поиск для нахождения ответов на вопросы пользователя, основываясь только на его личных заметках.
- Автоматизация отчетности в Jira/Trello: Реализуется через API-навыки. Агент анализирует активность в Slack-каналах команды за день и автоматически создает тикеты или обновляет статусы задач, экономя время на дейли-митингах.
Возможные проблемы и их решение
Команда openclaw doctor --fix устраняет большинство ошибок конфигурации.
Проблемы могут быть такие:
- 401 Unauthorized: проверьте корректность API-ключа.
- Ошибка 1008: перегенерините токен шлюза и перезапустите демон.
- 429 Rate Limit Exceeded: повысьте уровень аккаунта у провайдера или настройте задержку между запросами.
- Агент не отвечает: проверьте квоты и статус подписки. Попробуйте сменить модель на более легкую. В случае вылетов после активации новых плагинов, отключите их — нестабильные модули часто вызывают падение шлюза.
Система может инициировать 4-5 фоновых вызовов на одно сообщение. Для экономии отключите автогенерацию заголовков и тегов, оптимизируйте историю диалогов и используйте бюджетные модели для мониторинга.
Особо острый вопрос — безопасность. Например, есть кейс, как OpenClaw удалил сотни электронных писем у директора по безопасности ИИ из Meta* Саммер Ю, которая как раз его тестировала:
Источник: x.com
Чтобы ваши данные были в безопасности, стоит заранее предпринять меры:
- Запускайте OpenClaw в Docker или на выделенном VPS.
- Ограничьте доступ к личным файлам и используйте тестовые аккаунты.
- Используйте переменные окружения для хранения ключей.
Расходы на доступ
Доступ к ИИ-моделям по API составляет 70-85% стоимости работы ассистента. Чтобы сэкономить, используйте дорогие модели (Claude Opus 4.6, GPT-5.3) для планирования, а рутинные задачи отдавайте дешевым моделям (Gemini 2.5 Flash-Lite, DeepSeek V3.2).
| Уровень модели | Цена за 1M токенов | Модели |
|---|---|---|
| Level 1 (Дешевые) | 0-0.5$ | Gemini 2.5 Flash-Lite, Llama 3.2 1B (Local), Mistral NeMo 12B |
| Level 2 (Средние) | 0.5-15$ | DeepSeek V3.2, GPT-4o mini, Claude 3.5 Haiku |
| Level 3 (Премиум) | 15-30$ | Claude Opus 4.5, GPT-5, Gemini 2.0 Pro |
Управляйте памятью через файлы AGENTS.md, SOUL.md, IDENTITY.md и MEMORY.md. Регулярно обновляйте контекст в USER.md и начинайте новые сессии для крупных задач.
Выводы
OpenClaw — мощный фреймворк, обеспечивающий контроль над данными и процессами автоматизации, но требующий внимания к безопасности из-за глубокого доступа к системе.
Проект поддерживается сообществом в Discord (60 000+ участников) и получил гранты на развитие. В репозитории доступно более 13 700 навыков. Ожидается дальнейшая интеграция с новыми LLM и развитие мультиагентных систем.
