التكوين والعمليات

فحوصات الصحة

دليل مختصر للتحقق من اتصالية القنوات دون تخمين.

فحوصات سريعة

  • openclaw status — ملخص محلي: قابلية الوصول للبوابة/الوضع، تلميح التحديث، عمر مصادقة القناة المرتبطة، الجلسات + النشاط الأخير.
  • openclaw status --all — تشخيص محلي كامل (للقراءة فقط، ملون، آمن للنسخ لأغراض التصحيح).
  • openclaw status --deep — يفحص أيضًا البوابة قيد التشغيل (فحص لكل قناة عند دعمها).
  • openclaw health --json — يطلب من البوابة قيد التشغيل لقطة صحية كاملة (WS فقط؛ لا اتصال مباشر بمقبس Baileys).
  • أرسل /status كرسالة منفردة في واتساب/ويب شات للحصول على رد حالة دون استدعاء الوكيل.
  • السجلات: تابع /tmp/openclaw/openclaw-*.log ورشح لـ web-heartbeat، web-reconnect، web-auto-reply، web-inbound.

تشخيص عميق

  • بيانات الاعتماد على القرص: ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json (يجب أن يكون وقت التعديل mtime حديثًا).
  • مستودع الجلسات: ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json (يمكن تجاوز المسار في التكوين). يتم عرض العدد والمستلمين الأخيرين عبر status.
  • تدفق إعادة الربط: openclaw channels logout && openclaw channels login --verbose عند ظهور رموز الحالة 409–515 أو loggedOut في السجلات. (ملاحظة: تدفق تسجيل الدخول عبر QR يعيد التشغيل تلقائيًا مرة واحدة لرمز الحالة 515 بعد الاقتران.)

عندما يفشل شيء ما

  • logged out أو رمز الحالة 409–515 → أعد الربط باستخدام openclaw channels logout ثم openclaw channels login.
  • البوابة غير قابلة للوصول → ابدأها: openclaw gateway --port 18789 (استخدم --force إذا كان المنفذ مشغولاً).
  • لا توجد رسائل واردة → تأكد من أن الهاتف المرتبط متصل بالإنترنت وأن المرسل مسموح له (channels.whatsapp.allowFrom)؛ لدردشات المجموعات، تأكد من تطابق القائمة المسموحة + قواعد الذكر (channels.whatsapp.groups, agents.list[].groupChat.mentionPatterns).

أمر "الصحة" المخصص

openclaw health --json يطلب من البوابة قيد التشغيل لقطة صحية (بدون مقابس قنوات مباشرة من واجهة سطر الأوامر). يبلغ عن بيانات الاعتماد المرتبطة/عمر المصادقة عند توفرها، ملخصات فحص كل قناة، ملخص مستودع الجلسات، ومدة الفحص. يخرج برمز غير صفري إذا كانت البوابة غير قابلة للوصول أو إذا فشل الفحص/انتهت مهلة الانتظار. استخدم --timeout <ms> لتجاوز الإعداد الافتراضي 10 ثوانٍ.

مصادقة الوكيل الموثوقنبض القلب