---
read_when:
    - أنت تريد ذاكرة دائمة تعمل عبر الجلسات والقنوات
    - أنت تريد استدعاءً مدعومًا بالذكاء الاصطناعي ونمذجة للمستخدم
summary: ذاكرة أصلية للذكاء الاصطناعي عبر الجلسات باستخدام إضافة Honcho
title: ذاكرة Honcho
x-i18n:
    generated_at: "2026-04-05T12:40:31Z"
    model: gpt-5.4
    provider: openai
    source_hash: 83ae3561152519a23589f754e0625f1e49c43e38f85de07686b963170a6cf229
    source_path: concepts/memory-honcho.md
    workflow: 15
---

# ذاكرة Honcho

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

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

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

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

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

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

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

**أسئلة وأجوبة (مدعومة بـ LLM):**

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

## البدء

ثبّت الإضافة وشغّل الإعداد:

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

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

## كيف يعمل

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

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

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

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

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

## أوامر CLI

```bash
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
```

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

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