conversations-universal

对话历史的本地记忆库。

使用方式

第一次使用

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

python {baseDir}/scripts/import_sessions.py

2. 之后每次想回顾历史，直接用 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，支持自然语言查询

环境变量

依赖

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

与 conversations 1.0 的区别