> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Застосунок Android

<Note>
  Офіційний застосунок для Android доступний у [Google Play](https://play.google.com/store/apps/details?id=ai.openclaw.app\&hl=en_IN). Це супутній вузол, і для нього потрібен запущений OpenClaw Gateway. Вихідний код також доступний у [репозиторії OpenClaw](https://github.com/openclaw/openclaw) у `apps/android`; інструкції зі збирання див. у [apps/android/README.md](https://github.com/openclaw/openclaw/blob/main/apps/android/README.md).
</Note>

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

* Роль: застосунок супутнього вузла (Android не розміщує Gateway).
* Gateway потрібен: так (запустіть його на macOS, Linux або Windows через WSL2).
* Встановлення: [Google Play](https://play.google.com/store/apps/details?id=ai.openclaw.app\&hl=en_IN) для застосунку, [Початок роботи](/uk/start/getting-started) для Gateway, потім [Сполучення](/uk/channels/pairing).
* Gateway: [Runbook](/uk/gateway) + [Конфігурація](/uk/gateway/configuration).
  * Протоколи: [протокол Gateway](/uk/gateway/protocol) (вузли + площина керування).

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

Керування системою (launchd/systemd) розміщується на хості Gateway. Див. [Gateway](/uk/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 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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway --port 18789 --verbose
```

Підтвердьте, що в журналах бачите щось на кшталт:

* `listening on ws://0.0.0.0:18789`

Для віддаленого доступу Android через Tailscale надавайте перевагу Serve/Funnel замість сирої прив’язки tailnet:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway --tailscale serve
```

Це надає Android захищену кінцеву точку `wss://` / `https://`. Звичайного налаштування `gateway.bind: "tailnet"` недостатньо для першого віддаленого сполучення Android, якщо ви окремо не завершуєте TLS.

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

З машини Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
dns-sd -B _openclaw-gw._tcp local.
```

Додаткові нотатки щодо налагодження: [Bonjour](/uk/gateway/bonjour).

Якщо ви також налаштували домен wide-area виявлення, порівняйте з:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway discover --json
```

Це показує `local.` разом із налаштованим доменом wide-area за один прохід і використовує розв’язану
кінцеву точку сервісу замість підказок лише з TXT.

#### Виявлення через tailnet (Відень ⇄ Лондон) за допомогою unicast DNS-SD

Виявлення Android NSD/mDNS не працює між різними мережами. Якщо ваш вузол Android і Gateway перебувають у різних мережах, але з’єднані через Tailscale, натомість використовуйте Wide-Area Bonjour / unicast DNS-SD.

Самого виявлення недостатньо для сполучення Android через tailnet/публічну мережу. Виявленому маршруту все одно потрібна захищена кінцева точка (`wss://` або Tailscale Serve):

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

Докладніше й приклад конфігурації CoreDNS: [Bonjour](/uk/gateway/bonjour).

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

У застосунку Android:

* Застосунок підтримує з’єднання з Gateway активним через **foreground service** (постійне сповіщення).
* Відкрийте вкладку **Connect**.
* Використайте режим **Setup Code** або **Manual**.
* Якщо виявлення заблоковане, використайте ручні хост/порт у **Advanced controls**. Для приватних LAN-хостів `ws://` усе ще працює. Для Tailscale/публічних хостів увімкніть TLS і використовуйте кінцеву точку `wss://` / Tailscale Serve.

Після першого успішного сполучення Android автоматично перепідключається під час запуску:

* Ручна кінцева точка (якщо ввімкнено), інакше
* Останній виявлений Gateway (best-effort).

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

Після підключення автентифікованої сесії вузла, а також коли застосунок переходить у фоновий режим, поки
foreground service усе ще підключений, Android викликає `node.event` з
`event: "node.presence.alive"`. Gateway записує це як `lastSeenAtMs`/`lastSeenReason` у
метаданих сполученого вузла/пристрою лише після того, як відома ідентичність автентифікованого пристрою вузла.

Застосунок вважає сигнал успішно записаним лише тоді, коли відповідь Gateway містить
`handled: true`. Старіші Gateway можуть підтверджувати `node.event` через `{ "ok": true }`; така відповідь
сумісна, але не рахується як довговічне оновлення last-seen.

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

На машині Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>
```

Деталі сполучення: [Сполучення](/uk/channels/pairing).

Необов’язково: якщо вузол Android завжди підключається з суворо контрольованої підмережі,
ви можете явно ввімкнути автоматичне схвалення вузла під час першого підключення через CIDR або точні IP:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}
```

За замовчуванням це вимкнено. Це застосовується лише до нового сполучення `role: node`
без запитаних областей доступу. Сполучення оператора/браузера, а також будь-яка зміна ролі, області доступу, метаданих або
публічного ключа все одно потребує ручного схвалення.

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

* Через стан вузлів:

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  openclaw nodes status
  ```

* Через Gateway:

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  openclaw gateway call node.list --params "{}"
  ```

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

Вкладка Chat в Android підтримує вибір сесії (типово `main`, а також інші наявні сесії):

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

### 7) Canvas + камера

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

Якщо ви хочете, щоб вузол показував справжні HTML/CSS/JS, які агент може редагувати на диску, вкажіть вузлу хост Gateway canvas.

<Note>
  Вузли завантажують canvas із HTTP-сервера Gateway (той самий порт, що й `gateway.port`, типово `18789`).
</Note>

1. Створіть `~/.openclaw/workspace/canvas/index.html` на хості Gateway.

2. Спрямуйте вузол до нього (LAN):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes invoke --node "<Android Node>" --command canvas.navigate --params '{"url":"http://<gateway-hostname>.local:18789/__openclaw__/canvas/"}'
```

Tailnet (необов’язково): якщо обидва пристрої в Tailscale, використовуйте ім’я MagicDNS або IP tailnet замість `.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":"/"}`, щоб повернутися до стандартного каркаса). `canvas.snapshot` повертає `{ format, base64 }` (типово `format="jpeg"`).
* A2UI: `canvas.a2ui.push`, `canvas.a2ui.reset` (застарілий псевдонім `canvas.a2ui.pushJSONL`). Ці команди використовують вбудовану сторінку A2UI, що належить застосунку, для рендерингу з підтримкою дій.

Команди камери (лише на передньому плані; обмежені дозволами):

* `camera.snap` (jpg)
* `camera.clip` (mp4)

Параметри та CLI-помічники див. у [Вузол камери](/uk/nodes/camera).

### 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` і типу сервісу мікрофона під час виконання.
* За замовчуванням Android Talk використовує нативне розпізнавання мовлення, чат Gateway і `talk.speak` через налаштований Talk-провайдер Gateway. Локальний системний TTS використовується лише тоді, коли `talk.speak` недоступний.
* Android Talk використовує realtime-ретрансляцію 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**; типово перелічує застосунки, видимі в лаунчері.
  * `notifications.list`, `notifications.actions` (див. [Пересилання сповіщень](#notification-forwarding) нижче)
  * `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\..." відкриває застосунок і передає запит у композер чату.

Це використовує метадані Android **App Actions**, оголошені в маніфесті застосунку. На боці Gateway
не потрібна додаткова конфігурація -- intent асистента
повністю обробляється застосунком Android і пересилається як звичайне повідомлення чату.

<Note>
  Доступність App Actions залежить від пристрою, версії Google Play Services
  і того, чи встановив користувач OpenClaw як стандартний застосунок асистента.
</Note>

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

Android може пересилати сповіщення пристрою до Gateway як події. Кілька елементів керування дають змогу обмежити, які сповіщення пересилаються і коли.

| Ключ                             | Тип            | Опис                                                                                                |
| -------------------------------- | -------------- | --------------------------------------------------------------------------------------------------- |
| `notifications.allowPackages`    | string\[]      | Пересилати сповіщення лише від цих імен пакетів. Якщо задано, усі інші пакети ігноруються.          |
| `notifications.denyPackages`     | string\[]      | Ніколи не пересилати сповіщення від цих імен пакетів. Застосовується після `allowPackages`.         |
| `notifications.quietHours.start` | string (HH:mm) | Початок вікна тихих годин (локальний час пристрою). Сповіщення придушуються протягом цього вікна.   |
| `notifications.quietHours.end`   | string (HH:mm) | Кінець вікна тихих годин.                                                                           |
| `notifications.rateLimit`        | number         | Максимальна кількість пересланих сповіщень на пакет за хвилину. Надлишкові сповіщення відкидаються. |

Вибір сповіщень також використовує безпечнішу поведінку для пересланих подій сповіщень, запобігаючи випадковому пересиланню чутливих системних сповіщень.

Приклад конфігурації:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  notifications: {
    allowPackages: ["com.slack", "com.whatsapp"],
    denyPackages: ["com.android.systemui"],
    quietHours: {
      start: "22:00",
      end: "07:00",
    },
    rateLimit: 5,
  },
}
```

<Note>
  Пересилання сповіщень потребує дозволу Android Notification Listener. Застосунок запитує його під час налаштування.
</Note>

## Пов’язане

* [Застосунок iOS](/uk/platforms/ios)
* [Вузли](/uk/nodes)
* [Усунення несправностей вузла Android](/uk/nodes/troubleshooting)