Aller au contenu principal

Médias et appareils

Voice Wake

OpenClaw traite les mots d'éveil comme une liste globale unique appartenant à la Passerelle.

  • Il n'y a pas de mots d'éveil personnalisés par nœud.
  • Toute interface utilisateur de nœud/application peut modifier la liste ; les changements sont persistés par la Passerelle et diffusés à tous.
  • macOS et iOS conservent des boutons locaux Voice Wake activé/désactivé (l'expérience utilisateur et les permissions locales diffèrent).
  • Android conserve actuellement Voice Wake désactivé et utilise un flux micro manuel dans l'onglet Voix.

Stockage (hôte de la Passerelle)​

Les mots d'éveil sont stockés sur la machine de la passerelle à l'emplacement :

  • ~/.openclaw/settings/voicewake.json

Structure :

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

Protocole​

Méthodes​

  • voicewake.get → { triggers: string[] }
  • voicewake.set avec les paramètres { triggers: string[] } → { triggers: string[] }

Notes :

  • Les déclencheurs sont normalisés (espaces supprimés, vides éliminés). Les listes vides reviennent aux valeurs par défaut.
  • Des limites sont appliquées pour la sécurité (plafonds de nombre/longueur).

Événements​

  • voicewake.changed avec la charge utile { triggers: string[] }

Qui le reçoit :

  • Tous les clients WebSocket (application macOS, WebChat, etc.)
  • Tous les nœuds connectés (iOS/Android), et également lors de la connexion d'un nœud sous forme de poussée initiale de "l'état actuel".

Comportement des clients​

Application macOS​

  • Utilise la liste globale pour conditionner les déclencheurs de VoiceWakeRuntime.
  • La modification des "Mots déclencheurs" dans les paramètres Voice Wake appelle voicewake.set puis s'appuie sur la diffusion pour maintenir les autres clients synchronisés.

Nœud iOS​

  • Utilise la liste globale pour la détection des déclencheurs par VoiceWakeManager.
  • La modification des Mots d'éveil dans les Paramètres appelle voicewake.set (via le WS de la Passerelle) et maintient également la détection locale des mots d'éveil réactive.

Nœud Android​

  • Voice Wake est actuellement désactivé dans l'environnement d'exécution/les Paramètres Android.
  • La voix sur Android utilise une capture micro manuelle dans l'onglet Voix au lieu des déclencheurs par mot d'éveil.

Mode DiscussionCommande de localisation