Документация OpenClaw на русском: быстрый старт

Вы решили попробовать OpenClaw — платформу для AI-агентов, которая превращает языковые модели из простых чат-ботов в полноценных помощников, способных выполнять реальные задачи на вашем компьютере. Эта статья — адаптированный перевод официальной документации OpenClaw Getting Started, дополненный практическими советами для русскоязычных пользователей.

Если вы ещё не знаете, что такое OpenClaw — прочитайте наш обзор для новичков. А если хотите подробную инструкцию по установке на Windows — она здесь.

Что вам понадобится для начала

Для работы OpenClaw нужно совсем немного:

• Node.js версии 22 или новее — это среда выполнения, на которой работает OpenClaw. Проверьте свою версию командой node --version
• API-ключ от любого провайдера AI-моделей — Anthropic (Claude), OpenAI (GPT), Google (Gemini) или другого
• Компьютер с Windows, macOS или Linux

Установка OpenClaw: три способа

Способ 1: Через AI Magic Hub (рекомендуется)

Если вы не хотите разбираться с командной строкой, AI Magic Hub — это графическая оболочка, которая сделает всё за вас. Скачайте установщик с aimagichub.ru, запустите его — и через пару минут OpenClaw будет готов к работе.

Способ 2: Установка через терминал (macOS/Linux)

Откройте терминал и выполните одну команду:

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

Скрипт автоматически определит вашу операционную систему, скачает нужную версию и установит OpenClaw в системный PATH.

Способ 3: Установка через PowerShell (Windows)

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

Эта команда загрузит и установит OpenClaw на Windows. Рекомендуется запускать PowerShell от имени администратора.

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

После установки запустите мастер начальной настройки:

openclaw onboard --install-daemon

Мастер проведёт вас через несколько шагов:

1. Аутентификация — выберите провайдера AI-моделей и введите API-ключ (или настройте OAuth)
2. Настройка Gateway — это основной сервис OpenClaw, который обрабатывает все запросы
3. Каналы связи — опционально подключите Telegram, WhatsApp, Discord или другие мессенджеры
4. Установка демона — флаг --install-daemon создаёт фоновый сервис, который запускается автоматически

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

Убедитесь, что Gateway запущен:

openclaw gateway status

Если всё в порядке, вы увидите сообщение о том, что сервис активен. Теперь откройте панель управления:

openclaw dashboard

Эта команда откроет Control UI — веб-интерфейс OpenClaw по адресу http://127.0.0.1:18789/. Здесь вы можете общаться с агентом прямо в браузере, без настройки каких-либо каналов.

Ключевые понятия: что нужно знать

Gateway — сердце OpenClaw

Gateway — это серверный процесс, который принимает сообщения из разных каналов (Telegram, WhatsApp, браузер), отправляет их в AI-модель, получает ответ и пересылает обратно. Он работает как фоновый сервис на вашем компьютере.

Агент — ваш AI-помощник

Агент — это конфигурация, определяющая поведение AI. У каждого агента есть своё рабочее пространство (workspace), набор инструментов и модель. По умолчанию создаётся один агент с ID main.

Рабочее пространство (Workspace)

Директория ~/.openclaw/workspace, где агент хранит файлы, заметки и память. Вы можете положить туда свои файлы — агент получит к ним доступ и сможет с ними работать.

Каналы — способы общения

OpenClaw поддерживает множество каналов: Telegram, WhatsApp, Discord, Slack, Signal, iMessage и другие. Подробнее о настройке каналов — в нашей статье о каналах.

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

Если вы хотите запускать OpenClaw от имени сервисного аккаунта или использовать нестандартные пути, пригодятся переменные окружения:

• OPENCLAW_HOME — корневая директория OpenClaw
• OPENCLAW_STATE_DIR — директория состояния (сессии, крон-задачи, учётные данные)
• OPENCLAW_CONFIG_PATH — путь к файлу конфигурации (по умолчанию ~/.openclaw/openclaw.json)

Дополнительные проверки

Запуск Gateway в режиме отладки

Если что-то не работает, полезно запустить Gateway в переднем плане:

openclaw gateway --port 18789

Так вы увидите все логи прямо в терминале и сможете быстро найти проблему.

Отправка тестового сообщения

Если у вас настроен канал (например, Telegram), можно проверить отправку:

openclaw message send --target +79001234567 --message "Привет от OpenClaw"

Что у вас будет после настройки

После выполнения всех шагов у вас будет:

• Работающий Gateway — фоновый сервис, готовый обрабатывать запросы
• Настроенная аутентификация — подключение к выбранному провайдеру AI-моделей
• Доступ к Control UI — веб-интерфейс для общения с агентом
• Опционально: подключённые каналы — Telegram, WhatsApp или другие мессенджеры

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

Теперь, когда OpenClaw запущен, рекомендуем изучить:

• Конфигурация OpenClaw — полный справочник настроек
• Настройка каналов — Telegram, WhatsApp, Discord
• Безопасность — как защитить своего агента
• Память OpenClaw — как агент запоминает контекст

Частые проблемы при установке

Node.js не найден или старая версия

OpenClaw требует Node.js 22+. Скачайте последнюю LTS-версию с nodejs.org или используйте менеджер версий (nvm).

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

Запустите диагностику:

openclaw doctor

Если обнаружены проблемы с конфигурацией:

openclaw doctor --fix

Порт занят

По умолчанию Gateway использует порт 18789. Если он занят, укажите другой:

openclaw gateway --port 18790

Почему стоит попробовать OpenClaw

OpenClaw — это не просто чат-бот. Это полноценный AI-агент, который может:

• Работать с файлами на вашем компьютере
• Выполнять команды в терминале
• Искать информацию в интернете
• Отправлять сообщения через Telegram, WhatsApp, Discord
• Автоматизировать рутинные задачи по расписанию
• Запоминать контекст и учитывать ваши предпочтения

Подробнее о возможностях — в нашем полном обзоре OpenClaw.