纯文档型配置指南,帮助用户启用 Moltbot/Clawdbot 持久化记忆系统,实现跨会话上下文保持。
说明:
## 核心用法
`memory-setup` 是一个纯文档型 Skill(T-MD 分类),旨在指导用户为 Moltbot/Clawdbot 配置持久化记忆系统。它不提供可执行代码,而是通过结构化文档帮助用户:
1. **启用记忆搜索**:在 `~/.clawdbot/clawdbot.json` 中配置 `memorySearch` 参数,包括选择嵌入模型提供商(voyage/openai/local)、设置索引模式(hot 实时索引)、调整相关性阈值(minScore)等
2. **建立记忆文件结构**:创建 `MEMORY.md` 长期记忆文件,以及 `memory/` 目录下的日志、项目、群组、系统偏好等子目录
3. **规范日常记录**:提供 `YYYY-MM-DD.md` 格式的每日日志模板,确保对话历史可被向量化检索
4. **配置智能体行为**:建议在 `AGENTS.md` 中加入记忆召回指令,让智能体在回答历史相关问题时主动搜索记忆
## 显著优点
– **零代码风险**:纯 Markdown 文档,无可执行代码块,无文件系统操作,无网络请求,风险极低
– **配置全面**:涵盖从基础启用、文件结构、日志规范到故障排查的完整流程
– **多提供商支持**:支持 Voyage AI(推荐)、OpenAI、本地嵌入三种方案,适应不同预算和隐私需求
– **即时生效**:配置后重启 gateway 即可启用,无需重新训练或数据迁移
– **解决核心痛点**:明确针对”金鱼脑”问题(会话间失忆),提供系统性解决方案
## 潜在缺点与局限性
– **无自动化能力**:用户需手动创建所有文件、编辑配置、维护目录结构,学习成本较高
– **依赖外部 API**:若选择 voyage/openai 提供商,需自行管理 API Key 和费用
– **无版本控制指导**:未提及 MEMORY.md 的 Git 管理或备份策略
– **BSS 环境发布**:来源为个人开发者通过 BSS 环境发布,无 GitHub 可追溯历史,透明度有限
– **许可证不明**:文档未声明开源许可证,存在潜在使用合规风险
## 适合人群
– 使用 Moltbot/Clawdbot 且希望实现跨会话记忆的用户
– 有一定技术背景、能手动编辑 JSON 配置和 Markdown 文件的开发者
– 重视隐私、愿意采用本地嵌入方案避免云端 API 的用户
– 需要长期项目管理、客户关系维护等场景的专业用户
## 常规风险
– **配置错误风险**:minScore/maxResults 参数设置不当可能导致检索效果差或成本过高
– **API Key 管理**:用户需自行安全存储 VOYAGE_API_KEY / OPENAI_API_KEY,Skill 仅作说明无加密指导
– **记忆污染**:未提供记忆清理或敏感信息过滤机制,用户需自行维护 MEMORY.md 质量
– **来源可信度**:T3 级别来源,建议用户通读文档后再执行配置步骤







