使用 Docker 部署 OpenClaw:编译、迁移与 Token 配置

本文记录了从源码到 Docker 容器化部署 OpenClaw 的完整流程,包括编译打包、迁移到其他机器以及访问配置。

1. 克隆源码

首先,从官方仓库克隆 OpenClaw 源码:

bash 复制代码
git clone https://github.com/openclaw/openclaw.gitcd openclaw

2. 编译与打包(执行 docker-setup.sh 脚本)

在源码目录下,执行 docker-setup.sh 脚本完成编译和打包:

arduino 复制代码
./docker-setup.sh

执行后会完成以下操作:

  • 安装依赖(npm / pnpm)
  • 将 TypeScript 源码编译为 JavaScript,并生成 dist/ 目录
  • 构建 Docker 镜像,包含已经编译好的 OpenClaw

可以通过以下命令检查是否成功:

perl 复制代码
docker images | grep openclaw

或者在容器内运行:

bash 复制代码
docker run --rm openclaw:local node dist/index.js --version

如果输出版本号,即表示编译完成。

3. 启动 Docker 容器

使用 docker-compose 启动 OpenClaw 网关和 CLI:

复制代码
docker-compose up -d

启动后,网关默认监听 18789 端口。

4. 配置 Token 并访问 Control UI

  1. 进入容器生成 Dashboard Token:

    docker-compose exec openclaw-cli openclaw dashboard --no-open

输出类似:

perl 复制代码
Dashboard URL: http://127.0.0.1:18789/#token=<your-token>
  1. 拷贝 URL 到浏览器,使用 Token 登录 Control UI。

  2. 若需要多设备访问,可在 openclaw.json 中配置:

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

注意:此方式仅限使用 Token 登录,且存在安全风险,请仅在可信网络中使用。

5. 迁移到其他机器

迁移时,除了 Docker 镜像,还需要迁移 配置和环境文件:

  1. 保存 Docker 镜像:

    docker save openclaw:local -o openclaw.tar

  2. 在目标机器加载镜像:

    docker load -i openclaw.tar

  3. 迁移配置文件和环境变量:

    拷贝 docker-compose.yml 和 .env 文件scp docker-compose.yml .env user@target:/home/user/openclaw/# 拷贝 OpenClaw 配置目录scp -r /root/.openclaw user@target:/root/

  4. 在目标机器启动容器:

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

这样可以保证原有的 Token、Workspace 和插件配置完整迁移。

6. 注意事项

  1. HTTPS / 设备身份
    • 默认 Control UI 需要 设备身份 ,否则浏览器会报错 control ui requires device identity。
    • 在公网访问或多设备访问时,推荐使用 HTTPS(可用自签名证书或 Tailscale Serve)保护 Token。
    • 若必须使用 HTTP,可在 openclaw.json 中添加: "gateway": {
      "controlUi": {
      "allowInsecureAuth": true
      }
      } 仅支持 Token 登录,安全性降低。
  2. 跨域访问
    • 默认 Control UI 允许 http://localhost 或 127.0.0.1。
    • 若从其他主机访问,确保 gateway.controlUi.allowedOrigins 包含你的浏览器访问地址。例如: "gateway": {
      "controlUi": {
      "allowedOrigins": "[http://172.244.44.35:18789"\\](https://link.juejin.cn?target=http%3A%2F%2F172.244.44.35%3A18789%2522%255C "http://172.244.44.35:18789%22%5C")
      }
      }
  3. 设备授权
    • 当多台设备访问时,可能需要 配对批准 : openclaw devices list
      openclaw devices approve
    • 配对失败或 Token 登录过多次失败,会出现 unauthorized: too many failed authentication attempts,需等待或重新生成 Token。
  4. Token 多设备使用
    • 默认同一个 Token 仅允许单设备登录。
    • 若需要多人访问,可考虑为每个用户生成独立 Token 或配置 allowInsecureAuth(存在安全风险)。
相关推荐
郑世录10 小时前
codex 接本地模型,单次输出卡在 3208 token:一份照着做就能改的完整教程
ai编程
JavaGuide11 小时前
Gemini 真的变强了,写代码做视频的能力接近 Claude Opus5.5 了!
前端·ai编程
qinglongcn12 小时前
四面统一:记忆/Session/观测/Cron
agent·ai编程
qinglongcn12 小时前
从 metadata 键到独立列
agent·ai编程
YanisJiang12 小时前
别只把 AI 聊天当成「又一个网页」:把状态驱动的陪伴内核接到你自己的项目里
ai编程
AI入职记14 小时前
RAG 一个请求吃掉 8 个核,chat 只要 0.16 个
后端·ai编程
K715 小时前
别再搜「LangChain 教程」了——你学的 Chain 已经被判了死刑
langchain·ai编程
永不退场的闯关族15 小时前
把 AI 阅读工具做成 local-first:页边 ThinRead 的架构、取舍与踩坑
ai编程
双鱼大猫16 小时前
opencode 吃掉 100G 空间:Agent 会话数据要分级清理
人工智能·agent·ai编程
ZzT17 小时前
约 90% 代码由 Claude 写和审,Claude Code 团队如何做验证
ai编程·claude