> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Установка

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

* **Node 24** (рекомендуется) или Node 22.19+ - установочный скрипт обрабатывает это автоматически
* **macOS, Linux или Windows** - пользователи Windows могут начать с нативного приложения Windows Hub, установщика CLI для PowerShell или WSL2 Gateway. См. [Windows](/ru/platforms/windows).
* `pnpm` нужен только при сборке из исходного кода

## Рекомендуется: установочный скрипт

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

<Note>
  Пользователи Windows на настольных компьютерах также могут установить нативное сопутствующее приложение [Windows Hub](/ru/platforms/windows#recommended-windows-hub), которое включает настройку, статус в трее, чат, режим узла и локальный режим MCP.
</Note>

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

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

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```
  </Tab>
</Tabs>

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

## Альтернативные способы установки

### Установщик с локальным префиксом (`install-cli.sh`)

Используйте этот вариант, если хотите держать OpenClaw и Node в локальном префиксе, например
`~/.openclaw`, без зависимости от общесистемной установки Node:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl -fsSL https://openclaw.ai/install-cli.sh | bash
```

По умолчанию он поддерживает установку через npm, а также установку из git checkout в рамках того же
потока с префиксом. Полная справка: [Внутреннее устройство установщика](/ru/install/installer#install-clish).

Уже установлено? Переключайтесь между установками из пакета и из git с помощью
`openclaw update --channel dev` и `openclaw update --channel stable`. См.
[Обновление](/ru/install/updating#switch-between-npm-and-git-installs).

### npm, pnpm или bun

Если вы уже управляете Node самостоятельно:

<Tabs>
  <Tab title="npm">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Note>
      Размещенный установщик сбрасывает фильтры свежести npm, такие как `min-release-age`,
      для установки пакета OpenClaw. Если вы устанавливаете вручную через npm, ваша собственная
      политика npm все равно применяется.
    </Note>
  </Tab>

  <Tab title="pnpm">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    pnpm add -g openclaw@latest
    pnpm approve-builds -g
    openclaw onboard --install-daemon
    ```

    <Note>
      pnpm требует явного одобрения для пакетов со скриптами сборки. Выполните `pnpm approve-builds -g` после первой установки.
    </Note>
  </Tab>

  <Tab title="bun">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    bun add -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Note>
      Bun поддерживается для глобального пути установки CLI. Для среды выполнения Gateway рекомендуемой средой выполнения демона остается Node.
    </Note>
  </Tab>
</Tabs>

### Из исходного кода

Для участников разработки или всех, кто хочет запускать из локального checkout:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
```

Или пропустите связывание и используйте `pnpm openclaw ...` внутри репозитория. Полные рабочие процессы разработки см. в разделе [Настройка](/ru/start/setup).

### Установка из checkout основной ветки GitHub

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main
```

### Контейнеры и менеджеры пакетов

<CardGroup cols={2}>
  <Card title="Docker" href="/ru/install/docker" icon="container">
    Контейнеризованные или безголовые развертывания.
  </Card>

  <Card title="Podman" href="/ru/install/podman" icon="container">
    Rootless-альтернатива Docker для контейнеров.
  </Card>

  <Card title="Nix" href="/ru/install/nix" icon="snowflake">
    Декларативная установка через Nix flake.
  </Card>

  <Card title="Ansible" href="/ru/install/ansible" icon="server">
    Автоматизированная подготовка парка машин.
  </Card>

  <Card title="Bun" href="/ru/install/bun" icon="zap">
    Использование только CLI через среду выполнения Bun.
  </Card>
</CardGroup>

## Проверка установки

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
```

Если после установки нужен управляемый запуск:

* macOS: LaunchAgent через `openclaw onboard --install-daemon` или `openclaw gateway install`
* Linux/WSL2: пользовательская служба systemd через те же команды
* Нативная Windows: сначала Scheduled Task, с резервным элементом входа в пользовательской папке Startup, если создание задачи запрещено

## Хостинг и развертывание

Разверните OpenClaw на облачном сервере или VPS:

<CardGroup cols={3}>
  <Card title="VPS" href="/ru/vps">
    Любой Linux VPS.
  </Card>

  <Card title="Docker VM" href="/ru/install/docker-vm-runtime">
    Общие шаги для Docker.
  </Card>

  <Card title="Kubernetes" href="/ru/install/kubernetes">
    Развертывание K8s.
  </Card>

  <Card title="Fly.io" href="/ru/install/fly">
    Развертывание на Fly.io.
  </Card>

  <Card title="Hetzner" href="/ru/install/hetzner">
    Развертывание в Hetzner.
  </Card>

  <Card title="GCP" href="/ru/install/gcp">
    Развертывание в Google Cloud.
  </Card>

  <Card title="Azure" href="/ru/install/azure">
    Развертывание в Azure.
  </Card>

  <Card title="Railway" href="/ru/install/railway">
    Развертывание в Railway.
  </Card>

  <Card title="Render" href="/ru/install/render">
    Развертывание в Render.
  </Card>

  <Card title="Northflank" href="/ru/install/northflank">
    Развертывание в Northflank.
  </Card>
</CardGroup>

## Обновление, миграция или удаление

<CardGroup cols={3}>
  <Card title="Обновление" href="/ru/install/updating" icon="refresh-cw">
    Поддерживайте OpenClaw в актуальном состоянии.
  </Card>

  <Card title="Миграция" href="/ru/install/migrating" icon="arrow-right">
    Перенос на новую машину.
  </Card>

  <Card title="Удаление" href="/ru/install/uninstall" icon="trash-2">
    Полностью удалите OpenClaw.
  </Card>
</CardGroup>

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

Если установка прошла успешно, но `openclaw` не найден в вашем терминале:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?
```

Если `$(npm prefix -g)/bin` отсутствует в вашем `$PATH`, добавьте его в файл запуска вашей оболочки (`~/.zshrc` или `~/.bashrc`):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export PATH="$(npm prefix -g)/bin:$PATH"
```

Затем откройте новый терминал. Подробнее см. в разделе [Настройка Node](/ru/install/node).