Как установить и запустить OpenClaw (ранее Clawdbot/Moltbot) на Mac
OpenClaw — это open-source, самостоятельно размещаемый шлюз, который соединяет ваши повседневные приложения для обмена сообщениями с AI-агентами для кодинга. Вместо переключения между вкладками, приложениями и интерфейсами вы отправляете сообщение из WhatsApp или Telegram и получаете ответ на базе AI прямо у себя в кармане. Он лицензирован по MIT, работает на вашем оборудовании и оставляет вам полный контроль над вашими данными.
В этом руководстве мы пройдем через все, что нужно для установки и запуска OpenClaw на macOS — от предварительных требований до вашего первого работающего чата.
Что вам понадобится
Перед началом убедитесь, что у вас есть следующее:
- macOS (любая недавняя версия)
- Node.js 22 или новее — скрипт установки сделает это за вас, если он еще не установлен, но лучше проверить
- API-ключ — команда OpenClaw рекомендует Anthropic
- Около 5 минут вашего времени
Чтобы проверить текущую версию Node, откройте Terminal и выполните:
node --version
Если вы видите v22.x.x или выше, всё готово. Если нет, не волнуйтесь — установщик позаботится об этом.
Шаг 1: Установите OpenClaw через скрипт установки (рекомендуется)
Самый быстрый способ установить OpenClaw на macOS — однострочный скрипт установки. Он выполняет обнаружение Node, установку CLI и запускает мастер первоначальной настройки — всё за один шаг.
Откройте Terminal и выполните:
curl -fsSL https://openclaw.ai/install.sh | bash
Вот и всё. Скрипт загрузит CLI, установит его глобально через npm и автоматически запустит мастер первоначальной настройки.
Альтернатива: установка напрямую через npm
Если у вас уже есть Node 22+ и вы предпочитаете ручное управление, вы можете установить OpenClaw с помощью npm:
npm install -g openclaw@latest
openclaw onboard --install-daemon
Альтернатива: установка через pnpm
Если pnpm — ваш предпочтительный менеджер пакетов:
pnpm add -g openclaw@latest
pnpm approve-builds -g # approve openclaw, node-llama-cpp, sharp, etc.
openclaw onboard --install-daemon
Примечание: pnpm требует явного одобрения для пакетов со скриптами сборки. После того как первая установка покажет предупреждение "Ignored build scripts", выполните pnpm approve-builds -g и выберите перечисленные пакеты.
Устранение неполадок: ошибки сборки sharp
Если у вас глобально установлен libvips (часто встречается на macOS через Homebrew) и sharp не устанавливается, принудительно используйте предварительно собранные бинарные файлы:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
Если вы видите ошибку sharp: Please add node-gyp to your dependencies, либо установите инструменты сборки (Xcode Command Line Tools + npm install -g node-gyp), либо используйте переменную окружения выше.
Шаг 2: Запустите мастер первоначальной настройки
Если скрипт установки не запустил его автоматически, запустите мастер первоначальной настройки вручную:
openclaw onboard --install-daemon
Мастер проведет вас через настройку аутентификации, параметров шлюза и дополнительных подключений каналов. Он также установит OpenClaw как фоновую службу (daemon), чтобы Gateway продолжал работать даже после закрытия Terminal.
Что настраивает мастер
- Аутентификация — генерирует токен для Gateway, чтобы локальные и удаленные клиенты должны были проходить аутентификацию
- Настройки Gateway — порт, адрес привязки и установка службы
- Подключения каналов — дополнительная настройка для WhatsApp, Telegram, Discord и других
Шаг 3: Проверьте, что Gateway запущен
После завершения первоначальной настройки проверьте, что Gateway работает:
openclaw gateway status
Вы должны увидеть подтверждение, что Gateway запущен. Если вы хотите запустить его в foreground для отладки или быстрого тестирования, используйте:
openclaw gateway --port 18789
Для полной проверки работоспособности:
openclaw health
Шаг 4: Откройте Control UI (Dashboard)
Самый быстрый способ начать общаться с OpenClaw — через браузерный Control UI, без необходимости настраивать каналы.
Выполните:
openclaw dashboard
Это скопирует URL Dashboard, по возможности откроет ваш браузер и отобразит ссылку. По умолчанию Control UI доступен по адресу:
http://127.0.0.1:18789/
Если панель управления запрашивает аутентификацию, вставьте токен из конфигурации Gateway. Получить его можно с помощью:
openclaw config get gateway.auth.token
Примечание по безопасности: Control UI — это административная поверхность: она предоставляет доступ к чату, конфигурации и подтверждениям выполнения. Не открывайте ее для публичного доступа. Используйте localhost, Tailscale Serve или SSH-туннель.
Шаг 5: Подключите канал чата (необязательно)
Хотя Control UI дает мгновенный доступ к чату, настоящая сила OpenClaw — в общении с вашим AI-агентом из приложений, которыми вы уже пользуетесь. Вот краткий обзор поддерживаемых каналов:
| Канал | Сложность настройки | Примечания |
|---|---|---|
| Telegram | Самая простая | Простой токен бота |
| Простая | Требуется сопряжение по QR; хранит больше состояния на диске | |
| Discord | Средняя | Bot API + Gateway |
| iMessage | Средняя | Рекомендуется через BlueBubbles macOS server |
| IRC | Низкая | Классический IRC; каналы + личные сообщения |
| Slack | Средняя | Bolt SDK; приложения рабочей области |
| Signal | Средняя | Ориентирован на приватность; использует signal-cli |
Несколько каналов могут работать одновременно — настройте столько, сколько хотите, и OpenClaw будет маршрутизировать сообщения по чатам.
Ознакомьтесь с этой публикацией: OpenClaw Tutorial: Connect to Slack for Local AI Assistant - Milvus Blog
Быстрый пример: сопряжение WhatsApp
Чтобы подключить WhatsApp, выполните:
openclaw channels login
Следуйте процессу сопряжения по QR, и вы сможете писать своему AI-агенту напрямую из WhatsApp.
Шаг 6: Отправьте тестовое сообщение
После настройки канала отправьте тестовое сообщение из CLI:
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
Замените номер телефона на свой. Если все подключено правильно, вы увидите, как сообщение появится в вашем приложении для обмена сообщениями, — и AI-агент OpenClaw ответит.
Необязательно: сборка из исходного кода
Для контрибьюторов или тех, кто хочет запускать из локальной копии:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
Свяжите CLI глобально:
pnpm link --global
Затем запустите онбординг:
openclaw onboard --install-daemon
Для hot-reload во время разработки используйте pnpm gateway:watch вместо стандартной команды gateway.
Необязательно: онбординг приложения macOS
OpenClaw также предлагает нативное приложение для macOS (строка меню) со своим собственным процессом онбординга. Если вы используете приложение:
- Подтвердите предупреждение безопасности macOS при первом запуске
- Разрешите доступ "Find Local Networks"
- Выберите Local или Remote — выберите "This Mac" для Gateway только на локальном компьютере
- Предоставьте разрешения — приложение может запросить Automation, Notifications, Accessibility и другие разрешения TCC в зависимости от вашего сценария использования
- Установите CLI (необязательно) — приложение может установить глобальный CLI
openclawчерез npm, чтобы терминальные рабочие процессы работали вместе с приложением - Общайтесь в сессии онбординга — приложение открывает отдельный чат, чтобы агент мог представиться
Стабильный рабочий процесс, рекомендованный документацией OpenClaw: установите и запустите OpenClaw.app, завершите контрольный список онбординга, затем привяжите ваши каналы с помощью openclaw channels login.
Основы конфигурации
OpenClaw хранит свою конфигурацию в ~/.openclaw/openclaw.json. По умолчанию он использует встроенный бинарный файл Pi в режиме RPC с сессиями для каждого отправителя — настройка не требуется.
Если вы хотите ограничить, кто может писать вашему агенту, добавьте правило allowFrom:
{
"channels": {
"whatsapp": {
"allowFrom": ["+15555550123"],
"groups": {
"*": {
"requireMention": true
}
}
}
},
"messages": {
"groupChat": {
"mentionPatterns": ["@openclaw"]
}
}
}
Ключевые расположения файлов на macOS
| Путь | Назначение |
|---|---|
~/.openclaw/openclaw.json | Основной файл конфигурации |
~/.openclaw/workspace/ | Навыки, промпты, воспоминания |
~/.openclaw/credentials/ | Учетные данные каналов |
~/.openclaw/agents/<agentId>/sessions/ | Данные сессий агента |
/tmp/openclaw/ | Логи |
Полезные переменные окружения
| Переменная | Назначение |
|---|---|
OPENCLAW_HOME | Переопределить домашний каталог для разрешения внутренних путей |
OPENCLAW_STATE_DIR | Переопределить каталог состояния |
OPENCLAW_CONFIG_PATH | Переопределить путь к файлу конфигурации |
Устранение неполадок: openclaw не найден
Если ваша оболочка не может найти команду openclaw после установки, проблема почти всегда заключается в отсутствующей записи PATH.
Быстрая диагностика:
node -v
npm -v
npm prefix -g
echo "$PATH"
Если вывод npm prefix -g плюс /bin отсутствует в вашем $PATH, добавьте его в файл запуска оболочки (~/.zshrc для современных версий macOS):
export PATH="$(npm prefix -g)/bin:$PATH"
Затем откройте новое окно Терминала или выполните source ~/.zshrc.
Устранение неполадок: ошибка "Unauthorized" / 1008 в Dashboard
Если Control UI показывает ошибку неавторизованного доступа:
- Убедитесь, что Gateway доступен:
openclaw status - Получите токен:
openclaw config get gateway.auth.token - В настройках панели мониторинга вставьте токен в поле auth и подключитесь повторно
Если вам нужно сгенерировать новый токен:
openclaw doctor --generate-gateway-token
Что у вас теперь есть
После завершения этого руководства у вас есть:
- Запущенный Gateway на вашем Mac
- Настроенная аутентификация для безопасного доступа
- Доступ к Control UI для чата в браузере
- При необходимости один или несколько подключенных каналов обмена сообщениями (WhatsApp, Telegram, Discord и т. д.)
Далее вы можете изучить маршрутизацию между несколькими агентами, изоляцию рабочих пространств, поддержку медиа и весь спектр возможностей OpenClaw.
Ресурсы
Читать далее
Notion's Vector Search Is Excellent. Their Next Problem Is Harder.
Notion solved vector search scaling in two years. The next bottleneck — offline context engineering, unified data, and the real-time/offline gap — is harder.
How to Build RAG with Milvus, QwQ-32B and Ollama
Hands-on tutorial on how to create a streamlined, powerful RAG pipeline that balances efficiency, accuracy, and scalability using the QwQ-32B and Milvus.
Legal Document Analysis: Harnessing Zilliz Cloud's Semantic Search and RAG for Legal Insights
Enhance legal document analysis with Zilliz Cloud’s Semantic Search and RAG. Improve accuracy, efficiency, and scalability for contracts, case law, and compliance.