OpenClaw 從安裝到穩定維運完整指南
給想自行架設 OpenClaw 的使用者,依序完成基本設定、模型串接、遠端存取、記憶管理與常見故障排除。
建立基礎認識
先了解 OpenClaw 的定位與目前名稱,再開始選擇部署方式。
完成模型與操作設定
設定模型供應商,並依需求加入遠端操作方式。
- 3. 模型設定
OpenClaw (原 Moltbot) CLI 模型切換失敗?修改 agents.defaults.models 配置全解
使用 OpenClaw (原 Moltbot/Clawdbot) 切換模型時遇到無法使用的情況?原因是 onboard 時的模型選擇會寫入 agents.defaults.models,本文教你如何修改配置開放更多模型。
- 4. 替代模型方案
OpenCode Go 費用與訂閱:$10 方案、模型與 OpenClaw 設定
OpenCode Go 現行官方方案為每月 10 美元,並受 5 小時、每週與每月用量上限影響。本文更新訂閱、OpenClaw onboarding、模型前綴、共享 API Key、工作區限制與常見錯誤排查,也提醒設定前要重新核對官方方案頁與 CLI 輸出。
- 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。本文整理官方現況、安全更新、驗證與回復流程,並說明為何不該再硬改版本號。