Перейти к основному содержанию
Официальное приложение для Android доступно в Google Play. Это сопутствующий узел, для которого требуется запущенный OpenClaw Gateway. Исходный код также доступен в репозитории OpenClaw в apps/android; инструкции по сборке см. в apps/android/README.md.

​
Краткая сводка поддержки

​
Управление системой

Управление системой (launchd/systemd) находится на хосте Gateway. См. Gateway.

​
Runbook подключения

Приложение узла Android ⇄ (mDNS/NSD + WebSocket) ⇄ Gateway Android подключается напрямую к WebSocket Gateway и использует сопряжение устройства (role: node). Для Tailscale или публичных хостов Android требует защищенную конечную точку:
  • Предпочтительно: Tailscale Serve / Funnel с https://<magicdns> / wss://<magicdns>
  • Также поддерживается: любой другой URL Gateway wss:// с настоящей TLS-конечной точкой
  • Незашифрованный ws:// остается поддерживаемым для частных LAN-адресов / хостов .local, а также localhost, 127.0.0.1 и моста эмулятора Android (10.0.2.2)

​
Предварительные требования

  • Вы можете запустить Gateway на «главной» машине.
  • Устройство/эмулятор Android может достичь WebSocket шлюза:
    • В той же LAN с mDNS/NSD, или
    • В той же tailnet Tailscale с использованием Wide-Area Bonjour / unicast DNS-SD (см. ниже), или
    • Хост/порт шлюза вручную (резервный вариант)
  • Сопряжение мобильного устройства через tailnet/публичную сеть не использует raw tailnet IP-конечные точки ws://. Вместо этого используйте Tailscale Serve или другой URL wss://.
  • Вы можете запустить CLI (openclaw) на машине шлюза (или через SSH).

​
1) Запустите Gateway

openclaw gateway --port 18789 --verbose
Убедитесь, что в логах есть что-то вроде:
  • listening on ws://0.0.0.0:18789
Для удаленного доступа Android через Tailscale предпочитайте Serve/Funnel вместо raw tailnet bind: 
openclaw gateway --tailscale serve
Это дает Android защищенную конечную точку wss:// / https://. Обычной настройки gateway.bind: "tailnet" недостаточно для первичного удаленного сопряжения Android, если вы также отдельно не терминируете TLS.

​
2) Проверьте обнаружение (необязательно)

С машины шлюза: 
dns-sd -B _openclaw-gw._tcp local.
Дополнительные заметки по отладке: Bonjour. Если вы также настроили домен обнаружения wide-area, сравните с: 
openclaw gateway discover --json
Он показывает local. плюс настроенный wide-area домен за один проход и использует разрешенную конечную точку сервиса вместо подсказок только из TXT.

​
Обнаружение в tailnet (Вена ⇄ Лондон) через unicast DNS-SD

Обнаружение Android NSD/mDNS не проходит между сетями. Если ваш узел Android и шлюз находятся в разных сетях, но подключены через Tailscale, используйте вместо этого Wide-Area Bonjour / unicast DNS-SD. Одного обнаружения недостаточно для сопряжения Android через tailnet/публичную сеть. Обнаруженному маршруту все равно нужна защищенная конечная точка (wss:// или Tailscale Serve):
  1. Настройте зону DNS-SD (пример openclaw.internal.) на хосте шлюза и опубликуйте записи _openclaw-gw._tcp.
  2. Настройте split DNS Tailscale для выбранного домена, указав этот DNS-сервер.
Подробности и пример конфигурации CoreDNS: Bonjour.

​
3) Подключитесь с Android

В приложении Android:
  • Приложение поддерживает соединение со шлюзом через foreground service (постоянное уведомление).
  • Откройте вкладку Подключение.
  • Используйте режим Код настройки или Вручную.
  • Если обнаружение заблокировано, используйте ручной хост/порт в Расширенных элементах управления. Для частных LAN-хостов ws:// по-прежнему работает. Для Tailscale/публичных хостов включите TLS и используйте конечную точку wss:// / Tailscale Serve.
После первого успешного сопряжения Android автоматически переподключается при запуске:
  • Ручная конечная точка (если включена), иначе
  • Последний обнаруженный шлюз (по мере возможности).

​
Presence alive beacons

После подключения аутентифицированной сессии узла, а также когда приложение переходит в фон, пока foreground service все еще подключен, Android вызывает node.event с event: "node.presence.alive". Шлюз записывает это как lastSeenAtMs/lastSeenReason в метаданные сопряженного узла/устройства только после того, как известна идентичность аутентифицированного устройства узла. Приложение считает маяк успешно записанным только тогда, когда ответ шлюза включает handled: true. Более старые шлюзы могут подтверждать node.event с { "ok": true }; такой ответ совместим, но не считается долговременным обновлением last-seen.

​
4) Одобрите сопряжение (CLI)

На машине шлюза: 
openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>
Подробности сопряжения: Сопряжение. Необязательно: если узел Android всегда подключается из строго контролируемой подсети, вы можете явно включить автоматическое одобрение узла при первом сопряжении с помощью CIDR или точных IP: 
{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}
По умолчанию это отключено. Это применяется только к новому сопряжению role: node без запрошенных областей доступа. Сопряжение оператора/браузера и любое изменение роли, области доступа, метаданных или публичного ключа по-прежнему требуют ручного одобрения.

​
5) Проверьте, что узел подключен

  • Через статус узлов: 
    openclaw nodes status
  • Через Gateway: 
    openclaw gateway call node.list --params "{}"

​
6) Чат + история

Вкладка Chat в Android поддерживает выбор сессии (по умолчанию main, а также другие существующие сессии):
  • История: chat.history (нормализованная для отображения; встроенные теги директив удаляются из видимого текста, plain-text XML-полезные нагрузки вызовов инструментов (включая <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> и усеченные блоки вызовов инструментов) и просочившиеся ASCII/full-width токены управления модели удаляются, строки ассистента только с silent-token, такие как точные NO_REPLY / no_reply, опускаются, а слишком большие строки могут быть заменены placeholders)
  • Отправка: chat.send
  • Push-обновления (по мере возможности): chat.subscribe → event:"chat"

​
7) Canvas + камера

​
Хост Gateway Canvas (рекомендуется для веб-контента)

Если вы хотите, чтобы узел показывал настоящий HTML/CSS/JS, который агент может редактировать на диске, укажите узлу хост canvas Gateway.
Узлы загружают canvas с HTTP-сервера Gateway (тот же порт, что и gateway.port, по умолчанию 18789).
  1. Создайте ~/.openclaw/workspace/canvas/index.html на хосте шлюза.
  2. Перейдите узлом к нему (LAN): 
openclaw nodes invoke --node "<Android Node>" --command canvas.navigate --params '{"url":"http://<gateway-hostname>.local:18789/__openclaw__/canvas/"}'
Tailnet (необязательно): если оба устройства находятся в Tailscale, используйте имя MagicDNS или tailnet IP вместо .local, например http://<gateway-magicdns>:18789/__openclaw__/canvas/. Этот сервер внедряет клиент live-reload в HTML и перезагружает страницу при изменениях файлов. Gateway также обслуживает /__openclaw__/a2ui/, но приложение Android рассматривает удаленные страницы A2UI как доступные только для рендеринга. Команды A2UI с поддержкой действий используют встроенную страницу A2UI, принадлежащую приложению, перед применением сообщений. Команды Canvas (только на переднем плане):
  • canvas.eval, canvas.snapshot, canvas.navigate (используйте {"url":""} или {"url":"/"}, чтобы вернуться к стандартному scaffold). canvas.snapshot возвращает { format, base64 } (по умолчанию format="jpeg").
  • A2UI: canvas.a2ui.push, canvas.a2ui.reset (устаревший alias canvas.a2ui.pushJSONL). Эти команды используют встроенную страницу A2UI, принадлежащую приложению, для рендеринга с поддержкой действий.
Команды камеры (только на переднем плане; ограничены разрешениями):
  • camera.snap (jpg)
  • camera.clip (mp4)
Параметры и вспомогательные команды CLI см. в узле камеры.

​
8) Голос + расширенная поверхность команд Android

  • Вкладка Voice: Android имеет два явных режима захвата. Mic — это ручная сессия на вкладке Voice, которая отправляет каждую паузу как ход чата и останавливается, когда приложение покидает передний план или пользователь уходит со вкладки Voice. Talk — это непрерывный режим Talk Mode, который продолжает слушать, пока его не отключат или пока узел не отключится.
  • Talk Mode повышает существующий foreground service с connectedDevice до connectedDevice|microphone перед началом захвата, затем понижает его, когда Talk Mode останавливается. Сервис узла объявляет FOREGROUND_SERVICE_CONNECTED_DEVICE с CHANGE_NETWORK_STATE; Android 14+ также требует объявление FOREGROUND_SERVICE_MICROPHONE, runtime-разрешение RECORD_AUDIO и тип сервиса microphone во время выполнения.
  • По умолчанию Android Talk использует нативное распознавание речи, чат Gateway и talk.speak через настроенного провайдера Talk шлюза. Локальный системный TTS используется только когда talk.speak недоступен.
  • Android Talk использует realtime relay Gateway только когда talk.realtime.mode равно realtime, а talk.realtime.transport равно gateway-relay.
  • Voice wake остается отключенным в UX/runtime Android.
  • Дополнительные семейства команд Android (доступность зависит от устройства, разрешений и пользовательских настроек):
    • device.status, device.info, device.permissions, device.health
    • device.apps только когда включено Settings > Phone Capabilities > Installed Apps; по умолчанию выводит приложения, видимые в launcher.
    • notifications.list, notifications.actions (см. пересылку уведомлений ниже)
    • photos.latest
    • contacts.search, contacts.add
    • calendar.events, calendar.add
    • callLog.search
    • sms.search
    • motion.activity, motion.pedometer

​
Точки входа ассистента

Android поддерживает запуск OpenClaw через системный триггер ассистента (Google Assistant). Если настроено, удержание кнопки Home или фраза «Hey Google, ask OpenClaw…» открывает приложение и передает prompt в композер чата. Это использует метаданные Android App Actions, объявленные в манифесте приложения. На стороне шлюза дополнительная конфигурация не нужна — intent ассистента полностью обрабатывается приложением Android и пересылается как обычное сообщение чата.
Доступность App Actions зависит от устройства, версии Google Play Services и от того, выбрал ли пользователь OpenClaw как приложение ассистента по умолчанию.

​
Пересылка уведомлений

Android может пересылать уведомления устройства на шлюз как события. Несколько элементов управления позволяют ограничить, какие уведомления пересылаются и когда.
КлючТипОписание
notifications.allowPackagesstring[]Пересылать уведомления только от этих имен пакетов. Если задано, все остальные пакеты игнорируются.
notifications.denyPackagesstring[]Никогда не пересылать уведомления от этих имен пакетов. Применяется после allowPackages.
notifications.quietHours.startstring (HH:mm)Начало окна тихих часов (локальное время устройства). Уведомления подавляются в течение этого окна.
notifications.quietHours.endstring (HH:mm)Конец окна тихих часов.
notifications.rateLimitnumberМаксимум пересылаемых уведомлений на пакет в минуту. Лишние уведомления отбрасываются.
Пикер уведомлений также использует более безопасное поведение для пересылаемых событий уведомлений, предотвращая случайную пересылку конфиденциальных системных уведомлений. Пример конфигурации: 
{
  notifications: {
    allowPackages: ["com.slack", "com.whatsapp"],
    denyPackages: ["com.android.systemui"],
    quietHours: {
      start: "22:00",
      end: "07:00",
    },
    rateLimit: 5,
  },
}
Пересылка уведомлений требует разрешения Android Notification Listener. Приложение запрашивает его во время настройки.

​
Связанные материалы