ذاكرة Honcho

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

# ما الذي يقدمه

• ذاكرة عابرة للجلسات -- تُحفَظ المحادثات بعد كل دور، بحيث يستمر السياق عبر إعادة تعيين الجلسات، وCompaction، وتبديل القنوات.
• نمذجة المستخدم -- يحتفظ Honcho بملف تعريف لكل مستخدم (التفضيلات، والحقائق، وأسلوب التواصل) وكذلك للوكيل (الشخصية، والسلوكيات المتعلمة).
• البحث الدلالي -- بحث في الملاحظات المستخلصة من المحادثات السابقة، وليس الجلسة الحالية فقط.
• وعي متعدد الوكلاء -- يتتبع الوكلاء الأساسيون تلقائيًا الوكلاء الفرعيين الذين يتم تشغيلهم، مع إضافة الوكلاء الأساسيين كمراقبين في جلسات الوكلاء الفرعيين.

# الأدوات المتاحة

يسجل Honcho أدوات يمكن للوكيل استخدامها أثناء المحادثة:

استرجاع البيانات (سريع، من دون استدعاء LLM):

الأداة	ما الذي تفعله
honcho_context	التمثيل الكامل للمستخدم عبر الجلسات
honcho_search_conclusions	بحث دلالي في الاستنتاجات المخزنة
honcho_search_messages	العثور على الرسائل عبر الجلسات (تصفية حسب المرسل والتاريخ)
honcho_session	سجل الجلسة الحالية وملخصها

سؤال وجواب (مدعوم بـ LLM):

الأداة	ما الذي تفعله
honcho_ask	اطرح سؤالًا عن المستخدم. استخدم depth='quick' للحقائق، و'thorough' للتركيب

# البدء

ثبّت Plugin وشغّل الإعداد:

openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force

يطلب أمر الإعداد بيانات اعتماد API الخاصة بك، ويكتب التكوين، ويعرض اختياريًا ترحيل ملفات ذاكرة مساحة العمل الموجودة.

# التكوين

توجد الإعدادات تحت plugins.entries["openclaw-honcho"].config:

{
  plugins: {
    entries: {
      "openclaw-honcho": {
        config: {
          apiKey: "your-api-key", // احذفه في حالة الاستضافة الذاتية
          workspaceId: "openclaw", // عزل الذاكرة
          baseUrl: "https://api.honcho.dev",
        },
      },
    },
  },
}

بالنسبة إلى النُسخ المستضافة ذاتيًا، وجّه baseUrl إلى الخادم المحلي لديك (على سبيل المثال http://localhost:8000) واحذف مفتاح API.

# ترحيل الذاكرة الموجودة

إذا كانت لديك ملفات ذاكرة موجودة في مساحة العمل (USER.md وMEMORY.md، وIDENTITY.md، وmemory/، وcanvas/)، فإن openclaw honcho setup يكتشفها ويعرض ترحيلها.

# كيف يعمل

بعد كل دور للذكاء الاصطناعي، تُحفَظ المحادثة في Honcho. تتم ملاحظة رسائل المستخدم والوكيل معًا، مما يسمح لـ Honcho ببناء نماذجه وتحسينها مع مرور الوقت.

أثناء المحادثة، تستعلم أدوات Honcho من الخدمة في مرحلة before_prompt_build، وتحقن السياق ذي الصلة قبل أن يرى النموذج المطالبة. وهذا يضمن دقة حدود الأدوار وملاءمة الاسترجاع.

# Honcho مقابل الذاكرة المدمجة

	المدمجة / QMD	Honcho
التخزين	ملفات Markdown في مساحة العمل	خدمة مخصصة (محلية أو مستضافة)
عبر الجلسات	عبر ملفات الذاكرة	تلقائي، ومضمّن
نمذجة المستخدم	يدويًا (الكتابة إلى MEMORY.md)	ملفات تعريف تلقائية
البحث	متجه + كلمة مفتاحية (هجين)	دلالي على مستوى الملاحظات
متعدد الوكلاء	غير متتبَّع	وعي بالأب/الابن
التبعيات	لا شيء (مدمج) أو ملف QMD ثنائي	تثبيت Plugin

يمكن أن يعمل Honcho ونظام الذاكرة المدمج معًا. وعندما يكون QMD مكوّنًا، تصبح أدوات إضافية متاحة للبحث في ملفات Markdown المحلية إلى جانب ذاكرة Honcho العابرة للجلسات.

# أوامر CLI

openclaw honcho setup                        # تكوين مفتاح API وترحيل الملفات
openclaw honcho status                       # التحقق من حالة الاتصال
openclaw honcho ask <question>               # الاستعلام من Honcho عن المستخدم
openclaw honcho search <query> [-k N] [-d D] # بحث دلالي في الذاكرة

# قراءة إضافية

• الشيفرة المصدرية لـ Plugin
• توثيق Honcho
• دليل تكامل Honcho مع OpenClaw
• الذاكرة -- نظرة عامة على ذاكرة OpenClaw
• محركات السياق -- كيف تعمل محركات السياق الخاصة بالـ Plugin

# ذو صلة

• نظرة عامة على الذاكرة
• محرك الذاكرة المدمج
• محرك ذاكرة QMD