Как установить OpenClaw на Mac

OpenClaw можно установить на Mac несколькими способами — в зависимости от того, как вам удобнее работать и управлять настройкой. В этом руководстве вы найдёте пошаговые инструкции для разных методов установки, а также советы, которые помогут запустить OpenClaw без проблем.

Краткий обзор: три способа установки OpenClaw на Mac

Ниже приведено сравнение трёх методов. Они отличаются объёмом ручной настройки, который вам нужно выполнить.

Kimi Claw позволяет запускать OpenClaw в облаке без настройки Node.js, Homebrew или API-ключей. Работающего агента в браузере можно получить за считанные минуты.

Если вы предпочитаете локальную настройку, переходите к следующему разделу. Если хотите более простой вариант, перейдите к разделу Запуск OpenClaw на Mac с Kimi Claw или нажмите кнопку ниже, чтобы начать сразу.

Перед началом: необходимая подготовка и безопасность

Перед локальной установкой OpenClaw на Mac нужно выполнить несколько шагов по подготовке и безопасности. Если вы планируете использовать Kimi Claw, можете пропустить этот раздел и перейти прямо к инструкциям по настройке ниже.

• Зависимости: однострочный установщик автоматически устанавливает Node.js, если это необходимо. Если вы выбираете Homebrew, Node.js нужно установить вручную (рекомендуется Node 24; также подходит Node 22 LTS 22.16+).

• Настройки брандмауэра и сети: брандмауэр macOS обычно отключён по умолчанию. Включить его можно в System Settings > Network > Firewall. OpenClaw привязывает gateway к адресу 127.0.0.1 (localhost), поэтому другие устройства в вашей сети не могут подключиться к нему напрямую. Если вам нужен доступ с мобильных устройств или удалённый доступ, можно использовать такие инструменты, как Tailscale, или SSH-туннель. Не перенаправляйте порт 18789 через роутер.

Установка OpenClaw на Mac с помощью однострочного скрипта

Это самый быстрый способ запустить OpenClaw локально на Mac. OpenClaw работает из Terminal и предоставляет интерфейс на основе браузера для управления агентом, а не традиционное графическое приложение. Одна команда устанавливает CLI, проверяет версию Node.js и запускает мастер адаптации.

Шаг 1. Запустите скрипт установки в Terminal

Откройте Terminal с помощью Spotlight (⌘ + Space), затем вставьте следующую команду:

Скрипт определяет вашу систему, устанавливает CLI OpenClaw и проверяет версию Node.js. Если Node.js отсутствует или устарела, скрипт автоматически устанавливает Node 24 (также поддерживается Node 22 LTS 22.16+).

Шаг 2. Задайте API-ключ и настройте gateway

Мастер адаптации запускается автоматически после завершения установки. Выберите Moonshot AI (Kimi K2.5) в качестве провайдера LLM и вставьте свой API-ключ Kimi, когда это будет предложено. Примите настройки по умолчанию для порта gateway и аутентификации. Если вы хотите, чтобы OpenClaw запускался автоматически при загрузке Mac, выберите опцию установки демона в процессе настройки.

Шаг 3. Проверьте gateway и откройте панель управления

Выполните следующую команду, чтобы проверить, что gateway работает:

Затем откройте панель управления:

Эта команда открывает Control UI в браузере по адресу http://127.0.0.1:18789. Введите токен gateway для входа. После входа вы можете начать взаимодействие со своим агентом OpenClaw.

Установка OpenClaw на Mac с помощью Homebrew

Если вы предпочитаете управлять пакетами через Homebrew, вы можете установить OpenClaw на Mac более ручным способом. Этот метод даёт больше контроля над зависимостями и вписывается в уже привычный вам процесс работы с Homebrew.

Шаг 1. Установка Homebrew

Откройте Terminal через Spotlight (⌘ + Space). Если Homebrew ещё не установлен, выполните следующую команду. Homebrew — это менеджер пакетов для macOS, позволяющий устанавливать и управлять инструментами разработчика из терминала — похоже на то, как магазин приложений устанавливает приложения.

Во время установки может появиться запрос на ввод пароля от вашей учётной записи Mac. Обратите внимание, что терминал не отображает вводимые символы из соображений безопасности. Также могут появляться запросы на подтверждение установки и сообщения об устанавливаемых файлах.

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

Шаг 2. Установка Node.js

После установки Homebrew установите Node.js:

После установки убедитесь, что версия v24 (рекомендуется) или v22.16+.

Шаг 3. Установка CLI OpenClaw и запуск онбординга

Установите CLI глобально с помощью npm, затем запустите онбординг:

Если во время npm install -g появляется ошибка доступа EACCES, значит глобальной директории npm нужны повышенные права. Либо выполните sudo npm install -g openclaw@latest, либо измените стандартную директорию npm, чтобы в будущем не использовать sudo.

Флаг --install-daemon регистрирует OpenClaw как LaunchAgent, поэтому шлюз запускается автоматически при входе в систему. Во время онбординга выберите Moonshot AI (Kimi K2.5) в качестве провайдера и введите свой ключ Kimi API.

Шаг 4. Проверка шлюза и открытие панели управления

Убедитесь, что шлюз работает, и откройте панель управления:

В браузере откроется интерфейс управления. Введите токен шлюза — и всё готово к работе.

Запуск OpenClaw на Mac с помощью Kimi Claw

Kimi Claw — это онлайн-инструмент, позволяющий запускать OpenClaw в облаке без локальной настройки. На вашем Mac ничего не нужно устанавливать, не требуется работать в терминале или управлять зависимостями. Всё происходит прямо в браузере. Создать агента OpenClaw можно за несколько минут. Kimi Claw берёт на себя шлюз, рабочую область, хранение данных и доступ к моделям, поэтому агент остаётся в сети 24/7 — даже когда MacBook закрыт.

Как использовать Kimi Claw?

Шаг 1. Откройте Kimi Claw

Перейдите на страницу Kimi Claw и нажмите Create, чтобы начать развёртывание среды OpenClaw.

Шаг 2. Автоматическое развёртывание OpenClaw

Подтвердите развёртывание во всплывающем окне. После этого Kimi Claw настроит среду OpenClaw, включая шлюз, рабочую область и инструменты. Процесс обычно занимает всего несколько минут.

Шаг 3. Начало работы с OpenClaw

После завершения развёртывания рабочая область откроется на панели управления. Общайтесь с агентом, настраивайте навыки, планируйте задачи и управляйте файлами — всё прямо из браузера.

Чем Kimi Claw отличается от локального запуска OpenClaw

Kimi Claw предлагает более простой способ запускать OpenClaw без локальной настройки. Вместо установки зависимостей и управления локальной средой вы можете запускать агента прямо в браузере, а Kimi Claw возьмёт на себя настройку и инфраструктуру.

• Без локальной настройки: запускайте OpenClaw без установки Node.js и без использования терминала. Всё работает прямо в браузере, поэтому вы начинаете быстрее и избегаете проблем с настройкой окружения.

• Мгновенный доступ к более чем 5000 навыков: вместо ручной установки инструментов Kimi Claw может автоматически подключать нужные для вашей задачи навыки из обширной библиотеки, сокращая время настройки и проблемы совместимости.

• Автоматизация и планирование задач без перерывов: в отличие от локальных агентов, которые останавливаются при переходе Mac в режим сна, Kimi Claw работает в облаке 24/7, что делает его подходящим для запланированных задач и длительных процессов.

• 40 ГБ облачного хранилища и постоянная память: в отличие от локальных установок, где файлы обычно привязаны к одному устройству, Kimi Claw предоставляет 40 ГБ хранилища, благодаря чему ваши отчёты и исследования доступны из любого браузера. Он также запоминает ваши настройки и контекст работы между сессиями, чтобы вы могли продолжить с того места, где остановились.

• Встроенная модель Kimi K2.5 и профессиональный поиск: Kimi Claw поставляется со встроенным доступом к Kimi K2.5 и продвинутым поисковым возможностям, поэтому вам не нужно управлять API-ключами или настраивать внешние сервисы. Он может автоматически подключать актуальную информацию в таких областях, как финансы, технологии и новости, делая исследования и выполнение задач более плавными.

Как держать OpenClaw запущенным 24/7 на Mac

Большинство пользователей обращаются с ИИ как с обычным настольным приложением: используют его, когда сидят за компьютером, и закрывают, когда работа закончена. Но для действительно ценной автоматизации — например, отслеживания мировых рынков ночью или подготовки исследовательского отчёта к 8 утра — агент должен работать круглосуточно. Поскольку macOS автоматически приостанавливает локальные процессы при переходе системы в режим сна, для этого нужна отдельная стратегия. В этом разделе рассматриваются два способа поддерживать постоянное соединение:

Вариант A: выделенное оборудование Mac

Один из вариантов — держать Mac (например, Mac mini) постоянно включённым. Можно отключить сон с помощью sudo pmset -a sleep 0 и включить «Пробуждать для доступа по сети» в Системных настройках. Для удалённого доступа можно использовать такие инструменты, как Tailscale, или SSH-туннель.

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

Вариант B: Kimi Claw делает это автоматически

Если вы запускаете своего агента через Kimi Claw, доступность 24/7 обеспечена изначально. Ваш агент работает независимо от вашего локального устройства, поэтому продолжает функционировать даже когда Mac закрыт или выключен. Настраивать режим сна или держать машину включённой не требуется.

Устранение распространённых ошибок установки OpenClaw на Mac

Даже при простой настройке во время установки могут возникнуть проблемы. Вот некоторые распространённые проблемы и способы их устранения.

Ошибка «command not found» для OpenClaw

• Причина: глобальный bin-каталог npm не указан в PATH вашей оболочки.

• Решение: выполните source ~/.zshrc, чтобы перезагрузить конфигурацию оболочки. Если вы используете Bash вместо Zsh, замените ~/.zshrc на ~/.bash_profile. Если ошибка не исчезает, найдите путь npm prefix и добавьте его в PATH:

OpenClaw не запускается после перезагрузки

• Причина: LaunchAgent не был установлен во время первичной настройки.

• Решение: выполните команду первичной настройки с флагом daemon:

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

Порт 18789 уже используется

• Причина: другой процесс занимает порт шлюза.

• Решение: найдите и остановите конфликтующий процесс:

Ошибка Xcode Command Line Tools при установке навыка

• Причина: некоторые пакеты npm требуют нативной компиляции, а Xcode Command Line Tools отсутствуют или устарели.

• Решение: установите или обновите инструменты:

После завершения установки повторите попытку установки навыка.

Слишком старая версия Node.js

• Причина: на вашем Mac установлена версия Node.js старше 22.16. OpenClaw требует Node 24 (рекомендуется) или Node 22 LTS 22.16+.

• Решение: если вы использовали Homebrew:

Если вы использовали однострочный установщик, запустите его повторно. Скрипт обнаружит устаревшую версию и обновит её.

Заключение

OpenClaw можно запустить локально на Mac с помощью однострочного установщика или Homebrew, либо в браузере с помощью Kimi Claw без локальной настройки. Каждый способ приводит к работающему агенту, но требует разного объёма ручных усилий. Если вы хотите быструю настройку со встроенной доступностью 24/7, можно начать с Kimi Claw и получить работающего агента за несколько минут.