Применимо к OpenClaw v2026.2 | Статья предполагает наличие Node.js >= 22 и AI API Key (рекомендуется Anthropic Claude).

TL;DR: Установка OpenClaw за 5 минут. Поддерживаются четыре способа: npm/pnpm/bun/Docker. Рекомендуется npm install -g openclaw@latest && openclaw onboard. Конфигурационный файл находится в ~/.openclaw/openclaw.json, запуск через openclaw gateway. Подробно рассматриваются развёртывание Docker, структура конфигурации и устранение типичных проблем.

Предварительные требования

Обязательное окружение

Рекомендуемое окружение

AI API Key

OpenClaw требует подключения к ИИ-модели. Рекомендуется:

💡 Рекомендация: Anthropic Claude Opus 4.6 обеспечивает лучшую обработку длинного контекста и защиту от prompt-инъекций.

Проверка окружения

# Проверка версии Node.js
node --version
# Пример вывода: v22.12.0

# Проверка версии npm
npm --version
# Пример вывода: 10.9.0

# Проверка информации о системе
uname -a  # Linux/macOS
# или
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"  # Windows

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

flowchart TB
    A[Выбор способа установки] --> B{Сценарий использования?}
    B -->|Быстрая проба| C[npm глобальная установка]
    B -->|Повседневное использование| D[pnpm/bun установка]
    B -->|Продакшн-деплой| E[Docker развёртывание]
    B -->|Участие в разработке| F[Сборка из исходного кода]
    
    C --> G[5 минут на установку]
    D --> H[Более быстрое управление зависимостями]
    E --> I[Изоляция окружения, воспроизводимость]
    F --> J[Полная настройка, участие в разработке]

Таблица сравнения

Способ 1: npm глобальная установка (рекомендуется для новичков)

Шаги установки

# 1. Установка последней стабильной версии
npm install -g openclaw@latest

# 2. Проверка установки
openclaw --version
# Пример вывода: 2026.2.26

# 3. Просмотр справки
openclaw --help

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

/usr/local/lib/node_modules/openclaw/  # Каталог глобальной установки
├── bin/
│   └── openclaw                        # Исполняемый файл
├── lib/
│   └── ...                             # Основные библиотеки
└── package.json

~/.openclaw/                            # Каталог пользовательских данных (создаётся при первом запуске)
├── openclaw.json                       # Основной конфигурационный файл
├── credentials/                       # Хранилище учётных данных каналов
├── workspace/                          # Рабочее пространство Agent
│   ├── AGENTS.md                      # Руководство по поведению Agent
│   ├── SOUL.md                        # Настройка личности Agent
│   └── skills/                        # Пользовательские навыки
└── logs/                              # Каталог логов

Запуск мастера настройки

# Запуск интерактивного мастера настройки
openclaw onboard --install-daemon

Мастер проведёт вас через следующие шаги:

sequenceDiagram
    participant U as Пользователь
    participant W as Мастер
    participant S as Система
    
    U->>W: Запуск onboard
    W->>U: Выбор провайдера модели
    U->>W: Выбор Anthropic
    W->>U: Ввод API Key
    U->>W: Вставка Key
    W->>U: Выбор порта Gateway
    U->>W: 18789 (по умолчанию)
    W->>U: Установить демон?
    U->>W: Да
    W->>S: Создание сервиса systemd/launchd
    S-->>W: Установка успешна
    W-->>U: Настройка завершена!

Способ 2: установка через pnpm (рекомендуется для повседневного использования)

Установка pnpm

# Установка pnpm через npm
npm install -g pnpm

# Или с помощью отдельного скрипта
curl -fsSL https://get.pnpm.io/install.sh | sh -

Установка OpenClaw

# Установка через pnpm
pnpm add -g openclaw@latest

# Проверка
openclaw --version

Преимущества pnpm

Способ 3: установка через bun (для максимальной скорости)

Установка bun

# macOS/Linux
curl -fsSL https://bun.sh/install | bash

# Или через npm
npm install -g bun

Установка OpenClaw

# Установка через bun
bun add -g openclaw@latest

# Проверка
openclaw --version

Преимущества bun

Способ 4: развёртывание Docker (рекомендуется для продакшна)

Получение образа

# Загрузка последнего образа
docker pull openclaw/openclaw:latest

# Или конкретная версия
docker pull openclaw/openclaw:2026.2

Базовый запуск

# Минимальный запуск
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  -e ANTHROPIC_API_KEY=your_key_here \
  openclaw/openclaw:latest

# Просмотр логов
docker logs -f openclaw

Конфигурация Docker Compose

Создайте docker-compose.yml:

version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789"
    volumes:
      - ./openclaw-data:/root/.openclaw
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      # Или используйте конфигурационный файл
      # - OPENCLAW_CONFIG=/root/.openclaw/openclaw.json
    healthcheck:
      test: ["CMD", "openclaw", "health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

Запуск сервиса:

# Создание файла .env
echo "ANTHROPIC_API_KEY=your_key_here" > .env

# Запуск
docker-compose up -d

# Проверка статуса
docker-compose ps

# Просмотр логов
docker-compose logs -f

Сетевая конфигурация Docker

# docker-compose.yml расширенная конфигурация
services:
  openclaw:
    # ... прочие настройки
    networks:
      - openclaw-net

  # Опционально: обратный прокси
  caddy:
    image: caddy:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
    networks:
      - openclaw-net

networks:
  openclaw-net:
    driver: bridge

Способ 5: сборка из исходного кода (для разработчиков)

Клонирование репозитория

# Клонирование основного репозитория
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Установка зависимостей (рекомендуется pnpm)
pnpm install

# Сборка
pnpm build

# Запуск
pnpm openclaw onboard

Режим разработки

# Режим разработки (автоперезагрузка)
pnpm gateway:watch

# Запуск тестов
pnpm test

# Проверка кода
pnpm lint

Подробности конфигурационного файла

Приоритет конфигурации

Аргументы CLI > Переменные окружения > Конфигурационный файл > Значения по умолчанию

Структура каталогов

~/.openclaw/
├── openclaw.json           # Основной конфигурационный файл
├── openclaw.json.backup    # Автоматическая резервная копия
├── credentials/            # Конфиденциальные данные (автоматическое шифрование)
│   ├── telegram.json
│   ├── whatsapp.json
│   └── discord.json
├── workspace/              # Рабочее пространство Agent
│   ├── AGENTS.md          # Глобальное руководство по поведению
│   ├── SOUL.md            # Личность Agent
│   ├── TOOLS.md           # Описание пользовательских инструментов
│   ├── USER.md            # Информация о пользователе
│   └── skills/            # Каталог навыков
│       ├── gmail/
│       │   └── SKILL.md
│       └── calendar/
│           └── SKILL.md
├── sessions/              # Данные сессий
├── logs/                  # Файлы логов
│   ├── gateway.log
│   └── agent.log
└── cache/                 # Кэш-данные

Минимальная конфигурация

~/.openclaw/openclaw.json:

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  }
}

Полный пример конфигурации

{
  "agent": {
    "model": "anthropic/claude-opus-4-6",
    "thinkingLevel": "high",
    "verboseLevel": "normal"
  },
  "gateway": {
    "port": 18789,
    "bind": "loopback",
    "host": "127.0.0.1"
  },
  "channels": {
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN",
      "dmPolicy": "pairing",
      "allowFrom": []
    },
    "whatsapp": {
      "allowFrom": ["+8613800138000"],
      "groups": {
        "*": { "requireMention": true }
      }
    },
    "discord": {
      "token": "YOUR_DISCORD_TOKEN",
      "guilds": {}
    }
  },
  "agents": {
    "defaults": {
      "workspace": "~/.openclaw/workspace",
      "sandbox": {
        "mode": "off"
      }
    }
  },
  "models": {
    "fallback": [
      {
        "model": "anthropic/claude-sonnet-4",
        "condition": "rate_limit"
      }
    ]
  },
  "webhooks": [],
  "cron": []
}

Описание параметров конфигурации

Переменные окружения

OpenClaw поддерживает переопределение конфигурации через переменные окружения:

# API Keys
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."

# Конфигурация каналов
export TELEGRAM_BOT_TOKEN="123456:ABC..."
export DISCORD_BOT_TOKEN="..."

# Конфигурация Gateway
export OPENCLAW_PORT=18789
export OPENCLAW_BIND="loopback"

Запуск и проверка

Запуск Gateway

# Запуск на переднем плане (режим отладки)
openclaw gateway --verbose

# Запуск в фоне (демон)
openclaw gateway --daemon

# С указанием порта
openclaw gateway --port 18790

Проверка статуса работы

# Проверка состояния
openclaw doctor

# Пример вывода:
# ✓ Node.js version: v22.12.0
# ✓ OpenClaw version: 2026.2.26
# ✓ Gateway running on port 18789
# ✓ API key configured
# ✓ Workspace directory exists

Доступ к веб-консоли

После запуска Gateway откройте в браузере:

http://127.0.0.1:18789

Вы увидите Web Control UI:

Тестовый диалог

# Тест через командную строку
openclaw agent --message "Привет, расскажи о себе"

# Пример вывода:
# Привет! Я твой помощник OpenClaw. Я могу помочь тебе...

Устранение типичных проблем

Проблема 1: порт занят

Симптомы:

Error: EADDRINUSE: address already in use 127.0.0.1:18789

Решение:

# Поиск процесса, занимающего порт
lsof -i :18789
# или
netstat -tlnp | grep 18789

# Завершение процесса
kill -9 <PID>

# Или использование другого порта
openclaw gateway --port 18790

Проблема 2: недействительный API Key

Симптомы:

Error: Invalid API key

Решение:

# Проверка конфигурации
openclaw config get agent.model

# Проверка переменной окружения
echo $ANTHROPIC_API_KEY

# Повторная настройка
openclaw onboard

Проблема 3: устаревшая версия Node

Симптомы:

Error: OpenClaw requires Node.js >= 22.0.0

Решение:

# Переключение версии через nvm
nvm install 22
nvm use 22
nvm alias default 22

# Проверка
node --version

Проблема 4: проблемы с правами доступа

Симптомы:

Error: EACCES: permission denied

Решение:

# Исправление прав npm
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) ~/.openclaw

# Или управление Node.js через nvm (рекомендуется)

Проблема 5: сетевые проблемы Docker

Симптомы:

Error: Cannot connect to Gateway from container

Решение:

# Проверка сети
docker network ls
docker network inspect bridge

# Использование host-сети
docker run --network host ...

# Или корректное пробрасывание портов
docker run -p 127.0.0.1:18789:18789 ...

Проблема 6: утеря учётных данных

Симптомы:

Warning: Telegram credentials not found

Решение:

# Повторный вход в канал
openclaw channels login telegram

# Проверка файлов учётных данных
ls ~/.openclaw/credentials/

# Резервное копирование учётных данных
cp -r ~/.openclaw/credentials/ ~/.openclaw/credentials.backup/

Проблема 7: недостаточно памяти

Симптомы:

Error: JavaScript heap out of memory

Решение:

# Увеличение лимита памяти Node.js
export NODE_OPTIONS="--max-old-space-size=8192"
openclaw gateway

# Или в Docker
docker run -e NODE_OPTIONS="--max-old-space-size=8192" ...

Обновление и обслуживание

Обновление OpenClaw

# Обновление npm
npm update -g openclaw@latest

# Обновление pnpm
pnpm update -g openclaw@latest

# Обновление Docker
docker pull openclaw/openclaw:latest
docker-compose up -d

# Проверка версии
openclaw --version

Переключение канала обновлений

# Стабильная версия (рекомендуется)
openclaw update --channel stable

# Бета-версия
openclaw update --channel beta

# Версия разработки (новейшие функции, может быть нестабильной)
openclaw update --channel dev

Резервное копирование и восстановление

# Резервное копирование конфигурации
tar -czvf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

# Восстановление конфигурации
tar -xzvf openclaw-backup-20260226.tar.gz -C ~/

# Резервное копирование только ключевых файлов
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup
cp -r ~/.openclaw/credentials/ ~/.openclaw/credentials.backup/

Следующий шаг

Поздравляем! Вы успешно настроили окружение OpenClaw. Далее:

1. Настройка первого канала → Следующая статья: настройка каналов
2. Установка первого Skill → Поиск и установка через Web UI
3. Настройка личности Agent → Редактирование ~/.openclaw/workspace/SOUL.md

Итоги статьи:

• Освоены 5 способов установки и их области применения
• Понята структура конфигурационных файлов и приоритеты
• Изучены проверка запуска и устранение типичных проблем
• Рассмотрены базовые операции обновления и обслуживания

История обновлений:

• 2026-02-26: первая публикация, на основе OpenClaw v2026.2

Навигация по серии:

• ← Предыдущая статья: Введение в OpenClaw
• → Следующая статья: Настройка каналов: начинаем с Telegram