> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# النظام

# `openclaw system`

مساعدات على مستوى النظام لـ Gateway: أدرج أحداث النظام في قائمة الانتظار، وتحكم في Heartbeat،
واعرض الحضور.

تستخدم كل أوامر `system` الفرعية Gateway RPC وتقبل خيارات العميل المشتركة:

* `--url <url>`
* `--token <token>`
* `--timeout <ms>`
* `--expect-final`

## الأوامر الشائعة

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw system event --text "Check for urgent follow-ups" --mode now
openclaw system event --text "Check for urgent follow-ups" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system presence
```

## `system event`

أدرج حدث نظام في قائمة الانتظار على الجلسة **الرئيسية** افتراضيًا. سيحقنه Heartbeat التالي
كسطر `System:` في الموجه. استخدم `--mode now` لتشغيل
Heartbeat فورًا؛ وينتظر `next-heartbeat` النبضة المجدولة التالية.

مرر `--session-key` لاستهداف جلسة محددة (مثلًا لترحيل اكتمال
مهمة غير متزامنة إلى القناة التي بدأتها).

> **استثناء التوقيت مع `--session-key`:** عند توفير `--session-key`،
> ينهار `--mode next-heartbeat` إلى إيقاظ مستهدف فوري بدلًا من
> انتظار النبضة المجدولة التالية. تستخدم الإيقاظات المستهدفة نية Heartbeat
> `immediate` بحيث تتجاوز بوابة عدم حلول الموعد في المشغل، والتي كانت ستؤجل
> بخلاف ذلك إيقاظًا بنية `event` (وتسقطه فعليًا). إذا أردت تسليمًا
> مؤجلًا، فاحذف `--session-key` ليصل الحدث إلى الجلسة الرئيسية و
> يركب Heartbeat المنتظم التالي.

الخيارات:

* `--text <text>`: نص حدث النظام المطلوب.
* `--mode <mode>`: `now` أو `next-heartbeat` (الافتراضي).
* `--session-key <sessionKey>`: اختياري؛ استهدف جلسة وكيل محددة
  بدلًا من الجلسة الرئيسية للوكيل. تعود المفاتيح التي لا تنتمي إلى
  الوكيل المحدد إلى الجلسة الرئيسية للوكيل.
* `--json`: إخراج قابل للقراءة آليًا.
* `--url`، `--token`، `--timeout`، `--expect-final`: خيارات Gateway RPC المشتركة.

## `system heartbeat last|enable|disable`

عناصر التحكم في Heartbeat:

* `last`: اعرض آخر حدث Heartbeat.
* `enable`: أعد تشغيل Heartbeat (استخدم هذا إذا كانت معطلة).
* `disable`: أوقف Heartbeat مؤقتًا.

الخيارات:

* `--json`: إخراج قابل للقراءة آليًا.
* `--url`، `--token`، `--timeout`، `--expect-final`: خيارات Gateway RPC المشتركة.

## `system presence`

اسرد إدخالات حضور النظام الحالية التي يعرفها Gateway (العقد،
والمثيلات، وأسطر الحالة المشابهة).

الخيارات:

* `--json`: إخراج قابل للقراءة آليًا.
* `--url`، `--token`، `--timeout`، `--expect-final`: خيارات Gateway RPC المشتركة.

## ملاحظات

* يتطلب Gateway قيد التشغيل ويمكن الوصول إليه عبر إعدادك الحالي (محليًا أو عن بعد).
* أحداث النظام عابرة ولا تستمر عبر عمليات إعادة التشغيل.

## ذو صلة

* [مرجع CLI](/ar/cli)