大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



配置日期： 2026-03-11
配置者： 安逸
环境： macOS + OpenClaw
耗时： 约 1 小时（包含调试时间）

---

事情是这样的 —— 每次我和 OpenClaw 聊天，它都像金鱼一样，会话一结束就什么都忘了。

• 昨天说好的偏好设置，今天得重新说
• 配置过的东西，下次还要重新解释
• 任务做到一半，下次得从头交代

这太累了。 我想要一个真正"记得住"的 AI 助理。

于是我决定给 OpenClaw 装上 memclawz 记忆系统。这是完整的配置过程记录。

---

1. ✅ 实现三层记忆架构（QMD + Zvec + MEMORY.md）
2. ✅ 开机自启动，无需手动干预
3. ✅ 自动提取决策、偏好、任务状态
4. ✅ 毫秒级记忆检索
5. ✅ 集成到 OpenClaw 会话流程

---

第一阶段：环境准备 (00:00 - 00:15)

1.1 检查 Python 环境

GPT plus 代充 只需 145

⚠️ 注意： 必须使用 Python 3.10+，因为 memclawz_server 依赖一些新特性。

1.2 创建工作目录

1.3 克隆 memclawz 仓库

GPT plus 代充 只需 145

---

第二阶段：安装依赖 (00:15 - 00:30)

2.1 安装 Python 依赖

2.2 遇到的问题 #1：sentence-transformers 缺失

现象： 首次测试搜索时，embedding 返回 None

排查：

GPT plus 代充 只需 145

解决：

✅ 经验： 依赖安装一定要逐个验证，不要假设都装上了。

---

第三阶段：配置守护进程 (00:30 - 00:45)

3.1 为什么选择 launchd？

我对比了几个方案：

决策： 使用 launchd 作为守护进程方案

3.2 创建 Server plist

GPT plus 代充 只需 145

3.3 创建 Watcher plist

3.4 加载服务

GPT plus 代充 只需 145

---

第四阶段：创建管理脚本 (00:45 - 01:00)

4.1 编写 manage-service.sh

GPT plus 代充 只需 145

4.2 测试管理脚本

输出：

GPT plus 代充 只需 145

✅ 验证通过！

---

第五阶段：集成到 OpenClaw (01:00 - 01:30)

5.1 备份原始 AGENTS.md

⚠️ 重要： 修改配置文件前先备份！

5.2 编辑 AGENTS.md

在 部分添加 QMD 读取：

Before doing anything else:

1. Read — this is who you are
2. Read — this is who you’re helping
3. Read (today + yesterday) for recent context
4. If in MAIN SESSION (direct chat with your human): Also read
5. 🧠 Load QMD working memory:

   GPT plus 代充 只需 145

Don’t ask permission. Just do it.

5.3 添加记忆协议章节

在 AGENTS.md 末尾添加完整章节：

2. During Work — 自动记忆提取

自动写入记忆（无需用户说“记住这个”）：

• 检测到决策、偏好、任务完成、经验教训时，自动调用：

GPT plus 代充 只需 145

触发条件：

• ✅ 任务完成/状态变更
• ✅ 用户表达偏好（“我喜欢 X”、“默认用 Y”）
• ✅ 决策点（“决定用 Z”、“选择方案 A”）
• ✅ 问题解决/经验总结（“发现…原因是”、“下次应该…”）

3. Memory Search (优先级顺序)

Step 1: Check QMD first (<1ms)

Step 2: Search Zvec vector DB (<10ms)

GPT plus 代充 只需 145

Step 3: Fallback to built-in (~50ms)

4. Session End

GPT plus 代充 只需 145

---

第六阶段：验证与测试 (01:30 - 01:45)

6.1 测试 API 端点

6.2 测试记忆提取

GPT plus 代充 只需 145

6.3 测试记忆搜索

6.4 遇到的问题 #2：API 端点名称

现象： 搜索返回 404

排查：

GPT plus 代充 只需 145

发现： 文档中写的是 ，但实际 API 是

解决： 更新所有文档和脚本中的端点名称

✅ 经验： 一定要亲自测试每个 API 端点，不要盲目相信文档。

---

第七阶段：优化与完善 (01:45 - 02:00)

7.1 创建任务编排脚本

为了让复杂任务能够自动拆解和并行执行，我创建了 。

核心功能：

• 自动检测任务类型
• 拆解为子任务
• 并行执行无依赖任务
• 主动汇报进度

7.2 创建工具链编排脚本

为了串联多个工具，我创建了 。

预定义工具链：

• : 搜索 → 记忆
• : 抓取 → 文档 → 通知
• : 检查 → 记录

7.3 更新 AGENTS.md 添加优化协议

在 AGENTS.md 中添加：

工具链编排

执行工具链：

GPT plus 代充 只需 145

---

服务状态

记忆架构

已创建的脚本

---

决策 #1：守护进程方案

选项： launchd vs systemd vs cron vs 手动

决策： launchd

理由：

• macOS 原生支持
• 开机自启
• 崩溃自动重启
• 日志自动管理

决策 #2：记忆提取策略

选项： 手动触发 vs 自动检测

决策： 自动检测 + 手动补充

理由：

• 自动检测减少遗漏
• 手动补充保证准确性
• 平衡自动化和控制权

决策 #3：搜索 API 设计

选项： 纯向量搜索 vs 混合搜索

决策： 三层回退策略

理由：

• QMD 最快（<1ms）
• Zvec 语义搜索（<10ms）
• MEMORY.md 兜底（~50ms）
• 保证任何情况下都有结果

---

问题 #1：sentence-transformers 缺失

症状： embedding 返回 None

原因： 依赖安装不完整

解决：

预防： 添加依赖验证步骤

问题 #2：API 端点名称错误

症状： 搜索返回 404

原因： 文档与实际代码不一致

解决： 统一使用 端点

预防： 亲自测试每个 API 端点

---

---

什么做得好

1. ✅ 选择 launchd 作为守护进程方案 —— 稳定可靠
2. ✅ 创建管理脚本 —— 日常运维方便
3. ✅ 备份原始配置 —— 出问题时能回滚
4. ✅ 记录配置过程 —— 方便日后查阅和分享

什么可以改进

1. ⚠️ 应该更早测试 API 端点 —— 避免后期返工
2. ⚠️ 依赖安装应该添加验证步骤 —— 避免遗漏
3. ⚠️ 应该先在小环境测试 —— 再应用到主环境

给后来者的建议

1. 先备份再修改 —— 永远不要直接修改生产配置
2. 逐步验证 —— 每完成一步就测试一步
3. 记录过程 —— 配置过程中的决策和问题都值得记录
4. 不要盲目相信文档 —— 亲自测试每个步骤

---

---

• memclawz GitHub: https://github.com/yoniassia/memclawz
• OpenClaw 文档：https://docs.openclaw.ai
• launchd 编程指南：Apple Developer Docs
• Zvec 文档：https://github.com/yoniassia/zvec

---

🎉 配置完成！

现在我的 OpenClaw 助理拥有真正的长期记忆了。下次聊天时，它会记得我们之前说过的话、做过的决定、还有我的偏好设置。

告别金鱼记忆，拥抱持久化智能。🧠

---