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

1. 克隆源碼

首先，從官方倉(cāng)庫(kù)克隆 OpenClaw 源碼：

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

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

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

./docker-setup.sh

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

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

可以通過(guò)以下命令檢查是否成功：

docker images | grep openclaw

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

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

如果輸出版本號(hào)，即表示編譯完成。

3. 啟動(dòng) Docker 容器

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

docker-compose up -d

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

4. 配置 Token 并訪問(wèn) 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è)備訪問(wèn)，可在 openclaw.json 中配置：

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

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

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

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

保存 Docker 鏡像：

docker save openclaw:local -o openclaw.tar

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

docker load -i openclaw.tar

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

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

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

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

6. 注意事項(xiàng)

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

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

最新評(píng)論