核心用法
org-memory 是 org-cli 的扩展技能，为 AI 助手创建独立的 org-mode 工作空间，实现真正的持久化记忆管理。核心机制是通过 @a 前缀的快捷指令（如 @ak:、@at:）将内容写入助手专属的知识库，而非用户工作区。
关键能力：
- 双工作区架构：用户工作区（
org-cli）与助手记忆区（org-memory）完全分离，数据互不干扰 - 知识图谱替代：用 org-roam 取代 OpenClaw 原生 memory-wiki，构建可链接的实体关系网络
- 会话连续性：启动时自动加载
memory.org历史记忆与近两日日志，维持长期上下文
典型工作流：
1. 用 @ak: 捕获结构化知识（用户偏好、项目背景、系统历史）
2. 用 @at: 管理助手待办任务
3. 用 @an: 记录原始观察与笔记
4. 通过 org-memory: 前缀的写日志，用户可追溯助手记忆变更
显著优点
- 工具一致性：用户可用同一套 org-mode 工具浏览双工作区，降低认知成本
- 链接能力：知识图谱支持跨工作区引用（如助手笔记链接到用户项目节点）
- 持久化保障：SQLite 数据库 + 文件双存储，避免纯内存记忆的丢失风险
- 隐私边界清晰：
@a前缀明确标识操作主体，防止误写用户数据
潜在局限
- 强依赖链：必须前置安装
org-cli，且需独立配置ORG_MEMORY_*环境变量 - 冷启动成本：首次使用需执行
roam sync、创建索引节点等初始化步骤 - 无自动垃圾回收：长期运行后知识图谱可能膨胀，需手动维护
- 单用户假设：设计未考虑多用户场景下的记忆隔离问题
适合人群
- 需要 AI 助手长期陪伴且记忆累积价值高的深度用户
- 已采用 org-mode/roam 作为个人知识管理系统的效率工具用户
- 对"助手拥有独立知识库"有明确需求，而非每次会话从零开始
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 数据误覆盖 | `@a` 与裸指令混淆可能导致写入位置错误 | 严格遵循前缀约定，写日志双重确认 |
| 环境配置漂移 | `ORG_MEMORY_DIR` 等变量未设置或指向无效路径 | 启动时校验路径存在性，失败即告警 |
| 图谱膨胀 | 无约束的知识捕获导致查询性能下降 | 定期执行 `org index` 重建，或归档旧节点 |
| 跨工作区链接失效 | 用户重命名文件导致助手的外部链接断裂 | 优先使用 org-id 而非文件路径链接 |