Memory Setup

Memory Setup 是什么

Memory Setup 是一份面向 Moltbot 与 Clawdbot 的持久记忆配置指南，通过 MEMORY.md、按日期日志、项目目录和向量检索，让代理能够在不同会话之间找回经过整理的事实与决定。

适用场景

适合首次建立记忆体系、修复跨会话遗忘、整理长期偏好和项目状态；只需临时保存一句话时不必引入完整索引。

核心能力与工作机制

它配置 memorySearch 的提供商、来源、热索引、相似度阈值和返回数量，并规定长期记忆、日记、项目、群组与系统信息的目录分工。

执行流程

先备份配置并确认工作区，选择 Voyage、OpenAI 或本地嵌入；创建目录与 MEMORY.md，写入检索前置规则，重启网关后用历史问题验证召回质量，再调节阈值。

输入与输出

需要工作区路径、允许进入长期记忆的信息范围、嵌入提供商和是否索引会话；隐私、保留期限与群聊边界应先明确。输出是更新后的配置、记忆目录、日志模板和检索验证结果，低置信度信息应保留来源而不是写成永久事实。

依赖、账号与权限

需要 Moltbot 或 Clawdbot；Voyage 与 OpenAI 路线分别需要对应 API Key，本地路线无需云密钥但需要本地模型资源和磁盘空间。

副作用、限制与风险

会话记录可能含个人信息、密钥或过时结论，扩大 sources 与降低阈值会增加误召回；远程嵌入还会把选定文本发送给外部服务。会创建和修改工作区 Markdown 与代理配置，并可能重启网关、建立向量索引和产生 API 用量。

不适用边界

它不是事实数据库或自动备份系统，也不能保证记忆始终正确；秘密、一次性验证码和未经同意的群聊内容不应进入长期记忆。

失败处理与验收

搜索为空时检查 enabled、文件位置、索引来源和密钥，重启网关后重新测试；结果太杂则提高 minScore、缩小来源并清理重复内容。用已知历史问题测试检索，核对返回片段、文件和行号，确认敏感内容未被意外索引，并记录配置与回滚副本。

适合谁使用

适合维护长期代理和多项目上下文的用户，短期一次性对话可继续使用普通会话上下文。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.0 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. Memory Setup 主要解决什么问题？

Memory Setup 是一份面向 Moltbot 与 Clawdbot 的持久记忆配置指南，通过 MEMORY.md、按日期日志、项目目录和向量检索，让代理能够在不同会话之间找回经过整理的事实与决定。适合首次建立记忆体系、修复跨会话遗忘、整理长期偏好和项目状态；只需临时保存一句话时不必引入完整索引。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要工作区路径、允许进入长期记忆的信息范围、嵌入提供商和是否索引会话；隐私、保留期限与群聊边界应先明确。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

先备份配置并确认工作区，选择 Voyage、OpenAI 或本地嵌入；创建目录与 MEMORY.md，写入检索前置规则，重启网关后用历史问题验证召回质量，再调节阈值。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

需要 Moltbot 或 Clawdbot；Voyage 与 OpenAI 路线分别需要对应 API Key，本地路线无需云密钥但需要本地模型资源和磁盘空间。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

会创建和修改工作区 Markdown 与代理配置，并可能重启网关、建立向量索引和产生 API 用量。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

它不是事实数据库或自动备份系统，也不能保证记忆始终正确；秘密、一次性验证码和未经同意的群聊内容不应进入长期记忆。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

搜索为空时检查 enabled、文件位置、索引来源和密钥，重启网关后重新测试；结果太杂则提高 minScore、缩小来源并清理重复内容。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

用已知历史问题测试检索，核对返回片段、文件和行号，确认敏感内容未被意外索引，并记录配置与回滚副本。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。