Nodes 导读

全局唤醒词:一个列表管所有设备

唤醒词是 Gateway 持有的全局列表,所有节点共用,没有每个节点自己的唤醒词。任何节点修改列表后,Gateway 会广播给所有客户端。最容易搞错的是:macOS/iOS 有本地开关控制是否启用语音唤醒,但 Android 默认关闭,只能手动点按说话。

先讲这一页到底在解决什么

全局唤醒词:一个列表管所有设备

唤醒词是 Gateway 持有的全局列表,所有节点共用,没有每个节点自己的唤醒词。任何节点修改列表后,Gateway 会广播给所有客户端。最容易搞错的是:macOS/iOS 有本地开关控制是否启用语音唤醒,但 Android 默认关闭,只能手动点按说话。

原文共 9 节,先看 Start Here 路径:/nodes/voicewake 查看官方原文

第一站

📚 它像一张放在总控室里的“统一口令本”

谁改了这本口令本,其他客户端和节点都会跟着同步。

🌍

全局列表

没有每节点自定义私房唤醒词,大家共用一份。

💾

~/.openclaw/settings/voicewake.json

这就是总控室里保存口令本的地方。

📡

广播同步

一旦改了,Gateway 会把变化广播给所有连接着的客户端和节点。

📱

本地开关仍存在

虽然口令全局统一,但各设备本地仍可决定 Voice Wake 功能自己开或关。

第二站

🛠️ voicewake.getvoicewake.set 就像读口令本、改口令本

逻辑很朴素,但正因为朴素,才适合做全局统一入口。

voicewake.get

像问总控室:“现在大家通用的唤醒词都有哪些?”

voicewake.set

像重新写一版口令本,然后广播全场更新。

voicewake.changed

这是总控室发出去的“名单已更新”通知。

规范化

空白、空条目、超长条目不会被随意留下,官方会先做安全整理。

第三站

🎈 这页最核心的不是唤醒词长什么样,而是谁拥有这张名单

答案很明确:Gateway 拥有,节点只是订阅和执行,不各自分家。