跨平台 AI 智能体记忆管理 Skill —— 将记忆同步到 CNB Git 仓库，通过知识库 API 实现语义检索。

cnb-git-memory 是一个 CNB Skill，解决 AI 智能体「记忆易失」的问题。它将 workspace 中产生的记忆文件自动同步到独立的 CNB Git 仓库，由 CNB 知识库自动建立向量索引，实现跨实例、跨平台的记忆持久化与语义检索。

支持平台：OpenClaw / WorkBuddy / Claude Code

┌──────────────────────────────────────────────┐
│            AI 智能体 (任意平台)                 │
│                                              │
│   对话 → 写入 MEMORY.md / memory/*.md        │
│                    │                         │
│              sync-memory.sh                  │
│              (检测 → copy → commit → push)    │
└──────────────────┬───────────────────────────┘
                   ▼
          CNB Git 记忆仓库 (oh-my-memory)
                   │
                   ▼ push 自动触发
          CNB 知识库 (向量索引)
                   │
                   ▼ 每条消息自动检索
          handler.ts (OpenClaw Hook)
                   │
                   ▼ 注入 <memory_context>
          Agent 获得历史记忆上下文

文件	用途	适用平台
SKILL.md	Skill 描述文件，供智能体读取理解能力	所有
sync-memory.sh	记忆同步脚本：workspace → CNB Git 仓库	所有
handler.ts	OpenClaw Hook：消息预处理时自动语义检索并注入记忆	OpenClaw

export CNB_MEMORY_REPO="your-slug/your-memory-repo"  # 记忆仓库 slug
export MY_CNB_TOKEN="your-cnb-token"                  # CNB API Token

在 workspace 中修改记忆文件后：

bash sync-memory.sh

首次运行自动 clone 记忆仓库，后续增量同步。支持并发冲突自动 rebase 重试（最多 3 次）。

在 OpenClaw 配置中添加消息预处理 Hook：

{
  "hooks": [
    {
      "event": "message:preprocessed",
      "handler": "handler.ts"
    }
  ]
}

安装后，每条用户消息到达 Agent 前会自动查询知识库，将相关记忆以 <memory_context> 标签注入上下文，Agent 无需手动调用搜索工具。

平台	workspace 记忆路径	同步到记忆仓库的路径
OpenClaw	MEMORY.md, memory/	仓库根目录
WorkBuddy	.codebuddy/ 下的记忆文件	workbuddy/{project}/
Claude Code	CLAUDE.md, .claude/	claude-code/{project}/

变量	必需	默认值	说明
MY_CNB_TOKEN	是	-	CNB API Token
CNB_MEMORY_REPO	否	looc/memory	记忆仓库 slug
CNB_API_ENDPOINT	否	https://api.cnb.cool	CNB API 地址
KB_TOP_K	否	3	语义检索返回条数
KB_SCORE_THRESHOLD	否	0.3	相似度阈值
KB_HOOK_DEBUG	否	false	开启调试日志

• workspace 与记忆仓库解耦：记忆在 workspace 中产生，但持久化到独立 Git 仓库，不污染项目代码
• 平台无关：同一套记忆可被 OpenClaw、WorkBuddy、Claude Code 共享
• Git 原生：完整版本历史、可 diff、可回滚、可协作
• 语义检索：基于向量相似度自动召回相关记忆，而非关键词匹配

仓库	作用
oh-my-claw	OpenClaw 容器化部署方案，内置本 Skill
oh-my-memory	记忆存储仓库，push 自动触发知识库索引