المساعدة

الأسئلة الشائعة

إجابات سريعة بالإضافة إلى استكشاف أخطاء أعمق للإعدادات الواقعية (التطوير المحلي، VPS، متعدد الوكلاء، OAuth/مفاتيح API، تبديل النماذج الاحتياطي). للتشخيص أثناء التشغيل، راجع استكشاف الأخطاء وإصلاحها. للرجوع الكامل للتكوين، راجع التكوين.

جدول المحتويات

أول 60 ثانية إذا كان شيء ما معطلاً

  1. الحالة السريعة (التحقق الأول)

    نسخ

    openclaw status

    ملخص محلي سريع: نظام التشغيل + التحديث، إمكانية الوصول إلى البوابة/الخدمة، الوكلاء/الجلسات، تكوين المزود + مشاكل وقت التشغيل (عندما تكون البوابة قابلة للوصول).

  2. تقرير قابل للنسخ (آمن للمشاركة)

    نسخ

    openclaw status --all

    تشخيص للقراءة فقط مع ذيل السجل (الرموز المميزة محجوبة).

  3. حالة البرنامج الخفي + المنفذ

    نسخ

    openclaw gateway status

    يظهر وقت تشغيل المشرف مقابل إمكانية الوصول إلى RPC، عنوان URL المستهدف للتحقق، وأي تكوين استخدمته الخدمة على الأرجح.

  4. التحقيقات العميقة

    نسخ

    openclaw status --deep

    يقوم بإجراء فحوصات صحة البوابة + تحقيقات المزود (يتطلب بوابة قابلة للوصول). راجع الصحة.

  5. تتبع أحدث سجل

    نسخ

    openclaw logs --follow

    إذا كان RPC معطلاً، استخدم:

    نسخ

    tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"

    سجلات الملفات منفصلة عن سجلات الخدمة؛ راجع التسجيل و استكشاف الأخطاء وإصلاحها.

  6. تشغيل الطبيب (الإصلاحات)

    نسخ

    openclaw doctor

    يصلح/ينقل التكوين/الحالة + يقوم بإجراء فحوصات الصحة. راجع الطبيب.

  7. لقطة البوابة

    نسخ

    openclaw health --json
openclaw health --verbose   # يظهر عنوان URL المستهدف + مسار التكوين عند الأخطاء

    يطلب من البوابة قيد التشغيل لقطة كاملة (WS فقط). راجع الصحة.

البدء السريع وإعداد التشغيل الأول

أنا عالق، ما أسرع طريقة للخروج من هذا المأزق

استخدم وكيل ذكاء اصطناعي محلي يمكنه رؤية جهازك. هذا أكثر فعالية بكثير من السؤال في Discord، لأن معظم حالات "أنا عالق" هي مشاكل تكوين أو بيئة محلية لا يمكن للمساعدين البعيدين فحصها.

يمكن لهذه الأدوات قراءة المستودع، وتشغيل الأوامر، وفحص السجلات، والمساعدة في إصلاح إعدادك على مستوى الجهاز (PATH، الخدمات، الأذونات، ملفات المصادقة). امنحهم نسخة المصدر الكاملة عبر التثبيت القابل للاختراق (git):

curl -fsSL https://openclaw.ai/install.sh