memory-setup

核心用法

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 后迁移至其他嵌入模型，需重新索引全部历史数据。数据持久性风险：本地存储的记忆文件若未纳入备份策略，存在意外丢失可能。