核心用法
Memory Pill 是一套面向 OpenClaw 的持久化记忆与任务执行框架，解决 AI 对话"失忆"和任务半途而废的核心痛点。其设计基于 PARA 方法论（Projects, Areas, Resources, Archives），并深度集成 Obsidian 的双向链接生态。
关键操作流程：
1. 自动初始化：首次使用时 AI 自动创建扩展目录结构（projects/、people/、clients/、decisions/、skills/ 等），无需用户许可或手动脚本。
2. 项目与里程碑管理：每个项目分解为可追踪的里程碑（milestone），配备独立的 meta.json 存储进度、优先级（High/Medium/Low）和关联任务。任务采用三段式 ID：{project}-{milestone}-{number}，确保可溯源性。
3. Prompt 工程系统：用户简单指令（如"做个登录页"）自动扩展为结构化代理指令，包含：具体角色定义、完整上下文（技术栈、当前状态）、明确任务范围、输出格式规范、参考示例、可量化约束条件。
4. 代理优先执行：主 Claw 仅处理 2 分钟内的快速决策，实质性工作全部分派给专业代理（uiux-craftsman、system-designer、business-strategist 等），通过 expandedPrompt 字段传递完整上下文。
5. 记忆搜索与事实提取：内置 memory_search 工具检索 MEMORY.md、daily notes、projects 等；每日 3AM 定时任务扫描前一日笔记，提取"通用事实"（用户偏好、工作流程、约束条件）存入 memory/facts/，过滤一次性细节。
技术架构亮点：
- Obsidian 兼容的
[[wiki-link]]体系，支持跨文件图谱可视化 - JSON 结构化存储（meta.json、task.json、fact.json）+ Markdown 人类可读内容
- 执行纪律协议强制执行：目标锁定→任务拆解→假设声明→单层执行→循环检测→完成验证
显著优点
- 零配置启动：自动目录创建与文件初始化，降低使用门槛
- 防循环机制：内置 EXECUTION_DISCIPLINE_PROTOCOL，强制结构化思考，避免 AI 无限重复或过度优化
- 跨会话一致性：事实提取系统确保用户偏好、技术决策等关键信息持久化
- 专业分工：代理体系让复杂任务获得领域专精处理，主代理保持轻量决策
- 生态兼容：与 Obsidian、Vercel 等工具链无缝对接
潜在局限与风险
- 存储复杂度：多层级 JSON + Markdown 混合结构，大规模项目下文件碎片化，维护成本递增
- 索引延迟：
memory_search依赖后台索引，新创建内容可能无法立即检索，需手动触发或等待定时任务 - 代理边界模糊："实质性工作"与"快速决策"的判定标准主观，过度代理化可能增加协调开销
- 无版本控制：任务、项目元数据直接覆盖写入，误操作或代理错误难以回滚
- 隐私与数据安全：用户偏好、客户信息、决策记录以明文 JSON/Markdown 存储于本地文件系统，缺乏加密或访问控制机制
适合人群
- 长期使用 OpenClaw 进行复杂项目管理的重度用户
- 需要跨多周/多月追踪决策脉络的独立开发者、顾问、产品经理
- Obsidian 用户寻求 AI 增强的 PARA 工作流
- 对 AI "幻觉"和任务漂移容忍度低、需要执行纪律约束的专业人士
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 数据丢失 | 本地文件损坏、误删除 | 定期备份 `~/.openclaw/workspace/` |
| 记忆失效 | 搜索无结果时代理编造历史 | 强制要求代理在引用记忆时标注来源文件 |
| 权限越界 | 自动创建文件可能覆盖用户数据 | 首次使用前确认 workspace 目录状态 |
| 代理冲突 | 多代理并行修改同一 meta.json | 设计文件锁机制或串行任务队列 |