المساعدة

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

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

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

[البدء السريع وإعداد التشغيل الأول]
ما هو OpenClaw؟
المهارات والأتمتة
العزل والتخزين المؤقت
أين توجد الأشياء على القرص
أساسيات التكوين
البوابات البعيدة والعقد
متغيرات البيئة وتحميل .env
الجلسات والمحادثات المتعددة
النماذج: الافتراضيات، الاختيار، الأسماء المستعارة، التبديل
التبديل الاحتياطي للنموذج و "فشلت جميع النماذج"
ملفات تعريف المصادقة: ما هي وكيفية إدارتها
البوابة: المنافذ، "يعمل بالفعل"، والوضع البعيد
التسجيل والتشخيص
الوسائط والمرفقات
- أنشأت مهارتي صورة/PDF، لكن لم يتم إرسال شيء
الأمان والتحكم في الوصول
أوامر الدردشة، إلغاء المهام، و "لن يتوقف"

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

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

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

نسخ
```
openclaw status --all
```
تشخيص للقراءة فقط مع ذيل السجل (الرموز المميزة محجوبة).
حالة البرنامج الخفي + المنفذ

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

نسخ
```
openclaw status --deep
```
يقوم بإجراء فحوصات صحة البوابة + تحقيقات المزود (يتطلب بوابة قابلة للوصول). راجع الصحة.
تتبع أحدث سجل

نسخ
```
openclaw logs --follow
```
إذا كان RPC معطلاً، استخدم:

نسخ
```
tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
```
سجلات الملفات منفصلة عن سجلات الخدمة؛ راجع التسجيل و استكشاف الأخطاء وإصلاحها.
تشغيل الطبيب (الإصلاحات)

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

لقطة البوابة

نسخ

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

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

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

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

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

Claude Code: https://www.anthropic.com/claude-code/
OpenAI Codex: https://openai.com/codex/

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

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

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

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

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

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

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

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

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

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