Nodes and media

Sprachaktivierung

Aktivierungswörter sind eine globale Liste im Besitz des Gateways – es gibt keine benutzerdefinierten Listen pro Node. Jede Node- oder App-Benutzeroberfläche kann die Liste bearbeiten; das Gateway speichert die Änderung dauerhaft und überträgt sie an alle verbundenen Clients.

macOS: lokaler Schalter zum Aktivieren/Deaktivieren von Voice Wake. Erfordert macOS 26+; Laufzeit-/PTT-Details finden Sie unter Sprachaktivierung (macOS).
iOS: lokaler Schalter zum Aktivieren/Deaktivieren von Voice Wake in den Einstellungen.
Android: lokaler Schalter zum Aktivieren/Deaktivieren von Voice Wake und Editor für Aktivierungswörter unter Settings → Voice. Erfordert die geräteinterne Spracherkennung von Android.

Speicherung

Aktivierungswörter und Routingregeln befinden sich in der Zustandsdatenbank des Gateways, standardmäßig ~/.openclaw/state/openclaw.sqlite (überschreibbar mit OPENCLAW_STATE_DIR), in den Tabellen voicewake_triggers, voicewake_routing_config, voicewake_routing_routes. Die veralteten settings/voicewake.json und settings/voicewake-routing.json dienen ausschließlich als Eingaben für die openclaw doctor --fix-Migration – die Laufzeit liest sie niemals.

Protokoll

Auslöserliste

Methode	Parameter	Ergebnis
`voicewake.get`	keine	`{ triggers: string[] }`
`voicewake.set`	`{ triggers: string[] }`	`{ triggers: string[] }`

voicewake.set normalisiert die Eingabe: Leerraum wird entfernt, leere Einträge werden verworfen, höchstens 32 Auslöser werden beibehalten und jeder wird auf 64 UTF-16-Codeeinheiten gekürzt, ohne Surrogatpaare zu trennen. Bei einem leeren Ergebnis werden die integrierten Standardwerte (openclaw, claude, computer) verwendet.

Routing (Auslöser zum Ziel)

Methode	Parameter	Ergebnis
`voicewake.routing.get`	keine	`{ config: VoiceWakeRoutingConfig }`
`voicewake.routing.set`	`{ config: VoiceWakeRoutingConfig }`	`{ config: VoiceWakeRoutingConfig }`

json

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

Jede Route target unterstützt genau eine der folgenden Optionen:

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

Grenzwerte: höchstens 32 Routen, Auslösertext mit höchstens 64 Zeichen. Routenauslöser werden für den Abgleich und die Duplikaterkennung normalisiert, indem sie in Kleinbuchstaben umgewandelt, führende und nachgestellte Satzzeichen von jedem Wort entfernt und Leerraum zusammengefasst werden ("Hey, Bot!!" und "hey bot" stimmen überein und gelten als Duplikate) – dies ist eine strengere Normalisierung als das einfache Entfernen von Leerraum bei der globalen Auslöserliste oben.

Ereignisse

Ereignis	Nutzdaten
`voicewake.changed`	`{ triggers: string[] }`
`voicewake.routing.changed`	`{ config: VoiceWakeRoutingConfig }`

Beide werden an jeden WebSocket-Client mit Leseberechtigung (macOS-App, WebChat und ähnliche) sowie an jede verbundene Node übertragen. Eine Node erhält beide außerdem direkt nach dem Verbindungsaufbau als initiale Snapshot-Übertragung.

Clientverhalten

macOS: ruft voicewake.set/voicewake.get auf und überwacht voicewake.changed, um mit anderen Clients synchron zu bleiben.
iOS: ruft voicewake.set/voicewake.get auf und überwacht voicewake.changed, damit die lokale Erkennung von Aktivierungswörtern reaktionsfähig bleibt.
Android: ruft voicewake.set/voicewake.get auf, überwacht voicewake.changed und kündigt im aktivierten Zustand voiceWake an. Die Erkennung erfolgt weiterhin auf dem Gerät und nur im Vordergrund; sie wird pausiert, während Talk, manuelles Diktieren, die Aufnahme einer Sprachnachricht oder die Sprachausgabe von Nachrichten auf das Audio zugreift.