---
read_when:
    - Zmiana zachowania lub ustawień domyślnych głosowych słów wybudzających
    - Dodawanie nowych platform Node wymagających synchronizacji słowa wybudzającego
summary: Globalne głosowe słowa wybudzające (zarządzane przez Gateway) i sposób ich synchronizacji między węzłami
title: Wybudzanie głosem
x-i18n:
    generated_at: "2026-05-06T09:20:33Z"
    model: gpt-5.5
    provider: openai
    source_hash: a284cbe3e12784a8d7a3eab6ba8ae230123557bca7593c956111199b94b91b73
    source_path: nodes/voicewake.md
    workflow: 16
---

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

- Nie ma **niestandardowych słów wybudzających dla poszczególnych węzłów**.
- **Dowolny interfejs węzła/aplikacji może edytować** tę listę; zmiany są utrwalane przez Gateway i rozgłaszane do wszystkich.
- macOS i iOS zachowują lokalne przełączniki **włączenia/wyłączenia wybudzania głosem** (lokalny UX i uprawnienia się różnią).
- Android obecnie utrzymuje wybudzanie głosem wyłączone i używa ręcznego przepływu mikrofonu na karcie Głos.

## Przechowywanie (host Gateway)

Słowa wybudzające są przechowywane na maszynie Gateway w:

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

Kształt:

```json
{ "triggers": ["openclaw", "claude", "computer"], "updatedAtMs": 1730000000000 }
```

## Protokół

### Metody

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

Uwagi:

- Wyzwalacze są normalizowane (przycinane, puste usuwane). Puste listy wracają do wartości domyślnych.
- Limity są egzekwowane ze względów bezpieczeństwa (ograniczenia liczby/długości).

### Metody routingu (wyzwalacz → cel)

- `voicewake.routing.get` → `{ config: VoiceWakeRoutingConfig }`
- `voicewake.routing.set` z parametrami `{ config: VoiceWakeRoutingConfig }` → `{ config: VoiceWakeRoutingConfig }`

Kształt `VoiceWakeRoutingConfig`:

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

Cele tras obsługują dokładnie jedno z:

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

### Zdarzenia

- Ładunek `voicewake.changed` `{ triggers: string[] }`
- Ładunek `voicewake.routing.changed` `{ config: VoiceWakeRoutingConfig }`

Kto je otrzymuje:

- Wszyscy klienci WebSocket (aplikacja macOS, WebChat itp.)
- Wszystkie połączone węzły (iOS/Android), a także przy połączeniu węzła jako początkowe wypchnięcie „bieżącego stanu”.

## Zachowanie klienta

### Aplikacja macOS

- Używa globalnej listy do bramkowania wyzwalaczy `VoiceWakeRuntime`.
- Edycja „Słów wyzwalających” w ustawieniach wybudzania głosem wywołuje `voicewake.set`, a następnie polega na rozgłoszeniu, aby utrzymać synchronizację innych klientów.

### Węzeł iOS

- Używa globalnej listy do wykrywania wyzwalaczy przez `VoiceWakeManager`.
- Edycja słów wybudzających w Ustawieniach wywołuje `voicewake.set` (przez Gateway WS) i jednocześnie utrzymuje responsywne lokalne wykrywanie słów wybudzających.

### Węzeł Android

- Wybudzanie głosem jest obecnie wyłączone w środowisku uruchomieniowym/ustawieniach Androida.
- Głos na Androidzie używa ręcznego przechwytywania mikrofonu na karcie Głos zamiast wyzwalaczy słów wybudzających.

## Powiązane

- [Tryb rozmowy](/pl/nodes/talk)
- [Notatki audio i głosowe](/pl/nodes/audio)
- [Rozumienie multimediów](/pl/nodes/media-understanding)