Установка OpenClaw на macOS занимает 10–15 минут: нужно поставить Node.js, запустить один из официальных установщиков и пройти onboarding. В этом руководстве — системные требования, четыре способа установки на Mac (установщик-скрипт, DMG-приложение, Homebrew, npm), настройка автозапуска через launchd, подключение Telegram и других каналов, а также решение частых ошибок на macOS.
Что такое OpenClaw
OpenClaw — это персональный AI-ассистент с открытым исходным кодом, который запускается на вашем компьютере и работает через Gateway — локальный сервис-посредник между моделью ИИ и каналами связи (Telegram, WhatsApp, Discord и другими). Ключевая характеристика: агент не привязан к чужому серверу, умеет выполнять задачи на вашей машине (файлы, браузер, команды) и сохраняет память между сессиями. На macOS OpenClaw работает нативно — это одна из трёх официально поддерживаемых платформ наряду с Linux и Windows.
Какие требования у OpenClaw на Mac
Официальная документация указывает три требования:
Для приложения-компаньона из Homebrew (меню-бар) актуальная версия 2026.7.1 требует macOS 15 или новее — это единственное отличие от CLI-версии, которая работает на более старых системах.
Как установить OpenClaw на macOS: 4 способа
Способ 1. Установщик-скрипт (рекомендуется)
Самый быстрый путь, который описывает официальная документация:
curl -fsSL https://openclaw.ai/install.sh | bash
Скрипт определяет операционную систему, при необходимости ставит Node.js, устанавливает OpenClaw и запускает onboarding. Если нужно установить без мастера настройки (например, для автоматизации), добавьте флаг:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Способ 2. Приложение для macOS (.dmg)
OpenClaw поставляется с нативным приложением в меню-баре: статус, уведомления, WebChat, голосовой ввод и быстрый чат по горячей клавише Option-Space (⌥Space). Скачайте OpenClaw-.dmg (предпочтительно) или .zip со страницы релизов на GitHub.
При первом запуске приложение спросит режим работы:
Затем приложение проведёт проверку модели — если вам нужен свой API-ключ, выберите «Choose a different AI» на экране успеха. Разрешения macOS (экран, микрофон, доступность) выдаются через Settings → Permissions.
Способ 3. Homebrew
Если вы уже пользуетесь Homebrew, проще всего поставить приложение через cask:
brew install --cask openclaw
По данным формуляра Homebrew, за последний год (365 дней) cask openclaw установили 42 912 раз — это популярный способ установки. Текущая версия — 2026.7.1, требование — macOS 15 или новее. Раньше пакет назывался clawdbot, так что в старых гайдах вы можете встретить это имя.
Способ 4. npm, pnpm или bun
Если Node.js у вас уже настроен, ставьте глобальный пакет. На npm 12 или 11.16+:
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon
На pnpm:
pnpm add -g --allow-build=openclaw openclaw@latest
openclaw onboard --install-daemon
На bun:
bun add -g --trust openclaw@latest
bun run --bun openclaw onboard --install-daemon --daemon-runtime bun
Есть и вариант с локальным префиксом: curl -fsSL https://openclaw.ai/install-cli.sh | bash — он держит OpenClaw и Node в папке ~/.openclaw, не трогая системный Node.
Что делает onboarding и зачем нужен флаг —install-daemon
Onboarding — это пошаговый мастер первой настройки. Он поднимает Gateway, создаёт рабочее пространство (workspace), подключает каналы и скиллы. Во время прохождения OpenClaw обычно просит:
Флаг --install-daemon в команде openclaw onboard --install-daemon означает, что OpenClaw зарегистрирует Gateway как фоновый сервис. На macOS это LaunchAgent через launchd — ассистент автоматически запускается при входе в систему и продолжает работать, даже если вы закрыли терминал.
Как проверить, что OpenClaw работает
После установки выполните три команды:
openclaw --version # CLI установлен
openclaw doctor # проверка конфигурации и типичных проблем
openclaw gateway status # Gateway запущен
Дополнительно можно запустить health-check: openclaw health. Если всё в порядке, отправьте первое сообщение агенту:
openclaw agent --message "Напиши план на день" --thinking high
Как настроить автозапуск при включении Mac
Автозапуск настраивается одной командой во время установки — openclaw onboard --install-daemon, либо отдельно:
openclaw gateway install
На macOS эта команда создаёт LaunchAgent, которым управляет launchd. Проверить статус можно командой openclaw gateway status. Если вы ставили приложение из DMG в режиме «This Mac», LaunchAgent создаётся автоматически, и карточка обновлений в дашборде будет показывать «Update Mac app + Gateway» — приложение обновляет и себя, и Gateway согласованно.
Где хранятся настройки OpenClaw на Mac
Пользовательская конфигурация и рабочее пространство хранятся вне папки установки, чтобы обновления не ломали кастомизацию:
~/.openclaw/openclaw.json — конфигурация;~/.openclaw/workspace — рабочее пространство: скиллы, промпты, память.Документация рекомендует держать эти папки вне облачной синхронизации (iCloud Drive), потому что синхронизация может конфликтовать с файлами памяти и конфигурации. Резервное копирование сводится к копированию папки ~/.openclaw — этого достаточно для переноса на другую машину.
Как подключить Telegram, WhatsApp и другие каналы
OpenClaw работает как Gateway для ИИ-агентов в разных мессенджерах: Telegram, WhatsApp, Discord, Slack, Signal, Teams, Matrix. Для привязки канала выполните:
openclaw channels login
Мастер проведёт вас через авторизацию выбранного канала. На macOS рекомендуемый порядок из документации: установить приложение, пройти список разрешений, убедиться, что локальный Gateway запущен, затем линковать каналы и сделать openclaw health. Подробнее про Telegram — в нашем руководстве по подключению бота.
Mac Mini как домашний ИИ-сервер 24/7
Отдельный сценарий, ради которого OpenClaw на macOS ставят чаще всего, — превратить Mac Mini в постоянно работающий домашний ИИ-сервер. Apple Silicon M1–M4 потребляет мало энергии, работает тихо и не мешает в квартире, поэтому Mac Mini удобно держать включённым круглосуточно.
Схема такая: ставьте OpenClaw через любой способ выше, регистрируете LaunchAgent (--install-daemon), подключаете Telegram или другой канал — и получаете ассистента, который отвечает в любое время, даже когда вы не за компьютером. Для доступа к такому серверу извне без открытия портов используют Tailscale. Если же держать свою машину включённой не хочется, альтернатива — запустить ассистента на облачной платформе вроде Neirohost (AI-ассистенты на базе OpenClaw с уже подключёнными нейросетями) или на обычном VPS.
Частые ошибки при установке на macOS
«openclaw: command not found». Почти всегда это проблема PATH: глобальная папка npm не добавлена в PATH вашей оболочки. Проверьте по порядку:
node -v # Node установлен?
npm prefix -g # где глобальные пакеты?
echo "$PATH" # папка bin из npm prefix есть в PATH?
Слишком старый Node. OpenClaw требует Node 22.22.3+, 24.15+ или 25.9+. Обновите Node — проще всего через менеджер версий fnm или nvm.
Gateway не запускается. Проверьте статус openclaw gateway status, затем openclaw doctor — утилита сама подскажет, что не так с конфигурацией. Запустить Gateway вручную на стандартном порту 18789: openclaw gateway --port 18789 --verbose.
Скачали не тот установщик. В марте 2026 года появились предупреждения о поддельных загрузках OpenClaw, через которые распространяют инфостилеры. Скачивайте только с официального GitHub (github.com/openclaw/openclaw) и официального домена openclaw.ai, не переходите по рекламным ссылкам из поиска. Остальные проблемы разобраны в нашем гайде по частым ошибкам OpenClaw.
Пошаговая инструкция: установка за 10 минут
node --version. Если Node нет — установщик OpenClaw поставит его сам.curl -fsSL https://openclaw.ai/install.sh | bash.openclaw onboard --install-daemon.openclaw --version, openclaw doctor, openclaw gateway status.openclaw channels login.openclaw agent --message "Привет".Частые вопросы
Работает ли OpenClaw на Mac с чипом M1, M2, M3 или M4?
Да. OpenClaw полностью поддерживает Apple Silicon и Intel-процессоры. Приложение и CLI собираются в нативные версии для ARM64 и x86_64.
Нужен ли Mac с большим объёмом памяти?
Для работы с облачными моделями (Claude, GPT, Gemini) хватает 8 ГБ. Если вы планируете запускать локальные модели через Ollama, памяти нужно больше — отдельный вопрос, разобранный в статье про локальные модели.
Как сделать, чтобы OpenClaw запускался автоматически?
Используйте openclaw onboard --install-daemon или openclaw gateway install — на macOS это создаст LaunchAgent, которым управляет launchd, и Gateway будет стартовать при входе в систему.
Можно ли управлять Mac Mini с OpenClaw удалённо?
Да. Приложение поддерживает режим Remote (подключение к Gateway по SSH, LAN или Tailscale), а сам Mac Mini можно оставить дома включённым — ассистент будет доступен через Telegram или другой канал.
Чем OpenClaw на Mac отличается от установки на VPS?
На Mac вы получаете локальный Gateway с доступом к файлам, браузеру и командам вашей машины — это удобно для персонального ассистента. VPS даёт выделенный сервер в дата-центре, который не зависит от домашнего интернета и электричества. Сравнение вариантов — в статье про установку на VPS.