好事發生數位AI

OpenClaw Docker 部署：讓 AI 助理 24 小時在線

Gary
2026/2/8

用 AI 深入探索這篇文章

點選下方平台，從消費者角度快速整理重點、追問問題與站內延伸閱讀

ChatGPTGoogle AI

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 GB4 GB 以上
硬碟空間10 GB20 GB 以上
DockerDocker 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 version

macOS 使用者可以直接下載 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 腳本會自動完成以下工作：

  1. 從 Dockerfile 建構 Docker 映像檔（基於 Node.js 22）
  2. 執行 Onboarding 精靈，引導你完成初始設定
  3. 產生 Gateway Token（用於存取 Web UI）
  4. 建立設定目錄 ~/.openclaw 和工作目錄 ~/openclaw/workspace
  5. 透過 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_TOKENWeb UI 認證 Token，由腳本自動產生自動生成（openssl / python3）
OPENCLAW_GATEWAY_PORTWeb UI 監聽的連接埠18789
OPENCLAW_HOME_VOLUME持久化 /home/node 資料的 Docker Volume 名稱無（不持久化）
OPENCLAW_EXTRA_MOUNTS額外掛載主機目錄，逗號分隔無
OPENCLAW_DOCKER_APT_PACKAGES建構映像時安裝的額外系統套件無
OPENCLAW_CONFIG_DIROpenClaw 設定檔目錄~/.openclaw
OPENCLAW_WORKSPACE_DIR工作目錄（Agent 可存取的檔案空間）~/openclaw/workspace
CLAUDE_AI_SESSION_KEYAI 服務的 Session Key依據你的 AI 服務商設定

💡 小提醒：OPENCLAW_HOME_VOLUME 的設定值得留意。如果你沒有設定它，每次容器重建時 /home/node 底下的資料（包括 Agent 記憶和工作檔案）都會消失。建議在正式部署時加上這個設定。

常見問題排解

Q1：docker-setup.sh 執行時出現權限錯誤

這通常是因為目前的使用者不在 docker 群組中。執行以下指令後重新登入：

sudo usermod -aG docker $USER
# 然後登出並重新登入，或執行：
newgrp docker

Q2：建構映像時失敗，顯示 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服務，了解更多

←Back to Blog
OpenClaw Docker 部署：讓 AI 助理 24 小時在線