Ноды OpenClaw: зачем подключать второй компьютер и как это сделать

Коротко

• Нода — это периферийное устройство с ролью role: "node": камера, экран, уведомления, system.run. Gateway по-прежнему один, сообщения из Telegram и WhatsApp приходят на него, не на ноду.
• Подключение выполняется через одноразовый join-код: openclaw devices join-code на Gateway, npx openclaw connect https://gateway.example/j/<shortcode> на второй машине. После этого нода работает через openclaw node run или установленный сервис.
• Задачи отправляются на ноду через openclaw nodes invoke или exec с host=node для system.run. У агентов в OpenClaw своя маршрутизация по каналам, к нодам она не относится.

Сверено с документацией OpenClaw 2026.10.2, 13 октября 2026.

Нода в OpenClaw это не второй Gateway и не субагент. Это сопутствующее устройство: Mac, iPhone, iPad, Android или безголовая машина. Оно подключается к вашему Gateway по WebSocket с ролью role: "node" и предоставляет набор команд вроде camera.*, device.*, system.*, notifications.*. Запросы к ней идут через node.invoke. Каналы вроде Telegram и WhatsApp ноды не обслуживают, сообщения по-прежнему приходят на Gateway.

На macOS роль ноды часто берёт на себя само приложение OpenClaw в строке меню: оно подключается как одна нода и добавляет к ней виджет-панель, камеру, экран и компьютерное управление. Поднимать рядом второй CLI-нод на том же Mac не нужно, приложение уже держит подходящий node-host и остаётся единственным соединением.

Чем нода отличается от агента

Отдельный агент в OpenClaw создаётся командой openclaw agents add со своей рабочей папкой и привязками к каналам вроде telegram:*. Нода же подключается через openclaw connect или openclaw node run и представляет собой физическое устройство с камерой, микрофоном, экраном и доступом к локальной системе.

Подключение по шагам

1. На машине с Gateway выпустите одноразовый join-код: openclaw devices join-code. Команда выведет URL вида https://gateway.example/j/<shortcode> и готовую строку для копирования. Код живёт около 10 минут и срабатывает один раз.
2. На машине, которую хотите сделать нодой, выполните напечатанную команду. Она выглядит так: npx -y openclaw connect https://gateway.example/j/<shortcode> --service --session-host. Полезно сразу задать имя: npx openclaw connect https://gateway.example/j/<shortcode> --display-name "Build Node".
3. Учтите, что напечатанная команда ставит ноду системным сервисом (--service) и сразу разрешает ей хостить воркер-сессии агентов (--session-host). Хостинг сессий оставляйте только на машине, которой доверяете как самому Gateway. Для ноды, которая только выполняет команды, уберите --session-host и оставьте --service. Без обоих флагов нода работает в текущем терминале, пока вы её не остановите.
4. После первой связки Gateway и нода помнят друг друга. Перезапуск ноды в терминале делается через openclaw node run с теми же флагами, что были при подключении (например, --session-host). Ноду-сервис поднимает сам сервис. Сам join-код повторно использовать нельзя, если первый раз сел неудачно, напечатайте новый.
5. Проверьте результат на Gateway: openclaw nodes status покажет таблицу со всеми нодами, их возможностями и временем последнего подключения. Конкретную ноду смотрит openclaw nodes describe --node <idOrNameOrIp>.

Как задачи попадают на ноду

На ноду отправляют команду через openclaw nodes invoke. system.run и system.run.prepare через invoke заблокированы, для них есть отдельный путь через exec с host=node.

openclaw nodes invoke --node <id> --command system.which --params '{"bins":["uname"]}'
openclaw nodes notify --node <id> --title "Build" --body "Done" --priority timeSensitive
openclaw nodes location get --node <id> --accuracy precise
openclaw nodes screen record --node <id> --duration 10s --fps 10 --out ./clip.mp4

Отправка задач на ноду отличается от маршрутизации сообщений к агентам. Ноды так не работают: канал сообщений на них не приходит, вместо этого вы выбираете конкретную ноду по --node <id> (а также по имени, IP или префиксу ID) и вызываете нужную команду.

Когда ноды не нужны

Перед тем как поднимать вторую машину, проверьте три вещи: действительно ли вам нужен локальный доступ к камере, экрану или системе; справится ли с задачами второй агент с отдельным воркспейсом; устраивает ли вас, что нода живёт в фоне и обращаться к ней придётся через явные команды.

Частые ошибки

• Подключают ноду через openclaw connect после остановки процесса и получают отказ: join-код одноразовый, перезапуск делается через openclaw node run, а не через повтор команды.
• Поднимают второй CLI-нод на том же Mac, где уже запущено приложение OpenClaw. Нужно оставить одно соединение, приложение само держит node-host.
• Пытаются запустить system.run через openclaw nodes invoke и упираются в блокировку. Для shell-исполнения используют exec с host=node.
• Подключают вторую машину и забывают про рассинхрон версий. Порядок обновления Gateway и нод описан в документации: docs.openclaw.ai/nodes/pairing-and-status, раздел «Version skew and upgrade order».
• Считают, что нода примет сообщение из Telegram. Каналы идут на Gateway, ноды работают только через явные команды node.invoke или exec.