Voice Wake in OpenClaw konfigurieren

Kennst du das Problem? Du möchtest Sprachsteuerung auf mehreren Geräten nutzen, aber jedes Device kocht sein eigenes Süppchen bei den Einstellungen. Es ist nervig, wenn du jedes Mal manuell sicherstellen musst, dass dein Smartphone und dein Computer auf dieselben Begriffe hören.

OpenClaw löst das durch eine zentrale Verwaltung. Hier erfährst du, wie du Wake Words global setzt, damit dein gesamtes Setup synchron bleibt.

Voraussetzungen

• OpenClaw Gateway
• macOS App, iOS Node oder Android Node

Schnellstart

In OpenClaw werden Wake Words als eine einzige globale Liste behandelt, die vom Gateway verwaltet wird. Es gibt keine gerätespezifischen Wake Words. Jede Node oder App UI kann die Liste bearbeiten; Änderungen werden vom Gateway gespeichert und an alle verbundenen Clients übertragen.

1. Speicherung auf dem Gateway

Der Gateway speichert die Konfiguration in einer JSON-Datei unter: ~/.openclaw/settings/voicewake.json

So sieht die Struktur aus:

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

2. API-Methoden nutzen

Du kannst die Liste über WebSocket-Methoden steuern:

• Abrufen: voicewake.get gibt { triggers: string[] } zurück.
• Aktualisieren: voicewake.set mit Parametern { triggers: string[] }.

Wenn du voicewake.set aufrufst, normalisiert das System die Eingaben (entfernt Leerzeichen und leere Einträge). Falls die Liste leer ist, greift das System auf Default-Werte zurück.

3. Synchronisation

Sobald sich die Liste ändert, sendet der Gateway das Event voicewake.changed mit den neuen Triggern an:

• Alle WebSocket-Clients (macOS App, WebChat).
• Alle verbundenen Nodes (iOS/Android).

Fehlerbehebung

• Wake Words reagieren nicht: Überprüfe, ob der lokale “Voice Wake”-Schalter auf dem jeweiligen Gerät aktiviert ist. Jedes Gerät behält eine eigene Einstellung für die lokale Aktivierung und Berechtigungen.
• Eingabe-Limits: Der Gateway erzwingt Limits für die Anzahl und Länge der Trigger. Zu lange Listen oder Wörter werden blockiert.
• Leere Liste: Wenn du alle Trigger löschst, werden automatisch die Standard-Wake-Words verwendet.

Hast du spezifische Fragen zu deiner Konfiguration? Frag den AI Setup Assistant.

Nächste Schritte

• macOS App: Nutzt die globale Liste für die VoiceWakeRuntime.
• iOS Node: Verwendet den VoiceWakeManager für die Erkennung.
• Android Node: Bietet einen Editor in den Settings, der direkt mit dem Gateway synchronisiert.