Урок 2: Установка и первый запуск

Чему вы научитесь

• Ставить OpenClaw официальным скриптом или через npm
• Проходить мастер онбординга (onboarding wizard)
• Выбирать и подключать AI-модель (Claude, GPT, Gemini)
• Запускать Gateway как фоновый процесс (daemon)
• Проверять статус работы и диагностировать проблемы
• Настраивать VPS для российских пользователей (доступ к API)

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

Перед установкой убедитесь, что у вас есть:

1. Node.js — по официальной документации и примечаниям к релизу v2026.10.6 (github.com/openclaw/openclaw/releases) на октябрь 2026 года требуется пропатченный рантайм Node.js 24.22.1+ (в ветке 24) или Node.js 26.12.1+ (в ветке 26, рекомендуется Node 26). Эти версии закрывают октябрьскую уязвимость Node.js со скомпрометированными ключами TLS-сертификатов. Официальный скрипт установки подтягивает подходящий рантайм автоматически, а команда openclaw update на более старом Node безопасно останавливается с подсказкой по обновлению рантайма, не ломая текущий инстанс.

node --version

Если версии нет или она ниже минимума — проще не ставить Node руками, а взять скрипт из шага 1: он сам доставит подходящий Node.

2. npm (идёт вместе с Node.js), если ставите пакет вручную.

3. API-ключ AI-модели (одна из):

   • Anthropic (Claude): console.anthropic.com
   • OpenAI (GPT): platform.openai.com
   • Google (Gemini): aistudio.google.com

Шаг 1. Установка OpenClaw

Официальный путь на октябрь 2026 года — скрипт с сайта проекта (docs.openclaw.ai). Он определяет вашу ОС, при необходимости ставит свежий Node.js, устанавливает OpenClaw и сразу запускает мастер онбординга:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell): iwr -useb https://openclaw.ai/install.ps1 | iex (также для Windows доступно настольное приложение системного трея OpenClaw Windows Hub — github.com/openclaw/openclaw-windows-node).

Если Node уже есть и хотите поставить пакет вручную через npm (на npm 12 и 11.16+ скрипты пакета по умолчанию блокируются — нужен флаг --allow-scripts=openclaw):

Чтобы PATH сохранялся после перезагрузки, добавьте строку export в ~/.bashrc или ~/.zshrc.

Шаг 2. Онбординг

По официальному руководству Quick Start мастер онбординга предлагает два режима:

• Quick start (быстрый старт) — автоматически обнаруживает уже настроенные ключи доступа к ИИ в системе, проверяет их реальным тестовым запросом (completion) и сразу открывает браузерную панель управления Control UI (http://127.0.0.1:18789/) с запущенным Gateway. После проверки достаточно нажать Ctrl+C и установить фоновую службу.
• Custom setup / Classic wizard (пошаговая настройка) — полный управляемый сценарий выбора модели, ключей и каналов. Чтобы сразу открыть классический пошаговый мастер или установить фоновую службу daemon, выполните:

openclaw onboard --install-daemon
# Или классический пошаговый мастер:
openclaw onboard --classic

Флаг --install-daemon установит Gateway как фоновый процесс, который будет запускаться автоматически.

Что произойдёт во время онбординга

1. Выбор AI-модели. Мастер предложит выбрать основную модель. Рекомендуемый выбор на октябрь 2026 года:

   • Claude Sonnet 5.5 (claude-sonnet-5-5) — оптимальный повседневный баланс скорости, качества и цены (контекст 1M токенов)
   • Claude Opus 5.5 (claude-opus-5-5) — флагман Anthropic для сложных многошаговых задач и архитектуры
   • GPT-6.1 Sol (gpt-6.1-sol) / GPT-5.6 Sol (gpt-5.6-sol) — актуальные модели OpenAI для агентских сценариев
   • Gemini 3.8 Pro / Gemini 3.8 Flash — быстрые и экономичные модели Google
   • Из России без зарубежной карты — DeepSeek V3.2 / V4 Flash, GigaChat 3 Ultra / 3.5 или YandexGPT 5.1 Pro / Alice AI LLM (подробно в уроке 3.5/02)

2. Ввод API-ключа. Введите ключ выбранной модели. Ключ сохраняется локально в конфигурации.

3. Первый канал. Мастер предложит подключить первый канал (WebChat — самый простой вариант для начала).

4. Создание workspace. Будет создана директория ~/.openclaw/ со структурой:

~/.openclaw/
├── openclaw.json        # Основная конфигурация
├── workspace/
│   └── default/
│       ├── SOUL.md      # Личность агента
│       ├── AGENTS.md    # Контекст инструментов
│       └── USER.md      # Ваши предпочтения
├── skills/              # Навыки (пока пусто)
├── sessions/            # Сессии разговоров
└── logs/                # Логи

5. Запуск Gateway. После настройки Gateway запустится как daemon.

Шаг 3. Проверка работы

Проверьте, что Gateway работает:

openclaw status

Ожидаемый вывод:

OpenClaw Gateway
  Status: running
  PID: 12345
  Uptime: 2m 15s
  Channels: webchat (connected)
  Agents: default
  Model: claude-sonnet-5-5

Если статус stopped, запустите вручную:

openclaw start

Для просмотра логов в реальном времени:

openclaw logs --follow

Шаг 4. Первое сообщение через WebChat

WebChat — встроенный канал, который работает через терминал. Это самый простой способ проверить, что OpenClaw отвечает:

openclaw chat

Откроется интерактивный чат. Напишите что-нибудь:

Вы: Привет! Расскажи о себе в 3 предложениях.

OpenClaw ответит, используя выбранную AI-модель. Вы увидите ответ прямо в терминале.

Для выхода из чата нажмите Ctrl+C или введите /exit.

Конфигурация: openclaw.json

Основная конфигурация хранится в ~/.openclaw/openclaw.json. Вот как выглядит типичный файл после онбординга:

{
  // Основная модель
  "defaultModel": "claude-sonnet-5-5",

  // API-ключи
  "auth": {
    "anthropic": {
      "apiKey": "sk-ant-..."
    }
  },

  // Каналы
  "channels": {
    "webchat": {
      "enabled": true
    }
  },

  // Агенты
  "agents": {
    "default": {
      "model": "claude-sonnet-5-5",
      "workspace": "~/.openclaw/workspace/default"
    }
  },

  // Gateway
  "gateway": {
    "port": 18789,
    "daemon": true
  }
}

Вы можете редактировать этот файл вручную, но на данном этапе лучше использовать команды openclaw config.

Для пользователей из России

API Claude (Anthropic) и GPT (OpenAI) могут быть недоступны при прямом подключении из России. Варианты решения:

Вариант 1: VPS в другой стране

Установите OpenClaw на VPS в Нидерландах, Германии или Казахстане. Стоимость VPS: от $5/мес.

# На VPS
npm install -g openclaw@latest
openclaw onboard --install-daemon

OpenClaw будет работать на VPS и отвечать в ваших мессенджерах. Вам не нужно держать свой компьютер включённым.

Вариант 2: Прокси

Настройте прокси в конфигурации:

{
  "proxy": {
    "url": "socks5://your-proxy:1080"
  }
}

Вариант 3: Локальные модели

Используйте локально запущенные модели через Ollama. Для этого не нужен доступ к внешним API:

# Установка Ollama
curl -fsSL https://ollama.com/install.sh | sh

# Скачивание модели
ollama pull llama4:70b

# В openclaw.json
# "defaultModel": "ollama/llama4:70b"

Качество локальных моделей ниже, чем у Claude или GPT, но они бесплатны и работают без внешних API.

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

Ошибка “EACCES permission denied”

# Исправление прав для глобальных npm-пакетов
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
# Добавьте строку export в ~/.bashrc или ~/.zshrc

Gateway не запускается

# Проверка, не занят ли порт
lsof -i :18789

# Запуск с подробным логированием
openclaw gateway start --verbose

API-ключ не принимается

# Проверка ключа
openclaw config get auth.anthropic.apiKey

# Обновление ключа
openclaw config set auth.anthropic.apiKey "sk-ant-новый-ключ"

Ошибка “Node.js version too old”

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

# Обновление через nvm
nvm install 24
nvm alias default 24

Попробуйте сами

После установки выполните следующие задания:

1. Проверьте статус. Выполните openclaw status и убедитесь, что Gateway работает.

2. Откройте WebChat. Выполните openclaw chat и задайте 3 вопроса:

   • “Какая сейчас погода в Москве?” (проверка базового ответа)
   • “Создай файл test.txt с текстом Hello World” (проверка работы с файлами)
   • “Прочитай файл test.txt” (проверка чтения файлов)

3. Изучите конфигурацию. Откройте ~/.openclaw/openclaw.json и найдите:

   • Какая модель используется по умолчанию
   • Какие каналы подключены
   • На каком порту работает Gateway

4. Посмотрите логи. Выполните openclaw logs -n 20 и найдите записи о подключении модели и обработке ваших сообщений.

Альтернатива self-host: managed-провайдеры

Если разворачивать самому не хочется — на май 2026 экосистема OpenClaw имеет несколько готовых hosted-сервисов от сторонних провайдеров. Core-команда OpenClaw сама SaaS не делает (проект остаётся self-hosted/local-first), но провайдеры запускают изолированные инсталляции с auth-слоем, авто-обновлениями и интерфейсом без CLI.

Важно про безопасность: managed-варианты решают проблему открытого Gateway-порта (см. 3.5/04-security — категория 4) и proactively обновляют OpenClaw до закрытых от CVE версий. Если ваш use-case массовый или enterprise — managed-провайдер снимает большую часть ручного hardening.

Ключевые выводы

• Установка OpenClaw занимает 5 минут: npm install -g openclaw@latest и openclaw onboard --install-daemon
• Мастер онбординга помогает выбрать модель, ввести API-ключ и подключить первый канал
• Gateway работает как daemon (фоновый процесс) и автоматически перезапускается
• Конфигурация хранится в ~/.openclaw/openclaw.json
• Для пользователей из России: VPS за рубежом, прокси или локальные модели через Ollama
• WebChat — самый быстрый способ проверить работу OpenClaw
• Если self-host не вариант — есть managed-провайдеры (KiloClaw, Hostinger Managed OpenClaw, MyClaw, Lease Packet, Elest.io) от $4/мес

Следующий урок

Урок 3: Интерфейс и базовые команды — изучим все доступные команды, возможности WebChat и выполним первые практические задачи.