適合:OpenClaw 新手、想自架 AI 助手的人
OpenClaw 從安裝到穩定運作
想自己架 OpenClaw,又怕一更新就壞、記憶跟著不見?這裡照著實際使用的順序整理:認識它、接上模型、保住記憶,再到安全升級和排除常見錯誤,讓它能長期穩定地用下去。
OpenClaw 是什麼?
先認識它的來歷和現在的名字,再挑部署方式。
- 1. 背景與版本脈絡
Moltbot 改名 OpenClaw 了!完整更名懶人包(2026/01/30)
如果你在搜尋 Moltbot 教學卻發現專案改名了,別擔心!本文整理 Moltbot → OpenClaw 更名的來龍去脈、新功能、以及你需要知道的所有細節。舊的 Moltbot 教學文章依然適用!
- 2. 從 Clawdbot 搬到 OpenClaw
OpenClaw 升級實錄:從 Clawdbot 到 OpenClaw 的無痛遷移指南
記錄從 Clawdbot 升級至 OpenClaw 的完整過程,包含手動備份、服務切換以及使用 onboard 指令自動完成遷移的實戰經驗分享。
- 3. 建立第一套可用環境
自己架的 OpenClaw 怎麼用 Zeabur AI Hub?
自己部署的 OpenClaw 要如何接入 Zeabur AI Hub?不同於 Zeabur 一鍵部署,自架環境需要直接編輯 openclaw.json 設定檔。本文詳細說明設定檔位置、模型配置格式與切換技巧。
接上模型和操作入口
選好模型供應商,需要的話再加上 Telegram 這類遠端操作。
- 4. 模型設定
OpenClaw (原 Moltbot) CLI 模型切換失敗?修改 agents.defaults.models 配置全解
使用 OpenClaw (原 Moltbot/Clawdbot) 切換模型時遇到無法使用的情況?原因是 onboard 時的模型選擇會寫入 agents.defaults.models,本文教你如何修改配置開放更多模型。
- 5. 替代模型方案
OpenCode Go 是什麼?$10 月費、用量上限與 OpenClaw 設定
OpenCode Go 是 OpenCode 每月 10 美元的獨立訂閱,和 Zen API Key 是兩回事。本文整理 5 小時、每週與每月用量上限怎麼算,以及接上 OpenClaw 的 API Key、provider 設定和呼叫失敗時的檢查順序。
- 6. 串接本機與 Cloud 模型
OpenClaw 串接 Ollama 怎麼設定?先分清本機、Cloud 與 `/v1` 邊界
OpenClaw 串接 Ollama 時,先選本機、混合或直接 Cloud,再確認原生 API 與模型前綴。本文依 2026.11.3 文件更新手動模型與 discovery 合併規則,加入文字 smoke test、Gateway 網路與 web search 登入檢查,分流端點、目錄及工具問題。
- 7. 接入外部模型建立隔離顧問
試玩 Kimi K2.5:透過 NVIDIA 免費 API 在 OpenClaw 打造隔離顧問代理
看到 Kimi K2.5 的驚人表現後手癢想試,紀錄如何透過 NVIDIA Build 免費 API 在 OpenClaw 中接入 Kimi K2.5,並建立隔離代理確保資料安全。
- 8. Telegram 操作入口
OpenClaw Telegram Group Topics 設定:讓不同話題有獨立 AI 提示詞
OpenClaw v2026.3.7 起,topics 支援 agentId 欄位,可以讓不同話題路由到不同 agent。本文整理正確概念、完整設定格式與 Cron 推送到指定話題的方式,並說明 bindings 的限制。
記憶和設定怎麼保住?
做好備份,更新或重新部署後,重要設定和長期記憶都還在。
- 9. 建立本機記憶與 Embeddings
OpenClaw 記憶機制優化:本地 Embeddings 與自主重啟實錄
解決因對話 Token 爆炸導致的系統癱瘓與記憶錯亂。透過本地 Embeddings 實現高效檢索,擺脫不得不使用 /new 重置而遺失上下文的惡性循環。
- 10. 升級記憶系統
OpenClaw 記憶系統進化:升級至 qmd 專家模式
從標準本地 Embeddings 躍升至 Tobi Lütke 打造的本地搜尋引擎 qmd。透過 Hybrid Search 與 LLM Reranking,解決 macOS 環境下的 SQLite 動態載入難題,打造極致精準的 Agent 長期記憶。
- 11. 備份與還原
OpenClaw 身份資料備份與遷移
經歷過 OpenClaw 改名與更新失敗的慘痛教訓後,這是我總結出的資料保全策略,確保 Agent 在無限次重裝中依然記得你是誰。
升級前後要確認什麼?
先保存現狀、確認能退回,再分別檢查排程有沒有跑、通知有沒有送到。
- 12. 檢查升級與 rollback 結果
OpenClaw 2026.11.3 升級:舊版更新器逾時與 Gateway 復原驗收
OpenClaw 2026.11.3 更新器補上初始套件檢查逾時的復原流程。本文用 9.3/9.4 舊版案例說明如何確認實際失敗版本、保存診斷與備份,並分開驗收 CLI、Gateway 路徑和服務健康,同時保留各舊版的 Node 相容與 rollback 檢查。
- 13. 排查 Cron 時區與通知投遞
OpenClaw Cron 沒準時通知?分開檢查時區、執行與投遞
OpenClaw 每日排程沒有準時通知,不一定是模型沒執行。本文以 2026.9.8 文件為基準,設定 Asia/Taipei 時區,分開讀取排程、執行與投遞紀錄,辨識 UTC、none、NO_REPLY 與投遞失敗,避免盲目重建工作造成重複通知。
出問題了怎麼查?
從最常見的啟動、版本和環境衝突問題開始找。
- 14. 更新失敗診斷
OpenClaw 2026.3.2 更新踩坑:記憶遺失與 workspaceOnly 限制快速修復
OpenClaw 升級後記憶功能突然失效?很可能是 2026.3.2 版本新增的 workspaceOnly 限制,讓 Agent 無法存取外部記憶路徑。一行設定即可修復,附 tools.profile 權限確認指南。
- 15. Node.js 環境衝突
OpenClaw (原 Moltbot) CLI 安裝遇 Volta 衝突全解法(2026 實測)
用 curl 安裝 OpenClaw (原 Moltbot/Clawdbot) CLI 卻找不到指令?如果你使用 Volta 管理 Node.js,這是常見的 PATH 衝突問題。本文提供三種解法,推薦使用 volta install 一鍵修復。
- 16. 版本相容性修復
解決「This version of Antigravity is no longer supported」:OpenClaw 更新與遷移檢查
OpenClaw 出現「This version of Antigravity is no longer supported」時,先確認版本與舊 provider。本文整理官方現況、安全更新、驗證與回復流程,並說明為何不該再硬改版本號。
- 17. 定位特定版本的 Control UI 問題
OpenClaw 2026.3.22 已知問題:Control UI 503,三行指令暫時修復
僅影響 2026.3.22 版本。出現「Control UI assets not found」警告與 503 錯誤,是官方發布流程漏掉 UI 建置步驟所致,gateway 本體正常。三行指令暫時修復。