FAQ
Установка

Установка OpenClaw на macOS: пошаговая инструкция

Пошаговая инструкция по установке OpenClaw на macOS 13+. Системные требования, установка через npm и Homebrew, первый запуск и решение типичных проблем.

· 4 мин чтения
Установка OpenClaw на macOS: пошаговая инструкция

Самый быстрый способ: готовый сервер в облаке

Если хотите запустить OpenClaw без настройки и чтобы он работал 24/7 без вашего Mac — воспользуйтесь готовым образом от Timeweb Cloud.

Timeweb Cloud — российский хостинг с предустановленным OpenClaw в маркетплейсе. Один клик — сервер готов. Не нужно ставить Node.js, разбираться с правами и Docker. Серверы в России, поддержка на русском.

Запустить OpenClaw на Timeweb Cloud →

Установка на macOS: системные требования

Прежде чем устанавливать OpenClaw, убедитесь, что ваш Mac соответствует минимальным требованиям. Агент активно использует компьютерное зрение и управляет системными приложениями, поэтому ресурсы имеют значение.

КомпонентМинимумРекомендуется
macOS13 Ventura14 Sonoma или новее
RAM8 ГБ16 ГБ и более
ПроцессорApple M1 / Intel Core i5Apple M2/M3 или Intel Core i7+
Свободное место2 ГБ5 ГБ (с кешем моделей)
Node.js22.x22.x LTS
ИнтернетОбязательноСтабильное соединение

OpenClaw официально поддерживает только macOS 13 и выше из-за зависимости от новых API системных разрешений и Accessibility Framework.

Подробнее обо всех требованиях читайте в разделе системных требований OpenClaw.

Шаг 1: Установка Node.js 22

OpenClaw требует Node.js версии 22 или выше. Рекомендуемый способ — использовать nvm (Node Version Manager), чтобы управлять версиями без конфликтов.

Установка через nvm

  1. Откройте Terminal (⌘ + Space, введите «Terminal»).
  2. Установите nvm командой:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  1. Перезапустите терминал или выполните:
source ~/.zshrc
  1. Установите Node.js 22:
nvm install 22
nvm use 22
nvm alias default 22
  1. Проверьте версию:
node --version  # должно быть v22.x.x
npm --version   # должно быть 10.x.x или выше

Альтернатива: установка через Homebrew

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

brew install node@22
echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Шаг 2: Загрузка OpenClaw

Официальный репозиторий находится на GitHub: github.com/openclaw-ai/openclaw. Не скачивайте агент из сторонних источников — это небезопасно.

  1. Клонируйте репозиторий:
git clone https://github.com/openclaw-ai/openclaw.git
cd openclaw
  1. Либо скачайте ZIP-архив последнего релиза через раздел Releases на GitHub и распакуйте его.

Шаг 3: Установка зависимостей и сборка

После загрузки исходников установите зависимости:

npm install
npm run build

Процесс занимает 1–3 минуты. После завершения убедитесь, что в папке dist/ появились файлы.

Глобальная установка через npm

Для удобного запуска из любой директории установите OpenClaw глобально:

npm install -g openclaw

После этого команда openclaw будет доступна в любом терминале.

Шаг 4: Решение проблем macOS

macOS имеет строгую систему безопасности, которая может заблокировать работу OpenClaw. Вот наиболее частые проблемы и их решения.

Gatekeeper блокирует запуск

Если macOS выдаёт предупреждение «Невозможно открыть, так как разработчик не установлен»:

  1. Откройте Системные настройки → Конфиденциальность и безопасность.
  2. Найдите сообщение об OpenClaw и нажмите Всё равно открыть.
  3. Либо через Terminal выполните:
sudo xattr -rd com.apple.quarantine /path/to/openclaw

Разрешения Accessibility

OpenClaw управляет другими приложениями через Accessibility API. Без нужных разрешений агент не сможет кликать по кнопкам и вводить текст.

  1. Откройте Системные настройки → Конфиденциальность и безопасность → Универсальный доступ.
  2. Добавьте Terminal (или iTerm2) в список разрешённых приложений.
  3. Если используете встроенный сервер OpenClaw — добавьте node или openclaw напрямую.

Разрешения на запись файлов

Для работы с файлами агенту нужен доступ к папкам:

  • Откройте Конфиденциальность и безопасность → Файлы и папки.
  • Разрешите доступ к необходимым директориям.

Шаг 5: Первый запуск и проверка

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

openclaw --version
openclaw doctor

Команда doctor проверит все зависимости, разрешения и конфигурацию. Устраните все предупреждения перед началом работы.

Для первого тестового запуска выполните:

openclaw run "открой браузер и перейди на сайт example.com"

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

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

Что дальше

После успешной установки:

  • Настройте API-ключ модели (OpenAI, Anthropic или локальный LLM).
  • Изучите доступные навыки OpenClaw для автоматизации задач.
  • Подключите нужные интеграции — мессенджеры, браузер, файловую систему.

OpenClaw на macOS работает стабильно и использует нативные API системы. Apple Silicon (M1/M2/M3) обеспечивает значительно лучшую производительность по сравнению с Intel-моделями, особенно при запуске локальных языковых моделей.

Теги: установкаmacOSOpenClawинструкция