---
read_when:
    - تريد ذاكرة دائمة تعمل عبر الجلسات والقنوات
    - تريد استرجاعًا مدعومًا بالذكاء الاصطناعي ونمذجة للمستخدم
summary: ذاكرة أصلية للذكاء الاصطناعي عبر الجلسات باستخدام Plugin ‏Honcho
title: ذاكرة Honcho
x-i18n:
    generated_at: "2026-04-24T07:37:44Z"
    model: gpt-5.4
    provider: openai
    source_hash: d77af5c7281a4abafc184e426b1c37205a6d06a196b50353c1abbf67cc93bb97
    source_path: concepts/memory-honcho.md
    workflow: 15
---

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

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

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

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

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

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

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

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

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

## البدء

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

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

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

<Info>
يمكن تشغيل Honcho بالكامل محليًا (مستضاف ذاتيًا) أو عبر API المُدارة على
`api.honcho.dev`. لا توجد تبعيات خارجية مطلوبة للخيار المستضاف ذاتيًا.
</Info>

## التكوين

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

```json5
{
  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` يكتشفها
ويعرض ترحيلها.

<Info>
الترحيل غير هدّام -- تُرفع الملفات إلى Honcho. ولا يتم أبدًا حذف النسخ الأصلية
أو نقلها.
</Info>

## كيف يعمل

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

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

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

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

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

## أوامر CLI

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

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

- [الشيفرة المصدرية لـ Plugin](https://github.com/plastic-labs/openclaw-honcho)
- [توثيق Honcho](https://docs.honcho.dev)
- [دليل تكامل Honcho مع OpenClaw](https://docs.honcho.dev/v3/guides/integrations/openclaw)
- [الذاكرة](/ar/concepts/memory) -- نظرة عامة على ذاكرة OpenClaw
- [محركات السياق](/ar/concepts/context-engine) -- كيف تعمل محركات السياق الخاصة بالـ Plugin

## ذو صلة

- [نظرة عامة على الذاكرة](/ar/concepts/memory)
- [محرك الذاكرة المدمج](/ar/concepts/memory-builtin)
- [محرك ذاكرة QMD](/ar/concepts/memory-qmd)
