適合:OpenClaw 初學者、自架使用者、AI 工具開發者

OpenClaw 從安裝到穩定維運完整指南

給想自行架設 OpenClaw 的使用者,依序完成基本設定、模型串接、遠端存取、記憶管理與常見故障排除。

最後更新:

建立基礎認識

先了解 OpenClaw 的定位與目前名稱,再開始選擇部署方式。

  1. 1. 背景與版本脈絡

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

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

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

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

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

完成模型與操作設定

設定模型供應商,並依需求加入遠端操作方式。

  1. 3. 模型設定

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

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

  2. 4. 替代模型方案

    OpenCode Go 費用與訂閱:API Key、Go vs Zen、OpenClaw 設定教學

    OpenCode Go 首月 5 美元、之後每月 10 美元。本文整理訂閱與 API Key 取得方式、Go 和 Zen 差異,以及在 OpenClaw 執行 onboarding、確認模型與設定預設模型的步驟。

  3. 5. Telegram 操作入口

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

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

管理記憶與工作空間

避免更新或重新部署後遺失重要設定與長期記憶。

  1. 6. 升級記憶系統

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

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

  2. 7. 備份與還原

    OpenClaw 身份資料備份與遷移

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

疑難排解

從常見啟動、版本與環境衝突問題開始定位。

  1. 8. 更新失敗診斷

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

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

  2. 9. Node.js 環境衝突

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

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

  3. 10. 版本相容性修復

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

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