---
read_when:
    - تغيير سلوك كلمات التنبيه الصوتية أو إعداداتها الافتراضية
    - إضافة منصات Node جديدة تحتاج إلى مزامنة كلمة التنبيه
summary: كلمات التنبيه الصوتية العامة (المملوكة لـ Gateway) وكيفية مزامنتها عبر العُقد
title: الإيقاظ الصوتي
x-i18n:
    generated_at: "2026-05-06T08:03:26Z"
    model: gpt-5.5
    provider: openai
    source_hash: a284cbe3e12784a8d7a3eab6ba8ae230123557bca7593c956111199b94b91b73
    source_path: nodes/voicewake.md
    workflow: 16
---

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

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

## التخزين (مضيف Gateway)

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

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

الشكل:

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

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

### الطرق

- `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`.
- تعديل "كلمات التشغيل" في إعدادات التنبيه الصوتي يستدعي `voicewake.set` ثم يعتمد على البث لإبقاء العملاء الآخرين متزامنين.

### عقدة iOS

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

### عقدة Android

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

## ذات صلة

- [وضع التحدث](/ar/nodes/talk)
- [ملاحظات الصوت والصوتيات](/ar/nodes/audio)
- [فهم الوسائط](/ar/nodes/media-understanding)