Nodes в OpenClaw: мобильные устройства, камера, экран

Представьте: вы пишете AI-агенту в Telegram «сфотографируй, что сейчас перед камерой», и агент делает снимок с вашего iPhone и отправляет обратно. Или вы просите записать 10 секунд экрана Mac и получаете видео. Всё это — система нодов (Nodes) в OpenClaw.

Нод — это устройство-компаньон (macOS, iOS, Android или headless-сервер), которое подключается к Gateway через WebSocket и предоставляет агенту доступ к камере, экрану, геолокации, SMS и выполнению команд.

Что важно понять

• Ноды — это периферийные устройства, а не Gateway. Они не запускают серверную часть
• Сообщения из Telegram/WhatsApp приходят на Gateway, а не на ноды
• Gateway пересылает команды на ноды при необходимости

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

Ноды используют устройственный паринг — устройство представляет свой identity при подключении, а Gateway создаёт запрос на подтверждение.

openclaw devices list
openclaw devices approve <requestId>
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>

Node Host: удалённое выполнение команд

Если Gateway работает на одной машине, а вы хотите выполнять команды на другой — используйте Node Host.

Как это работает

• Gateway — принимает сообщения, запускает модель, маршрутизирует инструменты
• Node Host — выполняет system.run на своей машине
• Approvals — белый список команд на стороне нода

Запуск Node Host

# На удалённой машине:
openclaw node run --host <gateway-host> --port 18789 --display-name "Сервер сборки"

# Одобрение на стороне Gateway:
openclaw nodes pending
openclaw nodes approve <requestId>

Белый список команд

openclaw approvals allowlist add --node <id> "/usr/bin/uname"
openclaw approvals allowlist add --node <id> "/usr/bin/sw_vers"

Камера: фото и видео

Фотографии

openclaw nodes camera list --node <id>
openclaw nodes camera snap --node <id>               # обе камеры
openclaw nodes camera snap --node <id> --facing front # фронтальная

Видеоклипы

openclaw nodes camera clip --node <id> --duration 10s
openclaw nodes camera clip --node <id> --duration 3s --no-audio

Длительность ограничена 60 секундами. На Android будет запрос разрешений камеры и микрофона.

Запись экрана

openclaw nodes screen record --node <id> --duration 10s --fps 10
openclaw nodes screen record --node <id> --duration 10s --no-audio

На Android появится системный запрос на захват экрана. Максимум — 60 секунд.

Геолокация

openclaw nodes location get --node <id>
openclaw nodes location get --node <id> --accuracy precise --max-age 15000

Геолокация отключена по умолчанию. Включите в настройках приложения на устройстве. Ответ содержит координаты, точность в метрах и временную метку.

SMS (только Android)

openclaw nodes invoke --node <id> --command sms.send \
  --params '{"to":"+79001234567","message":"Привет от OpenClaw"}'

Требуется разрешение SMS на устройстве.

Canvas (WebView)

Если на ноде открыт Canvas (встроенный веб-просмотрщик), можно делать скриншоты и управлять контентом:

openclaw nodes canvas present --node <id> --target https://example.com
openclaw nodes canvas snapshot --node <id> --format png
openclaw nodes canvas eval --node <id> --js "document.title"
openclaw nodes canvas hide --node <id>

Системные команды

openclaw nodes run --node <id> -- echo "Привет с macOS"
openclaw nodes notify --node <id> --title "Пинг" --body "Gateway готов"

Уведомления поддерживают приоритеты: passive, active, timeSensitive.

Headless Node Host (кроссплатформенный)

OpenClaw может запускать безголовый нод-хост (без UI) на любой платформе — Linux, Windows, macOS. Он подключается к Gateway через WebSocket и предоставляет system.run и system.which.

openclaw node run --host <gateway-host> --port 18789

Требуется паринг. Конфигурация хранится в ~/.openclaw/node.json.

Привязка exec к ноду

# Глобально:
openclaw config set tools.exec.host node
openclaw config set tools.exec.node "node-name"

# Для конкретного агента:
openclaw config set agents.list[0].tools.exec.node "node-name"

Подробнее об установке — в инструкции для Windows. Обзор возможностей — что такое OpenClaw.