Memory System 🧠

> 完整的记忆系统 - 文件系统记忆 + 支持搜索 + 自动加载 + 内存刷新

特性

• 📁 文件系统存储 - 基于 Markdown 文件，无数据库依赖，可读、可手动编辑、易备份
• 🔍 支持搜索 - 支持语义搜索（需配置 Ollama）；未配置时自动降级为关键词匹配
• ⚡ 自动加载 - 会话启动时自动加载相关记忆，无需手动触发
• 🏠 群组隔离 - 支持多群组独立记忆，群组之间数据互不干扰
• 💾 Memory Flush - 上下文接近阈值时自动持久化，防止信息丢失
• 🔒 安全防护 - 路径验证防止目录遍历攻击，确保文件操作仅限于 memoryDir

安全说明

• 所有文件读写操作都经过路径验证
• 禁止 ../ 目录遍历
• 禁止访问 memoryDir 外的任何文件
• 绝对路径和符号链接都会被解析并验证

安装

clawhub install memory-system

配置

在 openclaw.json 中配置：

{
  "skills": {
    "memory-system": {
      "memoryDir": "~/.openclaw/workspace/memory",
      "flushMode": "safeguard",
      "softThresholdTokens": 300000,
      "vectorEnabled": true,
      "embeddingModel": "nomic-embed-text"
    }
  }
}

配置项说明

flushMode 说明

工具

memory_search

语义搜索记忆文件，返回最相关的记忆片段。

参数

示例

{
  "query": "用户上次提到的项目需求",
  "group": "project-a",
  "topK": 3
}

> 若 vectorEnabled 为 false 或 Ollama 不可用，自动降级为关键词全文匹配。

memory_get

读取指定记忆文件的完整内容。

参数

示例

{
  "file": "user-preferences.md",
  "group": "project-a"
}

memory_write

写入或追加内容到记忆文件。文件不存在时自动创建。

参数

示例

{
  "file": "user-preferences.md",
  "content": "## 偏好设置\n- 语言：中文\n- 风格：简洁",
  "group": "project-a",
  "mode": "append"
}

memory_flush

手动触发记忆持久化，将当前会话中的记忆写入文件系统。

参数

示例

{
  "group": "project-a"
}

> 建议在长会话结束前手动调用一次，确保数据不丢失。

搜索配置（可选）

语义搜索依赖本地 Ollama 服务，需提前安装并拉取嵌入模型：

# 安装 Ollama（参考官网）
ollama pull nomic-embed-text

确认 Ollama 服务正在运行后，将 vectorEnabled 设置为 true 即可启用。

未配置 Ollama 时：系统自动降级为关键词全文匹配，不影响基本功能使用。

注意事项

• 同一群组内并发写入时，以最后一次写入为准（last-write-wins），建议避免并发写入同一文件
• memoryDir 目录需要有读写权限，首次使用时会自动创建
• 记忆文件为标准 Markdown 格式，可用任意编辑器手动查看和修改

作者：团宝 (openclaw)

版本：1.0.2