ویکی حافظه

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

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

پیش از استفاده از CLI، ابزارها یا یکپارچه‌سازی زمان اجرای آن، Plugin را فعال کنید:

openclaw plugins enable memory-wikiopenclaw gateway restart

قاعدهٔ عملی:

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

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

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

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

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

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

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

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

حالت پل می‌تواند بر اساس کلید روشن/خاموش پیکربندی bridge.* موارد زیر را نمایه‌سازی کند:

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

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

چیدمان مخزن

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

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

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

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

openclaw wiki okf import ./bundles/ga4

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

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

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

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

صفحه‌ها دارای فرادادهٔ ابتدایی ساختاریافتهٔ 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:- مسیریابی نمونه در اکوسیستمnotEnoughFor:- تأیید حقوقیlastRefreshedAt: "2026-04-29T00:00:00.000Z"personCard:handles:  - "@example-handle"socials:  - "https://x.example/example-handle"emails:  - alex@example.comtimezone: America/Chicagolane: اکوسیستم نمونهaskFor:  - پرسش‌های نمونه دربارهٔ عرضهavoidAskingFor:  - تصمیم‌های نامرتبط صورت‌حسابconfidence: 0.8privacyTier: confirm-before-userelationships:- targetId: entity.other-person  targetTitle: شخص دیگر  kind: collaborates-with  confidence: 0.7  evidenceKind: discrawl-statclaims:- id: claim.example.routing  text: Alex برای مسیریابی در اکوسیستم نمونه مفید است.  status: supported  confidence: 0.9  evidence:    - kind: maintainer-whois      sourceId: source.maintainers      privacyTier: local-private

پایپ‌لاین کامپایل

کامپایل، صفحه‌های ویکی را می‌خواند، خلاصه‌ها را نرمال‌سازی می‌کند و یک تصویر لحظه‌ای ماشین‌محور را در وضعیت مشترک SQLite مربوط به Plugin در OpenClaw ذخیره می‌کند. کد زمان اجرا از تصویر لحظه‌ای مالک تحت مدیریت چرخهٔ حیات برای بارگذاری SQLite هنگام آماده‌سازی ناهمگام پرامپت استفاده می‌کند؛ مونتاژ همگام پرامپت هرگز Markdown را استخراج یا فایل‌های کش را نمی‌خواند. خروجی کامپایل‌شده همچنین نمایه‌سازی مرحلهٔ نخست ویکی برای جست‌وجو/دریافت، نگاشت شناسهٔ ادعا به صفحهٔ مالک، مکمل‌های فشردهٔ پرامپت و تولید گزارش را تأمین می‌کند.

ویرایش‌های منبع و بازیابی‌های مخزن تنها پس از کامپایل بعدی برای ماشین قابل‌استفاده می‌شوند. راه‌اندازی مجدد یا تازه‌سازی چرخهٔ حیات Plugin، انتشار کامپایل زنجیره‌شدهٔ علّی مخزن را با SQLite مقایسه می‌کند و تصویر لحظه‌ای متعلق به وضعیت جدیدتری را که به عقب برگردانده شده است، رد می‌کند. کامپایلری که پیش از بازگردانی آغاز شده باشد نمی‌تواند در برابر وضعیت پیشین بازیابی‌شده منتشر کند. آماده‌سازی پرامپت مخزن را پایش نمی‌کند و ناظر فایل نصب نمی‌کند. پس از قرنطینهٔ بازگردانی، یک کامپایل در فرایند در حال اجرا مالک را بلافاصله پاک می‌کند؛ فرایند کامپایلر جداگانه به تازه‌سازی چرخهٔ حیات Plugin نیاز دارد تا دیمون بتواند انتشار ماندگار جدید را تأیید کند. کش‌های کامپایل‌شده قابل بازسازی‌اند: ردیف‌های کش مربوط به پیش از دوره‌های انتشار ناموفق تلقی می‌شوند و با کامپایل بعدی جایگزین می‌شوند؛ آن‌ها مهاجرت داده نمی‌شوند.

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

هنگامی که 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 فعال باشد، بخش‌های پرامپت حافظه یک تصویر لحظه‌ای فشرده و کامپایل‌شده از وضعیت Plugin اضافه می‌کنند: فقط صفحات برتر، فقط ادعاهای برتر، تعداد تناقض‌ها، تعداد پرسش‌ها و شاخص‌های اطمینان/تازگی. این قابلیت اختیاری است، زیرا شکل پرامپت را تغییر می‌دهد؛ عمدتاً برای موتورهای زمینه یا مونتاژ پرامپت اهمیت دارد که مکمل‌های حافظه را صریحاً مصرف می‌کنند.

پیکربندی

پیکربندی را زیر 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 را مسئول بازیابی Active Memory نگه می‌دارد، تمرکز 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