摘要:想讓 OpenClaw 在隔離環境裡 24 小時運行、不污染本機 Node 環境?Docker 容器化是最佳選擇。官方提供 docker-setup.sh 一鍵腳本,可自動啟動 Gateway、生成 token、完成 onboard,並將工作區與記憶存於主機 ~/clawd/ 與 ~/.moltbot/,重啟容器也不丟資料。本文從前置需求、執行步驟到常見問題一次講清楚。
為什麼用 Docker 跑 OpenClaw?
OpenClaw 官方支援多種安裝方式:本機安裝腳本、npm 全域安裝、以及 Docker。Docker 適合「不想在本機裝 Node.js」「希望環境可重現」「同一台機器跑多個 OpenClaw 實例」的使用者。容器內已包含 Node 與相依套件,你只需要 Docker Desktop(Mac/Windows)或 Docker Engine + Docker Compose v2(Linux),即可一鍵啟動 Gateway。
資料持久化方面,容器重啟後工作區、記憶、設定都會保留,因為官方設計將 ~/clawd/(工作區、記憶、工件)與 ~/.moltbot/(設定、憑證、會話)掛載到主機,不會隨容器刪除而消失。
前置需求
- Docker:Docker Desktop(macOS/Windows)或 Linux 上 Docker Engine + Docker Compose v2。
- 磁碟空間:預留足夠空間給映像與日誌(建議 5GB 以上)。
- 網路:需能存取 Docker Hub、GitHub、npm 等,下載映像與套件時建議使用穩定網路或 VPN 加速。
一鍵部署步驟
取得 OpenClaw 原始碼
在終端機執行:
執行 Docker 一鍵腳本
在專案根目錄執行:
腳本會啟動 Docker Compose 的 Gateway、將 token 寫入 .env、引導你完成 onboard(選模型、API Key、通訊平台等),並建置 Gateway 映像。完成後可在本機開啟 http://127.0.0.1:18789/ 存取 Web 控制台。
驗證與日常操作
若要檢查服務狀態,可在專案目錄下使用 docker compose ps。日後更新 OpenClaw 時,重新 git pull 後再執行 ./docker-setup.sh 或依官方文件重建映像即可,資料仍在主機掛載目錄中。
常見問題
Q:docker-setup.sh 執行很慢或卡在拉取映像?
Docker 需從 Docker Hub 下載基礎映像,若網路不穩可先開啟 VPN 再執行。建議使用具千兆頻寬的網路服務,下載體驗更順暢。
Q:重啟電腦後容器沒自動跑?
Docker Desktop 多數設定下會隨開機啟動;Linux 上可設定 restart: unless-stopped 在 docker-compose 中讓容器開機自啟。
下載與 API 連線建議
Docker 部署時會從國際節點拉取映像與依賴,若你所在地區連線較慢,建議搭配穩定、高速的網路環境。OpenClaw 運行後呼叫 Claude、GPT 等 API 同樣需要穩定連線,延遲過高會影響回應速度。
推薦搭配 GreenVPN 加速下載與 API 連線
GreenVPN 提供 1000Mbps 千兆直連頻寬,覆蓋全球 70+ 國家地區,穩定運行十年。無論是拉取 Docker 映像、存取 GitHub,還是 OpenClaw 呼叫 Claude/GPT API,都能享受極速穩定體驗。包月僅需 $1.5,30 天無理由退款,全平台支援。
總結
用 Docker 跑 OpenClaw 可讓 AI 助理在隔離環境中 24 小時運行,不影響本機 Node 版本,且透過 ./docker-setup.sh 一條指令即可完成 Gateway 啟動、token 生成與 onboard。記得預留磁碟空間並確保網路穩定,必要時搭配 VPN 加速映像下載與日後 API 連線。