memory

openclaw memory 命令是和你的“记忆小本子”说话的工具。这个“小本子”其实是一个叫 memory-core 的插件在帮你工作。如果你不想用这个“小本子”，可以告诉系统把它关掉。

你可以用这个命令做三件事：

1. 看看小本子的状态 (status)：就像检查小本子有没有准备好，里面有没有东西。
2. 让小本子重新记东西 (index)：就像把小本子里的内容重新整理一遍，让它记得更清楚。
3. 在小本子里找东西 (search)：就像问小本子：“喂，你记得关于‘开会笔记’的事情吗？”

下面是一些例子，看看怎么和“小本子”说话：

• openclaw memory status：简单看看小本子状态。
• openclaw memory status --deep：仔细检查小本子，看看它记东西的能力好不好。
• openclaw memory index --force：不管怎样，都让小本子从头到尾重新记一遍所有东西。
• openclaw memory search "meeting notes"：在小本子里找所有和“开会笔记”有关的内容。
• openclaw memory search --query "deployment" --max-results 20：找关于“部署”的内容，最多只给我看20条最好的。

给命令加“小尾巴”（选项）可以告诉它更多细节：

检查状态 (status) 和重新记东西 (index) 时都可以用的“小尾巴”：

• --agent <id>：只和指定的一个“小助手”说话。如果不加这个，命令会和所有的小助手都说一遍。
• --verbose：让命令说话更详细，告诉你它每一步在干嘛。

只在检查状态 (status) 时用的“小尾巴”：

• --deep：仔细检查小本子记东西的能力。
• --index：如果发现小本子有点乱，就顺便让它重新整理一下（用了这个，就自动包含 --deep 了）。
• --json：让小本子用一种叫 JSON 的格式回答你，这样其他程序也能看懂。

只在重新记东西 (index) 时用的“小尾巴”：

• --force：不管小本子乱不乱，都强迫它从头开始重新记。

只在找东西 (search) 时用的“小尾巴”：

• 你可以直接把要找的词写在命令后面，比如 search "meeting notes"，也可以用 --query 这个小尾巴来写。
• 如果两个都写了，命令会听 --query 的。
• 如果两个都没写，命令会生气，告诉你出错了。
• --agent <id>：只在指定的小助手的记忆里找（如果不写，就在默认的小助手那里找）。
• --max-results <n>：最多给我看几条结果。
• --min-score <n>：分数太低的、不太像的结果就不要给我看了。
• --json：用 JSON 格式给我看结果。

要小心的事情：

• 用 memory index --verbose 时，它会告诉你很多整理记忆的细节。
• 检查状态时，它也会看看你有没有告诉它去别的地方找记忆（通过 memorySearch.extraPaths 设置）。
• 如果你的“记忆小本子”需要一把秘密的钥匙（API key）才能用，命令会尝试去一个叫“网关”的地方拿这把钥匙。如果“网关”不在家，命令就会立刻停下来，告诉你它失败了。
• 注意哦，这个拿钥匙的功能需要比较新的“网关”版本。如果“网关”太旧了，它会说“我不知道怎么拿钥匙”。