• config/llm_config.json - 无硬编码 API 密钥（仅占位符）
• config/persona_update.json - auto_update: false（与文档一致）
• config/unified_config.json - auto_update: false（与文档一致）
• require_confirmation: true（更新前需确认）
• backup_before_update: true（更新前备份）

启用用户画像自动更新：

# 修改配置文件
vim ~/.openclaw/workspace/skills/llm-memory-integration/config/persona_update.json
# 设置
{
  "auto_update": true,
  "require_confirmation": true,
  "backup_before_update": true
}

✅ 渐进式启用 + 优化修复

渐进式启用阶段

优化修复

一键启用

# 完整配置（推荐）
python3 ~/.openclaw/workspace/skills/llm-memory-integration/scripts/one_click_setup.py
# 向量架构体系一键配置
python3 ~/.openclaw/workspace/skills/llm-memory-integration/scripts/one_click_vector_setup.py
# 渐进式管理
python3 ~/.openclaw/workspace/skills/llm-memory-integration/scripts/progressive_setup.py status
python3 ~/.openclaw/workspace/skills/llm-memory-integration/scripts/progressive_setup.py enable P0
python3 ~/.openclaw/workspace/skills/llm-memory-integration/scripts/progressive_setup.py disable P3

核心能力

🔧 模型配置（用户自行配置）

配置文件位置

~/.openclaw/workspace/skills/llm-memory-integration/config/llm_config.json

LLM 配置示例

{
  "llm": {
    "provider": "openai-compatible",
    "base_url": "https://api.example.com/v1",
    "api_key": "your-api-key",
    "model": "gpt-4",
    "max_tokens": 150,
    "temperature": 0.5
  }
}

Embedding 配置示例

{
  "embedding": {
    "provider": "openai-compatible",
    "base_url": "https://api.example.com/v1",
    "api_key": "your-api-key",
    "model": "text-embedding-3-small",
    "dimensions": 1536
  }
}

支持的模型提供商

一键配置向导

# 运行配置向导
python3 ~/.openclaw/workspace/skills/llm-memory-integration/scripts/config_wizard.py

性能指标

快速使用

混合记忆搜索

# 自动模式（智能路由）
vsearch "推送规则"
# 快速模式（禁用 LLM）
vsearch "推送规则" --no-llm
# 完整模式（解释 + 摘要）
vsearch "如何配置记忆系统" --explain --summarize

LLM 记忆分析

# 提取用户偏好
llm-analyze persona "对话内容"
# 提取场景
llm-analyze scene "对话内容"
# 总结对话
llm-analyze summarize "对话内容"

技术架构

用户查询
    ↓
[查询理解] → 意图识别 + 实体提取
    ↓
[查询改写] → 拼写纠正 + 同义词扩展 + 语义扩展
    ↓
[语言检测] → 多语言支持
    ↓
[智能路由] → fast/balanced/full 模式
    ↓
[LLM 查询扩展] → 5个扩展词（优化prompt）
    ↓
[向量搜索] → top_k=20, max_dist=0.8（放宽阈值）
    ↓
[FTS 搜索] → 关键词匹配
    ↓
[RRF 融合] → 混合排序
    ↓
[语义去重] → 结果去重
    ↓
[LLM 重排序] → 最终排序
    ↓
[反馈学习] → 应用历史反馈
    ↓
[结果解释/摘要] → LLM 生成

默认配置信息

⚠️ 用户需自行配置 LLM 和 Embedding 模型，本技能不内置任何 API 密钥。

脚本列表

核心模块

核心功能脚本

使用示例

语义匹配（修复后）

$ vsearch "如何让AI记住重要信息"
结果: 9 条  # 之前 0 条
Top1: yaoyao-memory 配置场景
Top2: LLM 集成场景
Top3: embedding 配置场景

拼写纠正

$ vsearch "推送规责"
改写: 推送规则  # 自动纠正

智能路由

$ vsearch "推送规则"
模式: balanced (智能路由)
$ vsearch "如何配置记忆系统"
模式: full (智能路由)

结果解释

$ vsearch "用户偏好设置" --explain
💡 这些记忆记录了用户对AI行为模式、输出格式及功能执行流程的特定定制要求...

结果摘要

$ vsearch "如何配置记忆系统" --summarize
📝 摘要: 用户于2026年4月4日至5日完成OpenClaw记忆系统配置...

缓存命中

$ vsearch "推送规则"
缓存命中
耗时: 5ms