memory status
像先看看记忆卡片盒现在健不健康，抽屉有没有脏、钥匙有没有丢。
Cli 导读
用 openclaw memory 管理语义记忆：索引、搜索与自动巩固
先跑 `openclaw memory status --deep` 检查向量和嵌入是否可用，这是所有记忆功能的前提。`memory promote` 的深度阶段才会把短期记忆写入 `MEMORY.md`，别被 `--dry-run` 的输出骗了。如果启用 dreaming，记得在配置里开 `dreaming.enabled: true`，否则后台巩固不会启动。
先讲这一页到底在解决什么
用 openclaw memory 管理语义记忆：索引、搜索与自动巩固
先跑 `openclaw memory status --deep` 检查向量和嵌入是否可用，这是所有记忆功能的前提。`memory promote` 的深度阶段才会把短期记忆写入 `MEMORY.md`，别被 `--dry-run` 的输出骗了。如果启用 dreaming，记得在配置里开 `dreaming.enabled: true`，否则后台巩固不会启动。
第一站
📚 先把这 3 个主动作记成“看卡片盒、重做卡片、按意思翻卡片”
官方示例其实已经把主线交代完了：status、index、search。只要把这三件事分清，整页就不难。
memory index
像重新把旧故事切成卡片，再一张张放回抽屉里。
memory search
像问管理员：“帮我找和 deployment、meeting notes 最像的那几张记忆卡。”
一句话
先看状态，再建索引，最后按意思找。
第二站
🔦 status、--deep、--index，像“看一眼、照深一点、顺手重整抽屉”
这一组参数不是在堆功能，而是在决定你今天只想巡一圈，还是想把抽屉深处也一起照一照。
openclaw memory status像先站在抽屉柜前看看：卡片盒还在不在，门是不是卡住了。
--deep像把手电筒往更里面照，确认向量库和 embedding 那套齿轮是不是也都能转。
--index像发现抽屉里纸片有点乱，于是顺手把该重做的卡片重新整理一遍。官方说它会隐含 --deep，因为要真整理，就得先看深处。
--json像把检查结果装成一张标准报表，方便脚本继续接着看。
第三站
🛠️ index --force 像“别修修补补了，整柜卡片重做一遍”
平时索引可能只是补一点脏掉的部分，但 --force 的意思更重。
普通 index
像把最近新增或弄乱的那批卡片补齐。
--force
像把整排卡片柜重新洗牌重做，不再只补局部。
--verbose
像管理员一边重做，一边把“现在在切哪批卡、用哪个模型、进度到哪”念给你听。
--agent main
像别翻整栋楼所有人的卡片柜，只处理 main 这一间工位自己的那套抽屉。
第四站
🔍 search 最像“说一句大概意思，让管理员去翻最像的几张卡”
这部分最容易被误会成普通 grep。其实它更像“按意思”找，而不是只按字面找。
openclaw memory search "meeting notes"像你只说一个印象：“帮我找和会议笔记有关的那些卡。”
--query 胜过位置参数像你嘴上说了一个词，后来又递了一张更正式的小纸条，那管理员会以纸条为准。
--max-results / --min-score像限定“最多拿几张来”和“太不像的别拿出来”。
不写 query 会报错
像你只说“帮我找”，却没说找什么，管理员当然只能摊手。
第五站
🔐 SecretRef 那段在说：有些记忆库钥匙藏在远处抽屉里，拿不到就先别硬开
官方特别提醒了 memory remote API key 可能是 SecretRef 管理的。这类提示都在讲同一件事：开门前先拿到正确钥匙。
SecretRef 可解析
像管理员能从活动 Gateway 快照里拿到那把远程记忆库钥匙，就继续工作。
Gateway 不可用
像钥匙柜暂时够不着，那它会直接拦下，不乱猜也不乱开。
版本太旧也不行
如果 Gateway 老到还不会 secrets.resolve，这条路也走不通，像门锁和新钥匙规格不匹配。
一句话
记忆抽屉能不能打开，先看钥匙到不到位。
最后总结
🎈 把 openclaw memory 压成一句话
openclaw memory 就像一套会检索的记忆卡片柜：先看卡片柜状态，再决定要不要整柜重建，最后按“意思”去翻最像的那几张旧故事卡。