2026 OpenClaw MeshMac мультиузловая практика: балансировка нагрузки и отказоустойчивость — воспроизводимые шаги настройки

При работе OpenClaw на нескольких узлах MeshMac используется схема с одним State Server: один узел выступает сервером состояния, остальные Mac — агентами, подключающимися к нему по gRPC. Очередь задач и состояние выполнения сосредоточены на State Server; балансировка нагрузки достигается за счёт того, что свободные узлы забирают задачи из очереди, а при отказе одного узла другие продолжают брать задачи из той же очереди — таким образом реализуется отказоустойчивость.

1. Выделить один узел под State Server и обеспечить доступность по внутренней сети с остальных узлов.
2. На каждом Mac-узле установить агент OpenClaw в одной и той же версии.
3. Настроить все агенты на один и тот же адрес и порт State Server (подключение по gRPC).

Для воспроизводимости на всех узлах должны совпадать версии ОС и Xcode, OpenClaw устанавливается одной версией. Конфигурационный файл (YAML-профиль) готовится один и распространяется на все узлы без изменений.

• На каждом узле установить OpenClaw одной командой curl -sSL ... | sh или через Docker с одним и тем же тегом.
• Проверить работу на каждом узле командами openclaw onboard и openclaw doctor.
• В YAML на всех узлах указать один и тот же хост и порт State Server; распространять профиль через scp, Ansible или аналог.

Балансировка нагрузки обеспечивается за счёт общей очереди задач и нескольких агентов. Шаги настройки:

1. Запустить State Server и убедиться, что все агенты успешно подключаются по gRPC.
2. Определить очередь задач (имя очереди, приоритеты) в YAML или через API; на всех узлах должна быть одна и та же конфигурация.
3. При постановке задач только добавлять их в очередь; узел, который возьмёт задачу, определяется тем, какой агент первым заберёт её из очереди.
4. При необходимости задать веса или метки узлов, чтобы отдельные очереди обрабатывались только выбранной группой узлов.

В результате несколько узлов забирают задачи из одной очереди — нагрузка распределяется естественным образом. Рекомендуем дополнительно настроить стратегию повторов по статье очередь задач и повтор при сбоях.

Чтобы при отказе одного узла задачи переходили на другие, нужно настроить проверку здоровья и таймаут неответа: State Server помечает узел как «не отвечает» и возвращает его задачи в очередь для обработки другими узлами.

1. В YAML задать интервал проверки здоровья агента (например 30 с) и таймаут «считать узел не отвечающим» на стороне State Server (например 90 с — три подряд пропущенные проверки).
2. Для проверки намеренно остановить один агент и убедиться, что назначенные ему задачи подхватываются и выполняются на других узлах.
3. Для повышения доступности самого State Server рассмотреть его резервирование (отдельная документация).

• Connection refused (отказ в соединении): проверить, запущен ли State Server, открыт ли порт gRPC и разрешён ли он файрволом.
• Таймаут: проверить ping и traceroute между узлами, доступность порта gRPC; при большой задержке во внутренней сети можно увеличить таймаут проверки здоровья.
• Состояние не синхронизируется: убедиться, что на всех узлах один и тот же YAML и все агенты подключаются к одному State Server; проверить логи на ошибки gRPC.
• После отказоустойчивости задачи не выполняются: слишком короткие интервал проверки или таймаут неответа приводят к ложным срабатываниям; слишком длинные — к запаздыванию переназначения. Проверить настройки по рекомендациям в разделе ④.