OpenClaw v2026.3.12 离线源码构建与 Docker 部署完整教程

正文

OpenClaw 是一个开源的 AI Agent 平台，支持多模型调用、Skill 插件、Workflow 等功能。对于企业或特殊网络环境，往往需要 离线部署 。本文将详细讲解如何 从源码构建 OpenClaw v2026.3.12，并导出离线镜像，在离线服务器上直接部署和启动 Web UI。

---

一、准备环境

构建前请确保联网机器具备以下环境：

1. Docker ≥ 20

2. Node.js ≥ 22

3. Git

4. 稳定的网络（用于拉取基础镜像和依赖）

验证安装：

docker -v
node -v
git --version

提示：离线服务器只需 Docker 即可，源码和依赖通过镜像导入。

---

二、获取源码

在联网机器上：

# 克隆 OpenClaw 仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 切换到指定版本 v2026.3.12
git checkout v2026.3.12

使用 git tag 可以查看其他历史版本。

---

三、构建 Docker 镜像

在源码目录下执行：

docker build -t openclaw:2026.3.12 .

⚠️ 注意事项：

1. 国内网络可能拉不下 Debian / Node 镜像，可在 Dockerfile 中替换源：

   RUN sed -i 's/deb.debian.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list

2. Windows / WSL 用户如遇构建失败，可先清理 buildx cache：

   docker builder prune -a
   docker system prune -a

构建完成后可检查镜像：

docker images | grep openclaw

---

四、导出离线镜像

将镜像打包成 tar 文件，方便拷贝到离线服务器：

docker save -o openclaw_2026.3.12.tar openclaw:2026.3.12

如果基础镜像（如 node:22-bookworm）也没在离线服务器，需要同样导出：

docker pull node:22-bookworm
docker save -o node_22_bookworm.tar node:22-bookworm

---

五、拷贝镜像到离线服务器

可以使用 U 盘或者局域网传输：

scp openclaw_2026.3.12.tar user@offline-server:/opt/docker_images/
scp node_22_bookworm.tar user@offline-server:/opt/docker_images/

---

六、在离线服务器导入镜像

docker load -i /opt/docker_images/node_22_bookworm.tar
docker load -i /opt/docker_images/openclaw_2026.3.12.tar

验证：

docker images | grep openclaw

应该显示：

openclaw   2026.3.12
node       22-bookworm

---

七、离线启动 OpenClaw 容器

最小运行：

docker run -d \
-p 18789:18789 \
--name openclaw \
openclaw:2026.3.12

访问：

http://离线服务器IP:18789

首次访问会进入 Onboarding 初始化页面，可设置 Web Token、数据目录等。

如果想做数据持久化，可加卷映射：

docker run -d \
-p 18789:18789 \
-v /opt/openclaw_data:/app/data \
--name openclaw \
openclaw:2026.3.12

---

八、可选配置（后续上线可改）

离线部署时，模型 API 不需要立即配置，后续可以通过 .env 文件或 Docker 环境变量修改：

PORT=18789
HOST=0.0.0.0

OPENCLAW_TOKEN=your_token_here
MODEL_PROVIDER=openai
OPENAI_API_KEY=your_api_key
DATA_DIR=/app/data

启动时加载：

docker run -d -p 18789:18789 --env-file .env openclaw:2026.3.12

---

九、总结

通过本教程，你可以实现：

1. 在联网环境下 源码构建 OpenClaw v2026.3.12

2. 导出离线镜像，保证离线服务器部署

3. 离线启动容器，并快速访问 Web UI

4. 后续可灵活配置模型、Skill 插件、数据持久化

✅ 企业部署最佳实践：离线打包 + 镜像导入，无需依赖公网。

---

💡 小技巧

• 离线服务器只需 Docker 即可，基础镜像和 OpenClaw 镜像全部通过 tar 导入

• 国内服务器建议提前替换 Debian 源，加快构建

• UI 可先跑起来，模型配置可以后续调整