Skip to main content
唤醒词是由 Gateway 持有的一个全局列表——不存在每个节点各自的自定义列表。任何节点或应用 UI 都可以编辑该列表；Gateway 会持久化该更改，并将其广播给每个已连接的客户端。
  • macOS: 本地语音唤醒启用/禁用开关。需要 macOS 26+；运行时/PTT 详细信息请参见 语音唤醒（macOS）。
  • iOS: 设置中的本地语音唤醒启用/禁用开关。
  • Android: 设置 → 语音中的本地语音唤醒启用/禁用开关和唤醒词编辑器。需要 Android 设备端语音识别。

​
存储

唤醒词和路由规则存储在 Gateway 状态数据库中，默认位于 ~/.openclaw/state/openclaw.sqlite（可通过 OPENCLAW_STATE_DIR 覆盖），表为 voicewake_triggers、voicewake_routing_config、voicewake_routing_routes。旧版 settings/voicewake.json 和 settings/voicewake-routing.json 仅作为 openclaw doctor --fix 的迁移输入——运行时不会读取它们。

​
协议

​
触发词列表

voicewake.set 会规范化输入：去除首尾空白、丢弃空项、最多保留 32 个触发词，并将每个触发词截断为最多 64 个 UTF-16 代码单元且不拆分代理对。若结果为空，则回退到内置默认值（openclaw、claude、computer）。

​
路由（触发词到目标）

每个路由的 target 恰好支持以下之一：
  • { "mode": "current" }
  • { "agentId": "main" }
  • { "sessionKey": "agent:main:main" }
限制：最多 32 条路由，触发词文本最多 64 个字符。路由触发词在匹配和重复检测时会进行规范化：将每个单词转换为小写，去除每个单词首尾的标点符号，并折叠空白字符（"Hey, Bot!!" 和 "hey bot" 会匹配且会被视为重复）——这比上面全局触发词列表仅做简单 trim 的规范化更严格。

​
事件

两者都会广播给每个具有读取权限的 WebSocket 客户端（macOS 应用、WebChat 及类似客户端）以及每个已连接的节点。节点在连接后还会立即收到这两个事件作为初始快照推送。

​
客户端行为

  • macOS：调用 voicewake.set/voicewake.get 并监听 voicewake.changed，以与其他客户端保持同步。
  • iOS：调用 voicewake.set/voicewake.get 并监听 voicewake.changed，以保持本地唤醒词检测的响应性。
  • Android：调用 voicewake.set/voicewake.get，监听 voicewake.changed，并在启用时公布 voiceWake。识别始终在设备上进行且仅在前台有效；当 Talk、手动听写、语音备忘录录制或消息语音占用音频时会暂停。

​
相关内容