Docker 一鍵部署 OpenClaw|你的 AI 助理住進容器裡

2026-02-24 閱讀約12分鐘 AI工具教學 Docker

摘要:想讓 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 加速。

一鍵部署步驟

1

取得 OpenClaw 原始碼

在終端機執行:

# 克隆倉庫
git clone https://github.com/openclaw/openclaw.git
cd openclaw
2

執行 Docker 一鍵腳本

在專案根目錄執行:

# 啟動 Docker Compose Gateway、生成 token、執行 onboard
./docker-setup.sh

腳本會啟動 Docker Compose 的 Gateway、將 token 寫入 .env、引導你完成 onboard(選模型、API Key、通訊平台等),並建置 Gateway 映像。完成後可在本機開啟 http://127.0.0.1:18789/ 存取 Web 控制台。

3

驗證與日常操作

若要檢查服務狀態,可在專案目錄下使用 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 天無理由退款,全平台支援。

頻寬
1000Mbps
節點
70+國
穩定
十年
月費
$1.5
免費試用 GreenVPN

總結

用 Docker 跑 OpenClaw 可讓 AI 助理在隔離環境中 24 小時運行,不影響本機 Node 版本,且透過 ./docker-setup.sh 一條指令即可完成 Gateway 啟動、token 生成與 onboard。記得預留磁碟空間並確保網路穩定,必要時搭配 VPN 加速映像下載與日後 API 連線。

讓 OpenClaw 跑得更快更穩

GreenVPN 1000Mbps 千兆頻寬,月費 $1.5,30 天不滿意全額退款

立即免費試用 GreenVPN

相關文章推薦

全球70+節點 · 穩定運行十年
免費試用 GreenVPN