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

OpenClaw --- бесплатный автономный ИИ-агент с открытым исходным кодом, который работает прямо на вашем устройстве и общается через мессенджеры: Telegram, WhatsApp, Slack, Discord, Signal и другие. В этом руководстве вы пройдёте все шаги от чистой macOS до работающего агента, которому можно написать в мессенджер и получить ответ.

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

Что понадобится

Прежде чем начинать, убедитесь, что у вас есть:

• macOS 12 Monterey или новее --- OpenClaw работает на Intel- и Apple Silicon-маках. Проверить версию: меню Apple > «Об этом Mac».
• 2 ГБ свободного места на диске --- для Node.js, OpenClaw и его зависимостей.
• Стабильное подключение к интернету --- для установки пакетов и работы с API языковой модели.
• API-ключ языковой модели --- понадобится на этапе настройки. Если у вас его ещё нет, получим в шаге 3.

Никаких специальных знаний программирования не требуется --- достаточно уметь открыть терминал и вставить команду.

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

OpenClaw работает на Node.js --- среде выполнения JavaScript. Вам нужна версия 22 или новее.

Проверьте, установлен ли Node.js

Откройте Терминал (Finder > Программы > Утилиты > Терминал или через Spotlight: Cmd + Пробел, введите «Terminal») и выполните:

node --version

Если вы видите номер версии вроде v22.4.1 --- Node.js уже установлен. Убедитесь, что первая цифра 22 или больше, и переходите к шагу 2.

Если команда не найдена --- установите Node.js одним из способов ниже.

Способ A: Через Homebrew (рекомендуется для разработчиков)

Homebrew --- популярный пакетный менеджер для macOS. Если он у вас уже стоит:

brew install node

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

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

Следуйте инструкциям в терминале, затем установите Node.js командой выше.

Способ B: Через официальный установщик (для всех)

1. Перейдите на nodejs.org.
2. Скачайте версию LTS (Long Term Support) --- это стабильный выпуск.
3. Откройте скачанный .pkg-файл и следуйте шагам установщика.

Проверяем результат

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

node --version
npm --version

Вы должны увидеть что-то вроде:

v22.4.1
10.2.4

После этого шага у вас установлены Node.js и npm (менеджер пакетов), которые необходимы для работы OpenClaw.

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

Способ A: Официальный установщик (рекомендуется)

Самый простой способ --- официальный скрипт установки. Выполните в терминале:

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

Скрипт автоматически установит OpenClaw и запустит мастер настройки.

Способ B: Через npm

Альтернативный способ --- установка через npm:

npm install -g openclaw@latest

Если возникает ошибка sharp / libvips при сборке:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Проверка установки

openclaw --version

Ожидаемый вывод --- номер версии OpenClaw.

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

На macOS иногда появляется ошибка permission denied. Решение:

sudo npm install -g openclaw@latest

Введите пароль вашего Mac-аккаунта (символы не отображаются при вводе --- это нормально) и нажмите Enter.

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

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

OpenClaw --- это оболочка, а «мозг» агента --- языковая модель (LLM). Вам нужен API-ключ одного из провайдеров.

Какую модель выбрать

Провайдер	Рекомендация	Где получить ключ
Anthropic Claude	Лучший выбор для начала. Модели Claude отлично справляются с русским языком и сложными задачами.	console.anthropic.com
OpenAI GPT	Хорошая альтернатива с широким набором моделей.	platform.openai.com
Kimi	Бюджетный вариант с поддержкой длинного контекста.	kimi.ai
Ollama	Полностью локальный запуск, без отправки данных в облако. Требует мощный Mac (16+ ГБ RAM).	ollama.com

Как получить ключ (на примере Anthropic Claude)

1. Зарегистрируйтесь на console.anthropic.com.
2. Перейдите в раздел API Keys.
3. Нажмите Create Key, задайте имя (например, «openclaw»).
4. Скопируйте ключ --- он начинается с sk-ant-.... Сохраните его в надёжном месте: ключ показывается только один раз.
5. Пополните баланс: для тестирования достаточно $5.

Для OpenAI GPT

1. Зарегистрируйтесь на platform.openai.com.
2. Перейдите в API Keys > Create new secret key.
3. Скопируйте ключ (начинается с sk-...).
4. Пополните баланс в разделе Billing.

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

Шаг 4. Первая настройка --- openclaw onboard

Запустите мастер настройки:

openclaw onboard --install-daemon

Мастер настройки проведёт вас через несколько шагов:

1. Выбор языковой модели --- выберите провайдера (Claude, GPT, Kimi, Ollama). Для первого раза рекомендуем Claude.
2. Ввод API-ключа --- вставьте ключ, полученный в шаге 3.
3. Выбор мессенджера --- укажите, через какой мессенджер агент будет общаться (Telegram, WhatsApp, Slack, Discord, Signal). Для старта Telegram --- самый простой вариант.
4. Имя и описание агента --- задайте имя, которое будет отображаться в мессенджере.
5. Файл SOUL.md --- мастер создаст файл «личности» агента. Вы сможете отредактировать его позже, чтобы задать тон, стиль и область знаний агента.

После завершения в директории ~/.openclaw/ появятся файлы конфигурации:

ls -la ~/.openclaw/

Вы увидите структуру вроде:

~/.openclaw/
├── openclaw.json       # Основные настройки (формат JSON5)
├── workspace/
│   ├── SOUL.md         # Личность агента
│   ├── AGENTS.md       # Описание агентов
│   └── skills/         # Директория для скиллов
└── credentials         # Ключи и токены

После этого шага у вас настроенный агент с конфигурацией, файлом личности и подключённым мессенджером.

Шаг 5. Первый запуск

Запустите агента:

openclaw gateway --port 18789

В терминале вы увидите:

🤖 OpenClaw agent started
📡 Connected to Telegram
🌐 Dashboard: http://127.0.0.1:18789/
⏳ Waiting for messages...

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

Привет! Расскажи о себе.

Агент должен ответить в течение нескольких секунд. Если ответ пришёл --- поздравляем, установка завершена.

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

Полезные команды для работы

openclaw gateway --port 18789     # Запустить агента
openclaw gateway --port 18789 --verbose  # Запуск с подробным выводом
openclaw doctor                   # Диагностика проблем
openclaw update                   # Обновить OpenClaw

После этого шага у вас работающий ИИ-агент, который отвечает на сообщения в мессенджере.

Решение частых проблем

«command not found: openclaw»

Node.js установлен, но команда openclaw не найдена. Причина --- глобальные npm-пакеты не в PATH.

Проверьте, где npm устанавливает глобальные пакеты:

npm root -g

Добавьте путь к бинарным файлам npm в PATH:

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

Если вы используете bash вместо zsh, замените .zshrc на .bash_profile.

«Error: unsupported Node.js version»

OpenClaw требует Node.js 22+. Проверьте версию:

node --version

Если версия ниже 22, обновите Node.js. Через Homebrew:

brew upgrade node

Через установщик --- скачайте свежую LTS-версию с nodejs.org.

«Error: Invalid API key» или «Authentication failed»

• Убедитесь, что вы скопировали ключ полностью, без лишних пробелов.
• Проверьте, что на счёте провайдера есть средства.
• Убедитесь, что выбран правильный провайдер (ключ Claude не подойдёт для GPT и наоборот).

Перенастроить ключ можно, отредактировав конфигурационный файл:

nano ~/.openclaw/openclaw.json

«Error: EACCES permission denied» при установке

Используйте sudo npm install -g openclaw@latest или настройте npm для работы без root-прав (описано в шаге 2).

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

• Проверьте, что бот в мессенджере корректно создан и токен верный.
• Убедитесь, что вы пишете именно тому боту, который подключён к OpenClaw.
• Запустите диагностику и проверьте вывод в терминале, где запущен gateway:

openclaw doctor

Что дальше

Установка --- это только начало. Вот что стоит сделать следующим шагом:

• Установка OpenClaw на Windows --- инструкция для Windows 10 и 11.
• Установка OpenClaw на Linux --- инструкция для Ubuntu, Debian и других дистрибутивов.
• Gateway: как устроен и как настроить --- подробно о gateway, дашборде и удалённом доступе.
• Безопасность OpenClaw --- что нужно знать перед запуском агента.
• Выбор языковой модели --- какую LLM выбрать для OpenClaw.

OpenClaw --- проект с открытым исходным кодом и сообществом из более чем 145 000 пользователей на GitHub. Присоединяйтесь, экспериментируйте и делайте своего агента полезнее с каждым днём.