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

# Sprachaktivierung

# Sprachaktivierung (Globale Aktivierungswörter)

OpenClaw behandelt **Aktivierungswörter als eine einzige globale Liste**, die vom **Gateway** (Netzwerk-Gateway) verwaltet wird.

* Es gibt **keine benutzerdefinierten Weckwort**.
* **Jede Node-/App-UI kann** die Liste bearbeiten; Änderungen werden vom Gateway gespeichert und an alle verteilt.
* Jedes Gerät behält weiterhin seinen eigenen **Schalter für Sprachaktivierung ein/aus** (lokale UX + Berechtigungen unterscheiden sich).

## Speicherung (Gateway-Host)

Aktivierungswörter werden auf der Gateway-Maschine gespeichert unter:

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

Form:

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

## Protokoll

### Methoden

* `voicewake.get` → `{ triggers: string[] }`
* `voicewake.set` mit Parametern `{ triggers: string[] }` → `{ triggers: string[] }`

Hinweise:

* Trigger werden normalisiert (getrimmt, leere Einträge entfernt). Leere Listen fallen auf Standardwerte zurück.
* Zur Sicherheit werden Limits durchgesetzt (Begrenzungen für Anzahl/Länge).

### Ereignisse

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

Wer es erhält:

* Alle WebSocket-Clients (macOS-App, WebChat usw.)
* Alle verbundenen Nodes (iOS/Android) sowie zusätzlich beim Verbinden eines Nodes als initiale Push-Übermittlung des „aktuellen Zustands“.

## Client-Verhalten

### macOS-App

* Verwendet die globale Liste zur Steuerung von `VoiceWakeRuntime`-Triggern.
* Das Bearbeiten von „Trigger words“ in den Einstellungen zur Sprachaktivierung ruft `voicewake.set` auf und verlässt sich anschließend auf die Broadcasts, um andere Clients synchron zu halten.

### iOS-Node

* Verwendet die globale Liste für die Erkennung von `VoiceWakeManager`-Triggern.
* Das Bearbeiten der Aktivierungswörter in den Einstellungen ruft `voicewake.set` (über das Gateway-WS) auf und hält außerdem die lokale Aktivierungswort-Erkennung reaktionsfähig.

### Android-Node

* Stellt in den Einstellungen einen Editor für Aktivierungswörter bereit.
* Ruft `voicewake.set` über das Gateway-WS auf, damit Änderungen überall synchronisiert werden.