Настройка 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проверяет конфигурацию, подключение и версию Nodeopenclaw 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-ключом и страницей оплаты вместо управления несколькими провайдерами.
📖 Read the full source: r/openclaw
👀 Смотрите также

Создание полностью локального мультиагентного ассистента с OpenClaw и Ollama
Разработчик делится своим стеком для полностью локального персонального AI-ассистента с использованием OpenClaw и Ollama, включая модели qwen3.5:35b-a3b, gemma3:4b, mistral:7b, MCP-серверы для Home Assistant и Gmail, а также интерфейс Telegram Bot.

4 вещи, необходимых вашему оркестратору Claude Code для полезности
Практические советы от разработчика, создавшего агентов-оркестраторов для Claude Code: документ миссии, пульс, меж-агентская связь и контролируемый аудит.

Как праздный агент сжигал 50 млн токенов в день – и как это исправить
Простаивающий агент OpenClaw сжег 50M токенов в день из-за heartbeat-пингов с раздутой сессией. Пользователь Reddit рассказывает, как отследил утечку и исправил её настройками конфигурации.

Практический глоссарий терминов ИИ-агентов (Harness, Scaffold, Agent и т.д.)
Глоссарий из блога Hugging Face, объясняющий распространенные термины AI-агентов, такие как Harness, Scaffold и Agent, с простыми определениями и реальными примерами.