Установка

Уже прошли Быстрый старт? Тогда всё готово — эта страница для альтернативных способов установки, платформенных инструкций и обслуживания.

Системные требования

Node 24 (рекомендуется) (Node 22 LTS, сейчас 22.16+, всё ещё поддерживается для совместимости; скрипт установки установит Node 24, если его нет)
macOS, Linux или Windows
pnpm — только для сборки из исходников

Примечание: На Windows мы настоятельно рекомендуем запускать OpenClaw через WSL2.

Способы установки

Совет: Скрипт установки — рекомендуемый способ установки OpenClaw. Он определяет наличие Node, устанавливает его при необходимости и запускает мастер начальной настройки за один шаг.

Предупреждение: Для VPS и облачных хостов по возможности избегайте сторонних образов из маркетплейсов. Лучше используйте чистый образ ОС (например, Ubuntu LTS) и установите OpenClaw самостоятельно через скрипт установки.

Скрипт установки

Скачивает CLI, устанавливает его глобально через npm и запускает мастер начальной настройки.


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



Вот и всё — скрипт сам определит Node, установит его и проведёт начальную настройку.

Чтобы пропустить начальную настройку и просто установить бинарник:


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```

  #### Windows (PowerShell)
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```



Все флаги, переменные окружения и опции для CI/автоматизации — см. [Внутреннее устройство установщика](/docs/install/installer).

npm / pnpm

Если вы сами управляете Node, рекомендуем Node 24. OpenClaw по-прежнему поддерживает Node 22 LTS, сейчас `22.16+`, для совместимости:


  #### npm
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <details>

Ошибки сборки sharp?

      Если у вас глобально установлен libvips (часто бывает на macOS через Homebrew) и `sharp` не собирается, принудительно используйте готовые бинарники:

      ```bash
      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
      ```

      Если видите `sharp: Please add node-gyp to your dependencies` — либо установите инструменты сборки (macOS: Xcode CLT + `npm install -g node-gyp`), либо используйте переменную окружения выше.
    </details>

  #### pnpm
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # подтвердите openclaw, node-llama-cpp, sharp и т.д.
    openclaw onboard --install-daemon
    ```

    > **Примечание:** pnpm требует явного подтверждения для пакетов со скриптами сборки. После первой установки, когда появится предупреждение «Ignored build scripts», выполните `pnpm approve-builds -g` и выберите перечисленные пакеты.

Из исходников

Для контрибьюторов или тех, кто хочет запускать из локальной копии репозитория.


  ### Шаг 1: Клонирование и сборка
    Клонируйте [репозиторий OpenClaw](https://github.com/openclaw/openclaw) и соберите:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```

  ### Шаг 2: Создание глобальной ссылки на CLI
    Сделайте команду `openclaw` доступной глобально:

    ```bash
    pnpm link --global
    ```

    Или пропустите этот шаг и запускайте команды через `pnpm openclaw ...` из каталога репозитория.

  ### Шаг 3: Начальная настройка
    ```bash
    openclaw onboard --install-daemon
    ```



Подробнее о разработке — см. [Настройка](/docs/start/setup).

Другие способы установки

Docker — контейнерное или headless-развёртывание.
Podman — rootless-контейнер: один раз выполните setup-podman.sh, затем используйте скрипт запуска.
Nix — декларативная установка через Nix.
Ansible — автоматизированное развёртывание на парке серверов.
Bun — запуск CLI через среду выполнения Bun.

После установки

Убедитесь, что всё работает:

openclaw doctor         # проверка конфигурации
openclaw status         # статус шлюза
openclaw dashboard      # открыть веб-интерфейс

Если нужны нестандартные пути, используйте:

OPENCLAW_HOME — базовый каталог для внутренних путей
OPENCLAW_STATE_DIR — каталог изменяемого состояния
OPENCLAW_CONFIG_PATH — путь к файлу конфигурации

Подробности и приоритеты — см. Переменные окружения.

Решение проблем: `openclaw` не найден

Диагностика и исправление PATH

Быстрая диагностика:

node -v
npm -v
npm prefix -g
echo "$PATH"

Если $(npm prefix -g)/bin (macOS/Linux) или $(npm prefix -g) (Windows) отсутствует в $PATH, оболочка не может найти глобальные бинарники npm (включая openclaw).

Исправление — добавьте в файл инициализации оболочки (~/.zshrc или ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

На Windows добавьте вывод npm prefix -g в системную переменную PATH.

Затем откройте новый терминал (или выполните rehash в zsh / hash -r в bash).

Обновление / удаление

Обновление — поддержание OpenClaw в актуальном состоянии.
Миграция — перенос на другой компьютер.
Удаление — полное удаление OpenClaw.