استكشاف أخطاء Clawdbot وإصلاحها
تصحيح وإصلاح مشكلات مساعد Clawdbot للذكاء الاصطناعي الشائعة. تعلم كيفية تشخيص مشاكل الاتصال وفشل الرسائل وأخطاء البوابة.
نظرة عامة على استكشاف أخطاء Clawdbot وإصلاحها
يساعدك هذا الدليل في تشخيص وإصلاح المشكلات الشائعة في نشر Clawdbot. اعثر على حلول لمشاكل الاتصال وفشل الرسائل وأخطاء البوابة.
المشكلات الشائعة
البوابة لا تبدأ
الأعراض: البوابة تفشل في البدء أو تخرج فوراً.
الحلول:
- التحقق من توفر المنفذ:
lsof -i :3010- التحقق من التكوين:
clawdbot config validate- فحص السجلات:
clawdbot gateway logsفشل اتصال WhatsApp
الأعراض: رمز QR لا يظهر أو الاتصال ينقطع.
الحلول:
- مسح جلسة WhatsApp:
rm -rf ~/.clawdbot/providers/whatsapp/session- إعادة تشغيل البوابة:
clawdbot gateway restart- التحقق من اتصال الشبكة
الرسائل لم تُسلّم
الأعراض: الرسائل مُرسلة لكن لم تُستلم.
الحلول:
- التحقق من حالة الجلسة:
clawdbot sessions list- التحقق من اتصال المزود:
clawdbot providers status- التحقق من حدود المعدل
الوكيل لا يستجيب
الأعراض: الوكيل لا ينتج ردوداً.
الحلول:
- التحقق من حالة الوكيل:
clawdbot agents status- التحقق من مفتاح API:
echo $ANTHROPIC_API_KEY- التحقق من توفر النموذج
أوامر التشخيص
حالة البوابة
# التحقق من صحة البوابة
clawdbot gateway status
# عرض الاتصالات النشطة
clawdbot gateway connections
# عرض استخدام الموارد
clawdbot gateway statsتشخيص الجلسات
# سرد جميع الجلسات
clawdbot sessions list
# عرض تفاصيل الجلسة
clawdbot sessions get <session-key>
# مسح الجلسة المتوقفة
clawdbot sessions clear <session-key>تشخيص المزودين
# التحقق من حالة المزود
clawdbot providers status
# اختبار اتصال المزود
clawdbot providers test whatsapp
# إعادة اتصال المزود
clawdbot providers reconnect telegramتحليل السجلات
تمكين سجل التصحيح
clawdbot gateway start --log-level debugمواقع السجلات
| السجل | الموقع |
|---|---|
| البوابة | ~/.clawdbot/logs/gateway.log |
| المزودين | ~/.clawdbot/logs/providers/ |
| الوكلاء | ~/.clawdbot/logs/agents/ |
مستويات السجل
| المستوى | الوصف |
|---|---|
error | الأخطاء فقط |
warn | التحذيرات والأخطاء |
info | معلومات عامة |
debug | معلومات تصحيح مفصلة |
رموز الخطأ
أخطاء الاتصال
| الرمز | الوصف | الحل |
|---|---|---|
ECONNREFUSED | المنفذ غير مفتوح | تحقق من تشغيل البوابة |
ETIMEDOUT | انتهت مهلة الشبكة | تحقق من الشبكة |
EAUTH | فشل المصادقة | تحقق من بيانات الاعتماد |
أخطاء المزود
| الرمز | الوصف | الحل |
|---|---|---|
WA_DISCONNECTED | WhatsApp منفصل | أعد مسح QR |
TG_INVALID_TOKEN | رمز Telegram غير صالح | تحقق من الرمز |
DC_MISSING_INTENTS | صلاحيات Discord مفقودة | فعّل الصلاحيات |
مشاكل الأداء
الردود بطيئة
الأسباب:
- حجم رسائل كبير
- حجم سياق كبير
- تأخر الشبكة
الحلول:
- تمكين البث
- تقليل حجم السياق
- التحقق من الشبكة
استخدام الذاكرة
فحص الذاكرة:
clawdbot gateway stats --memoryتقليل الذاكرة:
{
"gateway": {
"messageBuffer": 500,
"maxHistory": 50
}
}إجراءات الاستعادة
إعادة تعيين البوابة
# إيقاف البوابة
clawdbot gateway stop
# مسح الحالة
clawdbot gateway reset --state
# إعادة التشغيل
clawdbot gateway startإعادة تعيين المزود
# فصل المزود
clawdbot providers disconnect whatsapp
# مسح بيانات المزود
rm -rf ~/.clawdbot/providers/whatsapp
# إعادة التكوين
clawdbot providers setup whatsappإعادة تعيين الوكيل
# مسح جلسات الوكيل
clawdbot agents reset main --sessions
# مسح مساحة عمل الوكيل
clawdbot agents reset main --workspaceالحصول على المساعدة
موارد الدعم
- التوثيق: https://docs.clawdbotai.app
- GitHub Issues: https://github.com/clawdbot/clawdbot/issues
- مجتمع Discord: https://discord.gg/clawdbot
تقارير الأخطاء
تضمين في تقارير الأخطاء:
- إصدار Clawdbot
- نظام التشغيل
- رسائل الخطأ
- خطوات إعادة الإنتاج
الخطوات التالية
- تكوين Clawdbot - دليل التكوين
- أمان Clawdbot - إعداد الأمان
- Clawdbot Gateway - نظرة عامة على البوابة