كيفية استخدام OpenClaw
دليل عملي لتحقيق أقصى استفادة من وكيل الذكاء الاصطناعي المستقل في RoqueOS.
واجهة الوكيل
ينقسم تطبيق AI Agent إلى منطقتين رئيسيتين:
- لوحة الدردشة (يسار) — حيث ترسل الرسائل وتتابع الردود
- معاينة سطح المكتب (يمين) — بث مباشر لما يفعله الوكيل داخل الحاوية
لوحة الخطوات
أسفل الدردشة، توجد لوحة خطوات في الوقت الفعلي تعرض كل إجراء يتخذه الوكيل: الانتقال إلى رابط URL، أو النقر على عنصر، أو تنفيذ أمر، وما إلى ذلك.
إنشاء جلسة
تقوم كل محادثة مع الوكيل بإنشاء جلسة — حاوية Docker معزولة مع سطح مكتب Linux حصري. للبدء:
- افتح تطبيق AI Agent من لوحة الإطلاق (Launchpad).
- انقر على جلسة جديدة (New Session).
- ستبدأ الحاوية في التهيئة (قد يستغرق الأمر من 10 إلى 30 ثانية في المرة الأولى).
- عندما يظهر سطح المكتب في اللوحة اليمنى، يكون الوكيل جاهزًا.
إرسال المهام
أفضل الممارسات لكتابة المطالبات (Prompts)
كن محددًا وموضوعيًا عند وصف المهمة. كلما قدمت سياقًا أكثر، كانت النتيجة أفضل.
❌ غامض:
ابحث عن Docker✅ محدد:
ابحث عن أبرز 5 اختلافات بين Docker Compose v2 و v3،
وقم بإنشاء ملف markdown يلخص النقاط، واحفظه في /home/user/docker-comparison.mdأمثلة على المهام
البحث والتوثيق:
اذهب إلى موقع hetzner.com، واعثر على خطط VPS المتاحة،
وأنشئ جدول مقارنة يحتوي على الأسعار والميزات بتنسيق CSV.أتمتة النماذج:
املأ نموذج التسجيل على [URL] بالبيانات التالية:
الاسم: John Doe، البريد الإلكتروني: john@example.com، الخطة: أساسيةالتطوير:
قم بإنشاء برنامج نصي (Script) بلغة Python يقوم بسحب عناوين الأخبار
من Hacker News ويحفظ أفضل 10 عناوين في ملف JSON.تحليل المواقع:
اذهب إلى مستودع GitHub هذا [URL]، واقرأ ملف README، واشرح
لي ماذا يفعل المشروع وما هي المتطلبات الأساسية لتثبيته.الإجراءات التي يمكن للوكيل تنفيذها على RoqueOS
يمكن لـ OpenClaw التفاعل مباشرة مع نظام RoqueOS الخاص بك خارج الحاوية المعزولة:
| الإجراء | الوصف |
|---|---|
| إشعار | إرسال تنبيه إلى سطح مكتب RoqueOS الخاص بك |
| فتح تطبيق | فتح تطبيق معين في لوحة الإطلاق (Launchpad) |
| فتح رابط | فتح رابط URL في متصفح RoqueOS |
مثال للاستخدام: في نهاية مهمة طويلة، يمكن للوكيل إرسال إشعار تلقائي لإعلامك بأنه قد انتهى.
إدارة الجلسات
الجلسات النشطة
يتم سرد جميع الجلسات النشطة في الجزء العلوي من التطبيق. يمكنك:
- استئناف (Resume) جلسة سابقة بالنقر عليها
- إنهاء (End) جلسة لتحرير موارد الخادم
حد الجلسات المتزامنة
افتراضيًا، يسمح الخادم بما يصل إلى 3 جلسات متزامنة (يمكن تكوينها عبر AGENT_MAX_SESSIONS). قم بإنهاء الجلسات التي لم تعد تستخدمها لتوفير ذاكرة الوصول العشوائي (RAM).
لقطة الشاشة وملء الشاشة
- لقطة شاشة — انقر على أيقونة الكاميرا لالتقاط الحالة الحالية لسطح مكتب الوكيل
- ملء الشاشة — قم بتوسيع عرض سطح المكتب ليملأ الشاشة بالكامل لتتبع المهام المرئية بشكل أفضل
القيود المعروفة
- يعمل الوكيل في بيئة معزولة — ليس لديه وصول مباشر إلى ملفاتك المحلية ما لم تقم بتوفير المعلومات عبر الدردشة.
- المهام التي تتطلب تسجيل الدخول إلى الحسابات (البريد الإلكتروني، الشبكات الاجتماعية) تتطلب منك توفير بيانات الاعتماد أثناء المحادثة.
- المهلة الافتراضية هي 30 دقيقة من عدم النشاط — المهام الطويلة جدًا قد تتطلب التفاعل بشكل دوري.
استكشاف الأخطاء وإصلاحها
الوكيل لا يستجيب
- تحقق مما إذا كان الخادم متصلاً بالإنترنت:
curl http://localhost:27021/health - تأكد من تكوين مفتاح API بشكل صحيح.
- قم بإنهاء الجلسة الحالية وإنشاء جلسة جديدة.
لا يظهر سطح المكتب في اللوحة
قد تكون الحاوية لا تزال قيد التهيئة. انتظر لمدة 30 ثانية وأعد تحميل التطبيق.
استجابات بطيئة أو غير مكتملة
قد تكون المشكلة تتعلق بحد المعدل (Rate limit) من مزود الذكاء الاصطناعي. انتظر بضع لحظات وحاول مرة أخرى، أو قلل من تعقيد المهمة.