Первый запуск и начальная настройка OpenClaw: пошаговая инструкция

Быстрая установка. Самый быстрый способ -- одна команда: npx openclaw init. Автоматически создаёт структуру проекта и запускает мастер настройки провайдера.

После установки OpenClaw (через npm или Docker) следующий шаг - запуск мастера начальной настройки. Этот мастер проведёт вас через конфигурацию всех ключевых параметров: выбор LLM-провайдера, настройку рабочего пространства, подключение каналов связи и активацию навыков.

Перед запуском убедитесь, что у вас есть API-ключ хотя бы одного LLM-провайдера. Если вы планируете использовать облачные модели, подготовьте ключ от Anthropic (Claude), OpenAI (GPT) или другого поддерживаемого провайдера. Если вы хотите работать полностью локально, установите Ollama (подробности - в отдельной статье).

Для нативной установки (через npm) выполните одну из двух команд:

openclaw onboard

или эквивалентную:

openclaw start

Для Docker-установки используйте:

docker compose run --rm openclaw-cli onboard

Мастер онбординга запускается в интерактивном режиме и задаёт серию вопросов, на основе которых генерирует конфигурацию.

На первом шаге мастер предложит выбрать провайдера языковой модели. Вам будет показан список поддерживаемых провайдеров с приоритетом по умолчанию: Anthropic, OpenAI, OpenRouter, Google Gemini, xAI, Groq, Ollama и другие. Выберите провайдера и введите API-ключ, когда будет запрошен.

Мастер проверит введённый ключ, выполнив тестовый запрос к API. Если ключ валиден, вы увидите подтверждение и название доступной модели. Если ключ невалиден, мастер предложит ввести его повторно.

Мастер автоматически генерирует уникальный токен для Gateway - внутреннего API-шлюза OpenClaw. Этот токен записывается в файл .env и используется для аутентификации запросов к Gateway. Токен нельзя терять: если вы его потеряете, придётся перегенерировать его и обновить конфигурацию всех подключённых клиентов.

На этом шаге мастер создаёт рабочее пространство (workspace) - набор файлов, определяющих поведение и знания вашего агента. Вам будет предложено указать имя агента и краткое описание его назначения. На основе ваших ответов мастер сгенерирует начальные версии файлов SOUL.md, AGENTS.md и USER.md.

Мастер предложит подключить один или несколько каналов коммуникации: Telegram, WhatsApp, Discord, Slack или веб-чат. Вы можете пропустить этот шаг и настроить каналы позже. Для каждого канала потребуется соответствующий токен или учётные данные (например, Telegram Bot Token).

На последнем шаге мастер показывает список доступных навыков (Skills) и предлагает активировать нужные. Навыки включают работу с электронной почтой, календарём, файловой системой, веб-поиском, умным домом и другими сервисами. Вы можете активировать или деактивировать навыки в любое время после онбординга.

После завершения онбординга OpenClaw создаёт конфигурационную директорию в домашнем каталоге пользователя. Её структура выглядит следующим образом:

~/.openclaw/
├── openclaw.json          # Главный конфигурационный файл
├── credentials/           # API-ключи (chmod 600)
│   ├── anthropic
│   ├── openai
│   └── ...
├── sessions/              # Данные сессий
└── workspace/             # Рабочее пространство агента
    ├── AGENTS.md           # Операционные инструкции
    ├── SOUL.md             # Личность и тон агента
    ├── USER.md             # Описание пользователя
    ├── TOOLS.md            # Документация инструментов
    ├── HEARTBEAT.md        # Автономные задачи
    ├── MEMORY.md           # Основная память (100 строк)
    ├── memory/             # Расширенная память
    │   ├── people/
    │   ├── projects/
    │   ├── topics/
    │   └── decisions/
    └── skills/             # Файлы навыков
        ├── email.md
        ├── calendar.md
        └── ...

Главный конфигурационный файл openclaw.json содержит путь к рабочему пространству, параметры Gateway, настройки моделей и другие глобальные параметры. Файлы в директории credentials/ хранят API-ключи с ограниченными правами доступа (chmod 600), чтобы другие пользователи системы не могли их прочитать.

После онбординга запустите Gateway - основной серверный компонент OpenClaw:

openclaw gateway

Gateway запускается как фоновый процесс и начинает слушать порт 18789 (по умолчанию). В терминале вы увидите сообщение о успешном запуске с указанием адреса и порта.

Для проверки работоспособности Gateway откройте в браузере или выполните curl-запрос:

curl http://localhost:18789/healthz

Если Gateway работает корректно, вы получите ответ с информацией о статусе. Эндпоинт /readyz показывает готовность к обработке запросов, включая доступность LLM-провайдера.

Самый простой способ проверить работу OpenClaw - отправить сообщение через CLI:

openclaw send "Привет! Расскажи о себе."

Агент должен ответить, представившись в соответствии с настройками из SOUL.md. Если ответ получен, значит вся цепочка работает: CLI отправляет сообщение через Gateway, Gateway передаёт его в Brain, Brain вызывает LLM-провайдера, получает ответ и возвращает его обратно через Gateway в CLI.

Для более интерактивного общения используйте режим чата:

openclaw chat

В этом режиме вы можете вести непрерывный диалог с агентом прямо в терминале. Для выхода введите /exit или нажмите Ctrl+C.

OpenClaw предоставляет набор CLI-команд для управления агентом:

# Запуск Gateway
openclaw gateway

# Отправка одиночного сообщения
openclaw send "Ваше сообщение"

# Интерактивный чат
openclaw chat

# Просмотр статуса Gateway
openclaw status

# Просмотр версии
openclaw --version

# Справка по командам
openclaw --help

# Повторный онбординг
openclaw onboard

Логи OpenClaw - основной инструмент диагностики. Gateway записывает логи в стандартный вывод, а также может сохранять их в файл. Для просмотра логов в реальном времени при нативной установке используйте:

openclaw gateway --verbose

Флаг --verbose включает подробное логирование, полезное при отладке. В логах вы увидите входящие и исходящие сообщения, вызовы к LLM-провайдеру, выполнение навыков и ошибки.

Для Docker-установки используйте стандартный просмотр логов контейнера:

docker compose logs -f openclaw-gateway

Файл SOUL.md - это «лист персонажа» вашего агента. Он загружается в контекст LLM в начале каждой сессии и определяет, как агент себя ведёт. Откройте его в любом текстовом редакторе и настройте под ваши нужды.

Типичный SOUL.md включает: имя агента, роль (личный ассистент, технический помощник, секретарь), тон общения (формальный, дружелюбный, лаконичный), языковые предпочтения (на каком языке общаться), ограничения (что агент не должен делать), контекст (ваш часовой пояс, рабочее расписание).

Файл HEARTBEAT.md определяет задачи, которые агент выполняет автономно при каждом heartbeat-цикле (по умолчанию каждые 30 минут). Например, вы можете настроить агента проверять входящую почту, напоминать о предстоящих встречах или мониторить определённые веб-страницы.

Каждая задача описывается в Markdown-формате с указанием условий выполнения, приоритета и ожидаемого результата. Gateway периодически отправляет агенту heartbeat-промпт, и агент решает, какие задачи из HEARTBEAT.md нужно выполнить прямо сейчас.

Gateway не запускается, порт 18789 занят. Проверьте, не работает ли уже другой экземпляр OpenClaw или иное приложение на этом порту. Используйте команду lsof -i :18789 (macOS/Linux) для поиска процесса, занимающего порт. Вы можете изменить порт Gateway в конфигурации.

Ошибка аутентификации при вызове LLM. Убедитесь, что API-ключ введён правильно. Проверьте файл в директории credentials/. Убедитесь, что на вашем аккаунте провайдера есть средства (для платных API) и не превышены лимиты запросов.

Агент не отвечает на сообщения. Проверьте логи Gateway командой openclaw gateway --verbose. Убедитесь, что Gateway запущен и доступен по адресу http://localhost:18789/healthz. Проверьте сетевое соединение с LLM-провайдером.

Теперь, когда ваш AI-агент настроен и работает, пора разобраться с подключением различных LLM-провайдеров. В следующей статье мы подробно рассмотрим настройку облачных моделей от OpenAI, Anthropic, DeepSeek и других провайдеров.

КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Anthropic OAuth более не доступен для OpenClaw. OAuth-авторизация была закрыта в январе 2026 года. Если в гайде описан процесс входа через OAuth или QR-код Anthropic - эта часть инструкции устарела и неработоспособна. Единственный способ подключить Anthropic - API-ключ.

Правильная процедура подключения Anthropic: зайдите на console.anthropic.com, создайте API-ключ в разделе API Keys, скопируйте ключ и введите его в OpenClaw при первом запуске или через команду 'openclaw config set anthropic_api_key YOUR_KEY'.

Новые команды, добавленные с момента написания оригинального гайда: '/think' активирует расширенный режим рассуждений (доступен с Claude Opus 4.8), '/fast' переключает на быстрый режим с сокращённым временем ответа. Команда 'openclaw doctor' проверяет конфигурацию и выявляет распространённые проблемы настройки.

Control UI Dashboard (localhost:3000). После запуска откройте localhost:3000 для мониторинга агентов и настройки без редактирования файлов.

После запуска OpenClaw откройте браузер и перейдите по адресу http://localhost:3000. Это Control UI -- панель управления агентом. Основные разделы:

Начиная с OpenClaw 2026.5.x, параметры автономного режима вынесены в отдельный файл HEARTBEAT.md. Он отвечает за расписание heartbeat, параметры задач и настройки Dreaming. Создаётся автоматически при первом запуске с openclaw onboard.

SOUL.md по-прежнему отвечает за личность агента, а HEARTBEAT.md -- за его расписание и автономное поведение. Это разделение упрощает настройку.

Dreaming -- ночная консолидация памяти -- включается в HEARTBEAT.md. По умолчанию отключено. Чтобы включить:

Откройте HEARTBEAT.md через Control UI (Memory -- HEARTBEAT.md) и добавьте:

## Dreaming
enabled: true
schedule: "0 3 * * *" # каждую ночь в 3:00
phases: [light, rem, deep]

Active Memory автоматически подгружает релевантный контекст перед каждым ответом. Установка через CLI:

openclaw skill install active-memory

После установки плагин активируется автоматически. Никакой дополнительной настройки не требуется.

TaskFlow -- официальный оркестрационный слой OpenClaw для автоматизации сложных задач. Позволяет описывать последовательности шагов в YAML и запускать их как автономные задачи агента.

Пример простого TaskFlow в HEARTBEAT.md:

## Tasks
- name: daily_briefing
schedule: "0 9 * * *"
steps:
- check_news
- summarize
- send_to_telegram

Рекомендуемые модели в OpenClaw v2026.6.8 (июнь 2026):

• openai/gpt-5.5 -- модель по умолчанию для большинства задач. Нативный Codex runtime, контекст 272 000 токенов. Укажите в BRAIN.md: model: openai/gpt-5.5
• anthropic/claude-opus-4.8 -- для сложных агентных цепочек и глубокого анализа
• openai/gpt-5.4 -- баланс скорости и качества, хорошо для высоконагруженных агентов
• google/gemini-3.5-pro -- рекомендуется для задач с большим контекстом (1M+ токенов)

Рекомендуемая версия для установки (июль 2026): v2026.7.1. Стабильный релиз, включающий все исправления ветки v2026.6.x и дополнительные улучшения производительности. Установка: npm install -g openclaw@2026.7.1

Этот материал подготовлен командой AI-агентов AravanaAI и проверен главным редактором.

В список рекомендуемых моделей для первого запуска добавлен Claude Fable 5 от Anthropic. Это флагманская модель с расширенными агентными возможностями, оптимизированная для работы с OpenClaw. Fable 5 показывает наилучшие результаты в задачах планирования, использования инструментов и долгосрочных агентных сессиях.

Для подключения Fable 5 выберите в настройках модели провайдер Anthropic и укажите модель `claude-fable-5`. Для работы потребуется API-ключ Anthropic, который можно получить на console.anthropic.com. Стоимость зависит от объёма использования - подробнее на странице ценообразования Anthropic.

Если вы работаете локально без облачных API, для первого запуска подойдут Qwen 3 27B или Mistral 3 через Ollama - они показывают хорошее качество агентного поведения без необходимости платного API.

Этот материал подготовлен командой AI-агентов AravanaAI и проверен главным редактором.