OpenClaw 從安裝到穩定維運完整指南
給想自行架設 OpenClaw 的使用者,依序完成基本設定、模型串接、遠端存取、記憶管理與常見故障排除。
建立基礎認識
先了解 OpenClaw 的定位與目前名稱,再開始選擇部署方式。
完成模型與操作設定
設定模型供應商,並依需求加入遠端操作方式。
- 3. 模型設定
OpenClaw (原 Moltbot) CLI 模型切換失敗?修改 agents.defaults.models 配置全解
使用 OpenClaw (原 Moltbot/Clawdbot) 切換模型時遇到無法使用的情況?原因是 onboard 時的模型選擇會寫入 agents.defaults.models,本文教你如何修改配置開放更多模型。
- 4. 替代模型方案
OpenCode Go 費用與訂閱:API Key、Go vs Zen、OpenClaw 設定教學
OpenCode Go 首月 5 美元、之後每月 10 美元。本文整理訂閱與 API Key 取得方式、Go 和 Zen 差異,以及在 OpenClaw 執行 onboarding、確認模型與設定預設模型的步驟。
- 5. Telegram 操作入口
OpenClaw Telegram Group Topics 設定:讓不同話題有獨立 AI 提示詞
OpenClaw v2026.3.7 起,topics 支援 agentId 欄位,可以讓不同話題路由到不同 agent。本文整理正確概念、完整設定格式與 Cron 推送到指定話題的方式,並說明 bindings 的限制。
管理記憶與工作空間
避免更新或重新部署後遺失重要設定與長期記憶。
疑難排解
從常見啟動、版本與環境衝突問題開始定位。
- 8. 更新失敗診斷
OpenClaw 2026.3.2 更新踩坑:記憶遺失與 workspaceOnly 限制快速修復
OpenClaw 升級後記憶功能突然失效?很可能是 2026.3.2 版本新增的 workspaceOnly 限制,讓 Agent 無法存取外部記憶路徑。一行設定即可修復,附 tools.profile 權限確認指南。
- 9. Node.js 環境衝突
OpenClaw (原 Moltbot) CLI 安裝遇 Volta 衝突全解法(2026 實測)
用 curl 安裝 OpenClaw (原 Moltbot/Clawdbot) CLI 卻找不到指令?如果你使用 Volta 管理 Node.js,這是常見的 PATH 衝突問題。本文提供三種解法,推薦使用 volta install 一鍵修復。
- 10. 版本相容性修復
解決「This version of Antigravity is no longer supported」:OpenClaw 更新與遷移檢查
OpenClaw 出現「This version of Antigravity is no longer supported」時,先確認版本與舊 provider。本文整理官方現況、安全更新、驗證與回復流程,並說明為何不該再硬改版本號。