الانتقال إلى المحتوى الرئيسي

​
ذاكرة Honcho

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

​
ما الذي توفره

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

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

تسجل Honcho أدوات يمكن للوكيل استخدامها أثناء المحادثة: استرجاع البيانات (سريع، من دون استدعاء LLM):
الأداةما الذي تفعله
honcho_contextالتمثيل الكامل للمستخدم عبر الجلسات
honcho_search_conclusionsبحث دلالي في الاستنتاجات المخزنة
honcho_search_messagesالعثور على الرسائل عبر الجلسات (مع التصفية حسب المرسل أو التاريخ)
honcho_sessionسجل الجلسة الحالية وملخصها
أسئلة وأجوبة (مدعومة بـ LLM):
الأداةما الذي تفعله
honcho_askاطرح سؤالًا عن المستخدم. استخدم depth='quick' للحقائق، و'thorough' للتركيب

​
البدء

ثبّت الإضافة وشغّل الإعداد: 
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
يطالبك أمر الإعداد ببيانات اعتماد API الخاصة بك، ويكتب الإعدادات، ويعرض اختياريًا ترحيل ملفات الذاكرة الموجودة في مساحة العمل.
يمكن تشغيل Honcho بالكامل محليًا (مستضافًا ذاتيًا) أو عبر API المُدار على api.honcho.dev. لا يلزم وجود تبعيات خارجية للخيار المستضاف ذاتيًا.

​
الإعدادات

توجد الإعدادات ضمن plugins.entries["openclaw-honcho"].config: 
{
  plugins: {
    entries: {
      "openclaw-honcho": {
        config: {
          apiKey: "your-api-key", // omit for self-hosted
          workspaceId: "openclaw", // memory isolation
          baseUrl: "https://api.honcho.dev",
        },
      },
    },
  },
}
بالنسبة إلى النُسخ المستضافة ذاتيًا، وجّه baseUrl إلى خادمك المحلي (على سبيل المثال http://localhost:8000) واحذف API key.

​
ترحيل الذاكرة الحالية

إذا كانت لديك ملفات ذاكرة موجودة في مساحة العمل (USER.md وMEMORY.md، وIDENTITY.md وmemory/ وcanvas/)، فإن openclaw honcho setup يكتشفها ويعرض ترحيلها.
الترحيل غير هدّام — يتم رفع الملفات إلى Honcho. ولا يتم أبدًا حذف الأصول أو نقلها.

​
كيف يعمل

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

​
Honcho مقابل الذاكرة المضمنة

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

​
أوامر CLI

openclaw honcho setup                        # Configure API key and migrate files
openclaw honcho status                       # Check connection status
openclaw honcho ask <question>               # Query Honcho about the user
openclaw honcho search <query> [-k N] [-d D] # Semantic search over memory

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