Первая настройка OpenClaw

· 4 мин чтения · admin

После установки OpenClaw нужно выполнить базовую настройку. Это занимает 2-3 минуты.

Первый запуск

Если вы установили через скрипт, онбординг уже запустился. Если нет:

openclaw onboard --install-daemon

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

  • Модель и провайдер — выберите, какой ИИ будет работать (OpenAI, Anthropic, Google и другие). Введите API-ключ
  • Рабочее пространство — где хранятся файлы агента (по умолчанию ~/.openclaw/workspace)
  • Gateway — порт и авторизация (обычно достаточно по умолчанию)
  • Каналы — подключение мессенджеров (можно позже)
  • Служба — автозапуск (systemd на Linux, LaunchAgent на macOS)

    • Проверка

    openclaw gateway status

    Gateway должен слушать порт 18789.

    Откройте дашборд:

    openclaw dashboard

    Если страница загрузилась — всё работает.

    Полная диагностика:

    openclaw status          # локальный статус
openclaw status --all    # полный отчёт
openclaw health --json   # здоровье Gateway

    Логи лежат в /tmp/openclaw/ (файл openclaw-YYYY-MM-DD.log).

    Bootstrapping (первый запуск агента)

    При первом запуске агента OpenClaw автоматически:

  • Создаст файлы AGENTS.md, BOOTSTRAP.md, IDENTITY.md, USER.md в рабочем пространстве
  • Запустит короткий опрос (по одному вопросу) — чтобы узнать ваше имя и предпочтения
  • Запишет ответы в IDENTITY.md, USER.md, SOUL.md
  • Удалит BOOTSTRAP.md — опрос запускается только один раз

    • Если хотите пропустить опрос (например, workspace уже настроен):

    openclaw onboard --skip-bootstrap

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

    Конфигурация хранится в ~/.openclaw/openclaw.json. Формат — JSON5 (поддерживает комментарии и trailing commas).

    Если файл отсутствует, OpenClaw использует безопасные настройки по умолчанию.

    Минимальный конфиг

    {
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+79001234567"] } },
}

    Способы редактирования

    Интерактивный мастер:

    openclaw configure

    CLI (однострочники):

    openclaw config get agents.defaults.workspace
openclaw config set agents.defaults.heartbeat.every "2h"

    Control UI: откройте http://127.0.0.1:18789 → вкладка Config.

    Прямое редактирование: измените ~/.openclaw/openclaw.json — Gateway следит за файлом и применяет изменения автоматически (hot reload).

    Валидация конфигурации

    OpenClaw проверяет конфиг по схеме. Если есть неизвестные ключи или неверные значения — Gateway не запустится. Исправления:

    openclaw doctor        # проверить проблемы
openclaw doctor --fix  # исправить автоматически

    Gateway хранит резервную копию последней рабочей конфигурации. Если файл сломается — OpenClaw восстановит его автоматически.

    Рабочее пространство агента

    В папке ~/.openclaw/workspace/ находятся файлы агента:

  • AGENTS.md — инструкции и правила для агента
  • SOUL.md — характер и стиль общения
  • USER.md — информация о пользователе
  • MEMORY.md — долгосрочная память
  • TOOLS.md — заметки об инструментах
  • IDENTITY.md — имя и сущность агента
  • HEARTBEAT.md — задачи для периодической проверки

    • Эти файлы можно редактировать — агент будет использовать их как контекст.

    Рекомендация: сделайте эту папку приватным git-репозиторием для бэкапа. OpenClaw автоматически инициализирует git при первом запуске.

    Подключение каналов

    Самый быстрый канал для начала — Telegram. Создайте бота через @BotFather, скопируйте токен:

    {
  channels: {
    telegram: {
      token: "ВАШ_ТОКЕН",
    },
  },
}

    Или через CLI:

    openclaw configure --section channels
    Все доступные каналы

    Telegram, Discord, WhatsApp, Signal, Slack, iMessage, Matrix, Microsoft Teams, Google Chat, Feishu, IRC, LINE, Nostr, Twitch, Zalo и другие.

    Подробнее: Все каналы

    Two-phone setup для WhatsApp

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

  • Купите вторую SIM/eSIM
  • Привяжите WhatsApp на втором номере к OpenClaw
  • Общайтесь с ассистентом с основного телефона

    • Если привязать личный WhatsApp — каждое входящее сообщение станет «входом агента». Это редко бывает нужно.

    Сессии и память

  • Файлы сессий: ~/.openclaw/agents//sessions/
  • /new или /reset — начать новую сессию (настраивается через resetTriggers)
  • /compact — сжать контекст и узнать оставшийся бюджет

    • Heartbeats (проактивный режим)

    По умолчанию OpenClaw проверяет HEARTBEAT.md каждые 30 минут. Если файл пуст — пропускает. Если агент отвечает HEARTBEAT_OK — сообщение не отправляется.

    Для отключения:

    {
  agents: {
    defaults: {
      heartbeat: { every: "0m" },
    },
  },
}

    Доктор

    Если что-то не работает:

    openclaw doctor

    Эта команда проверит конфигурацию, мигрирует устаревшие настройки и покажет проблемы.

    Что дальше

  • Конфигурация Gateway — подробные настройки
  • Провайдеры и модели — выбор и настройка ИИ
  • Каналы — подключение мессенджеров
  • Персонализация агента — настройка характера и поведения