ویکی حافظه

memory-wiki یک افزونهٔ همراه است که دانش ماندگار را به یک ویکی قابل پیمایش تبدیل می‌کند: صفحه‌های قطعی، ادعاهای ساخت‌یافته همراه با شواهد، منشأ، داشبوردها و خلاصه‌های ماشین‌خوان.

این افزونه جایگزین افزونهٔ حافظهٔ فعال نمی‌شود. بازیابی، ارتقا، نمایه‌سازی و Dreaming همچنان بر عهدهٔ هر پشتیبان حافظه‌ای است که پیکربندی شده باشد (memory-core، QMD، Honcho و غیره). memory-wiki در کنار آن قرار می‌گیرد و دانش را در قالب یک لایهٔ ویکی نگهداری‌شده تدوین می‌کند.

قاعدهٔ عملی:

• memory_search برای یک مرحلهٔ بازیابی گسترده در همهٔ پیکره‌های پیکربندی‌شده
• wiki_search / wiki_get هنگامی که رتبه‌بندی ویژهٔ ویکی، منشأ یا ساختار باور در سطح صفحه را می‌خواهید
• memory_search corpus=all برای پوشش هر دو لایه در یک فراخوانی، به‌شرط آنکه افزونهٔ حافظهٔ فعال از انتخاب پیکره پشتیبانی کند

یک راه‌اندازی رایج با اولویت اجرای محلی: QMD به‌عنوان پشتیبان حافظهٔ فعال برای بازیابی و memory-wiki در حالت bridge برای صفحه‌های ترکیبی ماندگار. نمونهٔ حالت QMD + bridge را در بخش پیکربندی ببینید.

اگر حالت bridge صفر خروجی صادرشده گزارش می‌کند، افزونهٔ حافظهٔ فعال در حال حاضر ورودی‌های عمومی bridge را ارائه نمی‌دهد. ابتدا openclaw wiki doctor را اجرا کنید، سپس تأیید کنید که افزونهٔ حافظهٔ فعال از خروجی‌های عمومی پشتیبانی می‌کند.

حالت‌های مخزن

• isolated (پیش‌فرض): مخزن مستقل، منابع مستقل و بدون وابستگی به افزونهٔ حافظهٔ فعال. برای یک انبارهٔ دانش مستقل و گزینش‌شده از این حالت استفاده کنید.
• bridge: خروجی‌های عمومی حافظه و گزارش‌های رویداد را از طریق رابط‌های عمومی SDK افزونه از افزونهٔ حافظهٔ فعال می‌خواند. برای تدوین خروجی‌های صادرشدهٔ افزونهٔ حافظه، بدون دسترسی به بخش‌های داخلی و خصوصی افزونه، از این حالت استفاده کنید.
• unsafe-local: راه گریز صریح روی همان دستگاه برای مسیرهای محلی خصوصی. این حالت عمداً آزمایشی و غیرقابل‌حمل است؛ فقط زمانی از آن استفاده کنید که مرز اعتماد را درک می‌کنید و مشخصاً به دسترسی محلی به سامانهٔ فایل نیاز دارید که حالت bridge نمی‌تواند فراهم کند.

حالت مخزن و دامنهٔ مخزن دو انتخاب جداگانه‌اند:

• vaultMode تعیین می‌کند ورودی‌های ویکی از کجا تأمین شوند.
• vault.scope تعیین می‌کند همهٔ عامل‌ها از یک مخزن استفاده کنند یا هر عامل یک مخزن فرزند داشته باشد.

vault.scope: "global" پیش‌فرض است و رفتار موجودِ تک‌مخزنی را حفظ می‌کند. هنگامی که عامل‌ها نباید صفحه‌های ویکی، خلاصه‌های تدوین‌شده، نتایج جست‌وجو یا عملیات نوشتن را با یکدیگر به اشتراک بگذارند، از vault.scope: "agent" همراه با حالت isolated یا bridge استفاده کنید. دامنهٔ عامل را نمی‌توان با حالت unsafe-local ترکیب کرد، زیرا مسیرهای خصوصی پیکربندی‌شده ورودی‌های تحت مالکیت عامل نیستند. اعتبارسنجی پیکربندی این ترکیب را رد می‌کند.

حالت bridge می‌تواند بر اساس کلیدهای تغییر وضعیت پیکربندی bridge.* موارد زیر را نمایه‌سازی کند:

• خروجی‌های صادرشدهٔ حافظه (indexMemoryRoot)
• یادداشت‌های روزانه (indexDailyNotes)
• گزارش‌های Dreaming (indexDreamReports)
• گزارش‌های رویداد حافظه (followMemoryEvents)

هنگامی که حالت bridge فعال است و bridge.readMemoryArtifacts فعال شده، دستورهای openclaw wiki status، openclaw wiki doctor و openclaw wiki bridge import از طریق Gateway در حال اجرا مسیریابی می‌شوند تا همان زمینهٔ افزونهٔ حافظهٔ فعال را ببینند که حافظهٔ عامل/زمان‌اجرا می‌بیند. اگر bridge غیرفعال باشد یا خواندن خروجی‌ها خاموش باشد، این دستورها رفتار محلی/آفلاین خود را حفظ می‌کنند.

چیدمان مخزن

<vault>/  AGENTS.md  WIKI.md  index.md  inbox.md  entities/  concepts/  syntheses/  sources/  reports/  _attachments/  _views/  .openclaw-wiki/

محتوای مدیریت‌شده درون بلوک‌های تولیدشده باقی می‌ماند؛ بلوک‌های یادداشت انسانی در بازتولیدها حفظ می‌شوند.

• sources/: مواد خام واردشده و صفحه‌های متکی بر bridge/unsafe-local
• entities/: موجودیت‌های ماندگار مانند اشیا، افراد، سامانه‌ها، پروژه‌ها و موارد دیگر
• concepts/: ایده‌ها، انتزاع‌ها، الگوها و سیاست‌ها (همچنین محل مقصد واردسازی‌های OKF)
• syntheses/: خلاصه‌های تدوین‌شده و تجمیع‌های نگهداری‌شده
• reports/: داشبوردهای تولیدشده

واردسازی‌های قالب دانش باز

openclaw wiki okf import ./bundles/ga4

یک بستهٔ استخراج‌شدهٔ قالب دانش باز را به صفحه‌های مفهومی ویکی وارد کنید. این روش زمانی مناسب است که یک کاتالوگ داده، خزندهٔ مستندات یا عامل غنی‌سازی از قبل OKF تولید می‌کند: OKF را به‌عنوان خروجی قابل‌حمل تبادل نگه دارید و اجازه دهید memory-wiki آن را به صفحه‌های مفهومی بومی OpenClaw و خلاصه‌های تدوین‌شده تبدیل کند.

• فایل‌های .md رزروشده‌نباشند، اسناد مفهومی هستند
• هر مفهوم واردشده به یک فیلد غیرخالی type در frontmatter نیاز دارد؛ نبود type هشدار missing-type ایجاد می‌کند و فایل نادیده گرفته می‌شود
• مقادیر ناشناختهٔ type به‌عنوان مفاهیم عمومی پذیرفته می‌شوند
• index.md و log.md رزروشده‌اند و هرگز به‌عنوان مفهوم وارد نمی‌شوند
• پیوندهای Markdown خراب یا خارجی بدون تغییر باقی می‌مانند

صفحه‌های واردشده زیر concepts/ به‌صورت تخت قرار می‌گیرند تا جریان‌های موجود تدوین، جست‌وجو، دریافت و داشبورد بدون نیاز به درخت ویکی دوم آن‌ها را ببینند. هر صفحه شناسهٔ اصلی مفهوم OKF، مسیر منبع، type، resource، tags، مُهر زمانی و کل frontmatter تولیدکننده را حفظ می‌کند. پیوندهای داخلی OKF به صفحه‌های مفهومی تولیدشدهٔ ویکی بازنویسی می‌شوند و هم‌زمان ورودی‌های ساخت‌یافتهٔ relationships با kind: okf-link نیز ایجاد می‌کنند.

ادعاها و شواهد ساخت‌یافته

صفحه‌ها دارای frontmatter ساخت‌یافتهٔ claims هستند، نه صرفاً متن آزاد. هر ادعا می‌تواند شامل id، text، status، confidence، evidence[] و updatedAt باشد. هر ورودی شواهد می‌تواند شامل kind، sourceId، path، lines، weight، confidence، privacyTier، note و updatedAt باشد.

این ویژگی باعث می‌شود ویکی مانند یک لایهٔ باور عمل کند، نه انباشتگاهی منفعل از یادداشت‌ها. ادعاها را می‌توان ردیابی، امتیازدهی، به چالش کشید و با رجوع به منابع حل‌وفصل کرد.

فرادادهٔ موجودیت برای عامل‌ها

صفحه‌های موجودیت دارای فرادادهٔ مسیریابی عمومی هستند که برای افراد، تیم‌ها، سامانه‌ها، پروژه‌ها یا هر نوع موجودیت دیگری قابل استفاده است:

• entityType: برای نمونه person، team، system، project
• canonicalId: کلید هویت پایدار در میان نام‌های مستعار و واردسازی‌ها
• aliases: نام‌ها، شناسه‌ها یا برچسب‌هایی که به همان صفحه ارجاع می‌دهند
• privacyTier: رشته‌ای با قالب آزاد؛ public بدون نیاز به بازبینی در نظر گرفته می‌شود و هر مقدار دیگری (برای نمونه local-private، sensitive، confirm-before-use) در reports/privacy-review.md علامت‌گذاری می‌شود
• bestUsedFor / notEnoughFor: راهنمای فشردهٔ مسیریابی
• lastRefreshedAt: مُهر زمانی تازه‌سازی منبع، جدا از زمان ویرایش صفحه
• personCard: کارت مسیریابی اختیاری و ویژهٔ افراد (شناسه‌ها، شبکه‌های اجتماعی، ایمیل‌ها، منطقهٔ زمانی، حوزه، موارد مناسب برای پرسش، موارد نامناسب برای پرسش، میزان اطمینان، سطح حریم خصوصی)
• relationships: یال‌های نوع‌دار به صفحه‌های مرتبط (هدف، نوع، وزن، میزان اطمینان، نوع شواهد، سطح حریم خصوصی، یادداشت)

برای ویکی افراد، از reports/person-agent-directory.md شروع کنید، سپس پیش از استفاده از جزئیات تماس یا واقعیت‌های استنباط‌شده، صفحهٔ شخص را با wiki_get باز کنید.

pageType: entityentityType: personid: entity.example-personcanonicalId: maintainer.example-personaliases:- Alex- example-handleprivacyTier: local-privatebestUsedFor:- Example ecosystem routingnotEnoughFor:- legal approvallastRefreshedAt: "2026-04-29T00:00:00.000Z"personCard:handles:  - "@example-handle"socials:  - "https://x.example/example-handle"emails:  - alex@example.comtimezone: America/Chicagolane: Example ecosystemaskFor:  - Example rollout questionsavoidAskingFor:  - unrelated billing decisionsconfidence: 0.8privacyTier: confirm-before-userelationships:- targetId: entity.other-person  targetTitle: Other Person  kind: collaborates-with  confidence: 0.7  evidenceKind: discrawl-statclaims:- id: claim.example.routing  text: Alex is useful for example-ecosystem routing.  status: supported  confidence: 0.9  evidence:    - kind: maintainer-whois      sourceId: source.maintainers      privacyTier: local-private

خط لولهٔ تدوین

تدوین، صفحه‌های ویکی را می‌خواند، خلاصه‌ها را نرمال‌سازی می‌کند و خروجی‌های پایدار ماشین‌محور را در مسیرهای زیر ایجاد می‌کند:

• .openclaw-wiki/cache/agent-digest.json
• .openclaw-wiki/cache/claims.jsonl

عامل‌ها و کد زمان‌اجرا به‌جای استخراج اطلاعات از Markdown، این خلاصه‌ها را می‌خوانند. خروجی تدوین‌شده همچنین نمایه‌سازی مرحلهٔ نخست ویکی را برای جست‌وجو/دریافت، یافتن صفحهٔ مالک بر اساس شناسهٔ ادعا، مکمل‌های فشردهٔ اعلان و تولید گزارش فراهم می‌کند.

داشبوردها و گزارش‌های سلامت

هنگامی که render.createDashboards فعال است، فرایند تدوین داشبوردهای زیر را در reports/ نگهداری می‌کند:

جست‌وجو و بازیابی

دو پشتیبان جست‌وجو:

• shared: در صورت دردسترس‌بودن، استفاده از جریان جست‌وجوی حافظهٔ مشترک
• local: جست‌وجوی محلی در ویکی

سه پیکره: wiki، memory، all.

• wiki_search / wiki_get در صورت امکان از خلاصه‌های تدوین‌شده به‌عنوان مرحلهٔ نخست استفاده می‌کنند
• شناسه‌های ادعا به صفحهٔ مالک بازگردانده می‌شوند
• ادعاهای مورد اختلاف/منقضی/تازه بر رتبه‌بندی اثر می‌گذارند
• برچسب‌های منشأ در نتایج حفظ می‌شوند

حالت‌های جست‌وجو (پارامتر --mode / پارامتر ابزار mode):

هنگامی که یک نتیجه با ادعایی ساخت‌یافته مطابقت دارد، wiki_search مقادیر matchedClaimId، matchedClaimStatus، matchedClaimConfidence، evidenceKinds و evidenceSourceIds را در بار جزئیات خود برمی‌گرداند. خروجی متنی در صورت دردسترس‌بودن، شامل خط‌های فشردهٔ Claim: و Evidence: است.

ابزارهای عامل

این Plugin همچنین یک مکمل غیرانحصاری برای پیکرهٔ حافظه ثبت می‌کند؛ بنابراین، اگر Plugin فعال حافظه از انتخاب پیکره پشتیبانی کند، memory_search و memory_get مشترک نیز می‌توانند به ویکی دسترسی داشته باشند.

رفتار اعلان و زمینه

وقتی context.includeCompiledDigestPrompt فعال باشد، بخش‌های اعلان حافظه یک تصویر لحظه‌ای فشرده و کامپایل‌شده از agent-digest.json را اضافه می‌کنند: فقط صفحات برتر، فقط ادعاهای برتر، تعداد تناقض‌ها، تعداد پرسش‌ها و توصیف‌گرهای اطمینان/تازگی. این قابلیت اختیاری است، زیرا شکل اعلان را تغییر می‌دهد؛ اهمیت اصلی آن برای موتورهای زمینه یا سازوکارهای ساخت اعلان است که مکمل‌های حافظه را به‌طور صریح مصرف می‌کنند.

پیکربندی

پیکربندی را زیر plugins.entries.memory-wiki.config قرار دهید:

{  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "isolated",          vault: {            scope: "global",            path: "~/.openclaw/wiki/main",            renderMode: "obsidian",          },          obsidian: {            enabled: true,            useOfficialCli: true,            vaultName: "OpenClaw Wiki",            openAfterWrites: false,          },          bridge: {            enabled: false,            readMemoryArtifacts: true,            indexDreamReports: true,            indexDailyNotes: true,            indexMemoryRoot: true,            followMemoryEvents: true,          },          unsafeLocal: {            allowPrivateMemoryCoreAccess: false,            paths: [],          },          ingest: {            autoCompile: true,            maxConcurrentJobs: 1,            allowUrlIngest: true,          },          search: {            backend: "shared",            corpus: "wiki",          },          context: {            includeCompiledDigestPrompt: false,          },          render: {            preserveHumanBlocks: true,            createBacklinks: true,            createDashboards: true,          },        },      },    },  },}

گزینه‌های کلیدی:

مخزن‌های مختص هر عامل

برای اختصاص یک ویکی جداگانه به هر عامل پیکربندی‌شده، vault.scope را روی agent تنظیم کنید. در این دامنه، vault.path یک پوشهٔ والد است و OpenClaw شناسهٔ نرمال‌شدهٔ عامل را به آن اضافه می‌کند:

{  agents: {    list: [{ id: "support" }, { id: "marketing" }],  },  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "bridge",          vault: {            scope: "agent",            path: "~/.openclaw/wiki",          },          bridge: {            enabled: true,            readMemoryArtifacts: true,          },        },      },    },  },}

مسیرهای حاصل ~/.openclaw/wiki/support و ~/.openclaw/wiki/marketing هستند. اگر vault.path در دامنهٔ عامل حذف شود، مسیر والد به‌طور پیش‌فرض ~/.openclaw/wiki خواهد بود. بنابراین عامل پیش‌فرض main مسیر موجود ~/.openclaw/wiki/main را حفظ می‌کند.

ابزارهای عامل، چکیده‌های اعلان کامپایل‌شده و مکمل ویکی که از طریق memory_search / memory_get ارائه می‌شود، مخزن را از زمینهٔ عامل فعال شناسایی می‌کنند. برای فراخوانی‌های CLI و Gateway در تنظیمی با چند عامل پیکربندی‌شده، عامل را به‌طور صریح با openclaw wiki --agent <agentId> ... یا agentId درخواست Gateway مشخص کنید. اگر فقط یک عامل پیکربندی شده باشد، در صورت ارائه نشدن شناسه همان عامل پیش‌فرض باقی می‌ماند.

در حالت پل، واردسازی‌های مختص عامل تنها زمانی یک مصنوع عمومی حافظه را می‌پذیرند که agentIds آن شامل عامل انتخاب‌شده باشد. مصنوعات متعلق به عاملی دیگر، مصنوعات فاقد فرادادهٔ مالکیت یا مصنوعات دارای مالک ناشناخته نادیده گرفته می‌شوند. دامنهٔ سراسری رفتار موجود مصنوعات مشترک را حفظ می‌کند.

نمونه: QMD و حالت پل

زمانی از این تنظیم استفاده کنید که QMD را برای بازیابی و memory-wiki را برای یک لایهٔ دانشی نگه‌داری‌شده می‌خواهید. تمرکز هر لایه حفظ می‌شود: QMD یادداشت‌های خام، خروجی‌های نشست و مجموعه‌های اضافی را قابل جست‌وجو نگه می‌دارد، در حالی که memory-wiki موجودیت‌های پایدار، ادعاها، داشبوردها و صفحات منبع را کامپایل می‌کند.

{  memory: {    backend: "qmd",  },  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "bridge",          bridge: {            enabled: true,            readMemoryArtifacts: true,            indexDreamReports: true,            indexDailyNotes: true,            indexMemoryRoot: true,            followMemoryEvents: true,          },          search: {            backend: "shared",            corpus: "all",          },          context: {            includeCompiledDigestPrompt: false,          },        },      },    },  },}

با این تنظیم، QMD مسئول بازیابی حافظهٔ فعال باقی می‌ماند، memory-wiki بر صفحات کامپایل‌شده و داشبوردها تمرکز می‌کند و شکل اعلان تا زمانی که آگاهانه اعلان‌های چکیدهٔ کامپایل‌شده را فعال نکنید، بدون تغییر می‌ماند.

CLI

openclaw wiki statusopenclaw wiki doctoropenclaw wiki initopenclaw wiki ingest ./notes/alpha.mdopenclaw wiki compileopenclaw wiki lintopenclaw wiki search "alpha"openclaw wiki get entity.alphaopenclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alphaopenclaw wiki bridge importopenclaw wiki obsidian status

برای مرجع کامل فرمان‌ها، از جمله wiki okf import، wiki apply metadata، wiki unsafe-local import، wiki chatgpt import / wiki chatgpt rollback و مجموعهٔ کامل زیرفرمان‌های wiki obsidian، به CLI: ویکی مراجعه کنید.

پشتیبانی از Obsidian

وقتی vault.renderMode برابر با obsidian باشد، Plugin فایل Markdown سازگار با Obsidian می‌نویسد و می‌تواند به‌صورت اختیاری از CLI رسمی obsidian برای بررسی وضعیت، جست‌وجوی مخزن، باز کردن صفحه، فراخوانی فرمان و رفتن به یادداشت روزانه استفاده کند. این قابلیت اختیاری است؛ ویکی بدون Obsidian نیز در حالت بومی کار می‌کند.

مخزن‌های مختص عامل همچنان می‌توانند از Markdown سازگار با Obsidian استفاده کنند، اما اعتبارسنجی پیکربندی ترکیب obsidian.useOfficialCli: true با vault.scope: "agent" را رد می‌کند. تنظیم کنونی obsidian.vaultName سراسری است و نمی‌تواند برای هر عامل یک مخزن متمایز Obsidian انتخاب کند. به‌جای آن از ابزارهای ویکی و عملیات CLI استفاده کنید، یا ویکیِ تحت مدیریت Obsidian را در دامنهٔ سراسری نگه دارید.

گردش کار پیشنهادی

مستندات مرتبط

• نمای کلی حافظه
• CLI: حافظه
• CLI: ویکی
• نمای کلی SDK مربوط به Plugin