English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

CLI commands

السجلات

openclaw logs

تابِع سجلات ملف Gateway عبر RPC (يعمل في الوضع البعيد).

ذات صلة:

الخيارات

  • --limit <n>: الحد الأقصى لعدد أسطر السجل المراد إرجاعها (الافتراضي 200)
  • --max-bytes <n>: الحد الأقصى للبايتات المراد قراءتها من ملف السجل (الافتراضي 250000)
  • --follow: متابعة تدفق السجل
  • --interval <ms>: فاصل الاستقصاء أثناء المتابعة (الافتراضي 1000)
  • --json: إخراج أحداث JSON مفصولة بالأسطر
  • --plain: إخراج نص عادي دون تنسيق مزيّن
  • --no-color: تعطيل ألوان ANSI
  • --local-time: عرض الطوابع الزمنية في منطقتك الزمنية المحلية

خيارات RPC المشتركة لـ Gateway

يقبل openclaw logs أيضًا أعلام عميل Gateway القياسية:

  • --url <url>: عنوان URL لـ WebSocket الخاص بـ Gateway
  • --token <token>: رمز Gateway
  • --timeout <ms>: المهلة بالمللي ثانية (الافتراضي 30000)
  • --expect-final: انتظار استجابة نهائية عندما يكون استدعاء Gateway مدعومًا بوكيل

عند تمرير --url، لا يطبّق CLI تلقائيًا بيانات اعتماد الإعدادات أو البيئة. ضمّن --token صراحةً إذا كان Gateway الهدف يتطلب المصادقة.

أمثلة

openclaw logs
openclaw logs --follow
openclaw logs --follow --interval 2000
openclaw logs --limit 500 --max-bytes 500000
openclaw logs --json
openclaw logs --plain
openclaw logs --no-color
openclaw logs --limit 500
openclaw logs --local-time
openclaw logs --follow --local-time
openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

ملاحظات

  • استخدم --local-time لعرض الطوابع الزمنية في منطقتك الزمنية المحلية.
  • إذا طلب Gateway الضمني عبر local loopback المحلي الاقتران، أو أُغلق أثناء الاتصال، أو انتهت مهلته قبل أن يجيب logs.tail، يعود openclaw logs تلقائيًا إلى سجل ملف Gateway المُعدّ. أهداف --url الصريحة لا تستخدم هذا الرجوع الاحتياطي.
  • عند استخدام --follow، تؤدي انقطاعات Gateway العابرة (إغلاق WebSocket، انتهاء المهلة، انقطاع الاتصال) إلى إعادة اتصال تلقائية مع تراجع أسي (حتى 8 محاولات، وبحد أقصى 30 ثانية بين المحاولات). يُطبع تحذير إلى stderr عند كل إعادة محاولة، وتُطبع ملاحظة [logs] gateway reconnected بمجرد نجاح استقصاء. في وضع --json، يُصدر كل من تحذير إعادة المحاولة وانتقال إعادة الاتصال كسجلات {"type":"notice"} على stderr. لا تزال الأخطاء غير القابلة للاسترداد (فشل المصادقة، إعدادات سيئة) تخرج فورًا.

ذات صلة