إذا كنت مطوراً عربياً وتبحث عن إطار عمل مفتوح المصدر لبناء وكيل ذكاء اصطناعي (AI Agent) يمكنك تخصيصه وتشغيله محلياً، فإن ElizaOS هو أحد أبرز الخيارات حالياً. المشروع نشط على GitHub مع أكثر من 18 ألف نجمة، ويوفر بنية مرنة تدعم ربط الوكيل بـ Telegram وDiscord وFarcaster، مع إمكانية استخدام نماذج لغوية مختلفة مثل OpenAI وAnthropic.

في هذا الدليل العملي، سنأخذك خطوة بخطوة من استنساخ المستودع إلى تشغيل وكيل يتحدث العربية، مع شرح ملف .env، وأمثلة استخدام تناسب السوق السعودي، وحلول للأخطاء الشائعة. لن ننسخ README حرفياً، بل سنقدم لك دليلاً عربياً أصيلاً يركز على الجانب التطبيقي.

ما هو ElizaOS؟

ElizaOS هو إطار عمل مفتوح المصدر (رخصة MIT) لبناء ونشر وكلاء ذكاء اصطناعي مستقلين. مكتوب بلغة TypeScript ويعمل على بيئة Bun. يوفر الإطار اتصالات جاهزة مع منصات مثل Telegram وDiscord وFarcaster، ويدعم نماذج لغوية متعددة (OpenAI، Anthropic، Llama). يمكن استخدامه لبناء روبوتات محادثة، وكلاء أتمتة أعمال، أو شخصيات NPC في الألعاب.

من يحتاج هذا المشروع؟ ومن لا يحتاجه؟

يناسبك إذا: كنت مطوراً متوسط الخبرة في TypeScript وBun، وتبحث عن إطار عمل مرن لبناء وكيل AI يمكن ربطه بسهولة بـ Telegram أو Discord. أيضاً إذا كنت تريد تجربة تقنيات RAG أو تشغيل وكيل على خادم رخيص.

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

المميزات الرئيسية

• اتصالات جاهزة: Discord، Telegram، Farcaster، والمزيد.
• دعم نماذج لغوية متعددة: OpenAI، Anthropic، Llama، وغيرها.
• بنية معيارية: إضافات (plugins) لتوسيع الوظائف.
• ذاكرة عبر PGlite (SQLite) أو Supabase.
• واجهة CLI وWeb UI لتشغيل الوكيل.
• رخصة MIT مفتوحة المصدر بالكامل.

المتطلبات الأساسية

• Node.js (إصدار 20 أو أحدث)
• Bun (أداة تشغيل JavaScript)
• Git
• مفتاح API من مزود LLM (مثل OpenAI)
• نظام تشغيل: macOS، Linux، أو Windows (مع WSL)

خطوات التركيب والتشغيل

1. استنساخ المستودع:
   git clone --filter=blob:none https://GitHub.com/elizaos/eliza.git
cd eliza
2. تثبيت الاعتماديات:
   bun install
3. إعداد ملف .env:
   انسخ ملف .env.example إلى .env وأضف مفتاح API الخاص بك:
   OPENAI_API_KEY=sk-xxxx
4. تشغيل الوكيل:
   bun run dev
5. تجربة المحادثة:
   افتح متصفحاً على http://localhost:3000 أو استخدم CLI:
   OPENAI_API_KEY=your_key bun run packages/examples/chat/chat.ts

شرح ملف .env والمتغيرات المطلوبة

ملف .env يحتوي على إعدادات حساسة مثل مفاتيح API. المتغير الأساسي هو OPENAI_API_KEY. يمكنك أيضاً إضافة مفاتيح لخدمات أخرى مثل Anthropic أو Discord Bot Token. مثال:

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
DISCORD_BOT_TOKEN=your_discord_token
TELEGRAM_BOT_TOKEN=your_telegram_token

تنبيه: لا تشارك ملف .env أبداً، وأضفه إلى .gitignore.

تشغيل الوكيل وتجربة المحادثة

بعد تشغيل bun run dev، ستظهر واجهة مستخدم على http://localhost:3000. يمكنك إرسال استعلام مثل "ما هو الطقس في الرياض؟" وسيجيب الوكيل بناءً على النموذج اللغوي. لتجربة المحادثة عبر الطرفية، استخدم الأمر:

OPENAI_API_KEY=sk-xxxx bun run packages/examples/chat/chat.ts

سيطلب منك إدخال نص، اكتب استعلامك واضغط Enter.

أخطاء شائعة وحلولها

استخدامات عملية في السوق السعودي

• خدمة عملاء لمتجر إلكتروني: وكيل يرد على استفسارات العملاء عبر Telegram أو واتساب، مع إمكانية ربطه بقاعدة بيانات المنتجات.
• مساعد شخصي: وكيل يدير مهامك اليومية مثل جدولة المواعيد وإرسال التذكيرات.
• بوت Telegram لمجتمع تقني: وكيل يجيب عن أسئلة الأعضاء ويساعد في الإشراف.

هل يستحق التجربة؟

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

بدائل مشابهة

• AutoGPT: يركز على الأتمتة الذاتية، لكنه أقل مرونة في الربط مع المنصات.
• LangChain: إطار عمل أشمل لبناء تطبيقات LLM، لكنه أكثر تعقيداً ويتطلب تكاملاً يدوياً أكبر.
• SuperAGI: منصة مفتوحة المصدر مع واجهة رسومية، لكنها أقل نشاطاً من ElizaOS.

أسئلة شائعة (FAQ)

هل أحتاج إلى حساب OpenAI لاستخدام ElizaOS؟

نعم، تحتاج إلى مفتاح API من مزود LLM، وOpenAI هو الأسهل للبدء. يمكنك أيضاً استخدام Anthropic أو نماذج محلية عبر Ollama.

ما هي لغة البرمجة المستخدمة في ElizaOS؟

TypeScript، مع بيئة تشغيل Bun.

هل يمكن تشغيل ElizaOS على خادم رخيص؟

نعم، يمكن تشغيله على VPS صغير (1-2 جيجابايت RAM) إذا استخدمت نموذجاً خفيفاً مثل GPT-3.5 أو Llama محلي.

كيف أضيف قدرات جديدة للوكيل؟

عبر كتابة إضافات (plugins) بلغة TypeScript. راجع دليل المطورين في المستودع.

هل يدعم ElizaOS اللغة العربية؟

الوكيل يفهم العربية إذا كان النموذج اللغوي يدعمها (GPT-4 مثلاً)، لكن الـ system prompt والواجهة بالإنكليزية. يمكنك تخصيص prompt بالعربية.

ما الفرق بين ElizaOS و AutoGPT؟

ElizaOS يركز على البنية المعيارية والربط بالمنصات، بينما AutoGPT يركز على الأتمتة الذاتية وحل المشكلات المعقدة.

هل المشروع مستقر للإنتاج؟

لا، المشروع في مرحلة تطوير نشطة (إصدارات متكررة). يمكن استخدامه للتجارب والمشاريع الصغيرة، لكنه يحتاج اختباراً دقيقاً للإنتاج.

خاتمة

ElizaOS يقدم لك فرصة لبناء وكيل ذكاء اصطناعي عملي بأقل جهد. ابدأ بتجربته محلياً، ثم جرب ربطه بـ Telegram أو Discord. تذكر أن تتابع المستودع للتحديثات، ولا تتردد في المشاركة في المجتمع. إذا واجهت أي مشكلة، ارجع إلى هذا الدليل أو افتح issue على GitHub.