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

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

# Голосовое пробуждение (глобальные слова пробуждения)

OpenClaw рассматривает **слова пробуждения как единый глобальный список**, принадлежащий **Gateway (шлюзу)**.

* **Пользовательских слов пробуждения для отдельных узлов не существует**.
* **Любой UI узла/приложения может редактировать** список; изменения сохраняются Gateway и рассылаются всем.
* Каждое устройство по‑прежнему хранит собственный переключатель **Voice Wake включено/выключено** (локальный UX и права доступа различаются).

## Хранилище (хост шлюза Gateway)

Слова пробуждения хранятся на машине шлюза по адресу:

* `~/.openclaw/settings/voicewake.json`

Форма:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{ "triggers": ["openclaw", "claude", "computer"], "updatedAtMs": 1730000000000 }
```

## Протокол

### Методы

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

Примечания:

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

### События

* `voicewake.changed` полезная нагрузка `{ triggers: string[] }`

Кто получает:

* Все клиенты WebSocket (приложение для macOS, WebChat и т. п.).
* Все подключённые узлы (iOS/Android), а также при подключении узла — как начальная отправка «текущего состояния».

## Поведение клиента

### Приложение для macOS

* Использует глобальный список для фильтрации триггеров `VoiceWakeRuntime`.
* Редактирование «Слова триггера» в настройках Voice Wake вызывает `voicewake.set`, после чего используется рассылка для синхронизации других клиентов.

### Узел iOS

* Использует глобальный список для обнаружения триггеров `VoiceWakeManager`.
* Редактирование Wake Words в настройках вызывает `voicewake.set` (через WS Gateway) и также поддерживает отзывчивость локального обнаружения слов пробуждения.

### Узел Android

* Предоставляет редактор Wake Words в настройках.
* Вызывает `voicewake.set` через WS Gateway, чтобы изменения синхронизировались везде.