---
read_when:
    - تغيير سلوك كلمات التنبيه الصوتي أو القيم الافتراضية
    - إضافة منصات عقد جديدة تحتاج إلى مزامنة كلمات التنبيه
summary: كلمات التنبيه الصوتي العامة (المملوكة للبوابة) وكيفية مزامنتها عبر العقد
title: التنبيه الصوتي
x-i18n:
    generated_at: "2026-04-05T12:49:09Z"
    model: gpt-5.4
    provider: openai
    source_hash: a80e0cf7f68a3d48ff79af0ffb3058a7a0ecebd2cdbaad20b9ff53bc2b39dc84
    source_path: nodes/voicewake.md
    workflow: 15
---

# التنبيه الصوتي (كلمات التنبيه العامة)

يتعامل OpenClaw مع **كلمات التنبيه** على أنها **قائمة عامة واحدة** تملكها **البوابة**.

- لا توجد **كلمات تنبيه مخصصة لكل عقدة**.
- يمكن **لأي واجهة عقدة/تطبيق تعديل** القائمة؛ ويتم حفظ التغييرات بواسطة البوابة وبثها للجميع.
- يحتفظ macOS وiOS بمفاتيح تبديل محلية مستقلة لحالة **تفعيل/تعطيل التنبيه الصوتي** (تختلف تجربة الاستخدام والأذونات محليًا).
- يحتفظ Android حاليًا بالتنبيه الصوتي في وضع التعطيل ويستخدم تدفق ميكروفون يدويًا في تبويب Voice.

## التخزين (مضيف البوابة)

تُخزَّن كلمات التنبيه على جهاز البوابة في:

- `~/.openclaw/settings/voicewake.json`

الشكل:

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

## البروتوكول

### الأساليب

- `voicewake.get` ← `{ triggers: string[] }`
- `voicewake.set` مع المعلمات `{ triggers: string[] }` ← `{ triggers: string[] }`

ملاحظات:

- تتم تسوية المحفزات (إزالة الفراغات، حذف القيم الفارغة). وتعود القوائم الفارغة إلى القيم الافتراضية.
- يتم فرض حدود لأسباب تتعلق بالسلامة (قيود العدد/الطول).

### الأحداث

- حمولة `voicewake.changed` هي `{ triggers: string[] }`

من الذي يتلقاها:

- جميع عملاء WebSocket ‏(تطبيق macOS، وWebChat، وغير ذلك)
- جميع العقد المتصلة (iOS/Android)، وكذلك عند اتصال العقدة كدفعة أولية لـ "الحالة الحالية"

## سلوك العميل

### تطبيق macOS

- يستخدم القائمة العامة لضبط محفزات `VoiceWakeRuntime`.
- يؤدي تعديل "Trigger words" في إعدادات Voice Wake إلى استدعاء `voicewake.set` ثم الاعتماد على البث لإبقاء العملاء الآخرين متزامنين.

### عقدة iOS

- تستخدم القائمة العامة لكشف المحفزات في `VoiceWakeManager`.
- يؤدي تعديل Wake Words في Settings إلى استدعاء `voicewake.set` (عبر Gateway WS) كما يحافظ أيضًا على استجابة كشف كلمات التنبيه محليًا.

### عقدة Android

- التنبيه الصوتي معطل حاليًا في وقت تشغيل/إعدادات Android.
- يستخدم الصوت في Android التقاطًا يدويًا للميكروفون في تبويب Voice بدلًا من محفزات كلمات التنبيه.
