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

# Wybudzanie głosem

# Wybudzanie głosem (globalne słowa wybudzania)

OpenClaw traktuje **słowa wybudzania jako jedną globalną listę** należącą do **Gateway**.

* **Nie ma niestandardowych słów wybudzania per węzeł**.
* **Dowolny interfejs węzła/aplikacji może edytować** listę; zmiany są zapisywane przez Gateway i rozgłaszane do wszystkich.
* Każde urządzenie nadal zachowuje własny przełącznik **Wybudzanie głosem włączone/wyłączone** (lokalny UX + różnice uprawnień).

## Przechowywanie (host Gateway)

Słowa wybudzania są przechowywane na maszynie gateway pod adresem:

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

Kształt:

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

## Protokół

### Metody

* `voicewake.get` → `{ triggers: string[] }`
* `voicewake.set` z parametrami `{ triggers: string[] }` → `{ triggers: string[] }`

Uwagi:

* Wyzwalacze są normalizowane (przycinanie, usuwanie pustych). Puste listy wracają do wartości domyślnych.
* Dla bezpieczeństwa egzekwowane są limity (liczby/długości).

### Zdarzenia

* `voicewake.changed` ładunek `{ triggers: string[] }`

Kto je otrzymuje:

* Wszyscy klienci WebSocket (aplikacja na macOS, WebChat itd.).
* Wszystkie podłączone węzły (iOS/Android), a także przy połączeniu węzła jako początkowe wysłanie „aktualnego stanu”.

## Zachowanie klienta

### Aplikacja na macOS

* Używa listy globalnej do bramkowania wyzwalaczy `VoiceWakeRuntime`.
* Edycja „Słów wyzwalania” w ustawieniach Wybudzania głosem wywołuje `voicewake.set`, a następnie polega na rozgłoszeniu, aby utrzymać synchronizację pozostałych klientów.

### Węzeł iOS

* Używa listy globalnej do wykrywania wyzwalaczy `VoiceWakeManager`.
* Edycja Słów wybudzania w Ustawieniach wywołuje `voicewake.set` (przez Gateway WS) i jednocześnie utrzymuje responsywność lokalnego wykrywania słów wybudzania.

### Węzeł Android

* Udostępnia edytor Słów wybudzania w Ustawieniach.
* Wywołuje `voicewake.set` przez Gateway WS, aby edycje synchronizowały się wszędzie.