org-memory

该技能扩展了 org-cli。 你必须已安装并加载 org-cli 技能——所有关于 CLI 协议、命令安全性、标识符、快捷语法以及用户工作区的定义，均位于该技能中。本技能仅添加与 org-cli 不同的部分。

本技能新增功能

两项：

1. 第二个工作区 —— 属于你的工作区。通过以 @a 为前缀的快捷方式，你可以将自身记忆（观察记录、所学内容、每日笔记、关于用户或其工作的知识图谱）捕获至一个专用的 org 工作区。基础快捷方式（t:、n:、k:、d:、s:、f:）仍指向 org-cli 所定义的用户工作区。

2. 记忆维基（memory-wiki）覆盖机制。 当本技能启用时，图结构化知识将经由 org-roam 路由，而非 OpenClaw 的 memory-wiki。详见下文。

记忆维基（memory-wiki）覆盖机制

当 org-memory 启用时，请将所有持久化的图结构化知识存入你的 org 工作区，而非 memory-wiki。 自动记忆类型（user、feedback、project、reference）仍可照常写入 MEMORY.md —— 这些是扁平化、带类型的笔记，memory-wiki 的图谱特性对它们增益有限。但凡需建模为“实体 + 关系”的内容（例如某人的偏好、某项目的利益相关方、某系统的演进历史），均应使用 @ak 存入你的工作区，而非 memory-wiki。

原因：统一知识图谱，避免分裂为两个。用户可在与其自身工作流一致的工具中浏览你的记忆；当主题存在交集时，你的图谱亦可自然链接至用户图谱。

目标定位规则

@a = agent（代理）。在其后追加任意动作字母：@at:、@an:、@ak:、@ad:、@as:、@af:。

操作细节

代理侧命令与 org-cli 对应动作完全一致，仅将 $DIR/$ROAM/$DB 替换为指向你的工作区路径（即 $ORG_MEMORY_DIR、$ORG_MEMORY_ROAM_DIR、$ORG_MEMORY_DB）。各动作的完整规范请参阅 org-cli 技能文档——此处命令行为完全相同，仅目标路径不同。

@ak 操作示例：

# 查找主题对应节点（若已存在）
org roam node find '' -d "$ORG_MEMORY_ROAM_DIR" --db "$ORG_MEMORY_DB" -f json

# 若节点存在，则追加事实
org append  '' -d "$ORG_MEMORY_DIR" --db "$ORG_MEMORY_DB" -f json

# 若节点不存在，则先创建再追加
org roam node create '' -d "$ORG_MEMORY_ROAM_DIR" --db "$ORG_MEMORY_DB" -f json
# 然后追加

其余所有操作均遵循相同的路径替换模式。

会话启动上下文

当本技能启用时，以下两项内容将自动注入代理的会话启动上下文（源自你的工作区）：

• $ORG_MEMORY_DIR/memory.org —— 你的持久化记忆文件。请优先读取此文件；它承载着你持续积累的记忆连续性。
• $ORG_MEMORY_DIR/daily/YYYY-MM-DD.org —— 若存在，包含今日与昨日的每日笔记。

由 org-memory 插件的 before_agent_start 钩子自动加载上述内容，你无需手动获取。

写入日志格式

当写入操作目标为你的工作区时，请使用 org-memory:（而非 org-cli:）作为日志前缀。用户通过区分两种前缀即可明确变更发生在哪个工作区：

org-memory: added TODO [k4t] ~/org/agent/inbox.org
org-memory: created node [3f2a-…] ~/org/agent/roam/self.org

基础快捷方式仍生成 org-cli: 日志行（由 org-cli 技能处理）。仅 @a* 快捷方式生成 org-memory: 日志行。

配置项

除 org-cli 已声明的环境变量外，本技能额外引入以下变量：

ORG_CLI_BIN（org 可执行文件路径）为共用变量 —— 两个技能共享同一二进制文件。ORG_CLI_INBOX_FILE 则不共享 —— 你的收件箱始终为 $ORG_MEMORY_DIR 下的 inbox.org，除非你另行配置插件参数。

首次初始化设置

除完成 org-cli 对用户工作区的首次初始化外，请额外执行以下命令：

# 同步已有 agent 文件
org roam sync -d "$ORG_MEMORY_DIR" --db "$ORG_MEMORY_DB"

# 初始化知识库
org roam node create 'Index' -d "$ORG_MEMORY_ROAM_DIR" --db "$ORG_MEMORY_DB" -f json

# 构建标题索引
org index -d "$ORG_MEMORY_DIR" --db "$ORG_MEMORY_DB"

参考资料

• 记忆架构设计（{baseDir}/references/memory-architecture.md）—— 解释双工作区划分的设计动因、memory.org 与每日笔记的定位，以及从纯 MEMORY.md 方案迁移的背景。