ClawCN - OpenClaw 中文版

主题

语音唤醒(全局唤醒词) ​

OpenClaw 将唤醒词视为由网关拥有的单一全局列表。

  • 没有针对每个节点的自定义唤醒词。
  • 任何节点/应用 UI 都可以编辑该列表;更改由网关持久化并广播给所有人。
  • 每个设备仍保留自己的语音唤醒启用/禁用开关(本地用户体验 + 权限不同)。

存储(网关主机) ​

唤醒词存储在网关机器上的位置:

  • ~/.openclaw/settings/voicewake.json

结构:

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

协议 ​

方法 ​

  • 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(通过网关 WS),并保持本地唤醒词检测响应。

Android 节点 ​

  • 在设置中公开唤醒词编辑器。
  • 通过网关 WS 调用 voicewake.set,使编辑在所有地方同步。