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

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

نظرة عامة على الذاكرة

كيف تعمل الذاكرة.

المحرك المدمج

واجهة SQLite الخلفية الافتراضية.

محرك QMD

ملحق محلي أولاً.

بحث الذاكرة

مسار البحث والضبط.

Active Memory

وكيل فرعي للذاكرة للجلسات التفاعلية.

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

إذا كنت تبحث عن مفتاح تفعيل ميزة Active Memory وإعدادات الوكيل الفرعي، فهي موجودة ضمن plugins.entries.active-memory بدلاً من memorySearch.تستخدم Active Memory نموذج بوابتين:

يجب أن يكون Plugin مفعلاً وأن يستهدف معرّف الوكيل الحالي
يجب أن يكون الطلب جلسة دردشة تفاعلية مستمرة مؤهلة

راجع Active Memory لمعرفة نموذج التفعيل، والإعدادات المملوكة للـ Plugin، واستمرارية النص، ونمط الطرح الآمن.

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

المفتاح	النوع	الافتراضي	الوصف
`provider`	`string`	مكتشف تلقائياً	معرّف محوّل التضمين مثل `bedrock` أو `deepinfra` أو `gemini` أو `github-copilot` أو `local` أو `mistral` أو `ollama` أو `openai` أو `voyage`؛ ويمكن أيضاً أن يكون `models.providers.<id>` معداً يشير `api` فيه إلى أحد هذه المحوّلات
`model`	`string`	افتراضي المزوّد	اسم نموذج التضمين
`fallback`	`string`	`"none"`	معرّف المحوّل الاحتياطي عند فشل الأساسي
`enabled`	`boolean`	`true`	تفعيل بحث الذاكرة أو تعطيله

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

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

local

يُختار إذا كان memorySearch.local.modelPath معداً وكان الملف موجوداً.

github-copilot

يُختار إذا أمكن حل رمز GitHub Copilot المميز (متغير بيئة أو ملف تعريف مصادقة).

openai

يُختار إذا أمكن حل مفتاح OpenAI.

gemini

يُختار إذا أمكن حل مفتاح Gemini.

voyage

يُختار إذا أمكن حل مفتاح Voyage.

mistral

يُختار إذا أمكن حل مفتاح Mistral.

deepinfra

يُختار إذا أمكن حل مفتاح DeepInfra.

bedrock

يُختار إذا نجحت سلسلة بيانات اعتماد AWS SDK في الحل (دور المثيل، أو مفاتيح الوصول، أو الملف التعريفي، أو SSO، أو هوية الويب، أو الإعدادات المشتركة).

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، ومفاتيح الوصول).

المزوّد	متغير البيئة	مفتاح الإعدادات
Bedrock	سلسلة بيانات اعتماد AWS	لا حاجة إلى مفتاح API
DeepInfra	`DEEPINFRA_API_KEY`	`models.providers.deepinfra.apiKey`
Gemini	`GEMINI_API_KEY`	`models.providers.google.apiKey`
GitHub Copilot	`COPILOT_GITHUB_TOKEN`, `GH_TOKEN`, `GITHUB_TOKEN`	ملف تعريف مصادقة عبر تسجيل دخول الجهاز
Mistral	`MISTRAL_API_KEY`	`models.providers.mistral.apiKey`
Ollama	`OLLAMA_API_KEY` (عنصر نائب)	—
OpenAI	`OPENAI_API_KEY`	`models.providers.openai.apiKey`
Voyage	`VOYAGE_API_KEY`	`models.providers.voyage.apiKey`

يغطي OAuth الخاص بـ Codex الدردشة/الإكمالات فقط ولا يفي بطلبات التضمين.

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

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

remote.baseUrl

string

عنوان URL أساسي مخصص للـ API.

remote.apiKey

string

تجاوز مفتاح API.

remote.headers

object

ترويسات HTTP إضافية (تُدمج مع افتراضيات المزوّد).

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

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

Gemini

المفتاح	النوع	الافتراضي	الوصف
`model`	`string`	`gemini-embedding-001`	يدعم أيضاً `gemini-embedding-2-preview`
`outputDimensionality`	`number`	`3072`	لـ Embedding 2: 768 أو 1536 أو 3072

يؤدي تغيير النموذج أو outputDimensionality إلى إعادة فهرسة كاملة تلقائية.

أنواع الإدخال المتوافقة مع OpenAI

يمكن لنقاط نهاية التضمين المتوافقة مع OpenAI الاشتراك في حقول طلب input_type الخاصة بالمزوّد. يكون ذلك مفيداً لنماذج التضمين غير المتماثلة التي تتطلب تسميات مختلفة لتضمينات الاستعلام والمستند.

المفتاح	النوع	الافتراضي	الوصف
`inputType`	`string`	غير معيّن	`input_type` مشترك لتضمينات الاستعلام والمستند
`queryInputType`	`string`	غير معيّن	`input_type` وقت الاستعلام؛ يتجاوز `inputType`
`documentInputType`	`string`	غير معيّن	`input_type` للفهرس/المستند؛ يتجاوز `inputType`

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

يؤثر تغيير هذه القيم في هوية ذاكرة التخزين المؤقت للتضمين لفهرسة دفعات المزوّد، وينبغي أن يتبعه إعادة فهرسة للذاكرة عندما يتعامل النموذج upstream مع التسميات بشكل مختلف.

Bedrock

إعداد تضمين Bedrock

يستخدم Bedrock سلسلة بيانات اعتماد AWS SDK الافتراضية — لا حاجة إلى مفاتيح API. إذا كان OpenClaw يعمل على EC2 بدور مثيل مفعّل لـ Bedrock، فما عليك سوى تعيين المزوّد والنموذج:

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

المفتاح	النوع	الافتراضي	الوصف
`model`	`string`	`amazon.titan-embed-text-v2:0`	أي معرّف نموذج تضمين Bedrock
`outputDimensionality`	`number`	افتراضي النموذج	لـ Titan V2: 256 أو 512 أو 1024

النماذج المدعومة (مع اكتشاف العائلة وافتراضيات الأبعاد):

معرّف النموذج	المزوّد	الأبعاد الافتراضية	الأبعاد القابلة للإعداد
`amazon.titan-embed-text-v2:0`	Amazon	1024	256, 512, 1024
`amazon.titan-embed-text-v1`	Amazon	1536	—
`amazon.titan-embed-g1-text-02`	Amazon	1536	—
`amazon.titan-embed-image-v1`	Amazon	1024	—
`amazon.nova-2-multimodal-embeddings-v1:0`	Amazon	1024	256, 384, 1024, 3072
`cohere.embed-english-v3`	Cohere	1024	—
`cohere.embed-multilingual-v3`	Cohere	1024	—
`cohere.embed-v4:0`	Cohere	1536	256-1536
`twelvelabs.marengo-embed-3-0-v1:0`	TwelveLabs	512	—
`twelvelabs.marengo-embed-2-7-v1:0`	TwelveLabs	1024	—

ترث المتغيرات ذات لاحقة معدل النقل (مثل amazon.titan-embed-text-v1:2:8k) إعدادات النموذج الأساسي.المصادقة: تستخدم مصادقة Bedrock ترتيب حل بيانات اعتماد AWS SDK القياسي:

متغيرات البيئة (AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY)
ذاكرة التخزين المؤقت لرمز SSO المميز
بيانات اعتماد رمز هوية الويب
بيانات الاعتماد المشتركة وملفات الإعدادات
بيانات اعتماد بيانات ECS أو EC2 الوصفية

تُحل المنطقة من AWS_REGION أو AWS_DEFAULT_REGION أو baseUrl الخاص بمزوّد amazon-bedrock، أو تكون افتراضياً us-east-1.أذونات IAM: يحتاج دور IAM أو المستخدم إلى:

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

للحد الأدنى من الصلاحيات، قيّد InvokeModel بالنموذج المحدد:

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

محلي (GGUF + node-llama-cpp)

المفتاح	النوع	الافتراضي	الوصف
`local.modelPath`	`string`	يُنزّل تلقائيًا	المسار إلى ملف نموذج GGUF
`local.modelCacheDir`	`string`	الافتراضي لـ node-llama-cpp	دليل التخزين المؤقت للنماذج المنزّلة
`local.contextSize`	`number \| "auto"`	`4096`	حجم نافذة السياق لسياق التضمين. يغطي 4096 المقاطع النموذجية (128–512 رمزًا مميزًا) مع ضبط ذاكرة VRAM غير الخاصة بالأوزان. خفّضه إلى 1024–2048 على المضيفات محدودة الموارد. يستخدم `"auto"` الحد الأقصى الذي دُرّب عليه النموذج — لا يوصى به لنماذج 8B+ (Qwen3-Embedding-8B: 40 960 رمزًا مميزًا → نحو 32 GB VRAM مقابل نحو 8.8 GB عند 4096).

النموذج الافتراضي: embeddinggemma-300m-qat-Q8_0.gguf (نحو 0.6 GB، يُنزّل تلقائيًا). لا تزال نسخ المصدر تتطلب موافقة البناء الأصلي: pnpm approve-builds ثم pnpm rebuild node-llama-cpp.استخدم CLI المستقل للتحقق من مسار المزوّد نفسه الذي يستخدمه Gateway:

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

إذا كان provider هو auto، فلن يُختار local إلا عندما يشير local.modelPath إلى ملف محلي موجود. لا يزال من الممكن استخدام مراجع نماذج hf: وHTTP(S) صراحةً مع provider: "local"، لكنها لا تجعل auto يختار المحلي قبل أن يصبح النموذج متاحًا على القرص.

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

sync.embeddingBatchTimeoutSeconds

number

تجاوز المهلة لدُفعات التضمين المضمّنة أثناء فهرسة الذاكرة.عند عدم الضبط، يُستخدم الافتراضي الخاص بالمزوّد: 600 ثانية للمزوّدين المحليين/المستضافين ذاتيًا مثل local وollama وlmstudio، و120 ثانية للمزوّدين المستضافين. زد هذه القيمة عندما تكون دُفعات التضمين المحلية المعتمدة على CPU سليمة لكنها بطيئة.

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

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

المفتاح	النوع	الافتراضي	الوصف
`enabled`	`boolean`	`true`	تفعيل البحث الهجين BM25 + المتجهي
`vectorWeight`	`number`	`0.7`	وزن درجات المتجهات (0-1)
`textWeight`	`number`	`0.3`	وزن درجات BM25 (0-1)
`candidateMultiplier`	`number`	`4`	معامل مضاعفة حجم مجموعة المرشحين

MMR (التنوع)
التلاشي الزمني (الحداثة)

المفتاح	النوع	الافتراضي	الوصف
`mmr.enabled`	`boolean`	`false`	تفعيل إعادة الترتيب باستخدام MMR
`mmr.lambda`	`number`	`0.7`	0 = أقصى تنوع، 1 = أقصى صلة

المفتاح	النوع	الافتراضي	الوصف
`temporalDecay.enabled`	`boolean`	`false`	تفعيل تعزيز الحداثة
`temporalDecay.halfLifeDays`	`number`	`30`	تنخفض الدرجة إلى النصف كل N يومًا

لا تخضع الملفات دائمة الصلاحية (MEMORY.md والملفات غير المؤرخة في memory/) للتلاشي أبدًا.

مثال كامل

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

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

المفتاح	النوع	الوصف
`extraPaths`	`string[]`	أدلة أو ملفات إضافية لفهرستها

{
  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:

المفتاح	النوع	الافتراضي	الوصف
`multimodal.enabled`	`boolean`	`false`	تفعيل الفهرسة متعددة الوسائط
`multimodal.modalities`	`string[]`	—	`["image"]` أو `["audio"]` أو `["all"]`
`multimodal.maxFileBytes`	`number`	`10000000`	الحد الأقصى لحجم الملف للفهرسة

ينطبق فقط على الملفات في extraPaths. تبقى جذور الذاكرة الافتراضية مخصصة لـ Markdown فقط. يتطلب gemini-embedding-2-preview. يجب أن يكون fallback هو "none".

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

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

المفتاح	النوع	الافتراضي	الوصف
`cache.enabled`	`boolean`	`false`	تخزين تضمينات المقاطع مؤقتا في SQLite
`cache.maxEntries`	`number`	`50000`	الحد الأقصى للتضمينات المخزنة مؤقتا

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

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

المفتاح	النوع	الافتراضي	الوصف
`remote.nonBatchConcurrency`	`number`	`4`	تضمينات مضمّنة متوازية
`remote.batch.enabled`	`boolean`	`false`	تفعيل API التضمين الدفعي
`remote.batch.concurrency`	`number`	`2`	مهام دفعية متوازية
`remote.batch.wait`	`boolean`	`true`	انتظار اكتمال الدفعة
`remote.batch.pollIntervalMs`	`number`	—	فاصل الاستطلاع
`remote.batch.timeoutMinutes`	`number`	—	مهلة الدفعة

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

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

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

المفتاح	النوع	الافتراضي	الوصف
`experimental.sessionMemory`	`boolean`	`false`	تفعيل فهرسة الجلسات
`sources`	`string[]`	`["memory"]`	أضف `"sessions"` لتضمين النصوص المسجلة
`sync.sessions.deltaBytes`	`number`	`100000`	عتبة البايتات لإعادة الفهرسة
`sync.sessions.deltaMessages`	`number`	`50`	عتبة الرسائل لإعادة الفهرسة

فهرسة الجلسات اختيارية وتعمل بشكل غير متزامن. قد تكون النتائج قديمة قليلا. توجد سجلات الجلسات على القرص، لذا تعامل مع الوصول إلى نظام الملفات باعتباره حد الثقة.

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

المفتاح	النوع	الافتراضي	الوصف
`store.vector.enabled`	`boolean`	`true`	استخدام sqlite-vec لاستعلامات المتجهات
`store.vector.extensionPath`	`string`	مضمّن	تجاوز مسار sqlite-vec

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

تخزين الفهرس

المفتاح	النوع	الافتراضي	الوصف
`store.path`	`string`	`~/.openclaw/memory/{agentId}.sqlite`	موقع الفهرس (يدعم الرمز `{agentId}`)
`store.fts.tokenizer`	`string`	`unicode61`	مجزئ FTS5 (`unicode61` أو `trigram`)

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

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

المفتاح	النوع	الافتراضي	الوصف
`command`	`string`	`qmd`	مسار ملف QMD التنفيذي؛ اضبط مسارا مطلقا عندما يختلف `PATH` الخاص بالخدمة عن صدفتك
`searchMode`	`string`	`search`	أمر البحث: `search`، `vsearch`، `query`
`includeDefaultMemory`	`boolean`	`true`	فهرسة تلقائية لـ `MEMORY.md` + `memory/*/.md`
`paths[]`	`array`	—	مسارات إضافية: `{ name, path, pattern? }`
`sessions.enabled`	`boolean`	`false`	فهرسة نصوص الجلسات المسجلة
`sessions.retentionDays`	`number`	—	احتفاظ النصوص المسجلة
`sessions.exportDir`	`string`	—	دليل التصدير

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

تبقى تجاوزات نماذج QMD في جانب QMD، وليس في إعدادات OpenClaw. إذا احتجت إلى تجاوز نماذج QMD عالميا، فعيّن متغيرات بيئة مثل QMD_EMBED_MODEL وQMD_RERANK_MODEL وQMD_GENERATE_MODEL في بيئة تشغيل Gateway.

جدول التحديث

Key	Type	Default	Description
`update.interval`	`string`	`5m`	فاصل التحديث
`update.debounceMs`	`number`	`15000`	إزالة ارتداد تغييرات الملفات
`update.onBoot`	`boolean`	`true`	التحديث عند فتح مدير QMD طويل العمر؛ ويتحكم أيضا في تحديث بدء التشغيل الاختياري
`update.startup`	`string`	`off`	تحديث اختياري عند بدء Gateway: `off` أو `idle` أو `immediate`
`update.startupDelayMs`	`number`	`120000`	تأخير قبل تشغيل تحديث `startup: "idle"`
`update.waitForBootSync`	`boolean`	`false`	حظر فتح المدير حتى يكتمل تحديثه الأولي
`update.embedInterval`	`string`	—	إيقاع تضمين منفصل
`update.commandTimeoutMs`	`number`	—	مهلة أوامر QMD
`update.updateTimeoutMs`	`number`	—	مهلة عمليات تحديث QMD
`update.embedTimeoutMs`	`number`	—	مهلة عمليات تضمين QMD

الحدود

Key	Type	Default	Description
`limits.maxResults`	`number`	`6`	الحد الأقصى لنتائج البحث
`limits.maxSnippetChars`	`number`	—	تقييد طول المقتطف
`limits.maxInjectedChars`	`number`	—	تقييد إجمالي الأحرف المحقونة
`limits.timeoutMs`	`number`	`4000`	مهلة البحث

النطاق

يتحكم في الجلسات التي يمكنها تلقي نتائج بحث QMD. المخطط نفسه مثل session.sendPolicy:

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

يسمح الافتراضي المشحون بجلسات الرسائل المباشرة والقنوات، مع الاستمرار في رفض المجموعات.الافتراضي هو الرسائل المباشرة فقط. يطابق match.keyPrefix مفتاح الجلسة المطبّع؛ ويطابق match.rawKeyPrefix المفتاح الخام بما في ذلك agent:<id>:.

الاستشهادات

ينطبق memory.citations على كل الخلفيات:

Value	Behavior
`auto` (default)	تضمين تذييل `Source: <path#line>` في المقتطفات
`on`	تضمين التذييل دائما
`off`	حذف التذييل (يظل المسار مررا إلى الوكيل داخليا)

تستخدم تحديثات إقلاع 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.

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

Key	Type	Default	Description
`enabled`	`boolean`	`false`	تفعيل Dreaming أو تعطيله بالكامل
`frequency`	`string`	`0 3 * * *`	إيقاع Cron اختياري لمسح Dreaming الكامل
`model`	`string`	النموذج الافتراضي	تجاوز اختياري لنموذج الوكيل الفرعي Dream Diary

مثال

{
  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",
          },
        },
      },
    },
  },
}

يكتب Dreaming حالة الآلة إلى memory/.dreams/.
يكتب Dreaming المخرجات السردية القابلة للقراءة البشرية إلى DREAMS.md (أو dreams.md الموجود).
يستخدم dreaming.model بوابة الثقة الحالية للوكيل الفرعي في Plugin؛ عيّن plugins.entries.memory-core.subagent.allowModelOverride: true قبل تفعيله.
يعيد Dream Diary المحاولة مرة واحدة باستخدام نموذج الجلسة الافتراضي عندما يكون النموذج المضبوط غير متاح. تُسجل إخفاقات الثقة أو قائمة السماح ولا يُعاد المحاولة بصمت.
سياسة مراحل light/deep/REM والعتبات سلوك داخلي، وليست إعدادات موجهة للمستخدم.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Release and CI

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

نظرة عامة على الذاكرة

المحرك المدمج

محرك QMD

بحث الذاكرة

Active Memory

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

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

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

حل مفتاح API

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

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

إعداد تضمين Bedrock

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

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

مثال كامل

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

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

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

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

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

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

تخزين الفهرس

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

مثال QMD كامل

Dreaming

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

مثال

ذات صلة

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Release and CI

Documentation Index

نظرة عامة على الذاكرة

المحرك المدمج

محرك QMD

بحث الذاكرة

Active Memory

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

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

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

​حل مفتاح API

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

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

​إعداد تضمين Bedrock

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

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

​مثال كامل

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

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

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

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

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

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

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

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

​مثال QMD كامل

​Dreaming

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

​مثال

​ذات صلة

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

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

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

حل مفتاح API

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

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

إعداد تضمين Bedrock

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

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

مثال كامل

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

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

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

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

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

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

تخزين الفهرس

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

مثال QMD كامل

Dreaming

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

مثال

ذات صلة