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