本文記錄了從源碼到 Docker 容器化部署 OpenClaw 的完整流程，包括編譯打包、遷移到其他機(jī)器以及訪問配置。

1. 克隆源碼

首先，從官方倉庫克隆 OpenClaw 源碼：

git clone https://github.com/openclaw/openclaw.gitcd openclaw

2. 編譯與打包（執(zhí)行 docker-setup.sh 腳本）

在源碼目錄下，執(zhí)行 docker-setup.sh 腳本完成編譯和打包：

./docker-setup.sh

執(zhí)行后會完成以下操作：

• 安裝依賴（npm / pnpm）
• 將 TypeScript 源碼編譯為 JavaScript，并生成 dist/ 目錄
• 構(gòu)建 Docker 鏡像，包含已經(jīng)編譯好的 OpenClaw

可以通過以下命令檢查是否成功：

docker images | grep openclaw

或者在容器內(nèi)運(yùn)行：

docker run --rm openclaw:local node dist/index.js --version

如果輸出版本號，即表示編譯完成。

3. 啟動 Docker 容器

使用 docker-compose 啟動 OpenClaw 網(wǎng)關(guān)和 CLI：

docker-compose up -d

啟動后，網(wǎng)關(guān)默認(rèn)監(jiān)聽 18789 端口。

4. 配置 Token 并訪問 Control UI

1. 進(jìn)入容器生成 Dashboard Token：
2. docker-compose exec openclaw-cli openclaw dashboard --no-open

輸出類似：

Dashboard URL: http://127.0.0.1:18789/#token=<your-token>

拷貝 URL 到瀏覽器，使用 Token 登錄 Control UI。

若需要多設(shè)備訪問，可在 openclaw.json 中配置：

"gateway": { "controlUi": { "allowInsecureAuth": true }}

注意：此方式僅限使用 Token 登錄，且存在安全風(fēng)險，請僅在可信網(wǎng)絡(luò)中使用。

5. 遷移到其他機(jī)器

遷移時，除了 Docker 鏡像，還需要遷移 配置和環(huán)境文件：

保存 Docker 鏡像：

docker save openclaw:local -o openclaw.tar

在目標(biāo)機(jī)器加載鏡像：

docker load -i openclaw.tar

遷移配置文件和環(huán)境變量：

在目標(biāo)機(jī)器啟動容器：

cd /home/user/openclawdocker-compose up -d

這樣可以保證原有的 Token、Workspace 和插件配置完整遷移。

6. 注意事項(xiàng)

1. HTTPS / 設(shè)備身份
   • 默認(rèn) Control UI 需要 設(shè)備身份，否則瀏覽器會報錯 control ui requires device identity。
   • 在公網(wǎng)訪問或多設(shè)備訪問時，推薦使用 HTTPS（可用自簽名證書或 Tailscale Serve）保護(hù) Token。
   • 若必須使用 HTTP，可在 openclaw.json 中添加： "gateway": {
     "controlUi": {
     "allowInsecureAuth": true
     }
     } 僅支持 Token 登錄，安全性降低。
2. 跨域訪問
   • 默認(rèn) Control UI 允許 http://localhost 或 127.0.0.1。
   • 若從其他主機(jī)訪問，確保 gateway.controlUi.allowedOrigins 包含你的瀏覽器訪問地址。例如： "gateway": {
     "controlUi": {
     "allowedOrigins": ["http://172.244.44.35:18789"\]
     }
     }
3. 設(shè)備授權(quán)
   • 當(dāng)多臺設(shè)備訪問時，可能需要 配對批準(zhǔn)： openclaw devices list
     openclaw devices approve
   • 配對失敗或 Token 登錄過多次失敗，會出現(xiàn) unauthorized: too many failed authentication attempts，需等待或重新生成 Token。
4. Token 多設(shè)備使用
   • 默認(rèn)同一個 Token 僅允許單設(shè)備登錄。
   • 若需要多人訪問，可考慮為每個用戶生成獨(dú)立 Token 或配置 allowInsecureAuth（存在安全風(fēng)險）。

以上就是使用Docker部署OpenClaw的完整流程的詳細(xì)內(nèi)容，更多關(guān)于Docker部署OpenClaw的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論