openclaw memory

نمایه‌سازی و جست‌وجوی حافظهٔ معنایی را مدیریت کنید. توسط Plugin همراه memory-core ارائه می‌شود. این دستور زمانی در دسترس است که plugins.slots.memory مقدار memory-core را انتخاب کند (پیش‌فرض)؛ سایر Pluginهای حافظه فضاهای نام CLI خودشان را ارائه می‌کنند.

مرتبط:

• مفهوم حافظه: حافظه
• ویکی حافظه: ویکی حافظه
• CLI ویکی: wiki
• Pluginها: Pluginها

مثال‌ها

openclaw memory statusopenclaw memory status --deepopenclaw memory status --fixopenclaw memory index --forceopenclaw memory search "meeting notes"openclaw memory search --query "deployment" --max-results 20openclaw memory promote --limit 10 --min-score 0.75openclaw memory promote --applyopenclaw memory promote --json --min-recall-count 0 --min-unique-queries 0openclaw memory promote-explain "router vlan"openclaw memory promote-explain "router vlan" --jsonopenclaw memory rem-harnessopenclaw memory rem-harness --jsonopenclaw memory status --jsonopenclaw memory status --deep --indexopenclaw memory status --deep --index --verboseopenclaw memory status --agent mainopenclaw memory index --agent main --verbose

گزینه‌ها

memory status و memory index:

• --agent <id>: دامنه را به یک عامل واحد محدود می‌کند. بدون آن، این دستورها برای هر عامل پیکربندی‌شده اجرا می‌شوند؛ اگر فهرست عاملی پیکربندی نشده باشد، به عامل پیش‌فرض برمی‌گردند.
• --verbose: هنگام بررسی‌ها و نمایه‌سازی، گزارش‌های تفصیلی منتشر می‌کند.

memory status:

• --deep: آمادگی ذخیره‌گاه برداری محلی، آمادگی ارائه‌دهندهٔ embedding، و آمادگی جست‌وجوی برداری معنایی را بررسی می‌کند. memory status ساده سریع می‌ماند و کار زندهٔ embedding یا کشف ارائه‌دهنده را اجرا نمی‌کند؛ وضعیت ناشناختهٔ ذخیره‌گاه برداری یا بردار معنایی یعنی در آن دستور بررسی نشده است. حالت واژگانی QMD با searchMode: "search" حتی با --deep بررسی‌های برداری معنایی و نگهداشت embedding را رد می‌کند.
• --index: اگر ذخیره‌گاه کثیف باشد، بازنمایه‌سازی اجرا می‌کند (مستلزم --deep است).
• --fix: قفل‌های recall کهنه را تعمیر و فرادادهٔ promotion را نرمال‌سازی می‌کند.
• --json: خروجی JSON چاپ می‌کند.

اگر memory status نشان دهد Dreaming status: blocked، Cron مدیریت‌شدهٔ Dreaming فعال است اما Heartbeat محرک آن برای عامل پیش‌فرض اجرا نمی‌شود. برای دو علت رایج، Dreaming هرگز اجرا نمی‌شود را ببینید.

memory index:

• --force: یک بازنمایه‌سازی کامل را اجباری می‌کند.

memory search:

• ورودی پرس‌وجو: یا [query] مکانی را بدهید یا --query <text>.
• اگر هر دو ارائه شوند، --query اولویت دارد.
• اگر هیچ‌کدام ارائه نشود، دستور با خطا خارج می‌شود.
• --agent <id>: دامنه را به یک عامل واحد محدود می‌کند (پیش‌فرض: عامل پیش‌فرض).
• --max-results <n>: تعداد نتایج برگشتی را محدود می‌کند.
• --min-score <n>: تطابق‌های با امتیاز پایین را فیلتر می‌کند.
• --json: نتایج JSON چاپ می‌کند.

memory promote:

promotionهای حافظهٔ کوتاه‌مدت را پیش‌نمایش و اعمال کنید.

openclaw memory promote [--apply] [--limit <n>] [--include-promoted]

• --apply -- promotionها را در MEMORY.md می‌نویسد (پیش‌فرض: فقط پیش‌نمایش).
• --limit <n> -- تعداد نامزدهای نمایش‌داده‌شده را سقف‌گذاری می‌کند.
• --include-promoted -- ورودی‌هایی را که در چرخه‌های قبلی از قبل promote شده‌اند شامل می‌کند.

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

• نامزدهای کوتاه‌مدت را از memory/YYYY-MM-DD.md با استفاده از سیگنال‌های وزن‌دار promotion (frequency، relevance، query diversity، recency، consolidation، conceptual richness) رتبه‌بندی می‌کند.
• از سیگنال‌های کوتاه‌مدت هم از recallهای حافظه و هم از گذرهای ingestion روزانه، به‌علاوهٔ سیگنال‌های تقویتی مرحلهٔ light/REM استفاده می‌کند.
• وقتی Dreaming فعال باشد، memory-core یک کار Cron را به‌صورت خودکار مدیریت می‌کند که یک جاروب کامل (light -> REM -> deep) را در پس‌زمینه اجرا می‌کند (نیازی به openclaw cron add دستی نیست).
• --agent <id>: دامنه را به یک عامل واحد محدود می‌کند (پیش‌فرض: عامل پیش‌فرض).
• --limit <n>: حداکثر نامزدها برای بازگرداندن/اعمال.
• --min-score <n>: حداقل امتیاز وزن‌دار promotion.
• --min-recall-count <n>: حداقل تعداد recall لازم برای یک نامزد.
• --min-unique-queries <n>: حداقل تعداد پرس‌وجوهای متمایز لازم برای یک نامزد.
• --apply: نامزدهای انتخاب‌شده را به MEMORY.md اضافه می‌کند و آن‌ها را promote‌شده علامت می‌زند.
• --include-promoted: نامزدهایی را که از قبل promote شده‌اند در خروجی شامل می‌کند.
• --json: خروجی JSON چاپ می‌کند.

memory promote-explain:

یک نامزد promotion مشخص و تفکیک امتیاز آن را توضیح می‌دهد.

openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]

• <selector>: کلید نامزد، قطعه‌ای از مسیر، یا قطعه‌ای از snippet برای جست‌وجو.
• --agent <id>: دامنه را به یک عامل واحد محدود می‌کند (پیش‌فرض: عامل پیش‌فرض).
• --include-promoted: نامزدهایی را که از قبل promote شده‌اند شامل می‌کند.
• --json: خروجی JSON چاپ می‌کند.

memory rem-harness:

بازتاب‌های REM، حقیقت‌های نامزد، و خروجی promotion عمیق را بدون نوشتن هیچ‌چیز پیش‌نمایش می‌کند.

openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]

• --agent <id>: دامنه را به یک عامل واحد محدود می‌کند (پیش‌فرض: عامل پیش‌فرض).
• --include-promoted: نامزدهای عمیقی را که از قبل promote شده‌اند شامل می‌کند.
• --json: خروجی JSON چاپ می‌کند.

Dreaming

Dreaming سامانهٔ تحکیم حافظه در پس‌زمینه است، با سه مرحلهٔ همکاری‌کننده: light (مرتب‌سازی/آماده‌سازی مواد کوتاه‌مدت)، deep (promote کردن واقعیت‌های پایدار به MEMORY.md)، و REM (بازتاب و نمایان‌کردن مضمون‌ها).

• با plugins.entries.memory-core.config.dreaming.enabled: true فعال کنید.
• از گفت‌وگو با /dreaming on|off تغییر وضعیت دهید (یا با /dreaming status بررسی کنید). فراخوان‌های کانال برای تغییر این تنظیم باید مالک باشند؛ کلاینت‌های Gateway به operator.admin نیاز دارند. وضعیت فقط‌خواندنی و راهنما برای ارسال‌کنندگان مجاز دستور همچنان در دسترس می‌مانند.
• Dreaming روی یک زمان‌بندی جاروب مدیریت‌شده (dreaming.frequency) اجرا می‌شود و مراحل را به‌ترتیب اجرا می‌کند: light، REM، deep.
• فقط مرحلهٔ deep حافظهٔ پایدار را در MEMORY.md می‌نویسد.
• خروجی خوانای انسانی مرحله و ورودی‌های دفترچه در DREAMS.md (یا dreams.md موجود) نوشته می‌شوند، با گزارش‌های اختیاری برای هر مرحله در memory/dreaming/<phase>/YYYY-MM-DD.md.
• رتبه‌بندی از سیگنال‌های وزن‌دار استفاده می‌کند: فراوانی recall، ارتباط retrieval، تنوع پرس‌وجو، تازگی زمانی، تحکیم میان‌روزی، و غنای مفهومی مشتق‌شده.
• promotion پیش از نوشتن در MEMORY.md یادداشت روزانهٔ زنده را دوباره می‌خواند، بنابراین snippetهای کوتاه‌مدت ویرایش‌شده یا حذف‌شده از snapshotهای کهنهٔ recall-store promote نمی‌شوند.
• اجراهای زمان‌بندی‌شده و دستی memory promote پیش‌فرض‌های مرحلهٔ deep یکسانی را به اشتراک می‌گذارند، مگر اینکه overrideهای آستانهٔ CLI را بدهید.
• اجراهای خودکار در سراسر workspaceهای حافظهٔ پیکربندی‌شده پخش می‌شوند.

زمان‌بندی پیش‌فرض:

• آهنگ جاروب: dreaming.frequency = 0 3 * * *
• آستانه‌های Deep: minScore=0.8، minRecallCount=3، minUniqueQueries=3، recencyHalfLifeDays=14، maxAgeDays=30

مثال:

{  "plugins": {    "entries": {      "memory-core": {        "config": {          "dreaming": {            "enabled": true          }        }      }    }  }}

نکته‌ها:

• memory index --verbose جزئیات هر مرحله را چاپ می‌کند (ارائه‌دهنده، مدل، منابع، فعالیت batch).
• memory status هر مسیر اضافی پیکربندی‌شده از طریق memorySearch.extraPaths را شامل می‌شود.
• اگر فیلدهای کلید API راه‌دور Active Memory که عملاً فعال هستند به‌صورت SecretRefs پیکربندی شده باشند، دستور آن مقادیر را از snapshot فعال Gateway حل می‌کند. اگر Gateway در دسترس نباشد، دستور سریعاً شکست می‌خورد.
• نکتهٔ ناهمخوانی نسخهٔ Gateway: این مسیر دستور به Gatewayای نیاز دارد که از secrets.resolve پشتیبانی کند؛ Gatewayهای قدیمی‌تر خطای unknown-method برمی‌گردانند.
• آهنگ جاروب زمان‌بندی‌شده را با dreaming.frequency تنظیم کنید. سیاست promotion عمیق در غیر این صورت داخلی است، به‌جز dreaming.phases.deep.maxPromotedSnippetTokens که طول snippet promote‌شده را محدود می‌کند و در عین حال منشأ را قابل مشاهده نگه می‌دارد. وقتی به overrideهای دستی و یک‌بارهٔ آستانه نیاز دارید، از پرچم‌های CLI روی memory promote استفاده کنید.
• memory rem-harness --path <file-or-dir> --grounded از یادداشت‌های روزانهٔ تاریخی، What Happened، Reflections، و Possible Lasting Updates مبتنی بر زمینه را بدون نوشتن هیچ‌چیز پیش‌نمایش می‌کند.
• memory rem-backfill --path <file-or-dir> ورودی‌های دفترچهٔ مبتنی بر زمینه و برگشت‌پذیر را برای بازبینی UI در DREAMS.md می‌نویسد.
• memory rem-backfill --path <file-or-dir> --stage-short-term همچنین نامزدهای پایدار مبتنی بر زمینه را در ذخیره‌گاه promotion کوتاه‌مدت زنده seed می‌کند تا مرحلهٔ deep عادی بتواند آن‌ها را رتبه‌بندی کند.
• memory rem-backfill --rollback ورودی‌های دفترچهٔ مبتنی بر زمینهٔ نوشته‌شدهٔ قبلی را حذف می‌کند، و memory rem-backfill --rollback-short-term نامزدهای کوتاه‌مدت مبتنی بر زمینهٔ stage‌شدهٔ قبلی را حذف می‌کند.
• برای توضیحات کامل مراحل و مرجع پیکربندی، Dreaming را ببینید.

مرتبط

• مرجع CLI
• نمای کلی حافظه