OMEM: ذاكرة دائمة مشتركة لوكلاء الذكاء الاصطناعي – دليل تركيب وتشغيل عربي عملي
Shared Memory That Never Forgets — persistent memory for AI agents with Space-based sharing across agents and teams. Plugins for OpenCode, Claude Code, OpenClaw, MCP Server.
خريطة الصفحة
اختر القسم الذي تحتاجه الآن
- ما هو OMEM؟
- من يحتاج OMEM ومن لا؟
- المميزات الرئيسية
- المتطلبات قبل البدء
- تركيب OMEM باستخدام Docker
- شرح ملف .env والمتغيرات
- تشغيل OMEM واختبار API
- ربط OMEM مع Claude Code وOpenCode
- أخطاء شائعة وحلولها
- استخدامات عملية في السوق السعودي
- هل يستحق التجربة؟
- بدائل OMEM
قبل أن تطبق
الفكرة التي تمنع التسرع
وكلاء الذكاء الاصطناعي يعانون من فقدان الذاكرة كل جلسة، والذاكرة محصورة في جهاز واحد. OMEM يقدم حلاً مفتوح المصدر لذاكرة دائمة مشتركة.
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
- هل وكيل AI الخاص بك يبدأ كل محادثة من الصفر؟
- هل تحتاج إلى مشاركة الذاكرة بين عدة وكلاء أو أجهزة؟
- هل تبحث عن حل مفتوح المصدر ومجاني للذاكرة الدائمة؟
- هل لديك خبرة أساسية مع Docker و REST API؟
- هل تفضل التثبيت المحلي على الحلول السحابية المدفوعة؟
- هل تستخدم Claude Code أو OpenCode أو أدوات مشابهة؟
- هل تحتاج إلى دعم اللغة العربية في البحث الدلالي؟
نظام التشغيل: Input → Process → Output
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
هل سئمت من أن وكيل الذكاء الاصطناعي الخاص بك يبدأ كل محادثة من الصفر؟ هل تحتاج إلى ذاكرة مشتركة بين وكلاء متعددين؟ OMEM هو حل مفتوح المصدر يمنح وكلاء AI ذاكرة دائمة ومشتركة عبر الأجهزة والفريق. في هذا الدليل العملي، سنشرح لك كيفية تركيبه وتشغيله وربطه مع أدوات مثل Claude Code وOpenCode، مع أمثلة من السوق السعودي.
ما هو OMEM؟
OMEM (Our Memory) هو خادم ذاكرة دائمة ومشتركة لوكلاء الذكاء الاصطناعي. يسمح للوكلاء بحفظ واسترجاع المعلومات عبر الجلسات والأجهزة، مع دعم المساحات (Spaces) لعزل الذاكرة حسب المشروع أو الفريق. مبني بلغة Rust ويستخدم LanceDB للتخزين المتجه والبحث الدلالي.
من يحتاج OMEM ومن لا؟
من يحتاجه: مطورو وكلاء AI، فرق التطوير التي تستخدم عدة وكلاء، أصحاب المشاريع الصغيرة الذين يريدون ذاكرة دائمة بتكلفة منخفضة. من لا يحتاجه: من يستخدم وكيلاً واحداً بذاكرة جلسة قصيرة، أو من يفضل الحلول السحابية المدفوعة مثل Mem0.
المميزات الرئيسية
- ذاكرة دائمة عبر الجلسات والأجهزة
- مشاركة الذاكرة بين وكلاء متعددين (مساحات)
- بحث دلالي باستخدام المتجهات
- يدعم 44+ وكيلاً بما في ذلك Claude Code وOpenCode وCursor
- خادم خفيف مبني بـ Rust، يعمل عبر Docker
- مفتوح المصدر (رخصة NOASSERTION)
المتطلبات قبل البدء
- Docker مثبت على جهازك (أو VPS)
- مفتاح API من مزود تضمين (مثل OpenAI أو Bedrock) – اختياري إذا كنت تستخدم التضمين المحلي
- سطر أوامر (Terminal)
- معرفة أساسية بـ REST API
تركيب OMEM باستخدام Docker
أسهل طريقة لتشغيل OMEM هي عبر Docker. افتح Terminal وشغّل الأمر التالي:
docker run -d -p 8080:8080 ghcr.io/ourmem/omem-server:latestهذا يشغل الخادم على المنفذ 8080. إذا كنت تريد استخدام مزود تضمين خارجي (مثل Bedrock)، أضف متغير البيئة:
docker run -d -p 8080:8080 -e OMEM_EMBED_PROVIDER=bedrock ghcr.io/ourmem/omem-server:latestبعد التشغيل، ستحصل على مفتاح API يمكنك حفظه لإعادة الاتصال بنفس الذاكرة من أي جهاز.
شرح ملف .env والمتغيرات
إذا كنت تريد تخصيص الإعدادات، أنشئ ملف .env بالمحتوى التالي:
OMEM_API_KEY=your-api-key
OMEM_EMBED_PROVIDER=openai
OMEM_EMBED_API_KEY=sk-xxx
OMEM_DB_PATH=/data/omemشرح المتغيرات:
OMEM_API_KEY: مفتاح API للوصول إلى الخادم (يُولد تلقائياً إذا لم تحدده)OMEM_EMBED_PROVIDER: مزود التضمين (openai, bedrock, أو none للتضمين المحلي)OMEM_EMBED_API_KEY: مفتاح API لمزود التضمينOMEM_DB_PATH: مسار تخزين قاعدة البيانات (اختياري)
تشغيل OMEM واختبار API
بعد تشغيل الحاوية، يمكنك اختبار API باستخدام curl. لحفظ ذاكرة:
curl -s "$OMEM_API_URL/v1/memories" -H "X-API-Key: $OMEM_API_KEY" -H "Content-Type: application/json" -d '{"content":"المستخدم يفضل الوضع المظلم","space":"my-project"}'للبحث عن ذاكرة:
curl -s "$OMEM_API_URL/v1/memories/search?q=dark+mode" -H "X-API-Key: $OMEM_API_KEY"تأكد من تعيين OMEM_API_URL (مثلاً http://localhost:8080).
ربط OMEM مع Claude Code وOpenCode
OMEM يوفر إضافات (plugins) لكلود كود وأوبن كود. بعد تشغيل الخادم، اتبع تعليمات الإضافة في README. بشكل عام، تحتاج إلى تعيين متغير البيئة OMEM_API_KEY في بيئة الوكيل.
أخطاء شائعة وحلولها
استخدامات عملية في السوق السعودي
مثال 1: شركة دعم فني سعودية – تستخدم OMEM لتوحيد معرفة فريق الدعم. كل وكيل يحفظ حلول المشكلات الشائعة في مساحة مشتركة، مما يقلل وقت الحل بنسبة 30%.
مثال 2: مطور تطبيق سعودي – يربط OMEM مع Claude Code لحفظ تفضيلات المستخدم عبر الجلسات، فيقدم تجربة مخصصة دون الحاجة لقاعدة بيانات منفصلة.
هل يستحق التجربة؟
نعم، خاصة إذا كنت تبني وكلاء AI متعددين وتحتاج لذاكرة دائمة. OMEM مجاني ومفتوح المصدر، سهل التركيب عبر Docker، ويدعم العديد من الوكلاء. لكنه لا يزال مشروعاً جديداً (197 نجمة)، لذا قد تواجه بعض الثغرات.
بدائل OMEM
أسئلة شائعة
هل OMEM مجاني؟
نعم، المشروع مفتوح المصدر ومجاني تماماً. يمكنك تشغيله على خادمك الخاص دون أي تكلفة.
ما هي لغات البرمجة المدعومة؟
OMEM يقدم REST API، لذا يمكن استخدامه مع أي لغة تدعم HTTP. الإضافات الرسمية متاحة لكلود كود وأوبن كود (JavaScript/TypeScript).
هل يمكن استخدام OMEM مع ChatGPT؟
ليس بشكل مباشر، لكن يمكنك بناء وكيل وسيط يربط ChatGPT بـ OMEM عبر API.
ما هو LanceDB وما دوره؟
LanceDB هو قاعدة بيانات متجهة مفتوحة المصدر، تُستخدم لتخزين واسترجاع الذكريات كمتجهات للبحث الدلالي.
كيف أضمن أمان بياناتي مع OMEM؟
OMEM لا يشفر البيانات أثناء النقل افتراضياً. يُنصح باستخدام HTTPS عند النشر في الإنتاج، وتقييد الوصول إلى API بمفتاح قوي.
هل OMEM مناسب للمشاريع الصغيرة؟
نعم، خفيف وسهل التركيب، ويمكن تشغيله على VPS صغير أو حتى على جهاز محلي.
ما الفرق بين OMEM وMem0؟
OMEM يركز على مشاركة الذاكرة بين الوكلاء عبر المساحات، بينما Mem0 يركز على الذاكرة الفردية. OMEM مبني بـ Rust (أسرع)، وMem0 بـ Python.
هل يدعم OMEM اللغة العربية؟
يدعم تخزين النصوص العربية، لكن جودة البحث الدلالي تعتمد على نموذج التضمين المستخدم. يُفضل استخدام نموذج يدعم العربية مثل OpenAI ada-002.
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
تثبيت Docker
لماذا؟ Docker هو الطريقة الموصى بها لتشغيل OMEM بسهولة.
كيف؟ اتبع التعليمات الرسمية لتثبيت Docker على نظامك (Windows/Mac/Linux).
الناتج: Docker مثبت ويعمل.
تشغيل خادم OMEM
لماذا؟ لتشغيل OMEM كخدمة خلفية.
كيف؟ شغّل الأمر: docker run -d -p 8080:8080 ghcr.io/ourmem/omem-server:latest
الناتج: خادم OMEM يعمل على المنفذ 8080.
الحصول على مفتاح API
لماذا؟ مطلوب للاتصال بالخادم.
كيف؟ بعد التشغيل، سترى مفتاح API في سجلات الحاوية. احفظه.
الناتج: مفتاح API محفوظ.
اختبار API
لماذا؟ للتأكد من أن الخادم يعمل بشكل صحيح.
كيف؟ استخدم curl لحفظ ذاكرة: curl -s "http://localhost:8080/v1/memories" -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{"content":"test","space":"test"}'
الناتج: استجابة JSON تؤكد الحفظ.
ربط OMEM مع Claude Code
لماذا؟ لتمكين الذاكرة الدائمة في Claude Code.
كيف؟ اتبع تعليمات الإضافة في README، ثم عيّن متغير البيئة OMEM_API_KEY.
الناتج: Claude Code يستخدم OMEM للذاكرة.
تطبيق عملي: فريق دعم سعودي
لماذا؟ لتوحيد معرفة الفريق وتقليل وقت الحل.
كيف؟ أنشئ مساحة (space) باسم "support"، واطلب من كل وكيل حفظ الحلول فيها.
الناتج: ذاكرة مشتركة لفريق الدعم.
قوالب جاهزة للنسخ
حوّل القراءة إلى تنفيذ سريع
curl -s "$OMEM_API_URL/v1/memories" -H "X-API-Key: $OMEM_API_KEY" -H "Content-Type: application/json" -d '{"content":"المستخدم يفضل الوضع المظلم","space":"my-project"}'curl -s "$OMEM_API_URL/v1/memories/search?q=dark+mode" -H "X-API-Key: $OMEM_API_KEY"
OMEM_API_KEY=your-api-key OMEM_EMBED_PROVIDER=openai OMEM_EMBED_API_KEY=sk-xxx OMEM_DB_PATH=/data/omem
مصفوفة الأخطاء
اعرف أين يتعثر الناس وكيف تتجنب ذلك
شجرة القرار
ماذا تفعل حسب حالتك؟
إذا: إذا كنت تستخدم وكيلاً واحداً ولا تحتاج لذاكرة دائمة
إذن: لا تحتاج OMEM، استخدم ذاكرة الجلسة الافتراضية.
إذا: إذا كنت تحتاج لذاكرة مشتركة بين عدة وكلاء
إذن: OMEM مناسب، استخدم المساحات (Spaces).
إذا: إذا كنت تفضل حلاً سحابياً مدفوعاً
إذن: فكر في Mem0 أو Zep بدلاً من OMEM.
إذا: إذا كنت تحتاج دعم اللغة العربية في البحث
إذن: استخدم مزود تضمين يدعم العربية مثل OpenAI ada-002.
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
- اليوم 1: تثبيت Docker وتشغيل OMEM
- اليوم 2: اختبار API الأساسي (حفظ وبحث)
- اليوم 3: ربط OMEM مع Claude Code أو OpenCode
- اليوم 4: إنشاء مساحة لمشروعك وتخزين ذكريات حقيقية
- اليوم 5: اختبار البحث الدلالي وتحسين التضمين
- اليوم 6: تطبيق حالة استخدام سعودية (مثل فريق الدعم)
- اليوم 7: مراجعة الأداء وتوثيق الإعدادات
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
1. OMEM مبني بلغة Rust، مما يجعله خفيفاً وسريعاً.
2. يستخدم LanceDB كقاعدة بيانات متجهة مفتوحة المصدر.
3. يدعم 44+ وكيلاً بما في ذلك Claude Code وOpenCode وCursor.
4. يمكن تشغيله على VPS صغير أو جهاز محلي.
5. المشروع حصل على 197 نجمة على GitHub (حتى كتابة الدليل).
6. رخصة المشروع NOASSERTION (مفتوح المصدر).
7. لا يشفر البيانات أثناء النقل افتراضياً، يُنصح باستخدام HTTPS.
8. يدعم التضمين المحلي دون الحاجة لمفتاح API خارجي.
9. يمكن استخدامه مع أي لغة برمجة عبر REST API.
أسئلة شائعة
إجابات مباشرة على ما يبحث عنه الزائر
مصطلحات سريعة
تعريفات مختصرة تمنع الالتباس
خادم ذاكرة دائمة ومشتركة لوكلاء الذكاء الاصطناعي، مفتوح المصدر.
قاعدة بيانات متجهة مفتوحة المصدر تستخدم لتخزين الذكريات كمتجهات.
مجموعة ذكريات معزولة لمشروع أو فريق معين.
تحويل النص إلى متجه رقمي للبحث الدلالي.
واجهة برمجة تطبيقات تعتمد على HTTP لتبادل البيانات.
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من مطور يعاني من فقدان ذاكرة وكلاء AI إلى مطور قادر على بناء نظام ذاكرة دائمة ومشتركة
- يمكن ربط OMEM مع أنظمة إدارة المعرفة مثل Confluence عبر API
- مشابه لمفهوم الذاكرة في أطر RAG
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
OMEM يقدم حلاً عملياً ومفتوح المصدر لمشكلة فقدان الذاكرة لوكلاء AI. بفضل سهولة التركيب عبر Docker ودعمه للعديد من الوكلاء، يمكنك البدء في دقائق. جربه اليوم وشارك تجربتك مع المجتمع العربي.
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
- تحقق من إصدار OMEM الجديد كل شهر.
- تحديث قائمة الوكلاء المدعومين عند إضافة دعم جديد.
- مراجعة بدائل OMEM (مثل Mem0) كل 6 أشهر.
- تحديث أمثلة السوق السعودي بناءً على تجارب المستخدمين.
التعليقات (0)
لا توجد تعليقات بعد. كن أول من يبدأ النقاش 👇