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:

{ "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.