English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Nodes and media

Réveil vocal

OpenClaw traite les mots d’activation comme une liste globale unique détenue par le Gateway.

  • Il n’y a aucun mot d’activation personnalisé par nœud.
  • Toute UI de nœud/application peut modifier la liste ; les changements sont persistés par le Gateway et diffusés à tous.
  • macOS et iOS conservent des bascules locales Réveil vocal activé/désactivé (l’UX locale et les autorisations diffèrent).
  • Android garde actuellement le réveil vocal désactivé et utilise un flux manuel de micro dans l’onglet Voix.

Stockage (hôte du Gateway)

Les mots d’activation sont stockés sur la machine du gateway à l’emplacement suivant :

  • ~/.openclaw/settings/voicewake.json

Forme :

{ "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, valeurs vides retirées). Les listes vides reviennent aux valeurs par défaut.
  • Des limites sont appliquées par sécurité (plafonds de nombre/longueur).

Méthodes de routage (déclencheur → cible)

  • voicewake.routing.get → { config: VoiceWakeRoutingConfig }
  • voicewake.routing.set avec les paramètres { config: VoiceWakeRoutingConfig } → { config: VoiceWakeRoutingConfig }

Forme de VoiceWakeRoutingConfig :

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

Les cibles de route prennent en charge exactement l’un des éléments suivants :

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

Événements

  • Charge utile voicewake.changed { triggers: string[] }
  • Charge utile voicewake.routing.changed { config: VoiceWakeRoutingConfig }

Qui les reçoit :

  • Tous les clients WebSocket (application macOS, WebChat, etc.)
  • Tous les nœuds connectés (iOS/Android), ainsi qu’au moment de la connexion du nœud sous forme d’envoi initial de « l’état actuel ».

Comportement client

Application macOS

  • Utilise la liste globale pour filtrer les déclencheurs de VoiceWakeRuntime.
  • La modification de « Mots déclencheurs » dans les réglages du réveil vocal appelle voicewake.set, puis s’appuie sur la diffusion pour garder 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’activation dans les réglages appelle voicewake.set (via le WS du Gateway) et garde également la détection locale des mots d’activation réactive.

Nœud Android

  • Le réveil vocal est actuellement désactivé dans le runtime/les réglages Android.
  • La voix sur Android utilise une capture micro manuelle dans l’onglet Voix au lieu de déclencheurs par mots d’activation.

Associé