TLDR：Docker 部署 OpenClaw 的重點
- 問題：本機關機後 AI 就離線，無法 24 小時服務
- 解法：用 Docker 部署到雲端 VPS，持續運行
- 需求：Ubuntu/macOS/Windows WSL2、4GB RAM、Docker
- 核心指令：
git clone→./docker-setup.sh→ 完成 - 關鍵設定：記得設定
OPENCLAW_HOME_VOLUME保留資料
本文由好事發生創立的 OpenClaw 執行撰寫。我們提供精準的自動化SEO服務，了解更多
本文由好事發生創立的 OpenClaw 執行撰寫。我們提供精準的自動化SEO服務，了解更多
本文由好事發生創立的 OpenClaw 執行撰寫。我們提供精準的自動化SEO服務，了解更多
本文由好事發生創立的 OpenClaw 執行撰寫。我們提供精準的自動化SEO服務，了解更多
Docker 是什麼？為什麼用它來部署 OpenClaw？
在進入操作之前，我們先用一個比喻來理解 Docker。
想像你要搬家。傳統做法是把所有家具逐件搬到新家，然後祈禱插座位置對、門框尺寸合。Docker 的做法不同。它把你的整個房間（包含家具、電器、牆上的畫）打包成一個「貨櫃」，直接搬到任何地方，打開就能住。
在技術層面，Docker 把應用程式和它需要的所有相依套件封裝成一個獨立的「容器（Container）」。這意味著：
- 不用擔心「你的電腦可以跑，我的不行」的問題
- 環境一致，部署到哪都一樣
- 隔離性好，OpenClaw 的運行不會影響主機上其他服務
- 方便更新和回滾。換個版本，重建容器就好
對 OpenClaw 來說，Docker 部署有一個關鍵優勢：你可以把它放在雲端 VPS 上 24 小時運行，隨時透過瀏覽器連線操作。不需要一直開著筆電，AI 助理也能持續待命。如果你正在選擇主機，可以參考我們的 OpenClaw VPS 主機推薦指南。
部署前的準備清單
在開始之前，請確認你的環境符合以下條件：
| 項目 | 最低需求 | 建議配置 |
|---|---|---|
| 作業系統 | Linux（Ubuntu 22.04+）、macOS、Windows（WSL2） | Ubuntu 24.04 LTS |
| 記憶體（RAM） | 2 GB | 4 GB 以上 |
| 硬碟空間 | 10 GB | 20 GB 以上 |
| Docker | Docker Engine + Docker Compose | 最新穩定版 |
| 網路 | 穩定的網路連線 | 固定 IP（雲端主機通常內建） |
💡 小提醒：OpenClaw 官方不提供預建的 Docker image。Docker Hub 上沒有
openclaw/openclaw:latest這樣的映像檔可以直接拉取。你需要從原始碼建構。雖然社群有非官方 image（例如alpine/openclaw），但為了穩定性與安全性，我們建議使用官方的建構方式。
如果你還沒安裝 Docker，下一節會帶你完成安裝。已經有 Docker 環境的朋友，可以直接跳到 Step 2。
OpenClaw Docker 部署：完整 Step by Step 教學
Step 1：安裝 Docker 與 Docker Compose
以 Ubuntu 為例，在終端機執行以下指令：
# 更新套件清單
sudo apt update
# 安裝 Docker
sudo apt install -y docker.io docker-compose-plugin
# 將目前使用者加入 docker 群組（免 sudo 執行）
sudo usermod -aG docker $USER
# 重新登入讓群組設定生效
newgrp docker
# 確認安裝成功
docker --version
docker compose versionmacOS 使用者可以直接下載 Docker Desktop，安裝後啟動即可。Windows 使用者需要先啟用 WSL2，再安裝 Docker Desktop。
Step 2：Clone OpenClaw 原始碼
OpenClaw 是一個擁有 176,000+ 顆星 的開源專案。倉庫中已經包含了部署所需的所有檔案：Dockerfile、Dockerfile.sandbox、docker-compose.yml，以及自動化腳本 docker-setup.sh。
# Clone 官方倉庫
git clone https://github.com/openclaw/openclaw.git
# 進入專案目錄
cd openclaw如果你的主機沒有安裝 Git，可以用 sudo apt install -y git 先裝好。想了解更多本機安裝方式，可以參考 OpenClaw 本機安裝指南。
Step 3：執行 docker-setup.sh 自動化腳本
這是整個部署流程中最關鍵的一步。OpenClaw 提供的 docker-setup.sh 腳本會自動完成以下工作：
- 從
Dockerfile建構 Docker 映像檔（基於 Node.js 22） - 執行 Onboarding 精靈，引導你完成初始設定
- 產生 Gateway Token（用於存取 Web UI）
- 建立設定目錄
~/.openclaw和工作目錄~/openclaw/workspace - 透過 Docker Compose 啟動服務
# 給予腳本執行權限
chmod +x docker-setup.sh
# 執行自動化部署腳本
./docker-setup.sh腳本執行完成後，終端機會顯示一組 Gateway Token。這組 Token 是你連線到 OpenClaw Web UI 的鑰匙。請妥善保存。
Step 4：設定環境變數
如果你希望自訂設定，可以在執行 docker-setup.sh 之前設定環境變數。以下是常用的環境變數：
# 自訂 Gateway 連接埠（預設 18789）
export OPENCLAW_GATEWAY_PORT=18789
# 設定持久化 Volume（資料不會因容器重建而消失）
export OPENCLAW_HOME_VOLUME=openclaw-home
# 掛載額外的主機目錄到容器中
export OPENCLAW_EXTRA_MOUNTS="$HOME/my-projects:/home/node/projects:rw"
# 安裝額外的系統套件（如果你的工作流程需要）
export OPENCLAW_DOCKER_APT_PACKAGES="build-essential python3"
# 設定完成後再執行腳本
./docker-setup.sh這些變數讓你可以根據自己的需求微調部署設定，而不需要直接修改 docker-compose.yml。
Step 5：連線到 OpenClaw Web UI
部署完成後，OpenClaw 會在 Port 18789 啟動 Web UI。打開瀏覽器，輸入：
http://你的主機IP:18789在設定頁面中貼上 Step 3 取得的 Gateway Token，就能開始使用。如果是本機測試，網址會是 http://127.0.0.1:18789。
部署到雲端主機後，OpenClaw 就能 24 小時在線。你可以從任何裝置、任何地點連線到你的 AI 助理。關於雲端主機的費用考量，可以看看 OpenClaw 費用完整解析。
環境變數完整對照表
以下整理了 OpenClaw Docker 部署中所有重要的環境變數：
| 環境變數 | 說明 | 預設值 |
|---|---|---|
OPENCLAW_GATEWAY_TOKEN | Web UI 認證 Token，由腳本自動產生 | 自動生成（openssl / python3） |
OPENCLAW_GATEWAY_PORT | Web UI 監聽的連接埠 | 18789 |
OPENCLAW_HOME_VOLUME | 持久化 /home/node 資料的 Docker Volume 名稱 | 無（不持久化） |
OPENCLAW_EXTRA_MOUNTS | 額外掛載主機目錄，逗號分隔 | 無 |
OPENCLAW_DOCKER_APT_PACKAGES | 建構映像時安裝的額外系統套件 | 無 |
OPENCLAW_CONFIG_DIR | OpenClaw 設定檔目錄 | ~/.openclaw |
OPENCLAW_WORKSPACE_DIR | 工作目錄（Agent 可存取的檔案空間） | ~/openclaw/workspace |
CLAUDE_AI_SESSION_KEY | AI 服務的 Session Key | 依據你的 AI 服務商設定 |
💡 小提醒：
OPENCLAW_HOME_VOLUME的設定值得留意。如果你沒有設定它，每次容器重建時/home/node底下的資料（包括 Agent 記憶和工作檔案）都會消失。建議在正式部署時加上這個設定。
常見問題排解
Q1：docker-setup.sh 執行時出現權限錯誤
這通常是因為目前的使用者不在 docker 群組中。執行以下指令後重新登入：
sudo usermod -aG docker $USER
# 然後登出並重新登入，或執行：
newgrp dockerQ2：建構映像時失敗，顯示 Node.js 版本相關錯誤
OpenClaw 需要 Node.js 22 以上版本。Docker 映像會使用 node:22-bookworm 作為基底，理論上不會有版本問題。如果你遇到錯誤，請確認：
- Docker 版本是否為最新穩定版
- 是否有足夠的硬碟空間（建構過程需要下載基底映像）
- 網路連線是否穩定（需要從 Docker Hub 拉取
node:22-bookworm）
Q3：忘記 Gateway Token 怎麼辦？
不用擔心，你可以透過以下指令重新取得 Token：
docker compose run --rm openclaw-cli dashboard --no-open終端機會重新顯示你的 Token 資訊。
Q4：容器重啟後資料消失了
這是因為沒有設定持久化 Volume。請在 docker-setup.sh 執行前加上：
export OPENCLAW_HOME_VOLUME=openclaw-home
./docker-setup.sh這會建立一個名為 openclaw-home 的 Docker Volume，確保資料在容器重建後依然保留。
Q5：Port 18789 被其他服務佔用
你可以透過環境變數更換連接埠：
export OPENCLAW_GATEWAY_PORT=19000
./docker-setup.sh之後用新的 Port 連線即可：http://你的主機IP:19000。
Q6：想更新到新版本怎麼做？
更新流程相當直覺：
# 進入專案目錄
cd openclaw
# 拉取最新程式碼
git pull origin main
# 停止目前的容器
docker compose down
# 重新建構映像並啟動
./docker-setup.sh只要你有設定 OPENCLAW_HOME_VOLUME，更新過程中的資料都會保留。
不想自己架伺服器？我們幫你處理
看完教學覺得可行，但不想面對 Linux 指令、Docker 設定、或是擔心搞壞伺服器？
我們提供 EasyClaw 代管服務，讓你跳過所有部署步驟，直接開始使用：
- 不需要準備 VPS 或管理主機
- 不需要設定 Docker 或環境變數
- 不需要擔心 SSL、備份、更新
- 我們幫你維護、監控、擴展
- 你只需專注於設定 AI 要怎麼回覆客戶
從簽約到上線，最快只要 3 個工作天。適合想快速驗證 AI 客服效果，但沒有技術人力的團隊。
安全性考量
Docker 部署本身就提供了一層隔離保護。OpenClaw 的 Docker 映像預設以非 root 的 node 使用者身份運行，降低了安全風險。不過，以下幾點值得留意：
- Gateway Token 的保護：Token 等同於你 OpenClaw 的密碼，不要分享或暴露在公開環境中
- 防火牆設定：如果部署在雲端，確保只開放必要的 Port，並考慮搭配反向代理（如 Nginx）加上 HTTPS
- 掛載目錄的權限：使用
OPENCLAW_EXTRA_MOUNTS時，盡量用:ro（唯讀）模式，除非 Agent 確實需要寫入 - 定期更新：保持 Docker 映像和 OpenClaw 原始碼為最新版本
更深入的安全實踐，可以參考我們的 AI Agent 安全指南。
結語：讓 AI 助理真正成為你的日常夥伴
完成 OpenClaw Docker 部署後，你擁有的不只是一個「跑在雲端的程式」，而是一個隨時待命的 AI 工作夥伴。無論你在咖啡廳用筆電、在通勤時用手機，都能連線到你的 OpenClaw 實例，延續昨天的對話和任務。
我們來回顧一下整個流程的重點：
- OpenClaw 需要從原始碼建構 Docker 映像，不能直接
docker pull docker-setup.sh是官方推薦的部署方式，自動處理建構和設定- 環境變數讓你可以靈活調整 Port、掛載目錄和持久化設定
- 記得設定
OPENCLAW_HOME_VOLUME來保留 Agent 資料 - 安全性方面，保護好 Gateway Token 並搭配防火牆使用
- 想讓 OpenClaw 更聰明：部署完成後，讓 AI 具備「記憶」和「搜尋」能力。參考QMD 本地搜尋引擎
如果你是第一次接觸 OpenClaw，建議從OpenClaw 完整指南（2026 版）開始，全面了解這個工具的能力與生態。Docker 部署只是其中一個環節，搭配適合的主機和工作流程，才能發揮它的完整價值。
聯絡我們
電話：0926-000-214
本文由好事發生創立的 OpenClaw 執行撰寫
我們提供精準的自動化SEO服務，了解更多