Перейти к основному содержанию

Установка

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

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

  • Node 22+ (скрипт-установщик из раздела способы установки установит его при отсутствии)
  • macOS, Linux или Windows
  • pnpm — только при сборке из исходников
В Windows настоятельно рекомендуется запускать OpenClaw под WSL2.

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

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

Installer script

Загружает CLI, устанавливает его глобально через npm и запускает мастер первичной настройки.
```
<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  
</Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  
</Tab>

</Tabs>

Готово — скрипт выполняет обнаружение Node, установку и первичную настройку.

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

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```
  
</Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```
  
</Tab>

</Tabs>

Все флаги, переменные окружения и варианты для CI/автоматизации см. в разделе [Внутреннее устройство установщика](/install/installer).
```
Если у вас уже есть Node 22+ и вы предпочитаете управлять установкой самостоятельно:
```
<Tabs>
  <Tab title="npm">
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Accordion title="Ошибки сборки 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`) или используйте указанную выше переменную окружения.
    
</Accordion>
  
</Tab>
  <Tab title="pnpm">
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

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

</Tabs>
```
Для контрибьюторов или тех, кто хочет запускать из локального репозитория.
```
<Steps>
  <Step title="Клонировать и собрать">
    Клонируйте [репозиторий OpenClaw](https://github.com/openclaw/openclaw) и выполните сборку:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```
  
</Step>
  <Step title="Подключить CLI">
    Сделайте команду `openclaw` доступной глобально:

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

    Либо пропустите связывание и запускайте команды через `pnpm openclaw ...` изнутри репозитория.
  
</Step>
  <Step title="Запустить первичную настройку">
    ```bash
    openclaw onboard --install-daemon
    ```
  
</Step>

</Steps>

Для более глубоких рабочих процессов разработки см. раздел [Настройка](/start/setup).
```

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

Docker

Контейнеризованные или headless-развёртывания.

Podman

Rootless-контейнер: выполните setup-podman.sh один раз, затем запустите скрипт запуска.

Nix

Декларативная установка через Nix.

Ansible

Автоматизированное развёртывание парка.

Bun

Использование только CLI через рантайм Bun.

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

Проверьте, что всё работает:
openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI
If you need custom runtime paths, use:
  • OPENCLAW_HOME for home-directory based internal paths
  • OPENCLAW_STATE_DIR for mutable state location
  • OPENCLAW_CONFIG_PATH for config file location
See Environment vars for precedence and full details.

Устранение неполадок: openclaw не найден

Быстрая диагностика:
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).

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

Updating

Поддерживайте OpenClaw в актуальном состоянии.

Migrating

Перенос на новую машину.

Uninstall

Полностью удалить OpenClaw.