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

Что понадобится перед установкой

Перед началом убедитесь, что ваш Mac соответствует базовым требованиям:

• macOS 12 Monterey или новее;
• не менее 2 ГБ свободного места;
• стабильное интернет-соединение;
• API-ключ для выбранной языковой модели.

OpenClaw работает как на Intel Mac, так и на Apple Silicon. Для установки не нужны глубокие технические знания — достаточно открыть Терминал и выполнить несколько команд.

Шаг 1. Установите Node.js

Для работы OpenClaw нужен Node.js версии 22 или выше. Сначала проверьте, установлен ли он у вас:

node --version

Если в ответ вы видите версию v22.x.x или новее, переходите к следующему шагу. Если команды нет или версия устарела, установите Node.js одним из способов ниже.

Вариант 1. Установка через Homebrew

Если у вас уже есть Homebrew, выполните:

brew install node

Если Homebrew ещё не установлен, сначала добавьте его:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

После этого снова выполните установку Node.js через brew install node.

Вариант 2. Установка через официальный сайт

Можно использовать и стандартный графический установщик:

1. Откройте сайт Node.js.
2. Скачайте версию LTS.
3. Запустите загруженный .pkg-файл и пройдите шаги мастера установки.

Проверка

После установки закройте и снова откройте Терминал, затем выполните:

node --version
npm --version

Если команды возвращают номера версий, всё готово.

Шаг 2. Установите OpenClaw

Есть два основных способа установки OpenClaw на Mac.

Способ 1. Через официальный установочный скрипт

Это самый быстрый вариант. Выполните в Терминале:

curl -fsSL https://openclaw.ai/install.sh | bash

Скрипт установит OpenClaw и подготовит систему к дальнейшей настройке.

Способ 2. Через npm

Если вы предпочитаете установку через пакетный менеджер Node.js, используйте:

npm install -g openclaw@latest

Если при установке возникает ошибка, связанная с sharp или libvips, попробуйте эту команду:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Проверьте, что установка завершилась успешно

openclaw --version

Если команда возвращает номер версии, OpenClaw установлен корректно.

Если появляется ошибка прав доступа

Иногда на macOS глобальная установка npm-пакетов требует дополнительных прав. В этом случае используйте:

sudo npm install -g openclaw@latest

Шаг 3. Получите API-ключ языковой модели

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

Какие провайдеры можно использовать

• Anthropic Claude — хороший вариант для старта;
• OpenAI GPT — популярный и универсальный выбор;
• Kimi — вариант с длинным контекстом;
• Ollama — для локального запуска без облака.

Пример: как получить ключ Anthropic

1. Зарегистрируйтесь в консоли Anthropic.
2. Откройте раздел API Keys.
3. Создайте новый ключ.
4. Скопируйте его и сохраните в безопасном месте.
5. При необходимости пополните баланс аккаунта.

Пример: как получить ключ OpenAI

1. Создайте аккаунт на платформе OpenAI.
2. Перейдите в раздел API Keys.
3. Создайте новый secret key.
4. Сохраните его и проверьте настройки биллинга.

Шаг 4. Выполните первичную настройку OpenClaw

После установки запустите мастер конфигурации:

openclaw onboard --install-daemon

Во время настройки вам предложат:

1. выбрать провайдера языковой модели;
2. вставить API-ключ;
3. подключить мессенджер для общения с агентом;
4. задать имя и описание агента;
5. создать файл личности SOUL.md.

После завершения мастер создаст конфигурацию в каталоге:

~/.openclaw/

Проверить содержимое можно так:

ls -la ~/.openclaw/

Обычно внутри находятся основные настройки, рабочая директория агента, файл личности и служебные credentials.

Шаг 5. Запустите агента

Чтобы выполнить первый запуск OpenClaw, используйте команду:

openclaw gateway --port 18789

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

После этого откройте подключённый мессенджер и отправьте агенту тестовое сообщение, например:

Привет! Расскажи, что ты умеешь.

Чтобы остановить работу агента, нажмите Ctrl + C в окне терминала.

Полезные команды OpenClaw

openclaw gateway --port 18789
openclaw gateway --port 18789 --verbose
openclaw doctor
openclaw update

• gateway — запускает агента;
• --verbose — включает расширенный вывод для диагностики;
• doctor — помогает найти проблемы в конфигурации;
• update — обновляет OpenClaw до свежей версии.

Частые проблемы и решения

Команда openclaw не найдена

Иногда глобальные npm-пакеты не попадают в переменную окружения PATH. Проверьте расположение глобальных пакетов:

npm root -g

Затем добавьте путь к исполняемым файлам в конфигурацию оболочки:

echo 'export PATH="$(npm root -g)/../bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Если используете bash, вместо .zshrc укажите .bash_profile.

Ошибка неподдерживаемой версии Node.js

OpenClaw требует Node.js 22 или новее. Проверьте текущую версию:

node --version

Если версия ниже нужной, обновите Node.js через Homebrew или установите новую LTS-версию вручную.

Неверный API-ключ или ошибка авторизации

• Проверьте, что ключ скопирован полностью;
• убедитесь, что у провайдера активен биллинг или есть баланс;
• не путайте ключи разных провайдеров.

При необходимости можно отредактировать конфигурацию вручную:

nano ~/.openclaw/openclaw.json

Ошибка EACCES permission denied

Обычно помогает повторная установка через sudo:

sudo npm install -g openclaw@latest

Агент запускается, но не отвечает в мессенджере

• Проверьте токен мессенджера;
• убедитесь, что подключён нужный бот;
• запустите диагностику командой ниже.

openclaw doctor

Что делать дальше

После установки OpenClaw можно перейти к следующим шагам:

• настроить личность агента через SOUL.md;
• добавить навыки в каталог skills/;
• подключить дополнительные каналы связи;
• настроить безопасность и доступ к gateway;
• подобрать подходящую языковую модель под ваши задачи.