مرجع تكوين الذاكرة

تسرد هذه الصفحة كل خيار إعدادات لبحث ذاكرة OpenClaw. للاطلاع على الشروحات المفاهيمية، راجع:

توجد كل إعدادات بحث الذاكرة ضمن agents.defaults.memorySearch في openclaw.json ما لم يُذكر خلاف ذلك.

# اختيار المزوّد

# ترتيب الاكتشاف التلقائي

عندما لا يتم تعيين provider، يختار OpenClaw أول خيار متاح:

ollama مدعوم لكنه لا يُكتشف تلقائياً (عيّنه صراحةً).

# معرّفات المزوّدين المخصصة

يمكن أن يشير memorySearch.provider إلى إدخال models.providers.<id> مخصص. يحل OpenClaw مالك api لذلك المزوّد لمحوّل التضمين مع الحفاظ على معرّف المزوّد المخصص للتعامل مع نقطة النهاية والمصادقة وبادئة النموذج. يتيح ذلك للإعدادات متعددة وحدات GPU أو متعددة المضيفين تخصيص تضمينات الذاكرة لنقطة نهاية محلية محددة:

{
  models: {
    providers: {
      "ollama-5080": {
        api: "ollama",
        baseUrl: "http://gpu-box.local:11435",
        apiKey: "ollama-local",
        models: [{ id: "qwen3-embedding:0.6b" }],
      },
    },
  },
  agents: {
    defaults: {
      memorySearch: {
        provider: "ollama-5080",
        model: "qwen3-embedding:0.6b",
      },
    },
  },
}

# حل مفتاح API

تتطلب التضمينات البعيدة مفتاح API. يستخدم Bedrock بدلاً من ذلك سلسلة بيانات اعتماد AWS SDK الافتراضية (أدوار المثيلات، وSSO، ومفاتيح الوصول).

# إعداد نقطة النهاية البعيدة

لنقاط النهاية المخصصة المتوافقة مع OpenAI أو لتجاوز افتراضيات المزوّد:

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "openai",
        model: "text-embedding-3-small",
        remote: {
          baseUrl: "https://api.example.com/v1/",
          apiKey: "YOUR_KEY",
        },
      },
    },
  },
}

# إعدادات خاصة بالمزوّد

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "openai",
        remote: {
          baseUrl: "https://embeddings.example/v1",
          apiKey: "env:EMBEDDINGS_API_KEY",
        },
        model: "asymmetric-embedder",
        queryInputType: "query",
        documentInputType: "passage",
      },
    },
  },
}

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "bedrock",
        model: "amazon.titan-embed-text-v2:0",
      },
    },
  },
}

{
  "Effect": "Allow",
  "Action": "bedrock:InvokeModel",
  "Resource": "*"
}

arn:aws:bedrock:*::foundation-model/amazon.titan-embed-text-v2:0

openclaw memory status --deep --agent main
openclaw memory index --force --agent main

# مهلة التضمين المضمّن

# إعداد البحث الهجين

كلها ضمن memorySearch.query.hybrid:

# مثال كامل

{
  agents: {
    defaults: {
      memorySearch: {
        query: {
          hybrid: {
            vectorWeight: 0.7,
            textWeight: 0.3,
            mmr: { enabled: true, lambda: 0.7 },
            temporalDecay: { enabled: true, halfLifeDays: 30 },
          },
        },
      },
    },
  },
}

# مسارات ذاكرة إضافية

{
  agents: {
    defaults: {
      memorySearch: {
        extraPaths: ["../team-docs", "/srv/shared-notes"],
      },
    },
  },
}

يمكن أن تكون المسارات مطلقة أو نسبية إلى مساحة العمل. تُفحص الأدلة تكراريًا بحثًا عن ملفات .md. يعتمد التعامل مع الروابط الرمزية على الخلفية النشطة: يتجاهل المحرك المدمج الروابط الرمزية، بينما يتبع QMD سلوك ماسح QMD الأساسي.

للبحث في نصوص وكلاء آخرين ضمن نطاق وكيل، استخدم agents.list[].memorySearch.qmd.extraCollections بدلًا من memory.qmd.paths. تتبع تلك المجموعات الإضافية البنية نفسها { path, name, pattern? }، لكنها تُدمج لكل وكيل ويمكنها الحفاظ على الأسماء المشتركة الصريحة عندما يشير المسار إلى خارج مساحة العمل الحالية. إذا ظهر المسار المحلول نفسه في كل من memory.qmd.paths وmemorySearch.qmd.extraCollections، يحتفظ QMD بالإدخال الأول ويتخطى التكرار.

# الذاكرة متعددة الوسائط (Gemini)

افهرس الصور والصوت إلى جانب Markdown باستخدام Gemini Embedding 2:

التنسيقات المدعومة: .jpg، .jpeg، .png، .webp، .gif، .heic، .heif (صور)؛ .mp3، .wav، .ogg، .opus، .m4a، .aac، .flac (صوت).

# ذاكرة التخزين المؤقت للتضمينات

يمنع إعادة تضمين النص غير المتغير أثناء إعادة الفهرسة أو تحديثات النصوص المسجلة.

# الفهرسة الدفعية

متاحة لـ openai وgemini وvoyage. تكون دفعات OpenAI عادة الأسرع والأقل تكلفة لعمليات الملء الخلفي الكبيرة.

يتحكم remote.nonBatchConcurrency في استدعاءات التضمين المضمّنة التي يستخدمها المزوّدون المحليون/المستضافون ذاتيا والمزوّدون المستضافون عندما لا تكون واجهات API الدفعية الخاصة بالمزوّد نشطة. القيمة الافتراضية لـ Ollama هي 1 للفهرسة غير الدفعية لتجنب إرباك المضيفين المحليين الأصغر؛ اضبط قيمة أعلى على الأجهزة الأكبر.

هذا منفصل عن sync.embeddingBatchTimeoutSeconds، الذي يتحكم في مهلة استدعاءات التضمين المضمّنة.

# بحث ذاكرة الجلسات (تجريبي)

افهرس نصوص الجلسات المسجلة واعرضها عبر memory_search:

# تسريع متجهات SQLite (sqlite-vec)

عندما لا يكون sqlite-vec متاحا، يعود OpenClaw تلقائيا إلى تشابه جيب التمام داخل العملية.

# تخزين الفهرس

# إعداد واجهة QMD الخلفية

اضبط memory.backend = "qmd" للتفعيل. توجد كل إعدادات QMD ضمن memory.qmd:

searchMode: "search" معجمي/BM25 فقط. لا يُجري OpenClaw مجسات جاهزية المتجهات الدلالية أو صيانة تضمينات QMD لهذا الوضع، بما في ذلك أثناء memory status --deep؛ يواصل vsearch وquery طلب جاهزية متجهات QMD والتضمينات.

يفضل OpenClaw مجموعة QMD الحالية وأشكال استعلام MCP، لكنه يُبقي إصدارات QMD الأقدم عاملة عبر تجربة أعلام أنماط المجموعات المتوافقة وأسماء أدوات MCP الأقدم عند الحاجة. عندما يعلن QMD دعمه لعدة مرشحات مجموعات، تُبحث مجموعات المصدر نفسه باستخدام عملية QMD واحدة؛ وتحتفظ إصدارات QMD الأقدم بمسار التوافق لكل مجموعة. يعني المصدر نفسه أن مجموعات الذاكرة الدائمة تُجمّع معا، بينما تبقى مجموعات نصوص الجلسات مجموعة منفصلة بحيث يظل تنويع المصادر يتضمن كلا المُدخلين.

{
  memory: {
    qmd: {
      scope: {
        default: "deny",
        rules: [{ action: "allow", match: { chatType: "direct" } }],
      },
    },
  },
}

تستخدم تحديثات إقلاع QMD مسار عملية فرعية لمرة واحدة أثناء بدء Gateway. يظل مدير QMD طويل العمر مالكا لمراقب الملفات العادي ومؤقتات الفواصل عندما يُفتح بحث الذاكرة للاستخدام التفاعلي.

# مثال QMD كامل

{
  memory: {
    backend: "qmd",
    citations: "auto",
    qmd: {
      includeDefaultMemory: true,
      update: { interval: "5m", debounceMs: 15000 },
      limits: { maxResults: 6, timeoutMs: 4000 },
      scope: {
        default: "deny",
        rules: [{ action: "allow", match: { chatType: "direct" } }],
      },
      paths: [{ name: "docs", path: "~/notes", pattern: "**/*.md" }],
    },
  },
}

# Dreaming

يُضبط Dreaming ضمن plugins.entries.memory-core.config.dreaming، وليس ضمن agents.defaults.memorySearch.

يعمل Dreaming كعملية مسح مجدولة واحدة، ويستخدم مراحل داخلية خفيفة/عميقة/REM كتفصيل تنفيذي.

للسلوك المفاهيمي وأوامر slash، راجع Dreaming.

# إعدادات المستخدم

# مثال

{
  plugins: {
    entries: {
      "memory-core": {
        subagent: {
          allowModelOverride: true,
          allowedModels: ["anthropic/claude-sonnet-4-6"],
        },
        config: {
          dreaming: {
            enabled: true,
            frequency: "0 3 * * *",
            model: "anthropic/claude-sonnet-4-6",
          },
        },
      },
    },
  },
}

# ذات صلة

• مرجع الإعدادات
• نظرة عامة على الذاكرة
• بحث الذاكرة