دليل OpenAgentd: بناء فريق وكلاء ذكاء اصطناعي محلي على جهازك خطوة بخطوة
Self-hosted AI agent OS — streaming chat, tool use, persistent memory, and multi-agent teams. Runs entirely on your machine.
خريطة الصفحة
اختر القسم الذي تحتاجه الآن
- ما هو OpenAgentd؟
- من يحتاج OpenAgentd ومن لا؟
- المميزات الرئيسية
- المتطلبات الأساسية قبل البدء
- تركيب OpenAgentd خطوة بخطوة
- إعداد ملف .env ومفاتيح API
- تشغيل OpenAgentd لأول مرة
- أخطاء شائعة وحلولها
- استخدامات عملية للمطور العربي
- هل يستحق OpenAgentd التجربة؟
- بدائل OpenAgentd
- أسئلة شائعة (FAQ)
قبل أن تطبق
الفكرة التي تمنع التسرع
تعتقد أن تشغيل وكيل ذكاء اصطناعي محلياً يتطلب خبرة متقدمة وموارد ضخمة؟ الحقيقة أن OpenAgentd يمكن تثبيته في 10 دقائق ويعمل على أي جهاز حديث.
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
- هل جهازك يعمل بنظام ويندوز 10/11 أو ماك أو لينكس؟
- هل لديك Python 3.14 أو أحدث مثبت؟
- هل لديك مفتاح API صالح لأحد مزودي النماذج (مثل Google Gemini)؟
- هل أنت مرتاح لاستخدام سطر الأوامر (Terminal)؟
- هل تريد تشغيل وكلاء AI محليًا لأسباب تتعلق بالخصوصية؟
- هل تحتاج إلى دعم اللغة العربية في ردود الوكيل؟
- هل جهازك يحتوي على 8GB RAM على الأقل و500MB مساحة تخزين؟
نظام التشغيل: Input → Process → Output
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت تبحث عن طريقة لتشغيل وكيل ذكاء اصطناعي على جهازك دون الاعتماد على خدمات سحابية باهظة الثمن، فإن OpenAgentd هو الحل. هذا المشروع مفتوح المصدر يقدم 'نظام تشغيل وكلاء' يمكنك من تشغيل فريق من الوكلاء يدعمون 15 مزود نموذج مختلف، مع ذاكرة دائمة وتدفق محادثة مباشر.
في هذا الدليل، ستتعلم كيفية تثبيت OpenAgentd خطوة بخطوة، إعداد مفاتيح API، وتشغيل أول وكيل لك. سنستخدم أمثلة عملية من السوق السعودي مثل أتمتة ردود العملاء وتحليل بيانات المبيعات. الدليل مبني على بنية المشروع الفعلية، مع تحذيرات من الأخطاء الشائعة.
ما هو OpenAgentd؟
OpenAgentd هو تطبيق سطح مكتب مفتوح المصدر (رخصة Apache 2.0) يعمل كـ 'نظام تشغيل لوكلاء الذكاء الاصطناعي'. يمكنك تشغيله بنقرة مزدوجة على جهازك، ويدعم:
- تدفق محادثة مباشر (streaming chat)
- استخدام أدوات خارجية (tool use)
- ذاكرة دائمة لكل جلسة
- فريق متعدد الوكلاء (multi-agent teams)
- 15 مزود نموذج مختلف (Anthropic, Google, OpenAI, OpenRouter...)
المشروع مكتوب بلغة Python مع واجهة React، ويستخدم FastAPI كخادم خلفي. يمكنك تشغيله على ويندوز، ماك، أو لينكس.
من يحتاج OpenAgentd ومن لا؟
يناسب:
- مطور عربي يريد تجربة وكلاء AI محلياً دون تكاليف سحابية
- صاحب مشروع صغير يحتاج أتمتة ردود العملاء أو تحليل بيانات
- صانع محتوى تقني يريد شرح أدوات AI لجمهوره
لا يناسب:
- من يبحث عن حل جاهز بدون أي إعداد فني (يتطلب معرفة أساسية بـ Python و API keys)
- من يحتاج نماذج محلية مثل Llama (لا يدعمها OpenAgentd حالياً)
- من يريد تشغيله على أجهزة ضعيفة جداً (يحتاج على الأقل 8GB RAM)
المميزات الرئيسية
- خصوصية كاملة: كل شيء يعمل على جهازك، لا بيانات تخرج
- دعم 15 مزود: اختر من Claude، Gemini، GPT، OpenRouter، وغيرها
- ذاكرة دائمة: الوكيل يتذكر محادثاتك السابقة حتى بعد إعادة التشغيل
- فريق وكلاء: شغّل عدة وكلاء يعملون معاً على مهمة واحدة
- واجهة ويب جميلة: تحكم كامل من المتصفح
- مجاني ومفتوح المصدر: لا رسوم ترخيص، يمكنك تعديل الكود
المتطلبات الأساسية قبل البدء
- نظام تشغيل: ويندوز 10/11، ماك، أو لينكس
- Python 3.14 أو أحدث (يمكنك التحقق بـ
python --version) - Git (لتحميل المشروع)
- مفتاح API لمزود نموذج واحد على الأقل (مثلاً من Google AI Studio مجاناً)
- مساحة تخزين 500MB على الأقل
- اتصال بالإنترنت (أثناء التثبيت فقط، وبعدها يمكن العمل دون اتصال إذا كان النموذج محلياً)
تركيب OpenAgentd خطوة بخطوة
ملاحظة: هذه الخطوات تقريبية بناءً على بنية المشروع. قد تختلف حسب التحديثات. راجع README الرسمي إذا واجهت مشكلة.
- تحميل المشروع: افتح الطرفية (Terminal) واكتب:
git clone https://GitHub.com/lthoangg/OpenAgentd.gitcd OpenAgentd - إنشاء بيئة افتراضية:
python -m venv venv
ثم تفعيلها:
ويندوز:venv\Scripts\activate
ماك/لينكس:source venv/bin/activate - تثبيت المتطلبات:
pip install -r requirements.txt - إعداد ملف .env: انسخ الملف النموذجي:
cp .env.example .env
ثم عدّل الملف كما في القسم التالي. - تشغيل التطبيق:
python main.py
أو حسب تعليمات README (قد يكون هناك سكربت منفصل). - فتح الواجهة: افتح المتصفح على
http://localhost:8000(أو المنفذ المحدد).
إعداد ملف .env ومفاتيح API
ملف .env هو قلب إعدادات OpenAgentd. إليك نموذج جاهز مع تعليقات بالعربية:
# اختر مزود نموذج واحد على الأقل
# مثال: Google Gemini (مجاني)
GOOGLE_API_KEY=AIzaSy...
# أو Claude من Anthropic
ANTHROPIC_API_KEY=sk-ant-...
# أو OpenAI
OPENAI_API_KEY=sk-...
# إعدادات إضافية (اختياري)
# LOG_LEVEL=INFO
# PORT=8000كيف تحصل على مفتاح API مجاني؟
- Google Gemini: اذهب إلى AI Studio وأنشئ مفتاحاً مجانياً.
- OpenRouter: سجل في OpenRouter واحصل على مفتاح مع رصيد تجريبي.
تشغيل OpenAgentd لأول مرة
بعد تشغيل الأمر python main.py، ستظهر رسالة تشير إلى أن الخادم يعمل. افتح المتصفح على http://localhost:8000. ستظهر واجهة بسيطة مع حقل نصي. اكتب استعلامك الأول مثل: 'ما هو الطقس في الرياض؟' إذا كان النموذج يدعم البحث. أو جرب: 'اكتب لي بريداً إلكترونياً لعميل سعودي يشكر فيه على طلبه'.
أخطاء شائعة وحلولها
استخدامات عملية للمطور العربي
مثال 1: وكيل ردود العملاء بالعربية
استخدم نموذج Claude لإنشاء وكيل يرد على استفسارات العملاء. اكتب في واجهة OpenAgentd: 'أنت وكيل دعم فني لشركة سعودية. أجب على الاستفسارات التالية بلغة عربية فصحى مهذبة'. ثم أضف الاستفسارات. الوكيل سيتذكر السياق بفضل الذاكرة الدائمة.
مثال 2: فريق وكلاء لتحليل بيانات المبيعات
شغّل وكيلين: الأول يحلل ملف CSV للمبيعات، والثاني يولد تقريراً. يمكنك تحميل الملف عبر واجهة الويب (إذا كانت الميزة مدعومة) أو استخدام tool use لقراءة الملفات.
مثال 3: دمج مع تقويم Google
إذا كان OpenAgentd يدعم tool use، يمكنك ربطه بتقويم Google عبر API. الوكيل يمكنه جدولة مواعيد بناءً على أوامر صوتية أو نصية.
هل يستحق OpenAgentd التجربة؟
نعم، خاصة إذا كنت تريد خصوصية كاملة وتحكماً كاملاً في وكلاء AI. لكنه ليس جاهزاً للمبتدئين تماماً. إذا كنت مرتاحاً مع سطر الأوامر ومفاتيح API، فجربه. المشروع لا يزال في مراحله الأولى (أقل من 200 نجمة على GitHub)، لذا توقع بعض الأخطاء.
بدائل OpenAgentd
أسئلة شائعة (FAQ)
هل OpenAgentd مجاني بالكامل؟
نعم، البرنامج مجاني ومفتوح المصدر. لكنك قد تحتاج لدفع مقابل استخدام بعض النماذج (مثل Claude أو GPT) إذا تجاوزت الحد المجاني.
ما هي متطلبات الأجهزة؟
معالج حديث (Intel i5 أو أعلى)، 8GB RAM، 500MB مساحة تخزين. لا تحتاج GPU إلا إذا كنت تشغل نماذج محلية (غير مدعومة حالياً).
هل يمكن استخدام OpenAgentd بدون اتصال بالإنترنت؟
إذا كنت تستخدم نموذجاً محلياً (غير مدعوم حالياً)، نعم. لكن معظم المزودين يتطلبون اتصالاً بالإنترنت.
كيف أضيف نموذج ذكاء اصطناعي جديد؟
عدّل ملف .env وأضف المفتاح الجديد. ثم في الواجهة، اختر المزود من القائمة المنسدلة.
هل يدعم OpenAgentd اللغة العربية؟
الواجهة بالإنكليزية، لكن الوكيل يمكنه التحدث بالعربية إذا كان النموذج يدعمها (مثل Gemini أو Claude).
ما الفرق بين OpenAgentd وAutoGPT؟
AutoGPT أداة مستقلة تركز على أتمتة المهام، بينما OpenAgentd هو نظام تشغيل لوكلاء متعددين مع ذاكرة دائمة.
هل يمكن تشغيل OpenAgentd على سيرفر خاص؟
نعم، يمكنك تشغيله على سيرفر VPS وتعديل الإعدادات للسماح بالوصول عن بعد (احرص على تأمينه).
خاتمة
OpenAgentd يقدم طريقة جديدة لتشغيل وكلاء AI محلياً بسهولة نسبية. ابدأ بتجربته اليوم، وإذا واجهت مشكلة، راجع README الرسمي أو ابحث في مجتمع GitHub. لا تنس مشاركة تجربتك مع المطورين العرب.
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
تحميل المشروع
لماذا؟ للحصول على كود OpenAgentd من GitHub
كيف؟ افتح الطرفية واكتب: git clone https://github.com/lthoangg/OpenAgentd.git ثم cd OpenAgentd
الناتج: مجلد OpenAgentd على جهازك
إنشاء بيئة افتراضية
لماذا؟ لعزل تبعيات المشروع عن النظام
كيف؟ python -m venv venv ثم تفعيلها: ويندوز venv\Scripts\activate، ماك/لينكس source venv/bin/activate
الناتج: بيئة افتراضية نشطة
تثبيت المتطلبات
لماذا؟ لتثبيت المكتبات اللازمة (FastAPI, React, إلخ)
كيف؟ pip install -r requirements.txt
الناتج: تثبيت جميع التبعيات
إعداد ملف .env
لماذا؟ لتخزين مفاتيح API والإعدادات
كيف؟ cp .env.example .env ثم عدّل الملف بإضافة مفتاح API واحد على الأقل (مثل GOOGLE_API_KEY=AIzaSy...)
الناتج: ملف .env جاهز
تشغيل التطبيق
لماذا؟ لبدء خادم OpenAgentd
كيف؟ python main.py (أو حسب README)
الناتج: رسالة تشير إلى أن الخادم يعمل على http://localhost:8000
فتح الواجهة واختبار الوكيل
لماذا؟ للتفاعل مع الوكيل
كيف؟ افتح المتصفح على http://localhost:8000، اكتب استعلامًا مثل 'ما هو الطقس في الرياض؟'
الناتج: رد من الوكيل
قوالب جاهزة للنسخ
حوّل القراءة إلى تنفيذ سريع
# اختر مزود نموذج واحد على الأقل # مثال: Google Gemini (مجاني) GOOGLE_API_KEY=AIzaSy... # أو Claude من Anthropic ANTHROPIC_API_KEY=sk-ant-... # أو OpenAI OPENAI_API_KEY=sk-... # إعدادات إضافية (اختياري) # LOG_LEVEL=INFO # PORT=8000
أنت وكيل دعم فني لشركة سعودية. أجب على الاستفسارات التالية بلغة عربية فصحى مهذبة. الاستفسار: [أدخل استفسار العميل هنا]
مصفوفة الأخطاء
اعرف أين يتعثر الناس وكيف تتجنب ذلك
شجرة القرار
ماذا تفعل حسب حالتك؟
إذا: إذا كنت تريد خصوصية كاملة وتحكماً كاملاً
إذن: استخدم OpenAgentd محلياً
إذا: إذا كنت مبتدئاً ولا تريد التعامل مع سطر الأوامر
إذن: ابحث عن حلول جاهزة مثل ChatGPT أو Poe
إذا: إذا كنت تحتاج نماذج محلية مثل Llama
إذن: استخدم أدوات أخرى مثل Ollama أو LM Studio
إذا: إذا كان جهازك أقل من 8GB RAM
إذن: قد تواجه بطءً، جرب استخدام نماذج خفيفة أو خدمات سحابية
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
- اليوم 1: تحميل المشروع وإنشاء البيئة الافتراضية
- اليوم 2: تثبيت المتطلبات وإعداد ملف .env
- اليوم 3: تشغيل التطبيق واختبار الوكيل باستخدام نموذج مجاني
- اليوم 4: تجربة استخدامات عملية (مثل وكيل ردود العملاء)
- اليوم 5: استكشاف ميزة فريق الوكلاء (multi-agent)
- اليوم 6: تجربة دمج أداة خارجية (tool use) إن أمكن
- اليوم 7: توثيق التجربة ومشاركتها مع المجتمع
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
1. OpenAgentd مرخص تحت Apache 2.0، مجاني ومفتوح المصدر.
2. يدعم 15 مزود نموذج مختلف بما في ذلك Gemini وClaude وGPT.
3. يعمل على ويندوز، ماك، ولينكس.
4. يتطلب Python 3.14 أو أحدث.
5. يحتاج 8GB RAM و500MB مساحة تخزين.
6. الواجهة بالإنكليزية لكن الوكيل يمكنه التحدث بالعربية.
7. المشروع جديد نسبياً (أقل من 200 نجمة على GitHub).
8. لا يدعم النماذج المحلية مثل Llama حالياً.
9. يمكن تشغيله على سيرفر VPS للوصول عن بعد.
أسئلة شائعة
إجابات مباشرة على ما يبحث عنه الزائر
مصطلحات سريعة
تعريفات مختصرة تمنع الالتباس
برنامج يمكنه أداء مهام بشكل مستقل باستخدام نموذج لغوي، مثل الرد على الاستفسارات أو تحليل البيانات.
شركة تقدم نماذج ذكاء اصطناعي عبر API، مثل Google (Gemini) أو OpenAI (GPT).
قدرة الوكيل على تذكر المحادثات السابقة حتى بعد إعادة التشغيل.
ميزة تسمح للوكيل باستخدام أدوات خارجية مثل البحث في الويب أو قراءة الملفات.
مجموعة من الوكلاء يعملون معاً على مهمة واحدة، كل وكيل متخصص في جزء.
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من مطور يبحث عن حل جاهز وغير مكلف إلى مستخدم قادر على تشغيل وإدارة فريق وكلاء AI محلياً
- أتمتة الأعمال: استخدام OpenAgentd لأتمتة ردود العملاء
- تحليل البيانات: تشغيل وكيل لتحليل ملفات CSV
- التسويق الرقمي: إنشاء وكيل لكتابة محتوى تسويقي بالعربية
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
OpenAgentd يقدم طريقة جديدة لتشغيل وكلاء AI محلياً بسهولة نسبية. ابدأ بتجربته اليوم، وإذا واجهت مشكلة، راجع README الرسمي أو ابحث في مجتمع GitHub. لا تنس مشاركة تجربتك مع المطورين العرب.
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
- تحقق من تحديثات المشروع على GitHub أسبوعياً.
- راجع قائمة المزودين المدعومين كل شهر.
- اختبر التوافق مع أحدث إصدار من Python.
- حدّث ملف .env إذا حصلت على مفاتيح API جديدة.
- تابع مجتمع GitHub للمشروع للحصول على نصائح وحلول.
التعليقات (0)
لا توجد تعليقات بعد. كن أول من يبدأ النقاش 👇