ویکی حافظه

memory-wiki یک Plugin بسته‌بندی‌شده است که حافظهٔ پایدار را به یک خزانهٔ دانش کامپایل‌شده تبدیل می‌کند.

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

از آن زمانی استفاده کنید که می‌خواهید حافظه بیشتر شبیه یک لایهٔ دانش نگهداری‌شده رفتار کند و کمتر شبیه انبوهی از فایل‌های Markdown باشد.

# چه چیزی اضافه می‌کند

• یک خزانهٔ ویکی اختصاصی با چیدمان صفحهٔ قطعی
• فرادادهٔ ساخت‌یافتهٔ ادعا و شواهد، نه فقط متن روایی
• منشأ، اطمینان، تناقض‌ها، و پرسش‌های باز در سطح صفحه
• چکیده‌های کامپایل‌شده برای مصرف‌کنندگان عامل/زمان اجرا
• ابزارهای بومی ویکی برای جست‌وجو/دریافت/اعمال/لینت
• حالت پل اختیاری که مصنوعات عمومی را از Plugin حافظهٔ فعال وارد می‌کند
• حالت رندر سازگار با Obsidian و یکپارچه‌سازی CLI به‌صورت اختیاری

# چگونه با حافظه هماهنگ می‌شود

این جداسازی را این‌طور در نظر بگیرید:

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

اگر Plugin حافظهٔ فعال مصنوعات یادآوری مشترک را ارائه دهد، OpenClaw می‌تواند هر دو لایه را در یک گذر با memory_search corpus=all جست‌وجو کند.

وقتی به رتبه‌بندی ویژهٔ ویکی، منشأ، یا دسترسی مستقیم به صفحه نیاز دارید، به‌جای آن از ابزارهای بومی ویکی استفاده کنید.

# الگوی ترکیبی پیشنهادی

یک پیش‌فرض قوی برای راه‌اندازی‌های local-first این است:

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

این جداسازی خوب عمل می‌کند چون هر لایه متمرکز می‌ماند:

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

قاعدهٔ عملی:

• از memory_search وقتی استفاده کنید که یک گذر یادآوری گسترده در سراسر حافظه می‌خواهید
• از wiki_search و wiki_get وقتی استفاده کنید که نتایج ویکی آگاه از منشأ می‌خواهید
• از memory_search corpus=all وقتی استفاده کنید که می‌خواهید جست‌وجوی مشترک هر دو لایه را پوشش دهد

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

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

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

memory-wiki از سه حالت خزانه پشتیبانی می‌کند:

# isolated

خزانهٔ خودش، منابع خودش، بدون وابستگی به memory-core.

از این حالت زمانی استفاده کنید که می‌خواهید ویکی ذخیره‌گاه دانش گزینش‌شدهٔ خودش باشد.

# bridge

مصنوعات حافظهٔ عمومی و رویدادهای حافظه را از Plugin حافظهٔ فعال از طریق نقاط اتصال عمومی SDK Plugin می‌خواند.

از این حالت زمانی استفاده کنید که می‌خواهید ویکی مصنوعات صادرشدهٔ Plugin حافظه را بدون دسترسی به درون‌ساخت‌های خصوصی Plugin کامپایل و سازمان‌دهی کند.

حالت پل می‌تواند این موارد را نمایه کند:

• مصنوعات حافظهٔ صادرشده
• گزارش‌های رؤیا
• یادداشت‌های روزانه
• فایل‌های ریشهٔ حافظه
• لاگ‌های رویداد حافظه

# unsafe-local

راه فرار صریح همان‌ماشین برای مسیرهای خصوصی محلی.

این حالت عمداً آزمایشی و غیرقابل حمل است. فقط زمانی از آن استفاده کنید که مرز اعتماد را می‌فهمید و مشخصاً به دسترسی به سیستم فایل محلی نیاز دارید که حالت پل نمی‌تواند فراهم کند.

# چیدمان خزانه

Plugin یک خزانه را به این شکل مقداردهی اولیه می‌کند:

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

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

گروه‌های اصلی صفحه عبارت‌اند از:

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

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

صفحه‌ها می‌توانند frontmatter ساخت‌یافتهٔ claims داشته باشند، نه فقط متن آزاد.

هر ادعا می‌تواند شامل این موارد باشد:

• id
• text
• status
• confidence
• evidence[]
• updatedAt

ورودی‌های شواهد می‌توانند شامل این موارد باشند:

• kind
• sourceId
• path
• lines
• weight
• confidence
• privacyTier
• note
• updatedAt

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

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

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

فیلدهای رایج شامل این موارد است:

• entityType: برای مثال person، team، system، یا project
• canonicalId: کلید هویت پایدار که در سراسر نام‌های مستعار و واردات استفاده می‌شود
• aliases: نام‌ها، شناسه‌ها، یا برچسب‌هایی که باید به همان صفحه resolve شوند
• privacyTier: public، local-private، sensitive، یا confirm-before-use
• bestUsedFor / notEnoughFor: راهنمایی‌های فشردهٔ مسیریابی
• lastRefreshedAt: مُهر زمانی تازه‌سازی منبع، جدا از زمان ویرایش صفحه
• personCard: کارت مسیریابی اختیاری ویژهٔ شخص با شناسه‌ها، شبکه‌های اجتماعی، ایمیل‌ها، منطقهٔ زمانی، مسیر، موارد قابل پرسش، مواردی که نباید پرسیده شوند، اطمینان، و حریم خصوصی
• relationships: یال‌های تایپ‌شده به صفحه‌های مرتبط با مقصد، نوع، وزن، اطمینان، نوع شواهد، سطح حریم خصوصی، و یادداشت

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

مثال:

pageType: entity
entityType: person
id: entity.brad-groux
canonicalId: maintainer.brad-groux
aliases:
  - Brad
  - bgroux
privacyTier: local-private
bestUsedFor:
  - Microsoft Teams and Azure routing
notEnoughFor:
  - legal approval
lastRefreshedAt: "2026-04-29T00:00:00.000Z"
personCard:
  handles:
    - "@bgroux"
  socials:
    - "https://x.example/bgroux"
  emails:
    - [email protected]
  timezone: America/Chicago
  lane: Microsoft ecosystem
  askFor:
    - Teams rollout questions
  avoidAskingFor:
    - unrelated billing decisions
  confidence: 0.8
  privacyTier: confirm-before-use
relationships:
  - targetId: entity.alice
    targetTitle: Alice
    kind: collaborates-with
    confidence: 0.7
    evidenceKind: discrawl-stat
claims:
  - id: claim.brad.teams
    text: Brad is useful for Microsoft Teams 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 را scrape کنند.

خروجی کامپایل‌شده همچنین این موارد را تأمین می‌کند:

• نمایه‌سازی گذر اول ویکی برای جریان‌های جست‌وجو/دریافت
• جست‌وجوی شناسهٔ ادعا به صفحه‌های مالک
• مکمل‌های فشردهٔ prompt
• تولید گزارش/داشبورد

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

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

گزارش‌های داخلی شامل این موارد است:

• reports/open-questions.md
• reports/contradictions.md
• reports/low-confidence.md
• reports/claim-health.md
• reports/stale-pages.md
• reports/person-agent-directory.md
• reports/relationship-graph.md
• reports/provenance-coverage.md
• reports/privacy-review.md

این گزارش‌ها مواردی مانند این‌ها را ردیابی می‌کنند:

• خوشه‌های یادداشت تناقض
• خوشه‌های ادعاهای رقیب
• ادعاهایی که شواهد ساخت‌یافته ندارند
• صفحه‌ها و ادعاهای کم‌اطمینان
• تازگی منسوخ یا ناشناخته
• صفحه‌هایی با پرسش‌های حل‌نشده
• کارت‌های مسیریابی شخص/موجودیت
• یال‌های رابطهٔ ساخت‌یافته
• پوشش کلاس شواهد
• سطوح حریم خصوصی غیرعمومی که پیش از استفاده نیاز به بازبینی دارند

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

memory-wiki از دو بک‌اند جست‌وجو پشتیبانی می‌کند:

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

همچنین از سه پیکره پشتیبانی می‌کند:

• wiki
• memory
• all

رفتار مهم:

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

قاعدهٔ عملی:

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

حالت‌های جست‌وجو:

• auto: پیش‌فرض متوازن
• find-person: موجودیت‌های شبیه شخص، نام‌های مستعار، شناسه‌ها، شبکه‌های اجتماعی، و شناسه‌های canonical را تقویت می‌کند
• route-question: کارت‌های عامل، راهنمایی‌های ask-for، راهنمایی‌های best-used-for، و بافت رابطه را تقویت می‌کند
• source-evidence: صفحه‌های منبع و فرادادهٔ شواهد ساخت‌یافته را تقویت می‌کند
• raw-claim: ادعاهای ساخت‌یافتهٔ مطابق را تقویت می‌کند و فرادادهٔ ادعا/شواهد را در نتایج برمی‌گرداند

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

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

Plugin این ابزارها را ثبت می‌کند:

• wiki_status
• wiki_search
• wiki_get
• wiki_apply
• wiki_lint

کارکرد آن‌ها:

• wiki_status: حالت فعلی خزانه، سلامت، دسترس‌پذیری CLI مربوط به Obsidian
• wiki_search: صفحه‌های ویکی و، در صورت پیکربندی، پیکره‌های حافظهٔ مشترک را جست‌وجو می‌کند؛ mode را برای یافتن شخص، مسیریابی پرسش، شواهد منبع، یا واکاوی ادعای خام می‌پذیرد
• wiki_get: یک صفحهٔ ویکی را با شناسه/مسیر می‌خواند یا به پیکرهٔ حافظهٔ مشترک fallback می‌کند
• wiki_apply: جهش‌های محدود سنتز/فراداده بدون جراحی آزادانهٔ صفحه
• wiki_lint: بررسی‌های ساختاری، شکاف‌های منشأ، تناقض‌ها، پرسش‌های باز

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

# رفتار prompt و بافت

وقتی context.includeCompiledDigestPrompt فعال باشد، بخش‌های prompt حافظه یک snapshot کامپایل‌شدهٔ فشرده از agent-digest.json اضافه می‌کنند.

این snapshot عمداً کوچک و پرسیگنال است:

• فقط صفحه‌های برتر
• فقط ادعاهای برتر
• شمار تناقض‌ها
• شمار پرسش‌ها
• توصیفگرهای اطمینان/تازگی

این حالت opt-in است، چون شکل prompt را تغییر می‌دهد و عمدتاً برای موتورهای بافت یا مونتاژ prompt قدیمی که به‌صراحت مکمل‌های حافظه را مصرف می‌کنند مفید است.

# پیکربندی

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

{
  plugins: {
    entries: {
      "memory-wiki": {
        enabled: true,
        config: {
          vaultMode: "isolated",
          vault: {
            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,
          },
          ingest: {
            autoCompile: true,
            maxConcurrentJobs: 1,
            allowUrlIngest: true,
          },
          search: {
            backend: "shared",
            corpus: "wiki",
          },
          context: {
            includeCompiledDigestPrompt: false,
          },
          render: {
            preserveHumanBlocks: true,
            createBacklinks: true,
            createDashboards: true,
          },
        },
      },
    },
  },
}

کلیدهای اصلی:

• vaultMode: isolated، bridge، unsafe-local
• vault.renderMode: native یا obsidian
• bridge.readMemoryArtifacts: وارد کردن مصنوعات عمومی Plugin حافظه فعال
• bridge.followMemoryEvents: گنجاندن گزارش‌های رویداد در حالت پل
• search.backend: shared یا local
• search.corpus: wiki، memory یا all
• context.includeCompiledDigestPrompt: افزودن نمای فشردهٔ digest به بخش‌های پرامپت حافظه
• render.createBacklinks: تولید بلوک‌های مرتبط قطعی
• render.createDashboards: تولید صفحه‌های داشبورد

# مثال: حالت QMD + پل

وقتی 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 روی صفحه‌های کامپایل‌شده و داشبوردها متمرکز می‌ماند
• شکل پرامپت تا زمانی که عمداً پرامپت‌های digest کامپایل‌شده را فعال کنید، بدون تغییر می‌ماند

# CLI

memory-wiki همچنین یک سطح CLI سطح‌بالا ارائه می‌کند:

openclaw wiki status
openclaw wiki doctor
openclaw wiki init
openclaw wiki ingest ./notes/alpha.md
openclaw wiki compile
openclaw wiki lint
openclaw wiki search "alpha"
openclaw wiki get entity.alpha
openclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alpha
openclaw wiki bridge import
openclaw wiki obsidian status

برای مرجع کامل فرمان‌ها، CLI: wiki را ببینید.

# پشتیبانی Obsidian

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

گردش‌کارهای پشتیبانی‌شده شامل موارد زیر است:

• بررسی وضعیت
• جست‌وجوی vault
• باز کردن یک صفحه
• فراخوانی یک فرمان Obsidian
• رفتن به یادداشت روزانه

این اختیاری است. ویکی همچنان در حالت بومی بدون Obsidian کار می‌کند.

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

1. Plugin حافظه فعال خود را برای یادآوری/ارتقا/Dreaming نگه دارید.
2. memory-wiki را فعال کنید.
3. مگر اینکه صراحتاً حالت پل را بخواهید، با حالت isolated شروع کنید.
4. وقتی منشأ و شواهد اهمیت دارد، از wiki_search / wiki_get استفاده کنید.
5. برای ترکیب‌های محدود یا به‌روزرسانی‌های فراداده، از wiki_apply استفاده کنید.
6. پس از تغییرات معنادار، wiki_lint را اجرا کنید.
7. اگر دیدپذیری موارد کهنه/تناقض‌ها را می‌خواهید، داشبوردها را روشن کنید.

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

• مرور کلی حافظه
• CLI: memory
• CLI: wiki
• مرور کلی Plugin SDK