Concepts 导读

零依赖起步的内置记忆引擎,自动检测 API Key 开启向量搜索

Builtin Memory Engine 是 OpenClaw 的默认记忆后端,每个 agent 对应一个 SQLite 数据库,无需额外安装即可使用。最值得先看的是:只要配置了 OpenAI、Gemini 等任一 API Key,引擎会自动启用向量搜索;否则只有关键词搜索可用。容易搞错的是:Ollama 和 Local 不会自动检测,必须显式设置 provider。

先讲这一页到底在解决什么

零依赖起步的内置记忆引擎,自动检测 API Key 开启向量搜索

Builtin Memory Engine 是 OpenClaw 的默认记忆后端,每个 agent 对应一个 SQLite 数据库,无需额外安装即可使用。最值得先看的是:只要配置了 OpenAI、Gemini 等任一 API Key,引擎会自动启用向量搜索;否则只有关键词搜索可用。容易搞错的是:Ollama 和 Local 不会自动检测,必须显式设置 provider。

原文共 9 节,先看 Start Here 路径:/concepts/memory-builtin 查看官方原文

第一站

🧺 先看它能做什么:在同一个抽屉里找字,也找意思

Builtin engine 的厉害处,是能把简单关键词和更像人脑的语义搜索放一起。

🔎

Keyword search

像拿着词条手电筒,照到就找得到。

🧠

Vector search

像按意思去找,不只看字面。

🪢

Hybrid search

像把“字面”和“意思”两条路一起跑。

中文支持

CJK / trigram

像给中文、日文、韩文都准备了更顺手的找法。

第二站

⚙️ 默认就能开,但有 API key 时会更聪明

如果你手边有常见 embedding provider,builtin engine 会自动把向量检索也打开。

OpenAI / Gemini / Voyage / Mistral

像已经挂好的老师名单,系统能自己认出来。

Ollama / Local

像你自己家里的老师,也可以手动加进去。

没有 provider

也没关系,至少关键词搜索还能用。

第三站

📦 SQLite + FTS5 + 可选向量,像一个够稳的记忆柜台

这套默认方案的卖点就是稳,不折腾就能先跑起来。

SQLite

像小巧但靠谱的抽屉柜。

FTS5

像给抽屉加了全文检索标签。

sqlite-vec

像给柜子里再塞一层向量加速层。

最后总结

🎈 把 Builtin Memory 这页压成一句最好记的话

它就是默认记忆柜台:先能存、先能搜,再慢慢把向量搜索和混合检索补齐。