Настройка OpenClaw на macOS с унифицированной конечной точкой AI-провайдера

Пошаговое руководство по установке OpenClaw на macOS

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

Системные требования и установка

Для настройки требуется Node.js 24 или 22.16+. Разработчик отметил, что Node 20 из старого проекта выдавал бесполезные сообщения об ошибках. Варианты установки включают:

• Homebrew: brew install openclaw-cli
• Официальный скрипт установки (выберите один метод, не оба)

После установки запустите мастер начальной настройки:

openclaw onboard

Настройка провайдера

Разработчик перешёл от отдельных ключей OpenAI и Anthropic к единой конечной точке провайдера, используя ZenMux. Во время начальной настройки он выбрал "Custom Provider", затем "OpenAI-compatible" и ввёл базовый URL и API-ключ.

Конфигурацию после установки можно выполнить в файле конфигурации JSON5 по адресу ~/.openclaw/openclaw.json:

// ~/.openclaw/openclaw.json
{
  models: {
    mode: "merge",
    providers: {
      "zenmux": {
        baseUrl: "<your provider's base URL>/v1",
        apiKey: "YOUR_API_KEY",
        api: "openai-responses",
      },
    },
  },
}

Проверка и фоновая работа

Для проверки настройки:

• openclaw doctor проверяет конфигурацию, подключение и версию Node
• openclaw models list показывает доступные модели
• openclaw agent --local --agent main --message "Hello, respond with just Hi" для проверки работоспособности

Чтобы запустить OpenClaw в качестве фоновой службы:

openclaw onboard --install-daemon

Это настраивает macOS LaunchAgent, который запускается при загрузке. Используйте openclaw status, чтобы подтвердить, что он работает.

Подводные камни и устранение неполадок

Разработчик столкнулся с двумя основными проблемами:

• WhatsApp по умолчанию блокирует все входящие сообщения в целях безопасности. Отправители должны быть явно добавлены в белый список, иначе сообщения будут тихо отбрасываться.
• При устранении неполадок всегда сначала запускайте openclaw doctor, так как он обнаруживает большинство проблем с конфигурацией.

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