CLI commands

النظام

openclaw system

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

تستخدم جميع الأوامر الفرعية لـ system استدعاء RPC الخاص بـ Gateway، وتقبل أعلام العميل المشتركة:

العلم القيمة الافتراضية الوصف
--url <url> gateway.remote.url عند ضبطه عنوان URL لاتصال WebSocket الخاص بـ Gateway.
--token <token> لا شيء رمز Gateway المميز (إذا كان مطلوبًا).
--timeout <ms> 30000 مهلة RPC بالمللي ثانية.
--expect-final معطّل انتظار الاستجابة النهائية (الوكيل).
--json معطّل إخراج JSON. تطبع heartbeat last/enable/disable وsystem presence دائمًا حمولة JSON الأولية من RPC بصرف النظر عن هذا العلم؛ ويستخدمه system event للتبديل بين JSON وسطر ok عادي.

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

bash
openclaw system event --text "Check for urgent follow-ups" --mode nowopenclaw system event --text "Check for urgent follow-ups" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"openclaw system heartbeat enableopenclaw system heartbeat lastopenclaw system presence

system event

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

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

الأعلام:

  • --text <text>: نص حدث النظام المطلوب.
  • --mode <mode>: إما now أو next-heartbeat (الافتراضي).
  • --session-key <sessionKey>: اختياري؛ يستهدف جلسة وكيل محددة بدلًا من الجلسة الرئيسية للوكيل. تعود المفاتيح التي لا تنتمي إلى الوكيل المحدد إلى الجلسة الرئيسية للوكيل.

system heartbeat last|enable|disable

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

system presence

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

ملاحظات

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

ذو صلة

Was this useful?
On this page

On this page