doctor

تشخيص مشاكل OpenClaw: فحص التكوين، التحقق من الاتصالات، واكتشاف المشاكل الشائعة.

الاستخدام

openclaw doctor
openclaw doctor --verbose
openclaw doctor --fix

ما يفحصه

  • التكوين - صحة ملف openclaw.json
  • مفاتيح API - وجود وصلاحية مفاتيح النماذج
  • Gateway - حالة وإمكانية الوصول
  • القنوات - اتصال قنوات المراسلة
  • التبعيات - Node.js، npm، والحزم المطلوبة
  • الأذونات - أذونات الملفات ومساحات العمل
  • الشبكة - الاتصال بالإنترنت ونقاط النهاية API
  • المتصفح - تكوين ووصول المتصفح المُدار

مستويات المخرجات

افتراضي

✅ Configuration: Valid
✅ API Keys: Configured
⚠️  Gateway: Not running
✅ Channels: 2/3 connected
✅ Dependencies: All present
❌ Permissions: /workspace not writable

مفصّل (--verbose)

[Config] Reading ~/.openclaw/openclaw.json
[Config] ✅ Valid JSON syntax
[Config] ✅ All required fields present
[API] Checking Anthropic API key...
[API] ✅ Valid key (claude-sonnet-4 accessible)
[Gateway] Attempting connection to localhost:18789...
[Gateway] ⚠️  Connection refused (gateway not running)
[Channels] Testing Telegram...
[Channels] ✅ Telegram connected (@your_bot)
...

الإصلاح التلقائي

يمكن لـ doctor محاولة إصلاح بعض المشاكل الشائعة تلقائيًا:

openclaw doctor --fix

ما يمكن إصلاحه:

  • أذونات الملفات والمجلدات
  • إنشاء مجلدات مساحة العمل المفقودة
  • إعادة تعيين ملفات التكوين التالفة
  • إعادة تثبيت التبعيات المفقودة

تحذير:

استخدم --fix بحذر. تحقق دائمًا من المخرجات قبل الموافقة على التغييرات. بعض الإصلاحات قد تتطلب تأكيدًا تفاعليًا.

الخيارات

  • --verbose - مخرجات مفصلة
  • --fix - محاولة إصلاح المشاكل تلقائيًا
  • --json - إخراج بتنسيق JSON
  • --check - فحص محدد (config، api، gateway، channels، deps، permissions، network، browser)

فحص محدد

openclaw doctor --check config
openclaw doctor --check api
openclaw doctor --check channels

نصيحة:

قم بتشغيل openclaw doctor بعد التثبيت أو التحديث للتأكد من أن كل شيء يعمل بشكل صحيح. إنه أيضًا أول ما يجب فعله عند مواجهة مشاكل.

مشاكل شائعة وحلولها

Gateway غير متصل

openclaw gateway start

مفتاح API غير صالح

openclaw configure
# أو تحرير يدويًا
nano ~/.openclaw/openclaw.json

قنوات غير متصلة

openclaw channels test telegram
openclaw channels test discord

انظر أيضًا