> ## 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.

# Голосове пробудження

OpenClaw розглядає **слова пробудження як єдиний глобальний список**, яким володіє **Gateway**.

* **Немає користувацьких слів пробудження для окремих вузлів**.
* **Будь-який вузол або UI застосунку може редагувати** список; зміни зберігаються Gateway і транслюються всім.
* macOS та iOS зберігають локальні перемикачі **увімкнення/вимкнення голосового пробудження** (локальний UX і дозволи відрізняються).
* Android наразі тримає голосове пробудження вимкненим і використовує ручний потік мікрофона на вкладці «Голос».

## Сховище (хост Gateway)

Слова пробудження та правила маршрутизації зберігаються в базі даних стану Gateway:

* `~/.openclaw/state/openclaw.sqlite`

Активні таблиці:

* `voicewake_triggers`
* `voicewake_routing_config`
* `voicewake_routing_routes`

Застарілі файли `settings/voicewake.json` і `settings/voicewake-routing.json` є
лише вхідними даними для міграції doctor; runtime читає та записує таблиці SQLite.

## Протокол

### Методи

* `voicewake.get` → `{ triggers: string[] }`
* `voicewake.set` з параметрами `{ triggers: string[] }` → `{ triggers: string[] }`

Примітки:

* Тригери нормалізуються (обрізаються пробіли, порожні значення відкидаються). Порожні списки повертаються до стандартних значень.
* Обмеження застосовуються для безпеки (ліміти кількості/довжини).

### Методи маршрутизації (тригер → ціль)

* `voicewake.routing.get` → `{ config: VoiceWakeRoutingConfig }`
* `voicewake.routing.set` з параметрами `{ config: VoiceWakeRoutingConfig }` → `{ config: VoiceWakeRoutingConfig }`

Форма `VoiceWakeRoutingConfig`:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "version": 1,
  "defaultTarget": { "mode": "current" },
  "routes": [{ "trigger": "robot wake", "target": { "sessionKey": "agent:main:main" } }],
  "updatedAtMs": 1730000000000
}
```

Цілі маршрутів підтримують рівно один із варіантів:

* `{ "mode": "current" }`
* `{ "agentId": "main" }`
* `{ "sessionKey": "agent:main:main" }`

### Події

* `voicewake.changed` з payload `{ triggers: string[] }`
* `voicewake.routing.changed` з payload `{ config: VoiceWakeRoutingConfig }`

Хто це отримує:

* Усі клієнти WebSocket (застосунок macOS, WebChat тощо)
* Усі підключені вузли (iOS/Android), а також під час підключення вузла як початкове надсилання «поточного стану».

## Поведінка клієнта

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

* Використовує глобальний список, щоб обмежувати тригери `VoiceWakeRuntime`.
* Редагування «Слів-тригерів» у налаштуваннях голосового пробудження викликає `voicewake.set`, а потім покладається на трансляцію, щоб синхронізувати інші клієнти.

### Вузол iOS

* Використовує глобальний список для виявлення тригерів `VoiceWakeManager`.
* Редагування слів пробудження в налаштуваннях викликає `voicewake.set` (через Gateway WS), а також підтримує швидку реакцію локального виявлення слів пробудження.

### Вузол Android

* Голосове пробудження наразі вимкнене в runtime/налаштуваннях Android.
* Голос на Android використовує ручне захоплення мікрофона на вкладці «Голос» замість тригерів слів пробудження.

## Пов’язане

* [Режим розмови](/uk/nodes/talk)
* [Аудіо та голосові нотатки](/uk/nodes/audio)
* [Розуміння медіа](/uk/nodes/media-understanding)