Обзор установки

Внутреннее устройство установщика

OpenClaw поставляется с тремя скриптами установки, доступными по адресу openclaw.ai.

СкриптПлатформаЧто делает
install.shmacOS / Linux / WSLУстанавливает Node при необходимости, устанавливает OpenClaw через npm (по умолчанию) или git, может запустить первоначальную настройку.
install-cli.shmacOS / Linux / WSLУстанавливает Node + OpenClaw в локальный префикс (~/.openclaw). Не требует прав root.
install.ps1Windows (PowerShell)Устанавливает Node при необходимости, устанавливает OpenClaw через npm (по умолчанию) или git, может запустить первоначальную настройку.

Быстрые команды

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

ℹ️ Если установка прошла успешно, но openclaw не находится в новом терминале, см. Устранение неполадок Node.js.

install.sh

💡 Рекомендуется для большинства интерактивных установок на macOS/Linux/WSL.

Порядок работы (install.sh)

Шаг 1: Определение ОС

Поддерживает macOS и Linux (включая WSL). Если обнаружен macOS, устанавливает Homebrew при его отсутствии.

Шаг 2: Проверка Node.js 22+

Проверяет версию Node и устанавливает Node 22 при необходимости (через Homebrew на macOS, через скрипты NodeSource на Linux apt/dnf/yum).

Шаг 3: Проверка Git

Устанавливает Git, если он отсутствует.

Шаг 4: Установка OpenClaw

  • Метод npm (по умолчанию): глобальная установка через npm
  • Метод git: клонирование/обновление репозитория, установка зависимостей через pnpm, сборка, затем установка обёртки в ~/.local/bin/openclaw

Шаг 5: Пост-установочные задачи

  • Запускает openclaw doctor --non-interactive при обновлениях и установках через git (по возможности)
  • Пытается запустить первоначальную настройку, когда это уместно (доступен TTY, настройка не отключена, проверки начальной загрузки и конфигурации пройдены)
  • По умолчанию устанавливает SHARP_IGNORE_GLOBAL_LIBVIPS=1

Обнаружение локальной копии исходного кода

Если скрипт запущен внутри локальной копии OpenClaw (присутствуют package.json + pnpm-workspace.yaml), он предлагает:

  • использовать локальную копию (git), или
  • использовать глобальную установку (npm)

Если TTY недоступен и метод установки не задан, по умолчанию используется npm с предупреждением. Скрипт завершается с кодом 2 при неверном выборе метода или недопустимых значениях --install-method.

Примеры (install.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

install-cli.sh

ℹ️ Предназначен для сред, где требуется разместить всё в локальном префиксе (по умолчанию ~/.openclaw) без зависимости от системного Node.

Порядок работы (install-cli.sh)

Шаг 1: Установка локальной среды выполнения Node

Загружает архив Node (по умолчанию 22.22.0) в <prefix>/tools/node-v<version> и проверяет SHA-256.

Шаг 2: Проверка Git

Если Git отсутствует, пытается установить его через apt/dnf/yum на Linux или Homebrew на macOS.

Шаг 3: Установка OpenClaw в префикс

Устанавливает через npm с использованием --prefix <prefix>, затем создаёт обёртку в <prefix>/bin/openclaw.

Примеры (install-cli.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

install.ps1

Порядок работы (install.ps1)

Шаг 1: Проверка PowerShell и среды Windows

Требуется PowerShell 5+.

Шаг 2: Проверка Node.js 22+

При отсутствии пытается установить через winget, затем Chocolatey, затем Scoop.

Шаг 3: Установка OpenClaw

  • Метод npm (по умолчанию): глобальная установка через npm с использованием выбранного -Tag
  • Метод git: клонирование/обновление репозитория, установка/сборка через pnpm и установка обёртки в %USERPROFILE%\.local\bin\openclaw.cmd

Шаг 4: Пост-установочные задачи

Добавляет необходимый каталог bin в пользовательский PATH, когда это возможно, затем запускает openclaw doctor --non-interactive при обновлениях и установках через git (по возможности).

Примеры (install.ps1)

iwr -useb https://openclaw.ai/install.ps1 | iex

ℹ️ Если используется -InstallMethod git и Git отсутствует, скрипт завершится с выводом ссылки на Git for Windows.

CI и автоматизация

Используйте неинтерактивные флаги/переменные окружения для предсказуемых запусков.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

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

УстановкаDocker