OpenClaw记忆检索优化需据场景选择方案：一、纯SQLite优化含IVFFlat索引、混合权重调优与时间衰减；二、SQLite+LiteVector协同卸载向量计算；三、外置Milvus等专业向量库；四、SQLite精简与冷热分离。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用OpenClaw并发现记忆检索变慢、上下文加载冗余或长期记忆更新滞后，则可能是由于SQLite本地向量索引未合理配置，或在是否引入外部向量数据库的问题上缺乏适配依据。以下是针对不同场景的优化路径：
一、纯SQLite本地向量索引优化
该方案维持OpenClaw原生架构完整性，不引入额外服务依赖，所有检索逻辑封装于单个.sqlite文件内，适用于注重隐私、离线可用及快速部署的用户。
1、启用IVFFlat近似最近邻索引：在vec_chunks虚拟表上执行CREATE INDEX idx_vec_ivf ON vec_chunks USING ivfflat(embedding, 100)，将聚类中心数设为100，平衡精度与响应速度。
2、调整混合检索权重参数：编辑~/.openclaw/workspace/config/memory.yaml，将hybrid_search.weight_vector设为0.65，weight_keyword设为0.35，适配中文技术文档中关键词密度高的特性。
3、激活时间衰减开关：在相同配置文件中设置temporal_decay.enabled: true，并指定temporal_decay.half_life_days: 30，确保非核心日志自动降权。
二、SQLite+轻量级向量数据库协同部署
该方案在保留SQLite作为元数据与文件管理中枢的前提下，将高维向量检索卸载至独立向量服务，缓解本地CPU压力，适用于日均处理超500个记忆块、且存在多Agent并发访问的中型工作流。
1、启动LiteVector服务：执行litevector --db-path ~/.openclaw/memory/vector.db --port 8081 --dim 768，使用与OpenClaw嵌入模型一致的768维输出。
2、重定向向量写入路径：修改openclaw.json中memory.vector_backend字段值为"http://localhost:8081"，使embedding_cache表仅缓存哈希，不再存储向量二进制。
3、同步建立双路索引：运行openclaw memory sync --mode hybrid --source sqlite --target litevector，触发全量chunk向量迁移，并校验chunks_vec与litevector间ID映射一致性。
三、完全外置向量数据库替代方案
该方案弃用SQLite内置向量能力，将全部向量化操作交由专业向量数据库托管，适用于已有Milvus、Qdrant或Weaviate集群，且需统一权限管控与可观测性的企业环境。
1、创建专用collection：在目标向量库中新建collection命名为openclaw_chunks_v2026_3，指定HNSW索引、cosine距离度量及768维向量字段。
2、配置OpenClaw连接凭证：在~/.openclaw/credentials.yaml中添加vector_db:区块，填入host、port、api_key与collection_name四项必填字段。
3、禁用本地sqlite-vec扩展：在终端执行sqlite3 ~/.openclaw/memory/main.sqlite "DROP TABLE IF EXISTS vec_chunks;"，并确认openclaw.json中memory.use_sqlite_vec设为false。
四、SQLite Schema精简与冷热分离
该方案聚焦于降低SQLite单文件体积与I/O延迟，通过剥离低频访问字段、压缩文本块粒度及分离活跃/归档数据，提升高频检索路径效率。
1、执行表结构裁剪：运行openclaw memory optimize --prune-fields chunk_hash,raw_content_md5，移除chunks表中未被任何检索逻辑引用的冗余列。
2、启用分块压缩策略：在config/memory.yaml中设置chunking.compression: zstd与chunking.max_size_bytes: 2048，强制将原文本切分为≤2KB的压缩块。
3、拆分冷热存储路径：创建~/.openclaw/memory/hot/与~/.openclaw/memory/archive/两个目录，将mtime >= 7 days的chunks记录迁移至archive子库，主库仅保留近一周向量索引。
