Как установить и запустить 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	Самая простая	Простой токен бота
WhatsApp	Простая	Требуется сопряжение по 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 (строка меню) со своим собственным процессом онбординга. Если вы используете приложение:

1. Подтвердите предупреждение безопасности macOS при первом запуске
2. Разрешите доступ "Find Local Networks"
3. Выберите Local или Remote — выберите "This Mac" для Gateway только на локальном компьютере
4. Предоставьте разрешения — приложение может запросить Automation, Notifications, Accessibility и другие разрешения TCC в зависимости от вашего сценария использования
5. Установите CLI (необязательно) — приложение может установить глобальный CLI openclaw через npm, чтобы терминальные рабочие процессы работали вместе с приложением
6. Общайтесь в сессии онбординга — приложение открывает отдельный чат, чтобы агент мог представиться

Стабильный рабочий процесс, рекомендованный документацией 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 показывает ошибку неавторизованного доступа:

1. Убедитесь, что Gateway доступен: openclaw status
2. Получите токен: openclaw config get gateway.auth.token
3. В настройках панели мониторинга вставьте токен в поле auth и подключитесь повторно

Если вам нужно сгенерировать новый токен:

openclaw doctor --generate-gateway-token

Что у вас теперь есть

После завершения этого руководства у вас есть:

• Запущенный Gateway на вашем Mac
• Настроенная аутентификация для безопасного доступа
• Доступ к Control UI для чата в браузере
• При необходимости один или несколько подключенных каналов обмена сообщениями (WhatsApp, Telegram, Discord и т. д.)

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

Ресурсы

• Мы извлекли систему памяти OpenClaw и открыли ее исходный код (memsearch)

• Что такое OpenClaw? Полное руководство по AI-агенту с открытым исходным кодом

• Создание AI-агентов в стиле Clawdbot с LangGraph и Milvus

• Как Claude Code управляет локальным хранилищем для AI-агентов