conversations

从 OpenClaw sessions/*.jsonl 导入对话历史到本地 SQLite，配合 FTS5 全文搜索。成为真正的记忆库，支持语义化查询历史对话，让整理和回顾更高效。装好后跑一次 import，之后随时可以 query。

将 OpenClaw sessions/*.jsonl 中的对话历史导入本地 SQLite，配合 FTS5 全文检索，实现记忆库，支持语义化查询历史对话，提升整理与回顾效率。安装后执行一次 import，之后随时可 query。

shu0yu

未分类 clawhub v2.0.0 1 版本 100000 Key: 无需

★ 0

Stars

📥 401

下载

💾 0

安装

版本

#latest

概述

conversations-universal

对话历史的本地记忆库。

使用方式

第一次使用

运行导入脚本，把历史 session 读入本地库：

python {baseDir}/scripts/import_sessions.py

之后每次想回顾历史，直接用 query 脚本：

python {baseDir}/scripts/query_conversations.py <搜索内容>

查询示例

# 查询某天的讨论
python scripts/query_conversations.py "我们讨论过内存泄漏"

# 查询某个话题
python scripts/query_conversations.py "OpenClaw 配置"

自动导入

建议配合 cron 定期导入新 session：

openclaw cron add \
  --name "对话历史导入" \
  --cron "0 */6 * * *" \
  --session isolated \
  --message "python {baseDir}/scripts/import_sessions.py" \
  --announce

工作原理

存储：SQLite + FTS5 全文搜索，零外部依赖
导入：读取 agents/main/sessions/*.jsonl，解析 role/content，写入 chunks 表
搜索：FTS5 MATCH，支持自然语言查询

环境变量

变量	默认值	说明
------	--------	------
OPENCLAW_WORKSPACE	自动推断	session 文件所在目录
CONVERSATIONS_DB	`{workspace}/conversations.db`	数据库路径
DRY_RUN	false	试运行，不写入

依赖

Python 3.8+（内置 sqlite3，FTS5 需要 3.9+）
OpenClaw sessions 目录

与 conversations 1.0 的区别

	conversations 1.0	conversations-universal
--	--	--
搜索方式	Ollama 向量搜索	SQLite FTS5
外部依赖	需要 Ollama	纯 Python
搜索质量	高（语义）	中（关键词）
适用场景	已有 Ollama 的用户	所有人

版本历史

共 1 个版本

v2.0.0 当前

2026-05-03 10:48 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)

安全，无风险

查看报告

🔗 相关推荐

ai-intelligence

self-improving agent

pskoett

捕获经验教训、错误及修正内容，以实现持续改进。适用于以下场景：（1）命令或操作意外失败；（2）用户纠正Claude（如“不，那不对……”“实际上……”）；（3）用户请求的功能不存在；（4）外部API或工具出现故障；（5）Claude发现自身

★ 4,065 📥 802,056

ai-intelligence

Self-Improving + Proactive Agent

ivangdavila

自我反思+自我批评+自我学习+自组织记忆。智能体评估自身工作、发现错误并持续改进。

★ 1,364 📥 319,267

developer-tools

Github

steipete

使用 `gh` CLI 与 GitHub 交互，通过 `gh issue`、`gh pr`、`gh run` 和 `gh api` 管理议题、PR、CI 运行及高级查询。

★ 672 📥 324,669