وائس ویک (عالمی ویک الفاظ)¶

OpenClaw ویک الفاظ کو ایک واحد عالمی فہرست کے طور پر سمجھتا ہے جس کی ملکیت Gateway کے پاس ہوتی ہے۔

• ہر نوڈ کے لیے علیحدہ حسبِ ضرورت ویک الفاظ موجود نہیں۔
• کسی بھی نوڈ/ایپ کا UI فہرست میں ترمیم کر سکتا ہے؛ تبدیلیاں Gateway محفوظ کرتا ہے اور سب کو براڈکاسٹ کرتا ہے۔
• ہر ڈیوائس کے پاس اب بھی اپنا Voice Wake فعال/غیرفعال ٹوگل ہوتا ہے (مقامی UX + اجازتیں مختلف ہوتی ہیں)۔

ذخیرہ (گیٹ وے ہوسٹ)¶

ویک الفاظ گیٹ وے مشین پر یہاں محفوظ ہوتے ہیں:

• ~/.openclaw/settings/voicewake.json

شکل:

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

پروٹوکول¶

طریقے¶

• voicewake.get → { triggers: string[] }
• voicewake.set بمعہ پیرامیٹرز { triggers: string[] } → { triggers: string[] }

نوٹس:

• Triggers کو معیاری بنایا جاتا ہے (غیر ضروری خالی جگہیں ہٹا دی جاتی ہیں، خالی اندراجات نکال دیے جاتے ہیں)۔ خالی فہرستوں کی صورت میں پہلے سے طے شدہ اقدار استعمال کی جاتی ہیں۔
• حفاظت کے لیے حدود نافذ کی جاتی ہیں (تعداد/لمبائی کی حدیں)۔

واقعات¶

• voicewake.changed پے لوڈ { triggers: string[] }

یہ کس کو موصول ہوتا ہے:

• تمام WebSocket کلائنٹس (macOS ایپ، WebChat، وغیرہ)
• تمام منسلک نوڈز (iOS/Android)، اور نوڈ کنیکٹ ہونے پر ابتدائی “موجودہ حالت” کے طور پر بھی۔

کلائنٹ رویّہ¶

macOS ایپ¶

• عالمی فہرست کو VoiceWakeRuntime ٹرگرز کو کنٹرول کرنے کے لیے استعمال کرتی ہے۔
• Voice Wake سیٹنگز میں “Trigger words” میں ترمیم voicewake.set کو کال کرتی ہے اور پھر دوسرے کلائنٹس کو ہم آہنگ رکھنے کے لیے براڈکاسٹ پر انحصار کرتی ہے۔

iOS نوڈ¶

• عالمی فہرست کو VoiceWakeManager ٹرگر کی شناخت کے لیے استعمال کرتا ہے۔
• سیٹنگز میں Wake Words کی ترمیم voicewake.set کو کال کرتی ہے (Gateway WS کے ذریعے) اور مقامی ویک ورڈ ڈیٹیکشن کو بھی مستعد رکھتی ہے۔

Android نوڈ¶

• سیٹنگز میں Wake Words ایڈیٹر فراہم کرتا ہے۔
• Gateway WS کے ذریعے voicewake.set کو کال کرتا ہے تاکہ ترمیمات ہر جگہ ہم آہنگ ہوں۔