Начало работы с OpenClaw: установка с помощью Docker (Ollama GPU или Claude + CPU)

Установите OpenClaw локально с помощью Ollama

Содержимое страницы

OpenClaw — это AI-ассистент для самостоятельного размещения (self-hosted), предназначенный для работы с локальными средами выполнения LLM, такими как Ollama, или с облачными моделями, такими как Claude Sonnet.

В этом руководстве по быстрому старту показано, как развернуть OpenClaw с помощью Docker, настроить локальную модель с использованием GPU или облачную модель только для CPU, а также проверить, что ваш AI-ассистент работает от начала до конца.

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

Задача проста:

  • Запустить OpenClaw.
  • Отправить запрос.
  • Подтвердить, что всё работает.

Это не руководство по усилению безопасности для production-среды.
Это не руководство по настройке производительности.
Это практичная отправная точка.

У вас есть два варианта:

  • Путь А — Локальный GPU с использованием Ollama (рекомендуется, если у вас есть GPU)
  • Путь Б — Только CPU с использованием Claude Sonnet 4.6 через API Anthropic

Оба пути используют один и тот же основной процесс установки.

install openclaw steps GPU vs CPU

Если вы новичок в OpenClaw и хотите получить более глубокое представление о структуре системы, прочтите Обзор системы OpenClaw. Если вы планируете запустить постоянно работающего ассистента с более строгим изолированием (sandboxing) и контролем политик, следуйте Руководству по безопасной эксплуатации NemoClaw.

Системные требования и настройка окружения

OpenClaw — это система стиля ассистента, которая может подключаться к внешним сервисам. Для этого быстрого старта:

  • По возможности используйте тестовые аккаунты.
  • Избегайте подключения чувствительных production-систем.
  • Запускайте его внутри Docker (рекомендуется).

Изоляция является хорошим значением по умолчанию при экспериментировании с программным обеспечением агентного типа.

Предварительные требования для OpenClaw (GPU с Ollama или CPU с Claude)

Требуется для обоих путей

  • Git
  • Docker Desktop (или Docker + Docker Compose)
  • Терминал

Для пути А (Локальный GPU)

  • Машина с совместимым GPU (рекомендуются NVIDIA или AMD)
  • Установленный Ollama

Для пути Б (CPU + Облачная модель)

  • Ключ API Anthropic
  • Доступ к Claude Sonnet 4.6

Шаг 1 — Установка OpenClaw с Docker (Клонирование и запуск)

OpenClaw можно запустить с помощью Docker Compose. Это сохраняет настройку изолированной и воспроизводимой.

Клонирование репозитория

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Копирование конфигурации окружения

cp .env.example .env

Откройте файл .env в вашем редакторе. Мы настроим его на следующем шаге в зависимости от выбранного пути модели.

Запуск контейнеров

docker compose up -d

Если всё запустится правильно, вы должны увидеть работающие контейнеры:

docker ps

На этом этапе OpenClaw работает, но он ещё не подключен к модели.

Шаг 2 — Настройка провайдера LLM (Ollama GPU или Claude CPU)

Теперь решите, как должен работать инференс.

Путь А — Локальный GPU с Ollama

Если у вас доступен GPU, это самый простой и наиболее самодостаточный вариант.

Установка или проверка Ollama

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

Если Ollama не установлен:

curl -fsSL https://ollama.com/install.sh | sh

Проверьте, что он работает:

ollama pull llama3
ollama run llama3

Если модель отвечает, инференс работает.

Настройка OpenClaw для использования Ollama

В вашем файле .env настройте:

LLM_PROVIDER=ollama
OLLAMA_BASE_URL=http://host.docker.internal:11434
OLLAMA_MODEL=llama3

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

docker compose restart

Теперь OpenClaw будет направлять запросы в ваш локальный экземпляр Ollama.

Если вы выбираете, какую модель запустить на GPU с 16 ГБ видеопамяти, хотите сравнить бенчмарки или вам нужны разумные значения по умолчанию для сэмплирования Qwen / Gemma для ассистентов, интенсивно использующих инструменты, см.:

Чтобы понять параллелизм и поведение CPU под нагрузкой:

Путь Б — Только CPU с использованием Claude Sonnet 4.6

Если у вас нет GPU, вы можете использовать хостовую модель.

Добавление вашего API-ключа

В вашем файле .env:

LLM_PROVIDER=anthropic
ANTHROPIC_API_KEY=ваш_api_ключ_здесь
ANTHROPIC_MODEL=claude-sonnet-4-6

Перезапустите:

docker compose restart

Теперь OpenClaw будет использовать Claude Sonnet 4.6 для инференса, в то время как оркестрация выполняется локально.

Эта настройка хорошо работает на машинах только с CPU, поскольку вычисления тяжелой модели происходят в облаке.

Если вы используете модели Anthropic здесь, это изменение политики подписки Claude объясняет, почему OpenClaw требует биллинга на основе API вместо повторного использования плана Claude.

Шаг 3 — Тестирование OpenClaw с вашим первым промптом

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

В зависимости от вашей настройки это может быть через:

  • Веб-интерфейс
  • Интеграцию с мессенджерами
  • Локальный конечный пункт API (endpoint)

Для базового тестирования API:

curl http://localhost:3000/health

Вы должны увидеть ответ со статусом здоровья.

Теперь отправьте простой промпт:

curl -X POST http://localhost:3000/chat   -H "Content-Type: application/json"   -d '{"message": "Объясните простыми словами, что делает OpenClaw."}'

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

Что вы только что запустили

На данный момент у вас есть:

  • Рабочий экземпляр OpenClaw
  • Настроенный провайдер LLM (локальный или облачный)
  • Работающий цикл запрос-ответ

Если вы выбрали путь с GPU, инференс происходит локально через Ollama.

Если вы выбрали путь с CPU, инференс происходит через Claude Sonnet 4.6, в то время как оркестрация, маршрутизация и обработка памяти выполняются внутри ваших локальных контейнеров Docker.

Видимое взаимодействие может выглядеть простым. Под капотом множество компонентов координируются для обработки вашего запроса.

Устранение неполадок при установке и проблемах во время работы OpenClaw

Модель не отвечает

  • Проверьте конфигурацию вашего файла .env.
  • Проверьте логи контейнеров:
docker compose logs

Ollama недоступен

  • Убедитесь, что Ollama запущен:
ollama list
  • Убедитесь, что базовый URL соответствует вашему окружению.

Недействительный API-ключ

  • Дважды проверьте ANTHROPIC_API_KEY
  • Перезапустите контейнеры после обновления .env

GPU не используется

  • Убедитесь, что драйверы GPU установлены.
  • Убедитесь, что Docker имеет доступ к GPU.

Следующие шаги после установки OpenClaw

У вас теперь есть рабочий экземпляр OpenClaw.

Отсюда вы можете:

  • Подключить платформы мессенджеров
  • Включить извлечение документов
  • Экспериментировать со стратегиями маршрутизации
  • Добавить наблюдаемость (observability) и метрики
  • Настроить поведение производительности и затрат

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

Запуск системы — это первый шаг.

После того как она запустится, естественными следующими статьями будут:

  • Руководство по плагинам OpenClaw — какие плагины установить для памяти, инструментов, каналов и наблюдаемости, и как работает жизненный цикл
  • Руководство по навыкам OpenClaw — какие навыки стоит установить из ClawHub, и как безопасно ограничивать их доступ в зависимости от роли агента
  • Шаблоны production-настройки OpenClaw — как плагины и навыки сочетаются для реальных типов пользователей, таких как разработчики, команды автоматизации, исследователи и операторы поддержки

Для более подробных исследований случаев использования AI-систем см. раздел AI Systems.

Подписаться

Получайте новые материалы про системы, инфраструктуру и AI engineering.