دليل elizaOS: بناء وكيل ذكاء اصطناعي عربي عملي خطوة بخطوة من GitHub
Open source agentic operating system
خريطة الصفحة
اختر القسم الذي تحتاجه الآن
- ما هو elizaOS؟
- من يحتاج elizaOS ومن لا؟
- المميزات الرئيسية
- المتطلبات الأساسية
- تركيب elizaOS خطوة بخطوة
- شرح ملف .env وإعداد المفاتيح
- تشغيل الوكيل لأول مرة
- أخطاء شائعة وحلولها
- استخدامات عملية في السوق السعودي
- هل يستحق التجربة؟
- بدائل مشابهة
- أسئلة شائعة
قبل أن تطبق
الفكرة التي تمنع التسرع
تعتقد أن بناء وكيل ذكاء اصطناعي يتطلب فريقاً وموارد ضخمة؟ elizaOS يثبت العكس: وكيل متكامل يعمل على تلغرام وديسكورد بخطوات بسيطة ومفتوح المصدر بالكامل.
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
- هل لديك حساب تلغرام أو ديسكورد لربط الوكيل؟
- هل تمتلك مفتاح API من OpenAI أو مزود LLM آخر؟
- هل جهازك مثبت عليه Node.js 18+ أو Bun؟
- هل تريد وكيلاً يعمل بالعربية؟
- هل تحتاج إلى قاعدة معرفة مخصصة (RAG)؟
- هل لديك خبرة في تعديل ملفات .env؟
نظام التشغيل: Input → Process → Output
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت تبحث عن طريقة لبناء وكيل ذكاء اصطناعي يعمل على تلغرام وديسكورد دون تعقيد، فـ elizaOS هو الحل. هذا الإطار مفتوح المصدر يتيح لك إنشاء وكلاء أذكياء بخطوات بسيطة، ويدعم ربطهم بقواعد البيانات والخدمات الخارجية. في هذا الدليل العملي، ستتعلم كيفية تركيبه وتشغيله مع أمثلة عربية واقعية.
elizaOS ليس مجرد أداة عادية؛ إنه نظام تشغيل للوكلاء الأذكياء (Agentic Operating System) يسمح لك ببناء وكيل واحد يعمل عبر منصات متعددة. سواء كنت مطوراً مبتدئاً أو صاحب مشروع صغير، ستجد في هذا الدليل كل ما تحتاج لبدء تجربتك.
ما هو elizaOS؟
elizaOS هو إطار عمل مفتوح المصدر (رخصة MIT) لبناء ونشر وكلاء ذكاء اصطناعي ذاتيين التشغيل. مبني بلغة TypeScript، ويدعم التكامل مع تلغرام، ديسكورد، Farcaster، وغيرها. يوفر واجهة سطر أوامر (CLI) وواجهة ويب لإدارة الوكلاء. يتميز بدعم RAG (توليد معزز بالاسترجاع) ونظام plugins مرن.
من يحتاج elizaOS ومن لا؟
يناسبك إذا: تريد وكيل AI يعمل على منصات متعددة، تحتاج أتمتة محادثات، تبحث عن إطار مفتوح المصدر قابل للتخصيص، لديك خبرة بسيطة في سطر الأوامر وملفات .env.
لا يناسبك إذا: تريد حلاً جاهزاً بدون برمجة، تحتاج دعماً فنياً تجارياً، أو تريد وكيلاً يعمل بدون أي تكلفة API (elizaOS يحتاج مفتاح LLM).
المميزات الرئيسية
- اتصال جاهز بـ Telegram، Discord، Farcaster، Slack
- دعم نماذج LLM متعددة: OpenAI، Anthropic، نماذج محلية
- نظام plugins لتوسيع الوظائف (مثلاً: بحث، تقويم، قاعدة معرفة)
- RAG مدمج للإجابة عن أسئلة تعتمد على وثائقك
- واجهة ويب لإدارة الوكلاء
- دعم Swarm (سرب وكلاء) للتعاون بين وكلاء متعددين
المتطلبات الأساسية
- Node.js (إصدار 18+) أو Bun (موصى به)
- Git
- مفتاح API من مزود LLM (مثل OpenAI)
- حساب تلغرام أو ديسكورد (اختياري للربط)
تركيب elizaOS خطوة بخطوة
- تثبيت Bun: اتبع التعليمات من
https://bun.shأو استخدمnpm install -g bun - استنساخ المشروع:
git clone --filter=blob:none https://github.com/elizaos/eliza.git - الدخول إلى المجلد:
cd eliza - تثبيت الاعتماديات:
bun install - بناء المشروع:
bun run build
شرح ملف .env وإعداد المفاتيح
انسخ ملف .env.example إلى .env وعدّل القيم التالية:
# مفتاح OpenAI (إلزامي إذا كنت تستخدم GPT)
OPENAI_API_KEY=sk-xxxxx
# إعدادات تلغرام (اختياري)
TELEGRAM_BOT_TOKEN=xxxxx
# إعدادات ديسكورد (اختياري)
DISCORD_BOT_TOKEN=xxxxx
يمكنك استخدام مزود آخر مثل Anthropic بإضافة ANTHROPIC_API_KEY.
تشغيل الوكيل لأول مرة
لتشغيل الوكيل مع واجهة ويب: bun run dev
لتشغيل الوكيل عبر سطر الأوامر: OPENAI_API_KEY=your_key bun run packages/examples/chat/chat.ts
لتشغيل وضع المحاكاة مع قاعدة بيانات محلية: bun run cloud:mock
أخطاء شائعة وحلولها
استخدامات عملية في السوق السعودي
مثال 1: وكيل خدمة عملاء لمتجر إلكتروني سعودي
اربط الوكيل بتلغرام، وأضف قاعدة معرفة بالمنتجات والأسعار باستخدام RAG. سيرد الوكيل على استفسارات العملاء عن التوفر والشحن.
مثال 2: وكيل إدارة حسابات التواصل
استخدم ديسكورد لنشر وجدولة المحتوى. الوكيل يمكنه استقبال أوامر مثل /post و/schedule.
مثال 3: وكيل بحث ذكي للشركات
اربط الوكيل بمستندات الشركة (PDF, Word) باستخدام RAG، ليصبح مساعداً ذكياً يجيب عن أسئلة الموظفين.
هل يستحق التجربة؟
نعم، خاصة إذا كنت تبحث عن إطار مفتوح المصدر ومرن. لكن ضع في اعتبارك أنك ستحتاج إلى مفتاح API (تكلفة حسب الاستخدام) وأن الدعم المجتمعي لا يزال في بداياته. المشروع نشط جداً (أكثر من 18 ألف نجمة) ومحدث باستمرار.
بدائل مشابهة
أسئلة شائعة
هل أحتاج إلى خبرة برمجية لاستخدام elizaOS؟
تحتاج معرفة أساسية بسطر الأوامر وملفات التكوين. لا تحتاج لكتابة كود معقد.
ما هي تكلفة تشغيل elizaOS؟
elizaOS مجاني، لكن استخدام API (مثل OpenAI) يكلف حسب الاستخدام. يمكنك استخدام نماذج محلية مجانية.
هل يدعم elizaOS اللغة العربية؟
نعم، إذا كان النموذج اللغوي يدعم العربية (مثل GPT-4).
كيف أربط elizaOS مع تلغرام؟
أنشئ بوت تلغرام واحصل على التوكن، ثم أضفه في ملف .env كـ TELEGRAM_BOT_TOKEN.
ما الفرق بين elizaOS وCrewAI؟
elizaOS يركز على وكلاء متعددي المنصات، بينما CrewAI يركز على سرب وكلاء يتعاونون في مهام معقدة.
هل يمكن استخدام elizaOS بدون OpenAI؟
نعم، يدعم Anthropic ونماذج محلية عبر Ollama.
ماذا أفعل إذا ظهر خطأ في تثبيت Bun؟
جرب استخدام npm: npm install -g bun أو استخدم Node.js مع npm.
كيف أضيف plugin جديد إلى elizaOS؟
اتبع دليل plugins في الوثائق الرسمية: docs.elizaos.ai
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
تثبيت Bun
لماذا؟ Bun أسرع من npm ويوفر توافقاً أفضل مع elizaOS
كيف؟ افتح الطرفية وشغل: npm install -g bun
الناتج: تأكيد التثبيت عبر الأمر bun --version
استنساخ المشروع
لماذا؟ تحميل كود elizaOS من GitHub
كيف؟ git clone --filter=blob:none https://github.com/elizaos/eliza.git && cd eliza
الناتج: ظهور مجلد eliza في المسار الحالي
تثبيت الاعتماديات
لماذا؟ تحميل المكتبات المطلوبة لتشغيل المشروع
كيف؟ bun install
الناتج: ظهور رسالة نجاح التثبيت
بناء المشروع
لماذا؟ تجميع الكود وجاهزيته للتشغيل
كيف؟ bun run build
الناتج: ظهور مجلد dist أو رسالة Build successful
إعداد ملف .env
لماذا؟ تحديد مفاتيح API والإعدادات
كيف؟ انسخ .env.example إلى .env ثم عدّل OPENAI_API_KEY=sk-xxxx وأضف TELEGRAM_BOT_TOKEN إن أردت
الناتج: ملف .env جاهز بالقيم الصحيحة
تشغيل الوكيل
لماذا؟ اختبار الوكيل والتفاعل معه
كيف؟ bun run dev (لواجهة ويب) أو OPENAI_API_KEY=your_key bun run packages/examples/chat/chat.ts (لسطر الأوامر)
الناتج: ظهور رسالة أن الوكيل يعمل على منفذ معين
قوالب جاهزة للنسخ
حوّل القراءة إلى تنفيذ سريع
OPENAI_API_KEY=sk-xxxxx TELEGRAM_BOT_TOKEN=xxxxx DISCORD_BOT_TOKEN=xxxxx ANTHROPIC_API_KEY=sk-ant-xxxxx
git clone --filter=blob:none https://github.com/elizaos/eliza.git && cd eliza && bun install && bun run build && cp .env.example .env && nano .env
مصفوفة الأخطاء
اعرف أين يتعثر الناس وكيف تتجنب ذلك
شجرة القرار
ماذا تفعل حسب حالتك؟
إذا: إذا كنت تريد وكيلاً على تلغرام
إذن: أضف TELEGRAM_BOT_TOKEN في .env واستخدم bun run dev
إذا: إذا كنت تريد وكيلاً على ديسكورد
إذن: أضف DISCORD_BOT_TOKEN في .env واستخدم bun run dev
إذا: إذا كنت تريد وكيلاً بدون API مدفوع
إذن: استخدم نموذجاً محلياً عبر Ollama بدلاً من OpenAI
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
- اليوم 1: تثبيت Bun واستنساخ المشروع
- اليوم 2: تثبيت الاعتماديات وبناء المشروع
- اليوم 3: إعداد .env وتشغيل الوكيل عبر سطر الأوامر
- اليوم 4: ربط الوكيل بتلغرام واختبار الردود
- اليوم 5: إضافة قاعدة معرفة (RAG) باستخدام plugin
- اليوم 6: اختبار الوكيل باللغة العربية مع أمثلة سعودية
- اليوم 7: نشر الوكيل على خادم (مثل VPS) وتشغيله باستمرار
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
1. elizaOS مبني بلغة TypeScript ومرخص تحت MIT.
2. يدعم التكامل مع Telegram, Discord, Farcaster, Slack.
3. يمكن استخدامه مع OpenAI, Anthropic, أو نماذج محلية.
4. يحتوي على نظام plugins لتوسيع الوظائف.
5. يدعم RAG (توليد معزز بالاسترجاع) للإجابة من وثائقك.
6. واجهة ويب لإدارة الوكلاء متوفرة.
7. يدعم Swarm (سرب وكلاء) للتعاون بين وكلاء متعددين.
8. أكثر من 18 ألف نجمة على GitHub.
أسئلة شائعة
إجابات مباشرة على ما يبحث عنه الزائر
مصطلحات سريعة
تعريفات مختصرة تمنع الالتباس
توليد معزز بالاسترجاع: تقنية تسمح للوكيل بالبحث في وثائقك والإجابة بناءً عليها.
إضافة توسع وظائف الوكيل، مثل البحث أو التقويم.
سرب وكلاء: مجموعة من الوكلاء يتعاونون لأداء مهام معقدة.
واجهة سطر أوامر: طريقة للتفاعل مع البرنامج عبر كتابة أوامر نصية.
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من مطور يبحث عن شرح عربي عملي إلى مستخدم قادر على تركيب وتشغيل وكيل ذكاء اصطناعي متكامل
- يمكن ربط elizaOS مع Zapier لأتمتة سير العمل
- يمكن استخدام elizaOS مع Supabase لتخزين البيانات
- يمكن دمج elizaOS مع منصات التجارة الإلكترونية مثل Shopify
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
elizaOS يقدم لك فرصة حقيقية لبناء وكيل ذكاء اصطناعي متكامل دون تعقيد. ابدأ بخطوات التركيب البسيطة، وجرب الأمثلة العملية، وسترى كيف يمكن لهذه الأداة أن تحول طريقة عملك. تذكر أن المفتاح هو التجربة المستمرة والاستفادة من المجتمع النشط حول المشروع.
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
- تحديث روابط GitHub كل شهر
- مراجعة إصدارات Node.js و Bun الموصى بها كل 3 أشهر
- إضافة أمثلة جديدة للسوق السعودي كل 6 أشهر
- تحديث قائمة البدائل عند ظهور أدوات جديدة
التعليقات (0)
لا توجد تعليقات بعد. كن أول من يبدأ النقاش 👇