其他
在 Moltbot/Clawdbot 中配置持久记忆搜索…
当需要为 Moltbot/Clawdbot 启用并配置 memorySearch、MEMORY.md、每日日志和向量搜索以获得持久上下文时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 57/100 ×0.15
适用场景
在 Moltbot/Clawdbot 中特定
解决思路
- 启用记忆搜索:在 `~/.clawdbot/clawdbot.json`(或 `moltbot.json`)中添加配置:`{"memorySearch": {"enabled": true, "provider": "voyage", "sources": ["memory", "sessions"], "indexMode": "hot", "minScore": 0.3, "maxResults": 20}}`。
- 在工作区创建目录结构:`workspace/` 下有 `MEMORY.md`,以及 `memory/logs/`(每日日志,文件名 YYYY-MM-DD.md)、`memory/projects/`(项目特定上下文)、`memory/groups/`(群聊上下文)、`memory/system/`(偏好、设置说明)。
- 在工作区根目录创建 `MEMORY.md`,使用以下结构:`# MEMORY.md — Long-Term Memory`,`## About [User Name]`(关键事实、偏好、上下文),`## Active Projects`(项目摘要和状态),`## Decisions & Lessons`(重要选择和经验教训),`## Preferences`(沟通风格、工具和工作流)。
- 配置项说明与推荐值:`enabled` 开启记忆搜索,推荐 `true`;`provider` 嵌入提供方,推荐 `"voyage"`;`sources` 要索引的内容,推荐 `["memory", "sessions"]`;`indexMode` 何时索引,推荐 `"hot"`(实时);`minScore` 相关性阈值,推荐 `0.3`(越低结果越多);`maxResults` 最多返回片段数,推荐 `20`。
- 选择 provider:`voyage` 使用 Voyage AI embeddings(推荐);`openai` 使用 OpenAI embeddings;`local` 使用本地 embeddings(无需 API)。
- 选择 sources:`memory` 索引 MEMORY.md + memory/*.md 文件;`sessions` 索引过去对话记录;`both` 获取完整上下文(推荐)。
- 每天创建 `memory/logs/YYYY-MM-DD.md`,格式为:`# YYYY-MM-DD — Daily Log`,然后每个事件写 `## [Time] — [Event/Task]`,下面列 `- What happened`、`- Decisions made`、`- Follow-ups needed`。
- 在 AGENTS.md 中添加 `## Memory Recall`:在回答关于先前工作、决策、日期、人物、偏好或待办事项的问题前:1. 用相关查询运行 `memory_search`;2. 如需要,用 `memory_get` 拉取具体行;3. 如果搜索后置信度低,说明你已检查过。
- 记忆搜索不工作时:检查 `memorySearch.enabled: true`;确认 workspace 根目录存在 MEMORY.md;重启 gateway:`clawdbot gateway restart`。
- 结果不相关时:将 `minScore` 降到 `0.2` 以获得更多结果;将 `maxResults` 增加到 `30`;检查记忆文件是否有有意义的内容。
- provider 报错时:Voyage 在环境中设置 `VOYAGE_API_KEY`;OpenAI 设置 `OPENAI_API_KEY`;如果没有 API key,使用 `local` provider。
- 验证记忆是否工作:让用户问“What do you remember about [past topic]?”,agent 应搜索记忆并返回相关上下文;如果 agent 没有记忆,说明配置未生效,重启 gateway。
- 完整配置示例:`{"memorySearch": {"enabled": true, "provider": "voyage", "sources": ["memory", "sessions"], "indexMode": "hot", "minScore": 0.3, "maxResults": 20}, "workspace": "/path/to/your/workspace"}`。
适用边界 · 注意事项
- 仅适用于 Moltbot/Clawdbot;其他 agent 框架或无对应配置文件的工具不适用。
- 如果不安装 Moltbot/Clawdbot,或不能编辑 `~/.clawdbot/clawdbot.json`/`moltbot.json`,不要使用。
- 若不能设置 Voyage/OpenAI API key 且不使用 `local` provider,则无法按原配置启用云向量搜索。