OpenClaw на Android и iOS: мобильный node, Gateway и pairing

OpenClaw на Android и iOS нужно понимать как мобильный node к уже запущенному Gateway, а не как самостоятельный AI-чат на телефоне. Gateway работает на macOS, Linux, Windows через WSL2, VPS или сервере, а телефон подключается к нему, проходит pairing и получает ограниченный набор возможностей устройства.

Короткий ответ: можно ли поставить OpenClaw на телефон

На момент подготовки материала официальная документация описывает Android app как не выпущенное публично приложение: исходный код доступен в репозитории OpenClaw в `apps/android`, собрать его можно самостоятельно при наличии Java 17 и Android SDK. iOS app обозначен как internal preview и не распространяется публично.

Поэтому ответ для обычного пользователя такой: сначала ставим OpenClaw Gateway на компьютер или сервер, а телефон рассматриваем как companion node или канал доступа. Если нужен простой чат с ассистентом с телефона уже сейчас, быстрее использовать Telegram, WhatsApp или WebChat через защищенный доступ.

Чем mobile node отличается от Telegram-бота

ВариантЧто даетКогда выбирать
Telegram или WhatsAppЧат с ассистентом через мессенджерНужен быстрый доступ с телефона
WebChatБраузерный чат через Control UIНужен тест Gateway и локальный интерфейс
Android nodeПодключение устройства к Gateway по WebSocket, Canvas, camera и другие возможности по мере поддержкиНужны функции устройства, а не только чат
iOS nodePreview-подключение к Gateway, node capabilities, pairingЭксперименты с внутренней сборкой или будущими релизами

Если задача — “хочу писать ассистенту с телефона”, mobile app не обязателен. Telegram-бот с allowlist решает это быстрее. Mobile node нужен, когда телефон должен стать устройством в сети OpenClaw: передавать status, работать с Canvas, camera, screen snapshot, voice или другими node-возможностями.

Базовая архитектура: телефон не хостит Gateway

В официальном Android-разделе прямо указано: Android app работает как companion node, а Gateway должен быть запущен на другом устройстве. Для iOS требования такие же: нужен Gateway на macOS, Linux или Windows через WSL2. Телефон подключается к Gateway по WebSocket и проходит approval как node.

  • Gateway host: компьютер, VPS или сервер, где запущен OpenClaw.
  • Gateway URL: `ws://` для приватной LAN или `wss://` для защищенного удаленного доступа.
  • Pairing request: заявка устройства, которую владелец одобряет на Gateway.
  • Node role: телефон подключается как устройство, а не как отдельный полноценный Gateway.
  • Capabilities: набор функций, которые mobile node может отдавать ассистенту.
openclaw gateway --port 18789
openclaw devices list
openclaw nodes status

Android: что доступно и как собрать

Android-приложение в документации описано как source-available, но не публично выпущенное в магазине. Код лежит в репозитории OpenClaw в `apps/android`. Для самостоятельной сборки нужны Java 17, Android SDK и Gradle-команда из README приложения.

git clone https://github.com/openclaw/openclaw.git
cd openclaw
./gradlew :app:assemblePlayDebug

Если вы не собираете Android-приложения регулярно, этот путь может занять больше времени, чем запуск Telegram-бота. Я бы выбирал Android node только при конкретной цели: проверить device pairing, Canvas, camera или работу телефона как node в сети Gateway.

Android-подключение к Gateway

Android подключается к Gateway напрямую по WebSocket. В приватной локальной сети допустим `ws://`, включая `.local`, private LAN addresses, `localhost`, `127.0.0.1` и Android emulator bridge `10.0.2.2`. Для tailnet или публичных hosts нужен защищенный endpoint `wss://` с TLS.

СетьАдресКомментарий
Один LAN`ws://host.local:18789`Подходит для приватной сети
Android emulator`ws://10.0.2.2:18789`Мост к host machine
Tailnet`wss://magicdns-name`Нужен secure endpoint
Public host`wss://your-domain`TLS и защита обязательны

Если Android не видит Gateway, проверьте не только приложение. Частые причины: host firewall, разные сети Wi-Fi, порт не слушает нужный interface, DNS-SD не сработал, endpoint открыт по `ws://` там, где нужен `wss://`.

iOS: internal preview и pairing

iOS app в документации отмечен как internal preview. Он подключается к Gateway по WebSocket, может видеть Gateway через Bonjour в LAN, tailnet discovery или manual host/port, а затем проходит pairing. Обычный пользователь не должен ожидать публичной App Store-установки без отдельного объявления проекта.

Базовый порядок для iOS preview такой: запустить Gateway, выбрать найденный Gateway или ввести host/port вручную, одобрить pairing request на Gateway host и проверить node status.

openclaw gateway --port 18789
openclaw devices list
openclaw devices approve <requestId>
openclaw nodes status
openclaw gateway call node.list --params "{}"

Если устройство повторяет pairing с измененными auth details, старый pending request может быть заменен новым. Поэтому перед approval запускайте `openclaw devices list` еще раз и проверяйте актуальный `requestId`.

Pairing мобильного устройства

Node pairing отличается от DM pairing в Telegram или WhatsApp. DM pairing отвечает на вопрос “кто может писать боту”. Node pairing отвечает на вопрос “какое устройство может подключиться к Gateway как node”. Это разные уровни доступа.

  1. Gateway создает pending request для устройства.
  2. Владелец смотрит role, scopes, requestId и источник.
  3. Владелец одобряет только понятную заявку.
  4. Gateway выдает bounded token для node.
  5. Node появляется в статусе и может выполнять разрешенные возможности.

В документации также описан Telegram-путь с device-pair plugin: пользователь пишет `/pair`, получает setup code, вставляет его в iOS app, затем через `/pair pending` проверяет заявку и одобряет ее. Такой code нужно считать временным паролем.

Какие возможности дает mobile node

Мобильный node интересен не тем, что “открывает чат”, а тем, что может дать Gateway возможности устройства. В iOS-разделе перечислены Canvas, screen snapshot, camera capture, location, talk mode и voice wake. Android-документация также говорит о Canvas, camera, voice и расширенном command surface.

При этом каждая capability должна быть осознанно разрешена. Camera, location и screen snapshot — чувствительные данные. Их нельзя включать по принципу “пусть будет”. Мы сначала определяем сценарий, потом даем минимальный scope, затем проверяем logs и поведение.

Безопасность мобильного подключения

  • Не открывайте Gateway по голому HTTP: для публичного доступа используйте `wss://` и TLS.
  • Не одобряйте неизвестные devices: сверяйте requestId, role и scopes.
  • Не давайте лишние scopes: camera, location и screen snapshot требуют отдельной причины.
  • Не публикуйте setup code: это временный ключ к pairing.
  • Не смешивайте тестовый и рабочий Gateway: мобильные эксперименты лучше начинать в отдельном workspace.
  • Смотрите node status: отключайте устройства, которые больше не используются.
openclaw devices list
openclaw nodes status
openclaw gateway call node.list --params "{}"

Если Gateway размещен на VPS, для телефона лучше использовать tailnet или reverse proxy с TLS, а не прямой открытый порт. Для локального теста в одной Wi-Fi-сети достаточно приватного адреса, если firewall не блокирует подключение.

Что выбрать обычному пользователю

Если цель — “общаться с OpenClaw с телефона”, выбирайте Telegram или WhatsApp. Если цель — “подключить телефон как устройство с camera, screen или voice capabilities”, изучайте mobile node. Если цель — “запустить Gateway прямо на телефоне”, текущая архитектура docs к этому не ведет: Gateway работает на другой машине.

ЦельЛучший маршрутПроверка успеха
Писать ассистенту с телефонаTelegram Bot или WhatsAppОтвет приходит в DM, неизвестный sender не проходит
Проверить мобильный nodeAndroid source build или iOS preview`openclaw nodes status` видит устройство
Доступ к dashboard с телефонаWebChat через защищенный endpointControl UI открывается без публичного порта
Постоянная работа вне домаVPS + tailnet или защищенный reverse proxyGateway отвечает, TLS работает, access policy закрыта

Практические сценарии для телефона

Самый простой сценарий — телефон как клиент мессенджера. Вы пишете в Telegram-бота, Gateway работает на сервере, а телефон вообще не знает о node pairing. Это лучший путь для большинства людей, потому что он опирается на стабильный мессенджер и понятную allowlist-модель.

Второй сценарий — телефон как тестовый node в локальной сети. Gateway запущен на ноутбуке, Android emulator или устройство подключается по `ws://host.local:18789`, владелец одобряет request, затем проверяет `nodes status`. Такой режим удобен для разработки, но не заменяет production-доступ снаружи.

Третий сценарий — телефон вне дома через tailnet или защищенный `wss://` endpoint. Здесь главный риск не в mobile app, а в сети: TLS, firewall, токены, approval и закрытый dashboard. Если вы не можете объяснить, кто имеет доступ к Gateway URL, лучше вернуться к Telegram-боту и не открывать node-подключение наружу.

Для первых тестов заведите отдельный тестовый Gateway или отдельный workspace. Не подключайте мобильный node сразу к рабочему агенту с доступом к реальным файлам, пока не проверили requestId, scopes и поведение capabilities. Телефон легко теряется, меняет сеть и получает новые разрешения, поэтому mobile-сценарий требует более строгой ревизии, чем WebChat на локальном компьютере.

Источники для сверки

Ответы на эти вопросы могут быть для вас полезными

Есть ли публичное приложение OpenClaw для Android?

В документации указано, что Android app еще не выпущен публично. Исходный код есть в `apps/android`, и приложение можно собрать самостоятельно при наличии Java 17 и Android SDK.

Можно ли использовать OpenClaw с iPhone?

Для обычного чата — да, через Telegram, WhatsApp или WebChat. Нативное iOS-приложение в docs отмечено как internal preview, поэтому публичную установку нужно проверять по свежей документации проекта.

Телефон может заменить сервер с Gateway?

Нет в текущей модели docs. Телефон подключается как node, а Gateway должен работать на другом устройстве: компьютере, VPS или сервере.

Оцените статью
0 0 голоса
Рейтинг статьи
Подписаться
Уведомить о
guest

0 комментариев
Старые
Новые Популярные
Межтекстовые Отзывы
Посмотреть все комментарии
0
Оставьте комментарий! Напишите, что думаете по поводу статьи.x