OpenClaw (ранее известный как Clawdbot и Moltbot) — это мощный опенсорсный AI-агент, который завоевал популярность благодаря своей способности не просто общаться, а выполнять реальные задачи на вашем компьютере: управлять файлами, запускать приложения, взаимодействовать с мессенджерами и даже симулировать действия мыши и клавиатуры. Проект, созданный австрийским разработчиком Петером Штайнбергером, предлагает высокую степень кастомизации и безопасности, запуская модель локально.
В этой статье мы подробно рассмотрим несколько способов установки OpenClaw, их тонкую настройку и меры безопасности, которые необходимо соблюдать при работе с инструментом такого уровня.
📋 Системные требования и подготовка
Перед началом установки убедитесь, что ваша система соответствует минимальным требованиям. Это поможет избежать большинства проблем на ранних этапах.
Операционная система: Windows 10 и новее, macOS 12+, Linux (рекомендуется Ubuntu 22.04+ или Debian 11+).
Среда выполнения: Node.js версии 22 или новее (рекомендуется Node 24). Большинство способов установки автоматизируют этот шаг.
Оперативная память: Минимум 2 ГБ, но для комфортной работы настоятельно рекомендуется 4 ГБ и более.
Свободное место на диске: Окол 500 МБ для базовой установки, плюс место под модели и зависимости.
Сетевой доступ: Требуется для загрузки пакетов, зависимостей и, разумеется, для обращения к API облачных моделей (если вы не используете локальные LLM).
Права доступа: На Windows потребуются права администратора для PowerShell. На Linux и macOS — права sudo для установки системных зависимостей.Важное замечание для пользователей Windows: Настоятельно рекомендуется использовать подсистему WSL2, так как она обеспечивает более стабильную и производительную среду для работы OpenClaw. Если вы планируете использовать установку на "голом" Windows, будьте готовы к возможным незначительным ограничениям.
🚀 Способ 1: Быстрая установка с помощью официального скрипта (Рекомендуется)
Это самый простой и предпочтительный метод для большинства пользователей, поскольку он автоматизирует установку всех необходимых компонентов и зависимостей.
Шаг 1: Запуск скрипта установки
Откройте терминал и выполните команду, соответствующую вашей операционной системе:
- На macOS и Linux:
curl -fsSL https://openclaw.ai/install.sh
- На Windows (PowerShell от имени администратора):
iwr -useb https://openclaw.ai/install.ps1
Скрипт автоматически определит вашу ОС, при необходимости установит Node.js, загрузит и настроит OpenClaw, после чего запустит мастер первоначальной настройки.
Шаг 2: Следуйте указаниям мастера настройки (Onboarding)
Сразу после установки запустится интерактивный мастер. Вот ключевые моменты, на которые стоит обратить внимание:
- Принятие рисков: Подтвердите, что вы осознаете риски использования AI-агента, выбрав
Yes. - Выбор режима: Выберите
QuickStartдля быстрой настройки. - Выбор модели: Один из самых важных шагов. Для пользователей из РФ одним из лучших вариантов является Moonshot AI (Kimi K2.5), который демонстрирует отличную производительность. Вы также можете выбрать OpenAI, Anthropic или другие совместимые API. Для Kimi потребуется выбрать точку доступа
.cnи указать API-ключ, полученный на platform.moonshot.cn. - Выбор каналов связи: Выберите мессенджеры, через которые вы будете взаимодействовать с ассистентом (WhatsApp, Telegram, Discord и др.). На этом этапе можно пропустить настройку, чтобы сначала протестировать работу через TUI-интерфейс.
- Выбор навыков (Skills): Отметьте необходимые навыки, которые будут установлены по умолчанию. Остальные можно добавить позже.
После завершения работы мастера вы можете сразу перейти к тестированию, выбрав опцию TUI (Terminal User Interface).
🐳 Способ 2: Установка с использованием Docker
Идеальный выбор для тех, кто ценит изоляцию, безопасность и воспроизводимость окружения. Этот метод позволяет запустить OpenClaw в контейнере, не затрагивая основную систему.
Шаг 1: Подготовка окружения
Убедитесь, что у вас установлены Docker Engine и Docker Compose v2. Проверьте это командами:
docker --version docker compose version
Шаг 2: Клонирование репозитория с инструкцией
Существует подготовленный репозиторий с полной инструкцией для быстрого старта:
git clone https://github.com/EvilFreelancer/openclaw-docker.git cd openclaw-docker
Внимательно изучите файл README.md и следуйте дальнейшим инструкциям из репозитория. Он проведет вас через настройку docker-compose.yml, где нужно будет указать API-ключи, и запуск контейнера.
Важно: Не открывайте порт 18789, который используется API-шлюзом, для доступа из внешней сети без крайней необходимости.
⚙️ Способ 3: Ручная установка для опытных пользователей
Этот метод дает вам полный контроль над процессом, но требует предварительной настройки окружения.
Шаг 1: Установка Node.js и менеджера пакетов
Убедитесь, что у вас установлены Node.js (v22+) и один из менеджеров пакетов: npm, pnpm или bun.
Шаг 2: Глобальная установка OpenClaw
Выполните команду, соответствующую вашему менеджеру пакетов:
# С использованием npm npm install -g openclaw@latest # С использованием pnpm pnpm add -g openclaw@latest # С использованием bun bun add -g openclaw@latest
После успешной установки запустите мастер настройки:
openclaw onboard --install-daemon
Шаг 3 (Для разработчиков): Установка из исходного кода
Если вы планируете участвовать в разработке или вам нужна самая свежая версия:
git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install && pnpm ui:build && pnpm build pnpm link --global openclaw onboard --install-daemon
Этот метод требует наличия git и pnpm.
🛠️ Базовая настройка и первые шаги после установки
Независимо от выбранного способа установки, следующие шаги помогут вам начать работу.
- Проверка статуса: Убедитесь, что все компоненты запущены и работают корректно.
openclaw status # Общий статус openclaw gateway status # Статус шлюза
- Запуск и остановка:
openclaw gateway start # Запустить шлюз openclaw gateway stop # Остановить шлюз
- Текстовый интерфейс (TUI): Самый быстрый способ проверить, что агент работает.
openclaw tui
- Для выхода из TUI в любой момент нажмите Ctrl+C.
🩺 Типичные проблемы и их решение
Даже у опытных IT-специалистов могут возникнуть трудности. Вот решения самых распространенных из них:
- Команда
openclawне найдена: - Это частая проблема, связанная с путями. Проверьте, что Node.js установлен корректно и глобальные пакеты находятся в вашем
PATH. Понять, куда npm складывает глобальные модули, можно командойnpm prefix -g. Если этого пути нет в переменной окруженияPATH, ее необходимо добавить. - Ошибки, связанные с моделями или API-ключами: Убедитесь, что ваш API-ключ активен, не истек и имеет достаточно средств на балансе. Проверьте, правильно ли выбран эндпоинт API для вашего региона (например,
.cnдля Kimi). - Проблемы с зависимостями: Установка из исходного кода или ручная установка иногда приводит к конфликтам зависимостей. Убедитесь, что используете актуальную версию Node.js и менеджера пакетов.
- Ложные срабатывания антивирусов: Из-за функций автоматизации (управление клавиатурой и мышью) антивирусы могут блокировать или удалять файлы OpenClaw. Это известная проблема. Если вы абсолютно уверены в источнике и хотите продолжить, возможно, потребуется на время установки отключить антивирусную защиту.
🔒 Безопасность прежде всего
OpenClaw — это мощный инструмент, который по своей природе требует глубокого доступа к вашей системе. Поэтому к вопросам безопасности следует подходить с особым вниманием.
- Запускайте в изолированной среде: Настоятельно рекомендуется использовать виртуальную машину (например, VMware или WSL на Windows). Это лучший способ защитить вашу основную ОС от непреднамеренных действий агента.
- Не открывайте порты наружу: Порт шлюза (
18789) должен быть доступен только локально. Не перенаправляйте его через NAT или брандмауэр, если в этом нет критической необходимости. - Следите за доступом: По умолчанию для новых пользователей включен режим сопряжения (Pairing mode), требующий подтверждения. Не отключайте его бездумно.
- Аудит безопасности: Разработчики рекомендуют регулярно запускать встроенную команду аудита безопасности:
openclaw security audit
- Это поможет выявить потенциальные проблемы в вашей конфигурации.
💎 Заключение
Мы рассмотрели основные способы установки OpenClaw, его первоначальную настройку и ключевые аспекты безопасной эксплуатации. Теперь у вас есть собственный AI-агент, способный автоматизировать рутинные задачи.
Начните с малого, настройте интеграцию с вашими мессенджерами (Telegram, Discord) через официальную документацию docs.openclaw.ai и постепенно изучайте каталог навыков, чтобы раскрыть весь потенциал этого инструмента. Помните о безопасности и удачных вам экспериментов с "лобстером"! 🦞
