المساعدة

استكشاف الأخطاء وإصلاحها

إذا كان لديك دقيقتان فقط، استخدم هذه الصفحة كبوابة أولية للفرز.

أول 60 ثانية

شغّل هذا السلم بالضبط بالترتيب:

openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

المخرجات الجيدة في سطر واحد:

openclaw status → تُظهر القنوات المُهيأة ولا تظهر أخطاء مصادقة واضحة.
openclaw status --all → التقرير الكامل موجود وقابل للمشاركة.
openclaw gateway probe → هدف البوابة المتوقع يمكن الوصول إليه.
openclaw gateway status → Runtime: running و RPC probe: ok.
openclaw doctor → لا توجد أخطاء في التكوين/الخدمة تمنع التشغيل.
openclaw channels status --probe → القنوات تُبلغ بـ connected أو ready.
openclaw logs --follow → نشاط مستمر، لا توجد أخطاء فادحة متكررة.

Anthropic سياق طويل 429

إذا رأيت: HTTP 429: rate_limit_error: Extra usage is required for long context requests، انتقل إلى /gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context.

فشل تثبيت الإضافة بسبب افتقار openclaw extensions

إذا فشل التثبيت مع package.json missing openclaw.extensions، فإن حزمة الإضافة تستخدم شكلًا قديمًا لم يعد OpenClaw يقبله. الإصلاح في حزمة الإضافة:

أضف openclaw.extensions إلى package.json.
وجّه المداخل إلى ملفات وقت التشغيل المبنية (عادةً ./dist/index.js).
أعد نشر الإضافة وشغّل openclaw plugins install <npm-spec> مرة أخرى.

مثال:

{
  "name": "@openclaw/my-plugin",
  "version": "1.2.3",
  "openclaw": {
    "extensions": ["./dist/index.js"]
  }
}

المرجع: /tools/plugin#distribution-npm

شجرة القرار

لا توجد ردود

لوحة التحكم أو واجهة التحكم لا تتصل

البوابة لا تبدأ أو الخدمة مثبتة ولكنها لا تعمل

القناة تتصل ولكن الرسائل لا تتدفق

المهمة المجدولة أو نبضات الحياة لم تُنفذ أو لم تُسلم

العقدة مقترنة ولكن الأداة تفشل في تنفيذ الكاميرا، اللوحة القماشية، الشاشة، exec

أداة المتصفح تفشل

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