AI 记忆系统一键配置指南

Moltbot/Clawdbot 官方记忆配置指南，通过向量搜索实现跨会话持久化上下文，解决 AI 助手"金鱼脑"问题，让智能体真正记住用户偏好与项目历史。

基本信息

• 技能名称?memory-setup
• 中文名称?AI 记忆系统一键配置指南
• 作者?jrbobbyhansen-pixel
• 分类?其他
• 版本?未标注
• 标签?productivity, automation, docs, development-engineering, project-program-management

使用方法

使用说明
核心用法
Memory Setup Skill 是一套完整的记忆系统配置指南，旨在将 Moltbot/Clawdbot 从"金鱼脑"升级为具备长期记忆能力的智能助手。用户需完成三步核心配置：首先在 ~/.clawdbot/clawdbot.json 中启用 memorySearch 模块，配置嵌入模型提供商（推荐 Voyage AI）、索引源（memory + sessions）及搜索参数；其次在 workspace 中建立规范的记忆目录结构，包括 MEMORY.md 长期记忆文件和 memory/logs/ 下的每日日志；最后在 AGENTS.md 中植入记忆召回指令，确保智能体在回答历史相关问题时主动检索记忆。
该技能支持三种嵌入提供商：Voyage AI（推荐）、OpenAI 和本地模型，满足不同隐私与成本需求。索引模式 hot 可实现实时更新，， minScore 和 maxResults 参数允许灵活调节召回精度与数量。
显著优点
彻底告别上下文丢失 ：跨会话保留用户偏好、项目决策和历史对话，实现真正的连续性交互。 结构化知识管理 ：通过 MEMORY.md、每日日志和项目专属目录，将碎片化信息转化为可检索的知识资产。 零代码配置 ：纯文档指导，无需编程能力即可完成企业级记忆系统搭建。 灵活可扩展 ：支持环境变量管理 API 密钥、本地嵌入模型离线运行，兼顾安全与隐私需求。 智能体行为增强 ：通过 AGENTS.md 指令植入，让 AI 主动使用记忆工具而非被动等待查询。
潜在缺点与局限性
依赖外部 API ：Voyage/OpenAI 嵌入服务需付费且存在网络延迟，本地模型虽免费但质量与性能受限。 存储成本累积 ：长期运行的项目会产生大量日志文件，需定期归档清理。 召回精度调优困难 ： minScore 阈值需反复试验，过低导致噪音，过高遗漏关键信息。 无自动冲突解决 ：若 MEMORY.md 与日志记录矛盾，系统无内置机制检测或合并。 初期配置门槛 ：JSON 配置、目录结构、环境变量对非技术用户仍有一定学习成本。
适合的目标群体
长期项目协作者 ：需要 AI 跟踪数月甚至数年项目进度的产品经理、研究员、作家。 高频对话用户 ：每日与 AI 交互且厌倦重复背景说明的专业人士。 知识工作者团队 ：希望共享组织记忆、减少信息孤岛的企业用户。 隐私敏感型用户 ：可选择本地嵌入模型，将记忆数据完全保留在本地。 AI 工作流构建者 ：需要将记忆能力集成到复杂自动化流程的开发者。
使用风险
API 密钥泄露风险 ：若误将密钥写入配置文件而非环境变量，可能导致凭证泄露。 记忆污染风险 ：错误或过时的记忆被反复召回，可能强化 AI 的错误认知。 性能衰减风险 ：记忆文件膨胀后，索引和搜索延迟可能显著增加，需定期维护。 供应商锁定风险 ：深度使用 Voyage AI 后迁移至其他嵌入模型，需重新索引全部历史数据。 数据持久性风险 ：本地存储的记忆文件若未纳入备份策略，存在意外丢失可能。