Configura Wake Words globales en OpenClaw

Seguro que has pasado por esto: configuras un comando de voz en un dispositivo, pero el resto de tu sistema no tiene ni idea de qué estás hablando. Mantener la coherencia entre diferentes plataformas suele ser un caos manual que termina en fragmentación y errores.

OpenClaw soluciona esto tratando las wake words como una lista global única gestionada por el Gateway. En lugar de configurar cada dispositivo por separado, cualquier cambio que realices se sincroniza automáticamente con todos tus nodos conectados.

Requisitos previos

• OpenClaw Gateway funcionando en tu red.
• Al menos un nodo conectado (macOS, iOS o Android).

Inicio rápido

El Gateway centraliza la configuración en un archivo JSON. No necesitas editarlo a mano, ya que las aplicaciones cliente se encargan de la comunicación.

1. Ubicación del almacenamiento

Los datos se guardan en el host del Gateway en la siguiente ruta: ~/.openclaw/settings/voicewake.json

El formato del archivo es directo:

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

2. Uso del Protocolo

Para interactuar con la lista desde cualquier herramienta o nodo, utiliza los métodos de la API:

• Obtener triggers: Usa voicewake.get para recibir { triggers: string[] }.
• Actualizar triggers: Envía voicewake.set con los parámetros { triggers: string[] }.

Cuando actualizas la lista, el Gateway normaliza los términos (elimina espacios y entradas vacías) y emite el evento voicewake.changed a todos los clientes WebSocket activos.

3. Comportamiento por plataforma

• macOS app: Utiliza la lista global para filtrar los disparadores de VoiceWakeRuntime.
• iOS node: Detecta triggers mediante VoiceWakeManager basándose en la lista global.
• Android node: Incluye un editor en Settings que llama a voicewake.set para sincronizar cambios.

Solución de problemas

• La lista vuelve a los valores por defecto: Esto ocurre si intentas guardar una lista vacía. El sistema está diseñado para no quedarse sin disparadores activos.
• Los cambios no se guardan: El Gateway aplica límites de seguridad en la cantidad de palabras y su longitud. Verifica que tus entradas no sean excesivamente largas.
• Nodos desincronizados: Los nodos reciben el estado actual al conectarse. Si un nodo no refleja los cambios, comprueba su conexión WebSocket con el Gateway.

Si necesitas ayuda personalizada para configurar tu entorno, consulta el AI Setup Assistant.

Próximos pasos

• Protocolo WebSocket del Gateway
• Configuración de nodos iOS
• Configuración de nodos Android
• Guía de VoiceWakeRuntime en macOS