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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

تضيف 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 الخاصة بك، ويكتب التكوين، ويعرض اختياريًا ترحيل ملفات ذاكرة مساحة العمل الموجودة.
يمكن تشغيل Honcho بالكامل محليًا (مستضاف ذاتيًا) أو عبر API المُدارة على api.honcho.dev. لا توجد تبعيات خارجية مطلوبة للخيار المستضاف ذاتيًا.

​
التكوين

توجد الإعدادات تحت 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 ببناء نماذجه وتحسينها مع مرور الوقت. أثناء المحادثة، تستعلم أدوات Honcho من الخدمة في مرحلة before_prompt_build، وتحقن السياق ذي الصلة قبل أن يرى النموذج المطالبة. وهذا يضمن دقة حدود الأدوار وملاءمة الاسترجاع.

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

المدمجة / QMDHoncho
التخزينملفات 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] # بحث دلالي في الذاكرة

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

​
ذو صلة