Застосунок Android

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Знімок підтримки

• Роль: супровідний застосунок вузла (Android не розміщує Gateway).
• Gateway потрібен: так (запустіть його на macOS, Linux або Windows через WSL2).
• Встановлення: Початок роботи + Сполучення.
• Gateway: Операційний довідник + Конфігурація.
  • Протоколи: протокол Gateway (вузли + площина керування).

​

Керування системою

​

Операційний довідник підключення

• Бажано: 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 gateway:
  • Та сама LAN з mDNS/NSD, або
  • Та сама tailnet Tailscale з Wide-Area Bonjour / unicast DNS-SD (див. нижче), або
  • Ручне задання хоста/порту gateway (резервний варіант)
• Мобільне сполучення через tailnet/публічну мережу не використовує сирі кінцеві точки IP tailnet ws://. Натомість використовуйте Tailscale Serve або іншу URL-адресу wss://.
• Ви можете запустити CLI (openclaw) на машині gateway (або через SSH).

​

1) Запустіть Gateway

openclaw gateway --port 18789 --verbose

• listening on ws://0.0.0.0:18789

openclaw gateway --tailscale serve

​

2) Перевірте виявлення (необов’язково)

dns-sd -B _openclaw-gw._tcp local.

openclaw gateway discover --json

​

Виявлення tailnet (Відень ⇄ Лондон) через unicast DNS-SD

1. Налаштуйте зону DNS-SD (приклад openclaw.internal.) на хості gateway і опублікуйте записи _openclaw-gw._tcp.
2. Налаштуйте split DNS Tailscale для вибраного домену, що вказує на цей DNS-сервер.

​

3) Підключіться з Android

• Застосунок підтримує з’єднання з gateway активним через службу переднього плану (постійне сповіщення).
• Відкрийте вкладку Підключення.
• Використовуйте режим Код налаштування або Ручний.
• Якщо виявлення заблоковано, використовуйте ручні хост/порт у Розширених елементах керування. Для хостів приватної LAN ws:// і далі працює. Для хостів Tailscale/публічних хостів увімкніть TLS і використовуйте кінцеву точку wss:// / Tailscale Serve.

• Ручна кінцева точка (якщо ввімкнено), інакше
• Останній виявлений gateway (за можливості).

​

Сигнали присутності alive

​

4) Схваліть сполучення (CLI)

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

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

​

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

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

​

6) Чат + історія

• Історія: chat.history (нормалізована для відображення; inline-теги директив вилучаються з видимого тексту, XML-навантаження викликів інструментів у plain text (зокрема <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> і обрізані блоки викликів інструментів) та витеклі ASCII/повноширинні керівні токени моделі вилучаються, рядки асистента лише з безшумними токенами, як-от точні NO_REPLY / no_reply, пропускаються, а надмірно великі рядки можуть замінюватися заповнювачами)
• Надсилання: chat.send
• Push-оновлення (за можливості): chat.subscribe → event:"chat"

​

7) Canvas + камера

​

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

1. Створіть ~/.openclaw/workspace/canvas/index.html на хості gateway.
2. Перейдіть вузлом до нього (LAN):

openclaw nodes invoke --node "<Android Node>" --command canvas.navigate --params '{"url":"http://<gateway-hostname>.local:18789/__openclaw__/canvas/"}'

• canvas.eval, canvas.snapshot, canvas.navigate (використовуйте {"url":""} або {"url":"/"}, щоб повернутися до стандартного шаблону). canvas.snapshot повертає { format, base64 } (типово format="jpeg").
• A2UI: canvas.a2ui.push, canvas.a2ui.reset (canvas.a2ui.pushJSONL застарілий псевдонім)

• camera.snap (jpg)
• camera.clip (mp4)

​

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

• Вкладка Voice: Android має два явні режими захоплення. Mic — це ручний сеанс вкладки Voice, який надсилає кожну паузу як хід чату й зупиняється, коли застосунок залишає передній план або користувач залишає вкладку Voice. Talk — це безперервний Talk Mode, який продовжує слухати, доки його не вимкнуть або вузол не від’єднається.
• Talk Mode підвищує наявну службу переднього плану з dataSync до dataSync|microphone перед початком захоплення, а потім знижує її, коли Talk Mode зупиняється. Android 14+ потребує декларації FOREGROUND_SERVICE_MICROPHONE, runtime-дозволу RECORD_AUDIO і типу служби мікрофона під час виконання.
• Озвучені відповіді використовують talk.speak через налаштованого провайдера Talk gateway. Локальний системний TTS використовується лише тоді, коли talk.speak недоступний.
• Голосова активація залишається вимкненою в UX/runtime Android.
• Додаткові сімейства команд Android (доступність залежить від пристрою + дозволів):
  • device.status, device.info, device.permissions, device.health
  • notifications.list, notifications.actions (див. пересилання сповіщень нижче)
  • photos.latest
  • contacts.search, contacts.add
  • calendar.events, calendar.add
  • callLog.search
  • sms.search
  • motion.activity, motion.pedometer

​

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

​

Пересилання сповіщень

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

​

Пов’язане

• Застосунок iOS
• Вузли
• Усунення несправностей вузла Android