Stage 01

OpenClaw 是什麼?

先認識它的來歷和現在的名字,再挑部署方式。

  1. 1. 背景與版本脈絡

    Moltbot 改名 OpenClaw 了!完整更名懶人包(2026/01/30)

    如果你在搜尋 Moltbot 教學卻發現專案改名了,別擔心!本文整理 Moltbot → OpenClaw 更名的來龍去脈、新功能、以及你需要知道的所有細節。舊的 Moltbot 教學文章依然適用!

  2. 2. 從 Clawdbot 搬到 OpenClaw

    OpenClaw 升級實錄:從 Clawdbot 到 OpenClaw 的無痛遷移指南

    記錄從 Clawdbot 升級至 OpenClaw 的完整過程,包含手動備份、服務切換以及使用 onboard 指令自動完成遷移的實戰經驗分享。

  3. 3. 建立第一套可用環境

    自己架的 OpenClaw 怎麼用 Zeabur AI Hub?

    自己部署的 OpenClaw 要如何接入 Zeabur AI Hub?不同於 Zeabur 一鍵部署,自架環境需要直接編輯 openclaw.json 設定檔。本文詳細說明設定檔位置、模型配置格式與切換技巧。

Stage 02

接上模型和操作入口

選好模型供應商,需要的話再加上 Telegram 這類遠端操作。

  1. 4. 模型設定

    OpenClaw (原 Moltbot) CLI 模型切換失敗?修改 agents.defaults.models 配置全解

    使用 OpenClaw (原 Moltbot/Clawdbot) 切換模型時遇到無法使用的情況?原因是 onboard 時的模型選擇會寫入 agents.defaults.models,本文教你如何修改配置開放更多模型。

  2. 5. 替代模型方案

    OpenCode Go 是什麼?$10 月費、用量上限與 OpenClaw 設定

    OpenCode Go 是 OpenCode 每月 10 美元的獨立訂閱,和 Zen API Key 是兩回事。本文整理 5 小時、每週與每月用量上限怎麼算,以及接上 OpenClaw 的 API Key、provider 設定和呼叫失敗時的檢查順序。

  3. 6. 串接本機與 Cloud 模型

    OpenClaw 串接 Ollama 怎麼設定?先分清本機、Cloud 與 `/v1` 邊界

    OpenClaw 串接 Ollama 時,先選本機、混合或直接 Cloud,再確認原生 API 與模型前綴。本文依 2026.11.3 文件更新手動模型與 discovery 合併規則,加入文字 smoke test、Gateway 網路與 web search 登入檢查,分流端點、目錄及工具問題。

  4. 7. 接入外部模型建立隔離顧問

    試玩 Kimi K2.5:透過 NVIDIA 免費 API 在 OpenClaw 打造隔離顧問代理

    看到 Kimi K2.5 的驚人表現後手癢想試,紀錄如何透過 NVIDIA Build 免費 API 在 OpenClaw 中接入 Kimi K2.5,並建立隔離代理確保資料安全。

  5. 8. Telegram 操作入口

    OpenClaw Telegram Group Topics 設定:讓不同話題有獨立 AI 提示詞

    OpenClaw v2026.3.7 起,topics 支援 agentId 欄位,可以讓不同話題路由到不同 agent。本文整理正確概念、完整設定格式與 Cron 推送到指定話題的方式,並說明 bindings 的限制。

Stage 03

記憶和設定怎麼保住?

做好備份,更新或重新部署後,重要設定和長期記憶都還在。

  1. 9. 建立本機記憶與 Embeddings

    OpenClaw 記憶機制優化:本地 Embeddings 與自主重啟實錄

    解決因對話 Token 爆炸導致的系統癱瘓與記憶錯亂。透過本地 Embeddings 實現高效檢索,擺脫不得不使用 /new 重置而遺失上下文的惡性循環。

  2. 10. 升級記憶系統

    OpenClaw 記憶系統進化:升級至 qmd 專家模式

    從標準本地 Embeddings 躍升至 Tobi Lütke 打造的本地搜尋引擎 qmd。透過 Hybrid Search 與 LLM Reranking,解決 macOS 環境下的 SQLite 動態載入難題,打造極致精準的 Agent 長期記憶。

  3. 11. 備份與還原

    OpenClaw 身份資料備份與遷移

    經歷過 OpenClaw 改名與更新失敗的慘痛教訓後,這是我總結出的資料保全策略,確保 Agent 在無限次重裝中依然記得你是誰。

Stage 04

升級前後要確認什麼?

先保存現狀、確認能退回,再分別檢查排程有沒有跑、通知有沒有送到。

  1. 12. 檢查升級與 rollback 結果

    OpenClaw 2026.11.3 升級:舊版更新器逾時與 Gateway 復原驗收

    OpenClaw 2026.11.3 更新器補上初始套件檢查逾時的復原流程。本文用 9.3/9.4 舊版案例說明如何確認實際失敗版本、保存診斷與備份,並分開驗收 CLI、Gateway 路徑和服務健康,同時保留各舊版的 Node 相容與 rollback 檢查。

  2. 13. 排查 Cron 時區與通知投遞

    OpenClaw Cron 沒準時通知?分開檢查時區、執行與投遞

    OpenClaw 每日排程沒有準時通知,不一定是模型沒執行。本文以 2026.9.8 文件為基準,設定 Asia/Taipei 時區,分開讀取排程、執行與投遞紀錄,辨識 UTC、none、NO_REPLY 與投遞失敗,避免盲目重建工作造成重複通知。

Stage 05

出問題了怎麼查?

從最常見的啟動、版本和環境衝突問題開始找。

  1. 14. 更新失敗診斷

    OpenClaw 2026.3.2 更新踩坑:記憶遺失與 workspaceOnly 限制快速修復

    OpenClaw 升級後記憶功能突然失效?很可能是 2026.3.2 版本新增的 workspaceOnly 限制,讓 Agent 無法存取外部記憶路徑。一行設定即可修復,附 tools.profile 權限確認指南。

  2. 15. Node.js 環境衝突

    OpenClaw (原 Moltbot) CLI 安裝遇 Volta 衝突全解法(2026 實測)

    用 curl 安裝 OpenClaw (原 Moltbot/Clawdbot) CLI 卻找不到指令?如果你使用 Volta 管理 Node.js,這是常見的 PATH 衝突問題。本文提供三種解法,推薦使用 volta install 一鍵修復。

  3. 16. 版本相容性修復

    解決「This version of Antigravity is no longer supported」:OpenClaw 更新與遷移檢查

    OpenClaw 出現「This version of Antigravity is no longer supported」時,先確認版本與舊 provider。本文整理官方現況、安全更新、驗證與回復流程,並說明為何不該再硬改版本號。

  4. 17. 定位特定版本的 Control UI 問題

    OpenClaw 2026.3.22 已知問題:Control UI 503,三行指令暫時修復

    僅影響 2026.3.22 版本。出現「Control UI assets not found」警告與 503 錯誤,是官方發布流程漏掉 UI 建置步驟所致,gateway 本體正常。三行指令暫時修復。