​

Voice Wake (Từ đánh thức toàn cục)

• Không có từ đánh thức tùy chỉnh theo từng node.
• Bất kỳ UI node/ứng dụng nào cũng có thể chỉnh sửa danh sách; các thay đổi được Gateway lưu lại và phát tới mọi nơi.
• Mỗi thiết bị vẫn giữ công tắc Bật/Tắt Voice Wake riêng (UX cục bộ + quyền hạn khác nhau).

​

Lưu trữ (máy chủ gateway)

• ~/.openclaw/settings/voicewake.json

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

​

Giao thức

​

Phương thức

• voicewake.get → { triggers: string[] }
• voicewake.set với tham số { triggers: string[] } → { triggers: string[] }

• 2. Các trigger được chuẩn hóa (cắt khoảng trắng, loại bỏ giá trị rỗng). 3. Danh sách rỗng sẽ quay về giá trị mặc định.
• Có áp dụng giới hạn để đảm bảo an toàn (giới hạn số lượng/độ dài).

​

Sự kiện

• voicewake.changed payload { triggers: string[] }

• Tất cả client WebSocket (ứng dụng macOS, WebChat, v.v.)
• Tất cả các node đã kết nối (iOS/Android), và cũng được gửi khi node kết nối như một lần đẩy “trạng thái hiện tại” ban đầu.

​

Hành vi phía client

​

Ứng dụng macOS

• Sử dụng danh sách toàn cục để kiểm soát các trigger VoiceWakeRuntime.
• Chỉnh sửa “Trigger words” trong cài đặt Voice Wake sẽ gọi voicewake.set và sau đó dựa vào broadcast để giữ các client khác đồng bộ.

​

Node iOS

• Sử dụng danh sách toàn cục cho việc phát hiện trigger VoiceWakeManager.
• Chỉnh sửa Wake Words trong Settings sẽ gọi voicewake.set (qua Gateway WS) và đồng thời giữ cho việc phát hiện từ đánh thức cục bộ luôn phản hồi nhanh.

​

Node Android

• Cung cấp trình chỉnh sửa Wake Words trong Settings.
• Gọi voicewake.set qua Gateway WS để các chỉnh sửa được đồng bộ ở mọi nơi.