打造你的 Jarvis

🎯 核心概念

OpenClaw 的唤醒词是全局列表，由 Gateway 统一管理：

• 没有每个节点的自定义唤醒词 - 所有客户端共享同一个唤醒词列表
• 任何节点/应用都可以编辑 - 修改后会同步到所有客户端
• macOS 和 iOS 有独立的启用开关 - 本地权限控制
• Android 使用手动麦克风 - 暂不支持唤醒词

💾 存储位置

唤醒词存储在 Gateway 主机的以下位置：

~/.openclaw/settings/voicewake.json

文件格式：

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

📱 各平台设置

🚀 快速开始

设置唤醒词

在 macOS 应用中：

1. 打开 OpenClaw 菜单栏应用
2. 进入 Settings → Voice Wake
3. 启用 "Enable Voice Wake"
4. 在 "Trigger words" 中添加你的唤醒词，如：openclaw、computer、hey jarvis

🔧 协议方法

唤醒词系统通过 Gateway WebSocket 提供以下方法：

获取当前唤醒词

# 方法：voicewake.get
# 返回：{ triggers: string[] }

设置唤醒词

# 方法：voicewake.set
# 参数：{ triggers: string[] }
# 返回：{ triggers: string[] }

{
  "triggers": ["openclaw", "hey claude"]
}

注意：

• 触发词会被规范化（去除空格，删除空值）
• 空列表会回退到默认值
• 有安全限制（数量/长度上限）

📡 事件广播

当唤醒词列表发生变化时，会广播到：

• 所有 WebSocket 客户端（macOS 应用、WebChat 等）
• 所有连接的节点（iOS/Android）
• 节点连接时也会收到当前状态推送

# 事件：voicewake.changed
# 载荷：{ triggers: string[] }

💡 使用建议

• 选择独特的唤醒词 - 避免常见词汇，减少误触发
• 多个唤醒词 - 可以设置 2-3 个备用唤醒词
• 考虑环境噪音 - 在安静环境使用效果更佳
• 隐私保护 - 语音处理在本地完成，不上传云端

🎉 接下来做什么？

继续探索其他有趣的玩法