Что происходит при первом запуске

После установки OpenClaw не готов к работе — ему нужны API-ключи языковой модели, разрешения операционной системы и базовая конфигурация. Без этого агент запустится, но не сможет выполнять задачи.

Этот раздел описывает полный процесс первичной настройки: от ввода ключа до выполнения первой реальной задачи. Если вы ещё не установили агент, сначала прочитайте полный гид по OpenClaw.

Шаг 1: Инициализация конфигурации

При первом запуске OpenClaw создаёт конфигурационный файл. Запустите мастер настройки:

openclaw init

Мастер создаст файл ~/.openclaw/config.json (на macOS/Linux) или %APPDATA%\openclaw\config.json (на Windows). Все настройки хранятся в этом файле в формате JSON.

Шаг 2: Настройка API-ключа языковой модели

OpenClaw использует большую языковую модель (LLM) для обработки команд и принятия решений. Поддерживаются три варианта:

Вариант A: OpenAI (GPT-4o, GPT-4.1)

Получите API-ключ на platform.openai.com.
Добавьте ключ в конфигурацию:

openclaw config set llm.provider openai
openclaw config set llm.apiKey sk-your-key-here
openclaw config set llm.model gpt-4o

Вариант B: Anthropic (Claude)

Получите ключ на console.anthropic.com.
Настройте:

openclaw config set llm.provider anthropic
openclaw config set llm.apiKey sk-ant-your-key-here
openclaw config set llm.model claude-sonnet-4-5

Вариант C: Локальная модель (Ollama, LM Studio)

Для работы без облака установите Ollama и загрузите совместимую модель:

ollama pull llama3.3

Затем укажите локальный endpoint:

openclaw config set llm.provider ollama
openclaw config set llm.baseUrl http://localhost:11434
openclaw config set llm.model llama3.3

Локальные модели работают медленнее и дают менее точные результаты, но полностью приватны.

Шаг 3: Выбор и настройка модели

Выбор модели сильно влияет на качество работы агента. Вот сравнение актуальных вариантов:

Модель	Скорость	Качество	Стоимость	Рекомендуется для
GPT-4o	Высокая	Отличное	Средняя	Повседневные задачи
GPT-4.1	Средняя	Превосходное	Высокая	Сложные сценарии
Claude Sonnet	Высокая	Отличное	Средняя	Код и документы
Claude Opus	Низкая	Превосходное	Очень высокая	Критические задачи
Llama 3.3 (локально)	Низкая	Хорошее	Бесплатно	Приватные данные

Шаг 4: Настройка разрешений

OpenClaw управляет браузером, файлами и приложениями — для этого нужны явные разрешения системы.

Разрешения файловой системы

Укажите, какие директории агент может читать и изменять:

openclaw config set permissions.fileAccess '["~/Documents", "~/Downloads", "~/Desktop"]'

По умолчанию доступ к системным папкам (/System, C:\Windows) заблокирован всегда.

Разрешения браузера

OpenClaw работает с Chrome, Firefox и Safari через расширение или Playwright:

openclaw config set permissions.browser true
openclaw config set browser.default chrome

На macOS дополнительно разрешите доступ в Системные настройки → Конфиденциальность → Универсальный доступ.

Разрешения для приложений

Чтобы агент мог управлять другими приложениями (мессенджеры, редакторы, IDE):

openclaw config set permissions.appControl true

Список разрешённых приложений можно ограничить в конфиге:

{
  "permissions": {
    "allowedApps": ["Telegram", "VS Code", "Finder", "Google Chrome"]
  }
}

Шаг 5: Проверка конфигурации

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

openclaw doctor

Вывод покажет статус каждого компонента:

LLM connection: OK / ERROR
File permissions: OK / WARNING
Browser access: OK / NOT CONFIGURED
App control: OK / DISABLED

Устраните все ошибки (ERROR) перед продолжением. Предупреждения (WARNING) не блокируют работу, но ограничивают возможности агента.

Шаг 6: Первая задача

Начните с простого, чтобы убедиться в корректной работе:

Тест браузера:

openclaw run "открой Google Chrome и перейди на google.com"

Тест файлов:

openclaw run "создай файл test.txt на рабочем столе с текстом 'OpenClaw работает'"

Тест кода:

openclaw run "напиши Python-скрипт для вывода текущего времени и сохрани его в ~/Documents/time.py"

Если все три задачи выполнены успешно — OpenClaw полностью настроен и готов к работе.

Чеклист первого запуска

Отметьте каждый шаг — прогресс сохраняется в браузере:

Установлен OpenClaw (openclaw --version показывает версию)
Создан и сохранён API-ключ языковой модели
Выбрана модель в конфиге (model в config.json)
Настроены разрешения для файловой системы
Настроены разрешения для браузера
Проверена работа браузера (тест с google.com)
Проверена работа с файлами (создание test.txt)
Проверена работа с кодом (скрипт Python)

Дополнительные настройки

После базовой конфигурации изучите расширенные возможности:

Навыки OpenClaw — готовые сценарии для типовых задач: обработка почты, сбор данных, автоматизация браузера.
Интеграции — подключение Telegram, Slack, Notion, GitHub и других сервисов.
Сравнение моделей — детальный анализ производительности разных LLM в связке с OpenClaw.

Конфигурационный файл можно редактировать напрямую в любом текстовом редакторе. После изменений перезапустите агента командой openclaw restart.