Memory Hub

Multi-agent shared memory protocol. Syncs a shared GitHub repo containing USER.md (owner preferences/habits), KNOWLEDGE.md (common knowledge), RULES.md (universal agent rules), and TOOLS.md (shared tools/scripts) across multiple agents. Supports read, write, sync, search, merge operations. Use when reading shared memory, writing new preference/knowledge to shared repo, syncing local cache with shared repo, searching shared memory, or first-time install/setup. Triggers: 读共享记忆, 写入共享记忆, 记录偏好, 同步记忆, 查共享记忆, shared memory, install memory-hub.

shared-memory

多龙虾共享记忆同步协议。所有 agent 通过同一个 GitHub 私有仓库共享对主人的认知，每只 agent 本地维护一份轻量摘要缓存。

首次安装

运行安装脚本（幂等，重复执行安全）：

bash

bash ~/.openclaw/skills/shared-memory/scripts/install.sh

脚本会：

1. 询问共享仓库地址（如未配置）
2. Clone 到 ~/.openclaw/shared-memory/
3. 生成本地缓存文件 ~/.openclaw/workspace/SHARED_MEMORY_CACHE.md
4. 提示用户确认后，在 AGENTS.md 的 ## Every Session 区块追加读取指令

安装完成后告知用户，并说明需要在其他龙虾上重复执行同样步骤。

配置文件

安装后配置存储在 ~/.openclaw/shared-memory/config.json：

json

{
  "repo_url": "https://github.com/your-username/shared-memory",
  "local_path": "~/.openclaw/shared-memory",
  "agent_id": "agent-home",
  "last_sync": "2026-01-01T00:00:00"
}

共享仓库结构

text

shared-memory-repo/
├── USER.md        # 主人偏好、习惯、沟通方式
├── KNOWLEDGE.md   # 公共知识沉淀：踩坑、工具用法、最佳实践
├── RULES.md       # 所有龙虾通用铁律
└── TOOLS.md       # 公共工具：脚本、命令、配置

每条记忆格式（严格遵守，不得自由发挥）：

markdown

## [分类] 标题

内容（1-5行，精炼）

_更新：YYYY-MM-DD by agent_id_

支持的操作

read — 读取共享记忆

text

触发词：读共享记忆、同步记忆、load shared memory

步骤：

1. git -C ~/.openclaw/shared-memory pull --rebase --quiet
2. 读取四个文件内容到上下文
3. 告知用户"已加载共享记忆（最后更新：XXX）"

write — 写入新记忆

text

触发词：写入共享记忆、记录偏好、记住这个

步骤：

1. 判断写入目标文件（USER/KNOWLEDGE/RULES/TOOLS，见分类指南）
2. git -C ~/.openclaw/shared-memory pull --rebase --quiet
3. grep 检查是否已有相似条目（有则更新，无则追加）
4. 按格式追加/更新内容
5. git -C ~/.openclaw/shared-memory add -A && git commit -m "🧠 [agent_id] 更新 FILE.md: 一句话描述" && git push
6. 同步更新本地 SHARED_MEMORY_CACHE.md 摘要

push 失败时：git pull --rebase 后重试一次；仍失败则告知用户，不强制。

sync — 定期同步（静默）

text

触发词：心跳时自动检查、sync shared memory

步骤：

1. pull 最新内容
2. 对比本地缓存的 last_sync 时间戳
3. 有更新则重新提炼摘要写入 SHARED_MEMORY_CACHE.md
4. 更新 config.json 的 last_sync
5. 静默完成，无需告知用户（除非发现重要新内容）

search — 检索

text

触发词：查共享记忆 + 关键词

步骤：

1. pull 最新
2. grep -r "关键词" ~/.openclaw/shared-memory/ --include="*.md" -l -n
3. 返回匹配的段落（上下文各2行）

merge — 合并到本地缓存

text

触发词：更新本地缓存、merge shared memory

步骤：

1. pull 最新内容
2. 提炼四个文件的核心要点（每个文件不超过20条）
3. 覆盖写入 SHARED_MEMORY_CACHE.md
4. 告知用户"本地缓存已更新，共 X 条摘要"

分类指南

内容类型	写入文件
主人的偏好、习惯、沟通风格	USER.md
工具用法、踩坑经验、最佳实践	KNOWLEDGE.md
所有龙虾必须遵守的行为规范	RULES.md
可复用脚本、命令、配置片段	TOOLS.md

写入原则（防垃圾堆积）

1. 去重优先：写入前必须 grep 检查，有相似条目则更新不新增
2. 精炼不冗余：每条记忆 1-5 行，不写流水账
3. 分类准确：按上表分类，不得新增文件
4. 标注来源：每条末尾标注更新时间和 agent_id

升级路径

当单文件超过 200 行时，主动提示用户考虑升级。 详见 references/upgrade-guide.md。

注意事项

• 不支持：删除条目、修改文件结构、新增文件
• 不支持：自由编辑，所有操作必须通过上述5个命令
• 共享仓库建议设为 Private（含个人隐私）
• 各龙虾的专属上下文（本地任务、环境配置）仍存各自的 MEMORY.md，不写入共享仓库