Перейти к основному содержанию

​
Приложение iOS (узел)

Доступность: внутренний превью. Приложение iOS пока не распространяется публично.

​
Что оно делает

  • Подключается к Gateway (шлюз) по WebSocket (LAN или tailnet).
  • Предоставляет возможности узла: Canvas, снимок экрана, захват с камеры, местоположение, режим разговора, голосовую активацию.
  • Принимает команды node.invoke и отправляет события состояния узла.

​
Требования

  • Gateway (шлюз), запущенный на другом устройстве (macOS, Linux или Windows через WSL2).
  • Сетевой путь:
    • Та же LAN через Bonjour, или
    • Tailnet через одноадресный DNS-SD (пример домена: openclaw.internal.), или
    • Ручной ввод хоста/порта (резервный вариант).

​
Быстрый старт (сопряжение + подключение)

  1. Запустите Gateway (шлюз):
openclaw gateway --port 18789
  1. В приложении iOS откройте Settings и выберите обнаруженный шлюз Gateway (или включите Manual Host и введите хост/порт).
  2. Подтвердите запрос на сопряжение на хосте шлюза Gateway: 
openclaw nodes pending
openclaw nodes approve <requestId>
  1. Проверьте подключение:
openclaw nodes status
openclaw gateway call node.list --params "{}"

​
Пути обнаружения

​
Bonjour (LAN)

Gateway (шлюз) объявляет _openclaw-gw._tcp на local.. Приложение iOS автоматически отображает такие объявления.

​
Tailnet (межсетевое)

Если mDNS заблокирован, используйте одноадресную зону DNS-SD (выберите домен; пример: openclaw.internal.) и split DNS в Tailscale. См. Bonjour для примера CoreDNS.

​
Ручной хост/порт

В Settings включите Manual Host и введите хост шлюза Gateway и порт (по умолчанию 18789).

​
Canvas + A2UI

Узел iOS рендерит canvas в WKWebView. Используйте node.invoke для управления им: 
openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18793/__openclaw__/canvas/"}'
Примечания:
  • Хост canvas шлюза Gateway обслуживает /__openclaw__/canvas/ и /__openclaw__/a2ui/.
  • Он обслуживается HTTP-сервером Gateway (тот же порт, что и gateway.port, по умолчанию 18789).
  • Узел iOS автоматически переходит к A2UI при подключении, если объявлен URL хоста canvas.
  • Возврат к встроенному шаблону выполняется с помощью canvas.navigate и {"url":""}.

​
Canvas eval / snapshot

openclaw nodes invoke --node "iOS Node" --command canvas.eval --params '{"javaScript":"(() => { const {ctx} = window.__openclaw; ctx.clearRect(0,0,innerWidth,innerHeight); ctx.lineWidth=6; ctx.strokeStyle=\"#ff2d55\"; ctx.beginPath(); ctx.moveTo(40,40); ctx.lineTo(innerWidth-40, innerHeight-40); ctx.stroke(); return \"ok\"; })()"}'

openclaw nodes invoke --node "iOS Node" --command canvas.snapshot --params '{"maxWidth":900,"format":"jpeg"}'

​
Голосовая активация и режим разговора

  • Голосовая активация и режим разговора доступны в Settings.
  • iOS может приостанавливать фоновое аудио; рассматривайте голосовые функции как best‑effort, когда приложение не активно.

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

  • NODE_BACKGROUND_UNAVAILABLE: переведите приложение iOS на передний план (команды canvas/камеры/экрана требуют этого).
  • A2UI_HOST_NOT_CONFIGURED: Gateway (шлюз) не объявил URL хоста canvas; проверьте canvasHost в Конфигурация шлюза Gateway.
  • Окно сопряжения не появляется: выполните openclaw nodes pending и подтвердите вручную.
  • Повторное подключение не удаётся после переустановки: токен сопряжения в Keychain был очищен; выполните повторное сопряжение узла.

​
Связанная документация