Nodes and media

Spraakactivering

Activeringswoorden vormen één globale lijst die eigendom is van de Gateway — er zijn geen aangepaste lijsten per Node. Elke Node of app-UI kan de lijst bewerken; de Gateway slaat de wijziging op en zendt deze naar elke verbonden client.

macOS: lokale schakelaar om Voice Wake in of uit te schakelen. Vereist macOS 26+; zie Activering via stem (macOS) voor details over runtime/PTT.
iOS: lokale schakelaar om Voice Wake in of uit te schakelen in Instellingen.
Android: lokale schakelaar om Voice Wake in of uit te schakelen en editor voor activeringswoorden in Settings → Voice. Vereist spraakherkenning op het Android-apparaat.

Opslag

Activeringswoorden en routeringsregels bevinden zich in de statusdatabase van de Gateway, standaard ~/.openclaw/state/openclaw.sqlite (overschrijven met OPENCLAW_STATE_DIR), in de tabellen voicewake_triggers, voicewake_routing_config, voicewake_routing_routes. Verouderde settings/voicewake.json en settings/voicewake-routing.json dienen uitsluitend als invoer voor de openclaw doctor --fix-migratie — de runtime leest ze nooit.

Protocol

Lijst met triggers

Methode	Parameters	Resultaat
`voicewake.get`	geen	`{ triggers: string[] }`
`voicewake.set`	`{ triggers: string[] }`	`{ triggers: string[] }`

voicewake.set normaliseert de invoer: verwijdert witruimte aan het begin en einde, verwijdert lege vermeldingen, behoudt maximaal 32 triggers en kort elke trigger in tot 64 UTF-16-code-eenheden zonder surrogaatparen te splitsen. Bij een leeg resultaat worden de ingebouwde standaardwaarden gebruikt (openclaw, claude, computer).

Routering (trigger naar doel)

Methode	Parameters	Resultaat
`voicewake.routing.get`	geen	`{ 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}

Elke route target ondersteunt precies één van:

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

Limieten: maximaal 32 routes, triggertekst van maximaal 64 tekens. Routetriggers worden voor overeenkomsten en detectie van duplicaten genormaliseerd door ze om te zetten naar kleine letters, leestekens aan het begin en einde van elk woord te verwijderen en witruimte samen te voegen ("Hey, Bot!!" en "hey bot" komen overeen en gelden als duplicaten) — dit is een strengere normalisatie dan alleen het verwijderen van witruimte aan het begin en einde, zoals bij de globale triggerlijst hierboven.

Gebeurtenissen

Gebeurtenis	Payload
`voicewake.changed`	`{ triggers: string[] }`
`voicewake.routing.changed`	`{ config: VoiceWakeRoutingConfig }`

Beide worden uitgezonden naar elke WebSocket-client met leesbereik (macOS-app, WebChat en vergelijkbare clients) en naar elke verbonden Node. Een Node ontvangt beide ook als initiële snapshotpush direct nadat deze verbinding maakt.

Clientgedrag

macOS: roept voicewake.set/voicewake.get aan en luistert naar voicewake.changed om gesynchroniseerd te blijven met andere clients.
iOS: roept voicewake.set/voicewake.get aan en luistert naar voicewake.changed om de lokale detectie van activeringswoorden responsief te houden.
Android: roept voicewake.set/voicewake.get aan, luistert naar voicewake.changed en kondigt voiceWake aan zolang de functie is ingeschakeld. Herkenning blijft op het apparaat en werkt alleen op de voorgrond; deze wordt gepauzeerd wanneer Talk, handmatig dicteren, het opnemen van spraaknotities of berichtspraak de audio gebruikt.

Gerelateerd

Was this useful?