---
read_when:
    - تريد أن يتعرّف OpenClaw على جهاز Mac النشط
    - أنت تعمل على تصحيح نشاط آخر إدخال أو تحديد الـ Node النشطة
    - تريد فهم توجيه إشعارات اتصال Node
summary: اكتشف جهاز Mac الذي استخدمته مؤخرًا ووجّه تنبيهات Node إليه
title: الحضور النشط على الحاسوب
x-i18n:
    generated_at: "2026-07-16T14:32:41Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 2a4ec4607e1e4ef8d989d3c4ece0ee6e0730908a1df76ff52c1898b4307d979b
    source_path: nodes/presence.md
    workflow: 16
---

يشير حضور الكمبيوتر النشط إلى Gateway بشأن عقدة macOS المتصلة التي تلقت
أحدث إدخال فعلي من الماوس أو لوحة المفاتيح. يستخدم OpenClaw هذه الإشارة
لوضع علامة `active` على أحد أجهزة Mac، وتزويد الوكيل بتلميح ثابت عن العقدة النشطة، وتوجيه
تنبيهات اتصال العقدة إلى الكمبيوتر الذي يُرجّح وجودك أمامه.

يختلف هذا عن [حضور النظام](/ar/concepts/presence)، وهو القائمة المباشرة
لعملاء Gateway، وعن إشارات `node.presence.alive` الدائمة، التي
تسجّل آخر وقت استيقظت فيه عقدة محمولة من دون اعتبارها متصلة.

## المتطلبات

- تطبيق OpenClaw لنظام macOS مقترن ومتصل في وضع العقدة.
- يُمنح تطبيق OpenClaw الموقّع إذن **Accessibility**.
- بالنسبة إلى تنبيهات الاتصال، يُمنح أيضًا إذن **Notifications** وتوفّر
  عقدة Mac ‏`system.notify`.

يُنفّذ الإبلاغ عن النشاط حاليًا بواسطة عقدة macOS الأصلية. يمكن لمضيفي العقد
على iOS وAndroid وwatchOS والمضيفين بلا واجهة الإبلاغ عن حالة الاتصال أو
حالة آخر ظهور في الخلفية، لكنهم لا يتنافسون على تعيين الكمبيوتر النشط.

## التحقق من الكمبيوتر النشط

1. في تطبيق macOS، افتح **Settings -> Permissions** وامنح
   إذن **Accessibility** في إعدادات نظام macOS.
2. تأكد من اتصال عقدة Mac:

   ```bash
   openclaw nodes status --connected
   ```

3. حرّك الماوس أو اضغط مفتاحًا على جهاز Mac ذاك، ثم شغّل:

   ```bash
   openclaw nodes status
   openclaw nodes describe --node <node-id-or-name>
   ```

تُوضع علامة `active` على أحدث جهاز Mac مؤهل. يعرض مخرج الحالة المدة المنقضية منذ آخر إدخال؛
ويعرض `describe` القيم `active` و`lastActiveAtMs` و`presenceUpdatedAtMs`.
يُدمج النشاط عمدًا، لذا قد يستغرق العرض نحو 15
ثانية كحد أقصى ليعكس إدخالًا آخر بعد تقرير حديث.

## كيف يتحول النشاط إلى حضور

تأخذ أداة الإبلاغ في macOS عينة من ساعة خمول نظام HID كل ثانيتين. وهي
تُبلغ مرة واحدة عندما يصبح اتصال العقدة جاهزًا، ثم تُبلغ عن النشاط الفعلي
الأحدث بمعدل لا يزيد على مرة كل 15 ثانية. أثناء الخمول، ترسل إشارة إبقاء اتصال
كل ثلاث دقائق. تُحد مدة الخمول عند 30 يومًا كي لا تنزاح عينة قديمة جدًا
إلى الأمام وتصبح خطأً أحدث كمبيوتر.

لا يقبل Gateway النشاط إلا عندما تتحقق كل الشروط الآتية:

- ينتمي الحدث إلى الاتصال الحالي المصادق عليه لمعرّف العقدة ذاك؛
- تمتلك العقدة إذن `accessibility: true` الفعّال؛
- تحتوي الحمولة على قيمة عدد صحيح محدودة `idleSeconds`.

يطرح Gateway ‏`idleSeconds` من وقت الرصد الخاص به لاشتقاق
`lastActiveAtMs`. وهو لا يثق مطلقًا بطابع زمني لساعة الحائط توفره العقدة. ومن بين
أجهزة Mac المتصلة والمؤهلة، يفوز أحدث `lastActiveAtMs`؛ وعند التعادل يُستخدم أحدث
تحديث للحضور.

الحضور محلي للعملية ومرتبط بالاتصال. يؤدي قطع اتصال الجلسة الحالية،
أو استبدالها بجلسة أخرى تستخدم معرّف العقدة نفسه، أو إلغاء إذن
Accessibility، إلى مسح حالة نشاط تلك العقدة وإعادة احتساب جهاز Mac النشط.

## الخصوصية وسياق النموذج

يرسل OpenClaw مدة الخمول، لا محتوى الإدخال. ولا يرسل قيم المفاتيح،
أو إحداثيات الماوس، أو أسماء التطبيقات، أو عناوين النوافذ، أو أحداث الإدخال الخام. تقرأ
أداة الإبلاغ في macOS حالة HID الخاصة بالأجهزة، ولذلك لا تجعل
أحداث التحكم الاصطناعية في الكمبيوتر جهاز Mac مؤتمتًا يبدو كأنه الكمبيوتر الذي استخدمته
فعليًا.

لا ينشئ النشاط المستمر أحداث نظام مرئية للنموذج. يحتوي سطر
وقت التشغيل الديناميكي فقط على معرّف العقدة المصادق عليه:

```text
active_node=<node-id>
```

تبقى الطوابع الزمنية الدقيقة وأسماء العرض التي تتحكم بها العقدة خارج الموجّه
لتجنب حقن الموجّه واضطراب ذاكرة التخزين المؤقت. عندما يحتاج الوكيل إلى التفاصيل الحالية،
يمكن لأداة `nodes` قراءة `node.list` أو `node.describe` بدلًا من ذلك.

## كيفية توجيه تنبيهات الاتصال

بعد أن تنهي العقدة مصافحة Gateway، ينتظر OpenClaw مدة 750 مللي ثانية كي
يتمكن جهاز Mac المتصل من إرسال عينة نشاطه الأولى. ثم يحاول الإرسال إلى
جهاز Mac المتصل القادر على عرض الإشعارات وصاحب أحدث نشاط.

- إذا نجح التسليم الأساسي، فلن يتلقى أي جهاز Mac آخر التنبيه.
- إذا لم يتوفر جهاز Mac نشط أو فشل التسليم الأساسي، ينتظر OpenClaw خمس
  ثوانٍ ويحاول الإرسال إلى كل جهاز Mac متصل متبقٍ يوفّر `system.notify`.
- يُمنع تنبيه إعادة الاتصال للعقدة نفسها لمدة خمس دقائق بعد
  محاولة تسليم فعلية، مما يمنع تقلبات إعادة الاتصال من إحداث
  عاصفة إشعارات.

ترتبط التنبيهات باتصالات العقد الدقيقة. لا يمكن لجلسة مصدر انقطع اتصالها أو استُبدلت
إكمال تنبيه قديم مجدول، ويظل بإمكان اتصال وجهة بديل المشاركة في
التسليم الاحتياطي.

## استكشاف الأخطاء وإصلاحها

| العَرَض                                   | ما يجب التحقق منه                                                                                                                                                                |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| لا يحمل أي صف علامة `active`                 | تأكد من اتصال عقدة macOS أصلية ومن أن `openclaw nodes describe --node <id>` يعرض `permissions.accessibility: true`.                                          |
| يظل جهاز Mac الخطأ نشطًا              | استخدم جهاز Mac ذاك فعليًا، وانتظر انقضاء نافذة الدمج، ثم أعد تشغيل `openclaw nodes status`. لا تُحتسب إجراءات التحكم الاصطناعية في الكمبيوتر.                        |
| تختفي بيانات آخر إدخال                | تحقق مما إذا كان اتصال جهاز Mac قد انقطع، أو استُبدلت جلسة عقدته، أو أُلغي إذن Accessibility. يمسح كل شرط النشاط عمدًا.                       |
| يظهر التنبيه على عدة أجهزة Mac         | لم يكن التسليم الأساسي متاحًا أو فشل، ولذلك نُفّذ المسار الاحتياطي المؤجل. تحقق من أن جهاز Mac النشط متصل، ويسمح بالإشعارات، ويوفّر `system.notify`. |
| لا يذكر الوكيل جهاز Mac النشط | ابدأ دورًا جديدًا بعد تغيّر النشاط. تلميح وقت التشغيل ثابت وموجز؛ استخدم أداة `nodes` للحصول على البيانات الوصفية الحالية الدقيقة.                                    |

لاستعادة TCC، راجع [أذونات macOS](/ar/platforms/mac/permissions). ولحل مشكلات اتصال العقدة
وفشل الأوامر، راجع [استكشاف أخطاء Node وإصلاحها](/ar/nodes/troubleshooting).

## ذو صلة

- [العُقد](/ar/nodes)
- [CLI للعُقد](/ar/cli/nodes)
- [حضور النظام](/ar/concepts/presence)
- [بروتوكول Gateway](/ar/gateway/protocol#presence)
- [تطبيق macOS](/ar/platforms/macos)