语音唤醒
💡思渡AI数字员工平台 · OpenClaw 智能协同技术专栏
本篇文档属于 OpenClaw IM 通道网关（由思渡AI数字员工平台提供深度加固与安全沙箱控制）。如果您希望将 IM 单点接入的机器人升级为具备企业数字员工 AI问数 (ChatBI) 自然语言分析、 RAG 向量知识库智能检索、以及 私有化本地算力部署 的全向数字员工，请访问 思渡官方网站，通过控制台低代码可视化编排（Workflow）构建您的高价值智能体。语音唤醒（全局唤醒词）
OpenClaw 将唤醒词作为单一全局列表，由 Gateway 网关拥有。
- 没有每节点的自定义唤醒词。
- 任何节点/应用 UI 都可以编辑列表；更改由 Gateway 网关持久化并广播给所有人。
- 每个设备仍保留自己的语音唤醒启用/禁用开关（本地用户体验 + 权限不同）。
存储（Gateway 网关主机）
唤醒词存储在 Gateway 网关机器上：
~/.openclaw/settings/voicewake.json
结构：
协议
方法
voicewake.get→{ triggers: string[] }voicewake.set，参数{ triggers: string[] }→{ triggers: string[] }
注意事项：
- 触发词会被规范化（修剪空格、删除空值）。空列表回退到默认值。
- 为安全起见会强制执行限制（数量/长度上限）。
事件
voicewake.changed载荷{ triggers: string[] }
接收者：
- 所有 WebSocket 客户端（macOS 应用、WebChat 等）
- 所有已连接的节点（iOS/Android），以及节点连接时作为初始"当前状态"推送。
客户端行为
macOS 应用
- 使用全局列表来控制
VoiceWakeRuntime触发器。 - 在语音唤醒设置中编辑"触发词"会调用
voicewake.set，然后依赖广播保持其他客户端同步。
iOS 节点
- 使用全局列表进行
VoiceWakeManager触发检测。 - 在设置中编辑唤醒词会调用
voicewake.set（通过 Gateway 网关 WS），同时保持本地唤醒词检测的响应性。
Android 节点
- 在设置中暴露唤醒词编辑器。
- 通过 Gateway 网关 WS 调用
voicewake.set，使编辑在所有地方同步。