OpenClaw Nodes Pairing: как подключить iPhone и Android к Gateway без боли
Если вам нужен прямой ответ на запрос «как подключить iPhone или Android как node в OpenClaw», то схема такая: поднимаете Gateway, даёте телефону безопасную точку подключения (для LAN подойдёт ws://, для удалённого доступа нужен wss:// через Tailscale Serve или другой TLS-эндпоинт), открываете приложение OpenClaw на устройстве, проходите pairing, подтверждаете запрос на хосте через openclaw devices approve <requestId> и проверяете статус командой openclaw nodes status. После этого телефон становится не просто «ещё одним клиентом», а полноценным устройством с camera, canvas, screen recording и другими node-возможностями.
Запрос openclaw nodes pairing пока не забит конкурентами, но практической боли вокруг него уже достаточно. Люди ставят Gateway, видят приложение, а дальше начинается классика: «в локалке что-то видно, снаружи не подключается», «pairing висит», «Android нашёл gateway, но не коннектится», «iPhone спаривается, а node не появляется в статусе». Разбираемся без шаманства и без ритуального перезапуска всего сервера три раза подряд.
📱 Что такое OpenClaw node и зачем вообще подключать телефон?
В OpenClaw node — это не gateway и не отдельный сервер, а подключённое устройство-периферия, которое соединяется с Gateway по WebSocket и даёт агенту доступ к своим возможностям. Телефон в роли node нужен не для красоты, а для вполне приземлённых задач:
- 📸 делать снимки с камеры и короткие клипы;
- 🖥️ показывать Canvas и отдавать snapshots;
- 📍 передавать геолокацию;
- 🔔 работать с уведомлениями;
- 🎙️ использовать голосовые сценарии;
- 📱 на Android — открывать доступ к расширенным device-командам.
Ключевой момент: сообщения приходят в Gateway, а node — это исполнитель и источник сенсоров. Поэтому если node не подключён, агент не сможет ни снять фото, ни показать экран, ни дотянуться до мобильных возможностей.
🧩 Какая схема подключения работает без боли?
Вот базовая архитектура, которая обычно приводит к рабочему результату:
| Сценарий | Что использовать | Почему так |
|---|---|---|
| Одна Wi‑Fi сеть | ws://gateway-host:18789 или discovery |
В локалке можно жить без TLS |
| Tailscale / удалённый доступ | wss:// через Tailscale Serve |
Android не любит сырой tailnet IP по ws:// для первого pairing |
| Публичный интернет | Нормальный TLS-эндпоинт + wss:// |
Безопаснее и совместимее для mobile pairing |
Из практики самый чистый путь такой:
- 🦞 Gateway крутится на VPS, Mac mini или домашней машине;
- 🦞 для LAN вы подключаете телефон напрямую;
- 🦞 для удалённого доступа делаете Tailscale Serve или другой TLS-прокси;
- 🦞 pairing подтверждаете уже на хосте с Gateway.
Если пытаться перепрыгнуть через шаг с безопасным endpoint, особенно на Android, потом рождаются длинные треды уровня «почти работает». Почти — это любимое состояние сломанной автоматизации.
⚙️ Как подключить iPhone или Android к OpenClaw пошагово?
Ниже короткий runbook, который реально можно повторить.
- 🦞 Запустите Gateway. На хосте должен работать OpenClaw Gateway и слушать нужный порт.
- 🦞 Подготовьте маршрут подключения. Для домашней сети подойдёт локальный адрес; для удалённого доступа — только
wss://через Tailscale Serve или аналогичный TLS-слой. - 🦞 Откройте приложение на телефоне. В Android это вкладка Connect, дальше Setup Code или Manual. На iPhone логика та же: выбрать gateway и инициировать pairing.
- 🦞 Сделайте pairing. Устройство отправит запрос на gateway с ролью node.
- 🦞 Подтвердите pairing на сервере через CLI: сначала посмотреть список запросов, затем approve нужного requestId.
- 🦞 Проверьте статус командой
openclaw nodes status. - 🦞 Протестируйте команду — например, camera snap, canvas snapshot или describe.
Что важно помнить отдельно по Android:
- 🤖 приложение держит соединение через foreground service;
- 🤖 для некоторых возможностей понадобятся permissions — уведомления, камера, location;
- 🤖 если node и gateway в разных сетях, discovery сам по себе не спасает: нужен ещё рабочий secure endpoint.
После первого успешного pairing устройство обычно переподключается уже гораздо спокойнее: приложение запоминает последний manual endpoint или последнюю найденную точку.
🛠️ Почему pairing не проходит и где обычно ломается?
Почти все проблемы можно разложить на четыре категории.
| Проблема | Что это значит | Что делать |
|---|---|---|
| Устройство видит gateway, но не коннектится | Есть discovery, но нет рабочего маршрута | Проверьте endpoint и переходите на wss:// для remote |
| Pairing request не появляется | Node не дошёл до gateway | Смотрите логи Gateway, порт и TLS-маршрут |
| Approve сделали, но node не виден в status | Pairing подтверждён, но соединение не удерживается | Проверьте foreground service, сеть и повторное подключение |
| Canvas/camera не работают | Node не в foreground или нет permission | Откройте приложение и выдайте доступы |
Отдельно стоит запомнить важную деталь из документации: node pairing и node status — это не одно и то же. Подтверждение запроса даёт право подключаться, но само устройство ещё должно удерживать живое соединение. То есть approve — это необходимое условие, но не магическая кнопка «почини всё».
🚀 Что можно делать после подключения node?
Вот где тема становится действительно интересной. После того как OpenClaw node подключён, телефон перестаёт быть просто экраном для чата и становится рабочим инструментом агента.
- 📷 Камера: получать фото и короткие клипы с телефона по запросу;
- 🪟 Canvas: показывать HTML/JS-интерфейс и снимать snapshots;
- 📲 Уведомления: читать список уведомлений и строить сценарии реакции;
- 🧭 Геолокация: узнавать текущее положение устройства, если включены разрешения;
- 🎤 Голос: использовать voice-сценарии и speech-поток;
- 🤖 Android-команды: device status, photos latest, calendar, motion и другие поверхности.
Для solo-founder, разработчика или человека, который строит личного AI-ассистента, это уже не «игрушка ради демо». Это мост между агентом и физическим устройством. А вот тут OpenClaw начинает показывать зубы, а не только симпатичный README.
✅ Какой чеклист пройти перед первым боевым запуском?
- ✅ Gateway запущен и доступен по нужному адресу;
- ✅ для удалённого доступа используется
wss://, а не сомнительный сыройws://; - ✅ pairing request появился и был подтверждён;
- ✅
openclaw nodes statusпоказывает подключённый node; - ✅ на телефоне выданы нужные permissions;
- ✅ вы проверили хотя бы одну реальную команду: camera, canvas или notifications.
Если этот чеклист закрыт, дальше уже можно строить сценарии: от удалённой камеры до проактивных мобильных уведомлений, завязанных на cron, heartbeat и события из внешних систем.
CTA: если вы хотите развернуть OpenClaw не «по верхам», а собрать себе реально полезного агента с node-устройствами, подписывайтесь на Telegram: https://t.me/aaakalsin. Там больше практики, меньше магического мышления.
❓ FAQ по запросу openclaw nodes pairing
1. Можно ли подключить Android node по обычному tailnet IP?
Для первого удалённого pairing это плохой путь. В документации OpenClaw для Android прямо рекомендуется использовать безопасный wss://-endpoint, например через Tailscale Serve.
2. Подходит ли локальная сеть без TLS?
Да, в пределах частной LAN OpenClaw допускает ws://. Но для публичного интернета и межсетевого mobile-подключения лучше сразу идти через TLS.
3. Чем отличается device pairing от node status?
Device pairing подтверждает право устройству подключаться как node. Node status показывает, что устройство действительно подключено и видно Gateway прямо сейчас.
4. Почему camera или canvas не отвечают, хотя node подключён?
Чаще всего приложение не находится в foreground или у него нет нужных разрешений. Для некоторых mobile-команд это критично.
5. Можно ли использовать iPhone и Android одновременно?
Да, Gateway умеет работать с несколькими node-устройствами. Дальше вы уже выбираете конкретный node по имени или id.
6. Какие команды стоит проверить первыми после pairing?
Самые показательные — openclaw nodes status, описание node, snapshot canvas и camera snap. Они быстро показывают, живо ли соединение и хватает ли разрешений.
7. Стоит ли писать отдельную инструкцию для Tailscale?
Если вы подключаете node не в одной Wi‑Fi сети с Gateway — да, обязательно. Именно там чаще всего возникает путаница между discovery, реальным endpoint и TLS.