Как установить OpenClaw и сделать первый запуск (полное руководство)

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

После установки 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)

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

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)

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

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. Дать первую задачу

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

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

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

2. Тест файлов:

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

3. Тест кода:

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.

Если на каком-то шаге появилась ошибка — загляните в базу ошибок и решений: там разобраны реальные случаи из обсуждений.

Что попробовать первым делом — полный список навыков. Прежде чем давать агенту автономность, стоит разобраться с правами доступа.