OpenClaw 用久覺得記憶力不夠？安裝 LanceDB PRO 讓 AI 助理真正記住你說過的話
你有沒有過這種經驗？跟 AI 說「幫我記住這件事」，結果下次問它，它完全沒印象？
這不是你的錯覺——OpenClaw 內建的記憶功能，本來就只有最基礎的向量搜尋。裝完 LanceDB PRO 之後，才會變成真正的「長期記憶系統」——不只是記住，還能自己思考、分類，自動複習。
這篇不是業配，我會直接帶你走一遍完整安裝流程，中間哪些地方最容易出錯，我也會明說。
在說安裝之前：LanceDB PRO 跟原來的版本差在哪？
簡單講，原版只能做「語意相似度搜尋」，新版把檢索引擎整個升級了：
- 混合檢索：不是只找語意相近，連關鍵字命中也算分數，兩個加在一起排序
- 結果重排序（Rerank）：用 Jina 交叉編碼器重新評估，把真正相關的拉上來
- Scope 隔離：不同 Agent 的記憶不會互相污染，各自有獨立空間
- 自動反思：每次對話結束自動做小結，長期累積下來 AI 越來越懂你
- 自適應檢索：系統自己判斷這句話需不需要查記憶，不是每次都亂抓
- Markdown 雙寫：記憶同時存進可讀的檔案，方便你事後審計或手動整理
安裝前必看：五個最常見的踩坑點
安裝失敗的原因，90% 都出在這幾項。先看過一遍，心裡有數再動手，成功率會高很多。
坑一：相對路徑寫配置，導致外掛 loading 失敗
很多人把外掛 clone 到任何地方，但設定檔裡寫的是：
"paths": ["plugins/memory-lancedb-pro"]問題在於——相對路徑的解析基準，會根據 Gateway 的啟動方式改變。用 systemd 啟動和用手動 node 啟動，找出來的路徑完全不同。明明外掛就在那裡，但 OpenClaw 怎麼都載入不到你裝的外掛。
解決方式：全部換成絕對路徑。
"paths": ["/home/你的使用者名稱/.openclaw/workspace/plugins/memory-lancedb-pro"]坑二：舊版 memory 外掛沒有停用，兩個打架
OpenClaw 同一時間只能有一個 memory 外掛在跑。如果你的設定檔案裡還啟著原本的 memory-lancedb，新外掛會因為 slot 衝突無法正常載入。
在 plugins.entries 裡面，把舊版設為 false，新外掛才不會搶同一個位置。
坑三：API Key 只在終端設了，systemd 環境沒有
這是最容易被忽略的坑。很多人習慣在 ~/.bashrc 或者終端機裡 export JINA_API_KEY=xxx，然後以為服務也讀得到。
但 Gateway 通常是用 systemd 運行的，而 systemd 不會繼承你終端的環境變數——它有自己獨立的環境。所以 API Key 在終端能跑，Gateway 卻一直報認證失敗。
解決方法：在 systemd service 檔案裡用 Environment= 顯式傳入，或者在 docker-compose 裡用 -e 參數。
坑四：沒有執行 npm install
clone 完之後直接 openclaw gateway restart，沒跑 npm install。依賴沒裝，外掛啟動時會一直報錯，但錯誤訊息不一定明顯，很容易誤判為其他原因。
坑五：clone 到錯誤的目錄
OpenClaw 的 workspace 目錄預設是 ~/.openclaw/workspace。如果你把外掛放到別的地方，再用相對路徑引用，基本上就是災難開始。
建議直接 clone 到 workspace/plugins/ 下，然後用絕對路徑引用，最穩。
完整安裝步驟
第一步：確認你的 workspace 在哪裡
openclaw config get agents.defaults.workspace記下輸出的路徑，這是放外掛的基準目錄。之後所有的絕對路徑都要以這個為基礎。
第二步：clone 到正確位置
cd ~/.openclaw/workspace
git clone https://github.com/win4r/memory-lancedb-pro.git plugins/memory-lancedb-pro裝完之後目錄結構應該像這樣：
~/.openclaw/workspace/
└── plugins/
└── memory-lancedb-pro/
├── index.ts
├── package.json
├── README.md
└── src/第三步：安裝 npm 依賴
cd plugins/memory-lancedb-pro
npm install這個不能跳過。缺少 node_modules 的話，外掛載入會靜默失敗，錯誤很難追蹤。
第四步：編輯 OpenClaw 設定檔
openclaw config edit在 plugins 區塊加入以下內容（把路徑換成你第一步查到的實際路徑）：
{
"plugins": {
"load": {
"paths": ["/home/你的使用者名稱/.openclaw/workspace/plugins/memory-lancedb-pro"]
},
"entries": {
"memory-lancedb-pro": {
"enabled": true,
"config": {
"embedding": {
"apiKey": "${JINA_API_KEY}",
"model": "jina-embeddings-v5-text-small",
"baseURL": "https://api.jina.ai/v1",
"dimensions": 1024
}
}
}
},
"slots": {
"memory": "memory-lancedb-pro"
}
}
}Embedding 和 Rerank 功能都需要 Jina API Key。先到 jina.ai 免費申請一個，再回來繼續設定。
第五步：停用舊版 memory 外掛
如果之前有開啟過內建的 memory-lancedb，在 plugins.entries 裡把它關掉：
{
"plugins": {
"entries": {
"memory-lancedb": {
"enabled": false
}
}
}
}第六步：重啟 Gateway
openclaw gateway restart怎麼確認安裝成功了？
方法一：指令檢查
openclaw plugins list
openclaw plugins info memory-lancedb-pro方法二：診斷指令
openclaw plugins doctor看到 memory-lancedb-pro: loaded 就代表外掛已經被正確載入。
方法三：實際測試記憶存取
在 OpenClaw 的對話視窗試著存一段記憶：
霜霜，幫我記住：我的電腦是華碩 VivoBook 15然後等幾秒，再問：
霜霜，我的電腦是什麼牌子？如果它正確回答了，代表記憶功能完全正常運作。
方法四：檢查資料庫檔案
ls ~/.openclaw/memory/lancedb-pro/應該會看到 .lance 格式的資料庫檔案。如果目錄是空的，代表外掛還沒有成功創建儲存。
安裝之後常見問題速查
| 症狀 | 原因 | 解決方法 |
|---|---|---|
| 外掛 loading 失敗 | 路徑寫錯 / 沒裝 npm 依賴 | 用絕對路徑 + 確認 npm install 有跑完 |
| 一直說 API Key 無效 | systemd 環境沒有這個環境變數 | 在 service 檔案裡用 Environment= 傳入 |
| 記憶怎麼都抓不到 | 舊版外掛還在跑，slot 被占走了 | 停用內建 memory-lancedb |
| 搜尋結果全是零分 | Rerank API Key 沒填 | 確認 retrieval.rerankApiKey 有填入 |
設定推薦：基礎版 vs 完整版
如果只是想「能記住東西 + 混合檢索」，最簡設定只需要三個欄位：
{
"embedding": { "apiKey": "${JINA_API_KEY}" },
"dbPath": "~/.openclaw/memory/lancedb-pro",
"autoCapture": true
}如果想要完整功能（自動反思 + 自適應 + 多 Agent 隔離），用這套：
{
"embedding": {
"apiKey": "${JINA_API_KEY}",
"model": "jina-embeddings-v5-text-small",
"baseURL": "https://api.jina.ai/v1",
"dimensions": 1024
},
"dbPath": "~/.openclaw/memory/lancedb-pro",
"autoCapture": true,
"autoRecall": true,
"retrieval": {
"mode": "hybrid",
"vectorWeight": 0.7,
"bm25Weight": 0.3,
"rerank": "cross-encoder"
},
"memoryReflection": {
"enabled": true,
"sessionStrategy": "memoryReflection"
}
}最後
LanceDB PRO 裝完之後，最大的感受會是——你幾乎不再需要手動說「幫我記住」了。系統會自動在後台做好捕捉、分類、複習。
但安裝過程確實有幾個地方容易出錯，最核心的三件事：
- 全部用絕對路徑，不要用相對路徑
- 確認 API Key 在 Gateway 的運行環境裡有設定，不是在終端機裡設了就當作服務也有
- 記得停用舊版外掛，同一個 slot 不能有兩個外掛
按照步驟走，大概五到十分鐘可以完成。裝完之後，你的 OpenClaw 會變得超有記憶力。
S.M.Project ⚫⚪✨ 你的電腦專家
