Reference OS v8 5 دقائق قراءة ٢٠ مايو ٢٠٢٦ دليل تركيبي عملي لمشروع GitHub حديث 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 هو حل مفتوح المصدر يمنح وكلاء AI ذاكرة دائمة ومشتركة عبر الأجهزة والفريق. في هذا الدليل العملي، سنشرح لك كيفية تركيبه وتشغيله وربطه مع أدوات مثل Claude Code وOpenCode، مع أمثلة من السوق السعودي.
OMEM (Our Memory) هو خادم ذاكرة دائمة ومشتركة لوكلاء الذكاء الاصطناعي. يسمح للوكلاء بحفظ واسترجاع المعلومات عبر الجلسات والأجهزة، مع دعم المساحات (Spaces) لعزل الذاكرة حسب المشروع أو الفريق. مبني بلغة Rust ويستخدم LanceDB للتخزين المتجه والبحث الدلالي.
من يحتاجه: مطورو وكلاء AI، فرق التطوير التي تستخدم عدة وكلاء، أصحاب المشاريع الصغيرة الذين يريدون ذاكرة دائمة بتكلفة منخفضة. من لا يحتاجه: من يستخدم وكيلاً واحداً بذاكرة جلسة قصيرة، أو من يفضل الحلول السحابية المدفوعة مثل Mem0.
أسهل طريقة لتشغيل 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 بالمحتوى التالي:
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: مسار تخزين قاعدة البيانات (اختياري)بعد تشغيل الحاوية، يمكنك اختبار 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 يوفر إضافات (plugins) لكلود كود وأوبن كود. بعد تشغيل الخادم، اتبع تعليمات الإضافة في README. بشكل عام، تحتاج إلى تعيين متغير البيئة OMEM_API_KEY في بيئة الوكيل.
مثال 1: شركة دعم فني سعودية – تستخدم OMEM لتوحيد معرفة فريق الدعم. كل وكيل يحفظ حلول المشكلات الشائعة في مساحة مشتركة، مما يقلل وقت الحل بنسبة 30%.
مثال 2: مطور تطبيق سعودي – يربط OMEM مع Claude Code لحفظ تفضيلات المستخدم عبر الجلسات، فيقدم تجربة مخصصة دون الحاجة لقاعدة بيانات منفصلة.
نعم، خاصة إذا كنت تبني وكلاء AI متعددين وتحتاج لذاكرة دائمة. OMEM مجاني ومفتوح المصدر، سهل التركيب عبر Docker، ويدعم العديد من الوكلاء. لكنه لا يزال مشروعاً جديداً (197 نجمة)، لذا قد تواجه بعض الثغرات.
نعم، المشروع مفتوح المصدر ومجاني تماماً. يمكنك تشغيله على خادمك الخاص دون أي تكلفة.
OMEM يقدم REST API، لذا يمكن استخدامه مع أي لغة تدعم HTTP. الإضافات الرسمية متاحة لكلود كود وأوبن كود (JavaScript/TypeScript).
ليس بشكل مباشر، لكن يمكنك بناء وكيل وسيط يربط ChatGPT بـ OMEM عبر API.
LanceDB هو قاعدة بيانات متجهة مفتوحة المصدر، تُستخدم لتخزين واسترجاع الذكريات كمتجهات للبحث الدلالي.
OMEM لا يشفر البيانات أثناء النقل افتراضياً. يُنصح باستخدام HTTPS عند النشر في الإنتاج، وتقييد الوصول إلى API بمفتاح قوي.
نعم، خفيف وسهل التركيب، ويمكن تشغيله على VPS صغير أو حتى على جهاز محلي.
OMEM يركز على مشاركة الذاكرة بين الوكلاء عبر المساحات، بينما Mem0 يركز على الذاكرة الفردية. OMEM مبني بـ Rust (أسرع)، وMem0 بـ Python.
يدعم تخزين النصوص العربية، لكن جودة البحث الدلالي تعتمد على نموذج التضمين المستخدم. يُفضل استخدام نموذج يدعم العربية مثل OpenAI ada-002.
خطوات عملية مرتبة من التشخيص إلى النتيجة
لماذا؟ Docker هو الطريقة الموصى بها لتشغيل OMEM بسهولة.
كيف؟ اتبع التعليمات الرسمية لتثبيت Docker على نظامك (Windows/Mac/Linux).
الناتج: Docker مثبت ويعمل.
لماذا؟ لتشغيل OMEM كخدمة خلفية.
كيف؟ شغّل الأمر: docker run -d -p 8080:8080 ghcr.io/ourmem/omem-server:latest
الناتج: خادم OMEM يعمل على المنفذ 8080.
لماذا؟ مطلوب للاتصال بالخادم.
كيف؟ بعد التشغيل، سترى مفتاح 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 تؤكد الحفظ.
لماذا؟ لتمكين الذاكرة الدائمة في 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.
جدول صغير يمنع التسويف
نقاط مختصرة ترجع لها لاحقاً
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 يقدم حلاً عملياً ومفتوح المصدر لمشكلة فقدان الذاكرة لوكلاء AI. بفضل سهولة التركيب عبر Docker ودعمه للعديد من الوكلاء، يمكنك البدء في دقائق. جربه اليوم وشارك تجربتك مع المجتمع العربي.
حتى يبقى المرجع صالحاً مع الوقت
FAQ
استمر في القراءة
