Nodes and media

การปลุกด้วยเสียง

OpenClaw ถือว่า คำปลุกเป็นรายการส่วนกลางรายการเดียว ที่เป็นของ Gateway

ไม่มีคำปลุกแบบกำหนดเองแยกตามโหนด
UI ของโหนด/แอปใดก็สามารถแก้ไข รายการได้ การเปลี่ยนแปลงจะถูกบันทึกโดย Gateway และกระจายให้ทุกคน
macOS และ iOS ยังคงมีสวิตช์ เปิด/ปิด Voice Wake ภายในเครื่อง (UX ภายในเครื่อง + สิทธิ์แตกต่างกัน)
ปัจจุบัน Android ปิด Voice Wake ไว้ และใช้ขั้นตอนเปิดไมค์ด้วยตนเองในแท็บ Voice

พื้นที่จัดเก็บ (โฮสต์ Gateway)

คำปลุกและกฎการกำหนดเส้นทางถูกจัดเก็บในฐานข้อมูลสถานะของ Gateway:

~/.openclaw/state/openclaw.sqlite

ตารางที่ใช้งานอยู่คือ:

voicewake_triggers
voicewake_routing_config
voicewake_routing_routes

ไฟล์เดิม settings/voicewake.json และ settings/voicewake-routing.json เป็น อินพุตสำหรับการย้ายข้อมูลโดย doctor เท่านั้น; runtime อ่านและเขียนตาราง SQLite

โปรโตคอล

เมธอด

voicewake.get → { triggers: string[] }
voicewake.set พร้อมพารามิเตอร์ { triggers: string[] } → { triggers: string[] }

หมายเหตุ:

ทริกเกอร์จะถูกทำให้เป็นมาตรฐาน (ตัดช่องว่างหัวท้าย, ตัดรายการว่างออก) รายการว่างจะย้อนกลับไปใช้ค่าเริ่มต้น
มีการบังคับใช้ขีดจำกัดเพื่อความปลอดภัย (เพดานจำนวน/ความยาว)

เมธอดการกำหนดเส้นทาง (ทริกเกอร์ → เป้าหมาย)

voicewake.routing.get → { config: VoiceWakeRoutingConfig }
voicewake.routing.set พร้อมพารามิเตอร์ { config: VoiceWakeRoutingConfig } → { config: VoiceWakeRoutingConfig }

รูปแบบ VoiceWakeRoutingConfig:

json

{  "version": 1,  "defaultTarget": { "mode": "current" },  "routes": [{ "trigger": "robot wake", "target": { "sessionKey": "agent:main:main" } }],  "updatedAtMs": 1730000000000}

เป้าหมายของเส้นทางรองรับอย่างใดอย่างหนึ่งเท่านั้น:

{ "mode": "current" }
{ "agentId": "main" }
{ "sessionKey": "agent:main:main" }

เหตุการณ์

เพย์โหลด voicewake.changed { triggers: string[] }
เพย์โหลด voicewake.routing.changed { config: VoiceWakeRoutingConfig }

ผู้ที่ได้รับ:

ไคลเอนต์ WebSocket ทั้งหมด (แอป macOS, WebChat ฯลฯ)
โหนดที่เชื่อมต่อทั้งหมด (iOS/Android) และยังส่งสถานะ "ปัจจุบัน" เริ่มต้นเมื่อโหนดเชื่อมต่อด้วย

พฤติกรรมของไคลเอนต์

แอป macOS

ใช้รายการส่วนกลางเพื่อกั้นทริกเกอร์ของ VoiceWakeRuntime
การแก้ไข "คำทริกเกอร์" ในการตั้งค่า Voice Wake จะเรียก voicewake.set จากนั้นอาศัยการกระจายข้อมูลเพื่อให้ไคลเอนต์อื่นซิงค์กัน

โหนด iOS

ใช้รายการส่วนกลางสำหรับการตรวจจับทริกเกอร์ของ VoiceWakeManager
การแก้ไข Wake Words ใน Settings จะเรียก voicewake.set (ผ่าน Gateway WS) และยังคงทำให้การตรวจจับคำปลุกในเครื่องตอบสนองได้ดี

โหนด Android

ปัจจุบัน Voice Wake ถูกปิดใช้งานใน runtime/Settings ของ Android
เสียงของ Android ใช้การจับเสียงจากไมค์ด้วยตนเองในแท็บ Voice แทนทริกเกอร์คำปลุก

ที่เกี่ยวข้อง

Was this useful?