OpenClaw — это локальный инструмент, который позволяет вашему ИИ-агенту подключаться к приложениям, таким как Telegram или WhatsApp, и выполнять действия, например отправлять сообщения или обрабатывать задачи. Настроить его несложно, если разобраться в процессе. В этом руководстве описана установка на macOS, Linux и Windows.
Краткий обзор вариантов установки OpenClaw
Выберите вариант установки, который вам подходит. Локальный запуск OpenClaw оставляет всё на вашем собственном компьютере и требует установки зависимостей, таких как npm, или использования автоматического скрипта. Если вы хотите обойтись без настройки, полностью хостируемые платформы, такие как Kimi Claw, берут окружение на себя, позволяя начать работу сразу.
| macOS / Linux | Windows | |
|---|---|---|
| Запуск локально | Однострочная команда для терминала | Однострочная команда для PowerShell |
| Через npm | Через npm | |
| Через Homebrew | Через WSL2 | |
| Запуск онлайн | Облачное решение (например, Kimi Claw) | Облачное решение (например, Kimi Claw) |
Как установить OpenClaw на macOS и Linux
На macOS и Linux используется один и тот же установщик и одни и те же команды. Эти инструкции применимы к обеим системам, если не указано иное.
Ниже приведено краткое руководство по установке. Полное пошаговое руководство со скриншотами см. в статье Как установить OpenClaw на macOS.
Способ 1: используйте однострочный скрипт установки
Шаг 1. Запустите скрипт установки в терминале
Запустите официальный скрипт установки для настройки OpenClaw. Скрипт проверяет, установлен ли Node.js версии 22 или новее. Если он отсутствует или устарел, автоматически будет установлен Node.js 24. Затем скрипт устанавливает CLI OpenClaw и запускает мастер первоначальной настройки.
Шаг 2. Завершите работу мастера первоначальной настройки
Следуйте инструкциям мастера настройки, чтобы подготовить окружение для агента: выберите провайдера модели (например, Kimi API), введите API-ключ, выберите канал и настройте основные параметры.
Шаг 3. Проверьте установку
Выполните следующую команду, чтобы узнать версию OpenClaw.
Шаг 4. Проверьте шлюз и завершите настройку
Выполните следующую команду, чтобы проверить, что шлюз OpenClaw активен.
Установщик также регистрирует LaunchAgent на macOS или службу systemd на Linux, поэтому OpenClaw продолжает работать в фоновом режиме. После завершения настройки ваш агент готов к использованию. Вы можете начать общение, подключить инструменты или настроить рабочие процессы в зависимости от ваших задач.
Способ 2: установка через Homebrew
Шаг 1: установка или обновление Node.js
Установите Node.js через Homebrew, выполнив следующую команду в терминале. Если Node.js уже установлен, выполните команду обновления, чтобы убедиться, что у вас последняя версия.
Шаг 2: установка OpenClaw CLI
Выполните следующую команду, чтобы установить OpenClaw CLI глобально.
Шаг 3: запуск онбординга и настройка демона
Выполните следующую команду, чтобы запустить мастер онбординга и зарегистрировать фоновый демон. Следуйте инструкциям мастера, чтобы настроить среду агента, включая выбор поставщика модели (например, Kimi API), ввод API-ключа и подключение канала обмена сообщениями. После завершения настройки ваш агент готов к использованию. Вы можете начать общение, подключить инструменты или настроить рабочие процессы в зависимости от ваших задач.
Способ 3: установка через npm
Шаг 1: проверка версии среды выполнения
Выполните следующую команду, чтобы убедиться, что на вашей системе установлен Node.js версии 22.14 или новее. Если версия актуальна, можно приступать к установке.
Шаг 2: установка OpenClaw CLI
Выполните следующую команду, чтобы установить OpenClaw CLI глобально.
Шаг 3: запуск онбординга и включение постоянной работы
Выполните следующую команду, чтобы запустить мастер онбординга и зарегистрировать фоновый демон. Следуйте инструкциям мастера, чтобы настроить среду агента, включая выбор поставщика модели (например, Kimi API), ввод API-ключа и выбор канала обмена сообщениями. После завершения настройки ваш агент готов к работе. Вы можете начать взаимодействовать с ним, подключить инструменты или создавать рабочие процессы в зависимости от ваших задач.
Особенности платформ: OpenClaw поддерживает как Mac на Intel, так и Mac на Apple Silicon. Если установка блокируется Gatekeeper, разрешить её можно в разделе «Приватность и безопасность» настроек системы.
Как установить OpenClaw на Windows
На Windows есть три основных способа установки OpenClaw: установщик PowerShell для быстрой нативной настройки, WSL2 для полноценной среды Linux и npm для установки вручную.
Ниже приведено краткое руководство по настройке. Полное поэтапное руководство со скриншотами см. в статье Как установить OpenClaw на Windows.
Способ 1: использование установщика PowerShell (нативно для Windows)
Шаг 1: выполнение скрипта установки в PowerShell
Откройте PowerShell от имени администратора и выполните официальную однострочную команду для установки OpenClaw.
Шаг 2: завершение мастера онбординга
Следуйте шагам онбординга, чтобы настроить среду агента, включая выбор поставщика модели (например, Kimi API), ввод API-ключа и выбор канала обмена сообщениями.
Шаг 3: проверка установки
Выполните следующую команду, чтобы убедиться, что OpenClaw установлен корректно и шлюз активен.
Шаг 4: начало работы с агентом
После завершения настройки ваш агент готов к работе. Вы можете начать взаимодействовать с ним, подключить инструменты или настроить рабочие процессы в зависимости от ваших задач.
Способ 2: установка через WSL2
Шаг 1: настройка среды Linux
Откройте PowerShell от имени администратора и выполните следующую команду, чтобы включить и инициализировать WSL2.
Шаг 2: запуск установщика в Linux
Откройте терминал Linux и выполните стандартный установочный скрипт для установки OpenClaw.
Шаг 3: завершение мастера онбординга
Следуйте шагам онбординга, чтобы настроить среду агента, включая выбор поставщика модели (например, Kimi API), ввод API-ключа и выбор канала обмена сообщениями.
После завершения настройки ваш агент готов к работе. Вы можете начать взаимодействовать с ним, подключать инструменты или настраивать рабочие процессы в зависимости от ваших задач.
Способ 3: установка через npm в Windows
Шаг 1: проверьте версию Node.js
Выполните следующую команду, чтобы убедиться, что Node.js установлен и обновлён до актуальной версии.
Шаг 2: установите OpenClaw CLI
Выполните следующую команду, чтобы установить OpenClaw CLI глобально.
Шаг 3: запустите onboarding и включите постоянную работу в фоне
Выполните следующую команду, чтобы запустить мастер первоначальной настройки и зарегистрировать фоновый демон.
Следуйте шагам мастера настройки, чтобы сконфигурировать среду вашего агента: выберите провайдера модели (например, Kimi API), введите API-ключ и укажите канал для обмена сообщениями.
После завершения настройки ваш агент готов к работе. Вы можете начать взаимодействовать с ним, подключать инструменты или настраивать рабочие процессы в зависимости от ваших задач.
Как запустить OpenClaw онлайн с помощью Kimi Claw
Описанные выше способы требуют терминала, поддерживаемой версии Node.js и постоянно включённого устройства. Kimi Claw предлагает полностью управляемый вариант, поэтому вы можете запускать OpenClaw без установки и поддержки локальной среды.
Шаг 1: откройте Kimi Claw и создайте инстанс
Перейдите на страницу Kimi Claw и нажмите Создать, чтобы начать.
Шаг 2: подтвердите развёртывание
Подтвердите развёртывание во всплывающем окне. Kimi Claw автоматически настроит вашу среду OpenClaw, включая шлюз и рабочее пространство, без необходимости локальной настройки.
Шаг 3: начните использовать рабочее пространство
После завершения развёртывания ваше рабочее пространство откроется в панели управления. Вы можете сразу взаимодействовать со своим агентом, настраивать навыки, планировать задачи и управлять файлами прямо в браузере.
Основные возможности Kimi Claw
Облачный хостинг: Kimi Claw запускает ваш шлюз в облаке, поэтому агент остаётся доступным даже когда ваше локальное устройство выключено.
Автоматическое обслуживание: обновления и исправления устанавливаются в фоновом режиме, без ручной настройки и перезапусков.
Встроенные возможности: планирование задач, постоянное хранение данных и динамическая загрузка навыков в зависимости от ваших запросов, с бесшовным доступом с любых устройств.
Устранение распространённых ошибок при установке OpenClaw
Большинство проблем при установке OpenClaw относятся к нескольким распространённым категориям: настройка PATH, отсутствующие зависимости или конфликты портов. Разделы ниже помогут быстро выявить и устранить самые частые проблемы в macOS, Windows и Linux.
«openclaw: command not found» после установки
OpenClaw не добавлен в системную переменную PATH.
Решение: добавьте каталог npm global bin в PATH.
Затем перезагрузите оболочку (например, source ~/.zshrc) или перезапустите терминал. В Windows добавьте путь в переменные среды и перезапустите PowerShell.
Ошибки сборки Sharp в macOS
Обычно это происходит из-за конфликта глобально установленной библиотеки libvips с библиотекой Sharp.
Решение: выполните команду установки с этой переменной среды.
Если появляются ошибки node-gyp, установите Xcode Command Line Tools:
OpenClaw не запускается после перезагрузки
Фоновый демон не был установлен во время onboarding.
Решение: запустите onboarding повторно с флагом демона.
Затем проверьте службу:
Шлюз не отвечает или показывает «0 tokens used»
Процесс шлюза может быть остановлен, либо не удалась аутентификация API.
Решение: перезапустите шлюз.
Выполните проверку работоспособности:
Для логов отладки:
Также проверьте, что ваш API-ключ действителен.
Порт 18789 уже занят
Порт шлюза OpenClaw используется другим процессом.
Решение: найдите и остановите конфликтующий процесс
Затем перезапустите шлюз:
Ошибки прав доступа EACCES
Обычно это означает, что у глобального каталога npm нет нужных прав доступа.
Решение: измените владельца каталога.
В Windows запустите PowerShell от имени администратора или задайте собственный префикс npm:
Для конфигураций Docker исправьте права доступа к тому:
Ошибка «spawn git ENOENT»
Git не установлен или недоступен в PATH.
Решение: установите Git с git-scm.com, перезапустите терминал и повторите установку.
systemd в WSL2 не работает
В конфигурации WSL не включён systemd.
Решение: отредактируйте
/etc/wsl.confи добавьте следующее.
Затем перезапустите WSL:
Заново откройте терминал Linux и проверьте:
Нехватка памяти при npm install на VPS
На VPS с малым объёмом памяти установка пакетов может завершиться сбоем.
Решение: создайте файл подкачки (swap).
Затем повторите установку.
Ошибка «Access not configured» при подключении к мессенджерам
Ваша учётная запись не авторизована в OpenClaw.
Решение: подтвердите свою учётную запись с помощью кода привязки.
Также проверьте, что учётные данные бота (токен, webhook, права доступа) настроены правильно.
Заключение
Установка OpenClaw проста на macOS, Linux и Windows. Можно использовать однострочный скрипт, PowerShell, WSL2 или npm — в зависимости от вашей конфигурации. Мастер настройки проведёт вас через выбор модели, настройку API и подключение мессенджеров. Если вы не хотите заниматься локальной средой, Kimi Claw предлагает полностью облачный вариант, позволяющий запускать OpenClaw прямо в облаке.
Вопросы и ответы
node --version, чтобы убедиться, что версия соответствует минимальным требованиям.npm install -g openclaw@latest в терминале. Это обновит CLI до последней версии. Также можно повторно запустить однострочный установщик — он автоматически обновит существующую установку. Кроме того, OpenClaw поддерживает обновление прямо из приложения через Control UI по адресу 127.0.0.1:18789. После обновления перезапустите шлюз с помощью openclaw gateway restart, чтобы загрузить новую версию.openclaw gateway status, чтобы убедиться, что демон активен. В Windows наиболее надёжный вариант постоянной работы обеспечивает WSL2 с включённым systemd. Если вы не хотите заниматься управлением локальными службами, полностью хостируемые решения, такие как Kimi Claw, позволяют запускать OpenClaw непрерывно в облаке.