🏷️ 文章标签
#OpenClaw#向量记忆#memory-core#插件报错#版本兼容

OpenClaw向量记忆插件报错排查指南

🔗 相关链接： AI工具导航站 Vercel镜像

一、问题现象

Gateway报错：

⚠️ 🔌 Gateway: memorySearch failed

检查系统状态：

│ Memory │ enabled (plugin memory-core) · unavailable │

⚠️ 困惑点：配置了Ollama向量模型，本地运行正常，为什么插件显示”unavailable”？

二、症状识别

三、诊断思路

第一步：排除配置问题

检查memorySearch配置：

# 查看配置文件
cat ~/.openclaw/openclaw.json | grep -A10 memorySearch

配置正常：

"memorySearch": {
  "provider": "ollama",
  "model": "nomic-embed-text",
  "baseUrl": "http://localhost:11434"
}

测试Ollama向量服务：

# 测试embedding接口
curl http://localhost:11434/api/embed \
  -d '{"model":"nomic-embed-text","input":"test"}'

第二步：检查插件状态

openclaw plugins list | grep memory

│ Memory │ memory-core │ openclaw │ error │ 2026.4.1-beta.1 │

❌ 关键发现：插件状态是 error，不是 enabled。

第三步：运行doctor诊断

openclaw doctor --non-interactive

找到根因：

ERROR memory-core: plugin failed during register: TypeError:
register.registerMemoryEmbeddingProvider is not a function

四、根因分析

版本兼容性问题

⚠️ 原因：beta版插件使用了新API，正式版OpenClaw还没实现。

五、影响范围

六、解决方案

方案一：等待更新（推荐）

等待OpenClaw和memory-core插件版本同步更新。

方案二：使用替代方案

在插件修复前，使用文件形式记忆系统：

• SESSION-STATE.md
  
  ：不受上下文压缩影响，每次session启动自动读取
• MEMORY.md
  
  ：人类可读的长期记忆，手动维护索引

七、诊断命令汇总

# 1. 检查memory状态
openclaw status | grep Memory

# 2. 检查插件列表
openclaw plugins list | grep memory

# 3. 深度诊断
openclaw doctor --non-interactive

# 4. 测试向量服务
curl http://localhost:11434/api/embed \
  -d '{"model":"nomic-embed-text","input":"test"}'

八、总结

🎯 一句话结论
向量记忆插件报错时，先检查版本兼容性——beta版插件可能与正式版OpenClaw API不匹配。

🔗 相关链接： AI工具导航站

相关文章：

• OpenClaw定时任务推送失败排查指南
• OpenClaw文件编辑踩坑指南

—— 爱默如深 · OpenClaw技术系列 ——