乐于分享
好东西不私藏

OpenClaw + Basic Memory 插件:技能详解

OpenClaw + Basic Memory 插件:技能详解

Basic Memory 作为 OpenClaw 的官方记忆插件,提供了 14 个工具 + 7 个斜杠命令 + 6 个内置技能。本文整理作为 OpenClaw 技能使用的那部分核心功能。


14 个 Agent 工具
工具
用途
memory_search
跨所有记忆源复合搜索
memory_get
获取指定记忆条目
search_notes
全文本 + 语义搜索笔记
read_note
按标题/permalink/memory:// URL 读取笔记
write_note
创建或更新笔记
edit_note
增量编辑(追加、前置、查找替换)
delete_note
删除笔记
move_note
移动笔记(保持数据库一致性)
build_context
通过 memory:// URL 导航知识图谱
list_memory_projects
列出所有项目及状态
list_workspaces
列出可用工作空间
`schema_validate
按 schema 验证笔记
schema_infer
从现有笔记推断 schema
schema_diff
检测 schema 漂移

7 个斜杠命令
命令
功能
/bm-setup
初始化 Basic Memory 配置
/remember
保存内容到记忆
/recall
搜索和检索记忆
/tasks
管理结构化任务笔记
/reflect
回顾对话,提取见解
/defrag
拆分臃肿文件,合并重复项,重组织
/schema
Schema 生命周期 — 推断、验证、检测漂移

6 个内置技能
技能
用途
memory-notes
核心笔记格式 — frontmatter、observations、relations
memory-tasks
结构化任务追踪, surviving context compaction
memory-schema
Schema 生命周期 — 推断、验证、检测漂移
memory-reflect
回顾对话,提取见解,整合知识
memory-defrag
拆分臃肿文件,合并重复项,重组织层级
memory-metadata-search
按自定义 frontmatter 字段查询笔记

工作原理

复合记忆搜索

Agent 搜索时,插件并行查询三个来源并合并结果:

  1. MEMORY.md — 主记忆文件文本搜索
  2. 知识图谱 — 全部笔记的混合全文 + 向量搜索
  3. 活跃任务 — 扫描 memory/tasks/ 中的进行中工作

自动召回

会话启动时,插件自动加载活跃任务和最近笔记,Agent 无需询问即可获得上下文。

自动捕获

对话轮次被记录为每日笔记中的时间戳条目,构建可搜索的交互日志。

持久连接

插件通过 stdio 维护长期运行的 Basic Memory 进程,避免每次工具调用的启动开销。


安装配置
# 一键安装openclaw plugins install @basicmemory/openclaw-basic-memoryopenclaw gateway restart

默认配置项:

  • project: 项目名
  • projectPath: 项目目录路径
  • memoryDir: 记忆文件目录(默认 memory/
  • memoryFile: 主记忆文件名(默认 MEMORY.md
  • autoCapture: 自动记录对话(默认 true)
  • autoRecall: 会话启动时加载任务和笔记(默认 true)

使用场景
# 记住重要信息/remember 波哥的密码是 xxx# 搜索记忆/recall 上次那个项目怎么决定的# 管理任务/tasks 查看我当前的任务# 反思学习/reflect 过去一周学到了什么

本文根据 docs.basicmemory.com/integrations/openclaw 整理