1. Зачем отдельное руководство по OpenClaw для Mac
OpenClaw работает на разных платформах, но на Mac (особенно Apple Silicon) путь окружения, глобальный префикс Homebrew и npm, Gatekeeper и права, а также способ держать процесс в фоне отличаются от Linux/Windows. Многие застревают на «command not found», EACCES или «порт занят». В этом руководстве — воспроизводимые шаги для Mac и таблица устранения неполадок.
2. Подготовка окружения Mac (Xcode CLI, Homebrew, Node)
Шаг 1: Установите Xcode Command Line Tools: в Терминале выполните xcode-select --install.
Шаг 2: Установите Homebrew официальной одной строкой. На Apple Silicon добавьте Homebrew в PATH: echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile, затем source ~/.zprofile.
Шаг 3: Установите Node.js 22+. Рекомендуется: brew install nvm, настройте shell, затем nvm install 22 и nvm use 22. Или brew install node@22 и brew link node@22 --force. Проверьте node -v и npm -v.
3. Сравнение способов установки
| Способ | Команда / примечание | Когда использовать |
|---|---|---|
| npm global | npm install -g openclaw@latest | Уже есть Node, быстрая проверка |
| Официальный скрипт | curl -fsSL https://openclaw.ai/install.sh | bash | Зависимости и PATH одной командой |
| Docker | Использовать официальный или сообщества образ OpenClaw | Изолированное окружение |
4. Установка в пять шагов и первый запуск
Шаг 1: Выполните выбранную установку (например npm install -g openclaw@latest). При EACCES: permission denied исправьте права глобальной директории npm: sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}.
Шаг 2: Проверьте CLI: в новом терминале выполните openclaw --version. Если «command not found», убедитесь, что в PATH есть глобальный bin npm (npm config get prefix + /bin).
Шаг 3: Выполните инициализацию по документации (например openclaw onboard) и задайте API-ключ. Порт консоли по умолчанию часто 18789 или 3000; разрешите его в файрволе или группе безопасности.
Шаг 4: Запустите шлюз/сервис (например openclaw gateway или openclaw start). Откройте порт в браузере и проверьте консоль.
Шаг 5: Сделайте минимальный тест (один запрос через консоль или CLI), затем при необходимости настройте LaunchAgent или фоновый режим.
5. Заметки по Apple Silicon
(1) Путь Homebrew: На Apple Silicon Homebrew находится в /opt/homebrew; добавьте /opt/homebrew/bin в PATH. (2) Rosetta 2: Некоторые нативные модули npm могут запросить Rosetta; установите по запросу. (3) Gatekeeper: Если бинарник заблокирован: Системные настройки → Конфиденциальность и безопасность → «Всё равно открыть».
6. Таблица устранения неполадок на Mac
| Симптом | Вероятная причина | Действие |
|---|---|---|
| Command not found (openclaw / node) | В PATH нет Homebrew или глобального bin npm | Добавьте путь в ~/.zprofile или ~/.bash_profile и source |
| EACCES | Глобальная директория npm не принадлежит текущему пользователю | chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} |
| Порт занят | Порт по умолчанию занят | Смените порт в конфиге или остановите процесс через lsof |
| Консоль недоступна | Файрвол или группа безопасности | Разрешите приложение в файрволе macOS; для удалённого Mac откройте 18789/3000 |
| Процесс завершается при закрытии крышки | Нет фонового режима | Используйте LaunchAgent или nohup/screen; или запуск на удалённом Mac 24/7 |
7. Итог: запуск OpenClaw 24/7 на удалённом Mac
Когда OpenClaw работает локально, для круглосуточной работы без использования своей машины или чтобы избежать проблем со сном/крышкой разверните его на удалённом Mac-узле. Тот же macOS и те же шаги, выделенный и стабильный режим. Чтобы не настраивать локальный фоновый режим и не заниматься администрированием, арендуйте удалённый Mac MACGPU и установите OpenClaw там — одна настройка и долгая стабильная работа.