وكيل الذكاء الاصطناعي — RoqueClaw
"ثبت Plex على الخادم"، "افتح الطرفية وأرني استخدام القرص"، "ابحث في Hacker News اليوم وأنشئ ملخصًا في Notes"
RoqueClaw (مبني على OpenClaw) هو المشغل المستقل لـ RoqueOS الخاص بك. على عكس روبوت المحادثة الذي يرد فقط بالنص، إنه ينفذ إجراءات حقيقية على خادمك وسطح المكتب الخاص بك: يثبت الحاويات، يفتح التطبيقات، يكتب الملفات، يطلق الإشعارات، يتنقل في الويب، ينفذ الأوامر في الطرفية.
الفرق العملي؟ تقول "أحتاج إلى خادم وسائط" وهو يثبت Jellyfin، يضبطه، يفتحه في متصفحك ويخبرك عندما يكون جاهزًا. بدلاً من أن تفتح 5 علامات تبويب، تقرأ الدرس وتتبع 20 خطوة.
ما يمكنه فعله
🐳 تثبيت حاويات Docker عبر اللغة الطبيعية
أنت: "ثبت Nextcloud لي، بـ 2GB من RAM"
RoqueClaw: ✓ جاري تثبيت nextcloud:latest...
✓ تكوين 2GB من RAM ومجلد دائم
✓ الحاوية تعمل على المنفذ 8080
✓ فتحتها في متصفحك. تسجيل الدخول الأولي: admin/adminفي الخلفية، يستخدم roqueos-cli المثبت مسبقًا على الخادم (انظر القسم أدناه) لاستدعاء API RoqueOS Server. نفس App Store، نفس الكتالوج، نفس installApp(appId, config) — فقط تشغل باللغة الطبيعية بدلاً من النقر.
💻 العمل على سطح المكتب الخاص بك
- يفتح تطبيقات محددة (
افتح Finder،افتح VS Code،افتح المتصفح على google.com) - ينشئ ملفات في Files (
احفظ هذا الملخص كـ /home/user/notes/reuniao.md) - يرسل إشعارات (
أخبرني عندما ينتهي النسخ الاحتياطي) - يعرض مربعات حوار (
اسأل المستخدم إذا كان يوافق على هذه الخطوة قبل المتابعة)
🌐 التنقل في الويب والأتمتة
- يفتح Chromium داخل حاوية معزولة (ليس في متصفحك — أمان)
- استخراج البيانات، ملء النماذج، تنزيل الملفات
- يلتقط لقطات شاشة لتتمكن من متابعة التقدم بصريًا
🤖 تنفيذ المهام المعقدة متعددة الخطوات
ليست موجهًا واحدًا → ردًا واحدًا. إنها حلقة مستقلة:
- تصف الهدف
- يخطط RoqueClaw للخطوات
- ينفذ كل خطوة (تراه مباشرة عبر VNC)
- إذا حدث خطأ، يضبط ويحاول مرة أخرى
- في النهاية، يلخص لك ما تم + الإجراءات التي اتخذها
البنية المعمارية
3 طبقات:
- Frontend: دردشة + تصور مباشر لسطح المكتب عبر noVNC
- Backend: يدير الجلسات والحاويات وتدفق الرسائل/الخطوات. يكشف عن نقاط نهاية
/agent/actions/*التي تتلقى أوامر من CLI وتطلق إجراءات في الواجهة الأمامية المتصلة. - حاوية RoqueClaw: Ubuntu 22.04 + XFCE + VNC + Chromium + Node.js + OpenClaw +
roqueos-cliمثبت مسبقًا للرجوع إلى الخادم.
🔧 CLI roqueos-cli (قوة الوكيل، وقوتك أيضًا)
roqueos-cli هو القناة بين الوكيل و RoqueOS Server. إنه مثبت مسبقًا في موقعين:
| أين | من يستخدم |
|---|---|
حاوية RoqueClaw (/usr/local/bin/roqueos-cli) | الوكيل يستدعي عبر العملية الفرعية عند تنفيذ إجراءاته |
| حاوية تطبيق Terminal (لكل مستخدم خادم واحد) | أنت، عبر shell، كلما احتجت — حتى بدون الوكيل |
هذا يعني أنه يمكنك أيضًا استخدام CLI مباشرة، دون المرور عبر الوكيل. افتح تطبيق Terminal، اكتب roqueos-cli ...، انتهى.
الأوامر المتاحة
راجع المرجع الكامل بتشغيل roqueos-cli --help في تطبيق Terminal — إنه مصدر الحقيقة. الإجراءات الـ 6 القانونية:
roqueos-cli notify <title> <message> # إشعار على سطح مكتب RoqueOS
roqueos-cli open-app <appId> # افتح تطبيقًا (finder, vscode, browser, إلخ)
roqueos-cli open-url <url> # افتح URL في Roque Browser
roqueos-cli create-file <path> # أنشئ ملفًا بقراءة المحتوى من stdin
roqueos-cli run-terminal <command> # نفذ أمرًا + أرجع stdout
roqueos-cli show-dialog <message> [--type X] # نموذج confirm/alert/infoأمثلة عملية:
# أرسل إشعارًا إلى سطح مكتب RoqueOS الخاص بك
roqueos-cli notify "اكتمل النسخ الاحتياطي" "23 GB تمت مزامنتها مع Cloudflare R2"
# افتح تطبيقًا محددًا
roqueos-cli open-app finder
# افتح URL في المتصفح
roqueos-cli open-url "https://github.com/roqueribeiro"
# أنشئ/اكتب ملفًا (يقرأ من stdin)
echo "ملاحظات الاجتماع..." | roqueos-cli create-file "/home/user/notes/reuniao.md"
# نفذ أمرًا + استلم النتيجة كإشعار
roqueos-cli run-terminal "df -h"
# نموذج تأكيد (ينتظر استجابة المستخدم قبل المتابعة)
roqueos-cli show-dialog "حذف 50GB من السجلات القديمة؟" --type confirmيستخدم الصيغة وسائط موضعية (وليس علامات
--title/--message). إذا كانت نسخة CLI الخاصة بك مختلفة، فقم بتحديثها عبرapt-get install --reinstall roqueos-cliداخل الحاوية.
حالات الاستخدام الحقيقية
سكربت cron يخطر عندما يحدث شيء:
# Crontab الذي يعمل يوميًا ويخطرك عن استخدام القرص
0 9 * * * df -h | grep -E '^/' | awk '$5+0 > 80 {print $6, $5}' | \
xargs -I {} roqueos-cli notify "القرص ممتلئ تقريبًا" "{}"سير عمل النشر:
# سكربت البناء الذي يفتح السجل في VS Code عند الانتهاء
yarn build && roqueos-cli open-app vscode && \
roqueos-cli notify "البناء OK" "تحقق من السجل في /tmp/build.log"التكامل مع حاويات أخرى:
# مهمة داخل حاوية أخرى (مثل ترميز Plex) تخطر المستخدم
roqueos-cli notify "Plex" "اكتمل ترميز 4K. الفيلم جاهز."تم توثيق HTTP API الذي يقف وراءه في 75-agent-module.md (القاعدة الداخلية للخادم)، قسم "Actions". نفس الإجراءات التي تستخدمها الواجهة الأمامية عبر WebSocket — notify و open-app و open-url و create-file و run-terminal و show-dialog.
نماذج AI المدعومة
يعمل RoqueClaw مع مزودي LLM الرئيسيين:
| المزود | النماذج الموصى بها | التكوين |
|---|---|---|
| OpenAI | GPT-4o، GPT-4-turbo | OPENAI_API_KEY env var في الحاوية |
| Anthropic | Claude 3.5 Sonnet، Claude 4.6 Sonnet | ANTHROPIC_API_KEY env var |
اختيار النموذج يؤثر على سرعة وجودة الإجراءات. للأتمتة المعقدة للويب، يكون لدى Claude Sonnet 4.6 أو GPT-4o عادةً تحكم بصري أفضل عبر VNC.
حالات الاستخدام الحقيقية
| السيناريو | المهمة | النتيجة |
|---|---|---|
| إعداد خادم جديد | "ثبت Plex و qBittorrent و Sonarr، وقم بتكوينها للعمل معًا" | 3 حاويات تعمل + مترابطة في ~3 دقائق |
| البحث | "ابحث عن أفضل 5 إطارات JavaScript لعام 2026 وأنشئ مقالة مقارنة في Notes" | مقالة MD محفوظة في /home/user/notes/ + مفتوحة في Finder |
| التشخيص | "تحقق لماذا الخادم بطيء" | يشغل top, df, free, docker stats — يولد تقريرًا في Notes |
| الأتمتة | "نزل نسخة احتياطية بالأمس من Google Drive واستخرجها في /data" | تسجيل الدخول OAuth + التنزيل + استخراج عبر tar |
| التطوير | "أنشئ سكربت Python يراقب API الخاص بي ويخطرني إذا توقف" | السكربت محفوظ في /home/user/projects/ + cron مكون |
| المنزل الذكي | "اتصل بـ Home Assistant وأرني الأضواء المضاءة" | قائمة مباشرة + خيار الإيقاف عبر الدردشة |
الخطوات التالية
- التكوين — كيفية تثبيت وتمكين RoqueClaw (علامة
--with-roqueclawفي المثبت) - كيفية الاستخدام — برنامج تعليمي خطوة بخطوة + أفضل ممارسات الموجهات + أوامر CLI كاملة