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

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

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

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

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

1. Node.js версии 24 или выше

node --version
# Ожидаемый вывод: v24.x.x или выше

Если версия ниже 24:

# Установка через nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 24
nvm use 24

2. npm (устанавливается вместе с Node.js)

npm --version
# Ожидаемый вывод: 10.x.x или выше

3. API-ключ AI-модели (одна из):
   • Anthropic (Claude): console.anthropic.com
   • OpenAI (GPT): platform.openai.com
   • Google (Gemini): aistudio.google.com

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

Установите OpenClaw глобально и проверьте, что всё работает:

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

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

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

openclaw onboard --install-daemon

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

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

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

   • Claude Sonnet 4.6 — оптимальный баланс качества и скорости
   • Claude Opus 4.7 — лучшее качество (флагман на май 2026), но дороже
   • GPT-4o или o-series — хорошая альтернатива
   • Gemini — бюджетный вариант

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-4-6

Если статус 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-4-6",

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

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

  // Агенты
  "agents": {
    "default": {
      "model": "claude-sonnet-4-6",
      "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 и выполним первые практические задачи.