Мобильные ноды: iOS и Android

Мобильные устройства (iPhone, iPad, Android) подключаются к Gateway как ноды — companion-устройства, которые дают агенту доступ к камере, геолокации, уведомлениям и Canvas. Ни iOS, ни Android не запускают Gateway — только подключаются к нему.

Статус приложений

Оба приложения требуют запущенный Gateway на другой машине (macOS, Linux или Windows через WSL2).

Что даёт нода

Подключённый телефон становится периферией для агента:

Быстрый старт: подключение ноды

1. Запустить Gateway

На основной машине:

openclaw gateway --port 18789

Для удалённого доступа через Tailscale (рекомендуется — даёт wss://):

openclaw gateway --tailscale serve

2. Подключить телефон

Обнаружение (одинаково для iOS и Android):

Для Tailscale/публичных адресов — обязательно wss:// (Tailscale Serve). Обычный ws:// работает только в локальной сети.

3. Одобрить подключение

На машине с Gateway:

openclaw devices list          # найти requestId
openclaw devices approve 

Если нода переподключается с новыми параметрами — старый requestId становится невалидным. Запустите devices list заново перед одобрением.

4. Проверить

openclaw nodes status
openclaw gateway call node.list --params "{}"

{
  "gateway": {
    "nodes": {
      "pairing": {
        "autoApproveCidrs": ["192.168.1.0/24"]
      }
    }
  }
}

Камера

Агент может сделать фото или записать видео с камеры телефона.

# Фото (обе камеры по умолчанию — 2 файла)
openclaw nodes camera snap --node 

# Фото с фронтальной камеры
openclaw nodes camera snap --node  --facing front

# Видео 5 секунд без звука
openclaw nodes camera clip --node  --duration 5s --no-audio

Важно:

Canvas

Canvas — HTML/CSS/JS панель, которая рендерится на экране телефона. Агент может управлять ею через node.invoke.

# Показать веб-страницу
openclaw nodes canvas present --node  --target https://example.com

# Выполнить JavaScript
openclaw nodes canvas eval --node  --js "document.title"

# Сделать скриншот Canvas
openclaw nodes canvas snapshot --node  --format png

# Сбросить к стандартному scaffold
openclaw nodes canvas navigate --node  --url ""

Canvas загружается с Gateway HTTP-сервера (тот же порт, что gateway.port):

http://:18789/__openclaw__/canvas/
http://:18789/__openclaw__/a2ui/

A2UI рендерится внутри Canvas. При подключении нода автоматически переходит на A2UI, если Gateway передаёт canvas host URL.

Геолокация

По умолчанию выключена. Включите в настройках приложения.

openclaw nodes location get --node 
openclaw nodes location get --node  --accuracy precise --max-age 15000

Возвращает: широту, долготу, точность (метры), временную метку.

iOS: требует разрешения «При использовании» или «Всегда». Фоновый доступ — best-effort.

Уведомления (Android)

Android может пересылать уведомления телефона на Gateway. Агент видит что пришло и может реагировать.

Настройка в приложении:

{
  "notifications": {
    "allowPackages": ["com.slack", "com.whatsapp"],
    "denyPackages": ["com.android.systemui"],
    "quietHours": { "start": "22:00", "end": "07:00" },
    "rateLimit": 5
  }
}

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

Голос (Talk Mode)

Голосовые ответы идут через talk.speak (настроенный на Gateway провайдер). Локальный TTS — только если talk.speak недоступен.

Запуск команд на ноде (system.run)

Если Gateway на одном компьютере, а нужно выполнять команды на другом — используйте headless node host:

# На машине-ноде
openclaw node run --host  --port 18789 --display-name "Build Node"

# Или установить как сервис
openclaw node install --host  --port 18789 --display-name "Build Node"
openclaw node start

Потом направить exec на ноду:

openclaw config set tools.exec.host node
openclaw config set tools.exec.node ""

Exec approvals живут на ноде в ~/.openclaw/exec-approvals.json.

Типичные ошибки

openclaw status
openclaw nodes status
openclaw nodes describe --node 
openclaw doctor
openclaw logs --follow

Что дальше