OpenClaw 是 2026 年最火的开源 AI 执行引擎,凭借其强大的任务自动化能力和灵活的扩展性,吸引了大量开发者和企业用户。通过 Docker 部署 OpenClaw,不仅可以实现完美的环境隔离,还能大幅简化管理和升级流程。
本文将详细介绍如何使用 Docker Compose 在 Linux 服务器上部署 OpenClaw,涵盖配置详解、渠道集成、故障排除等全环节。

一、OpenClaw 简介
OpenClaw(曾用名 Clawdbot、Moltbot)由奥地利开发者、PSPDFKit 创始人 Peter Steinberger 主导开发,于 2026 年 1 月完成品牌定名与全生态统一。截至 2026 年 2 月,其 GitHub 仓库星标数已突破 18.6 万,社区贡献者与插件生态持续高速扩张。
核心特性:
- 🤖 AI 执行引擎:不只是对话,更能执行实际任务
- 🔌 多渠道集成:支持 WhatsApp、Telegram、Discord、微信等
- 🧩 插件生态:丰富的 Memory、Tools、Channels 插件
- 🔒 沙箱隔离:智能体工具执行在独立 Docker 容器中
- 📊 Control UI:可视化 Web 管理界面
二、部署架构
典型的 Docker 部署架构如下:
- openclaw-gateway:OpenClaw 核心服务
- openclaw-cli:命令行管理工具
- 配置目录:~/.openclaw(持久化存储)
- 工作区:~/.openclaw/workspace(智能体工作空间)
三、环境准备
系统要求:
- ✅ Docker Desktop(或 Docker Engine)+ Docker Compose v2
- ✅ 至少 2 GB 内存(镜像构建时 pnpm install 需要)
- ✅ 足够的磁盘空间用于镜像和日志(建议 10GB+)
- ✅ 如果在 VPS/公网主机上运行,需配置防火墙策略
四、快速部署(一键脚本)
OpenClaw 提供了自动化安装脚本,推荐新手使用此方式。
步骤 1:克隆仓库
git clone https://github.com/openclaw/openclaw.git cd openclaw
步骤 2:运行安装脚本
./scripts/docker/setup.sh
安装脚本会自动完成以下操作:
- ✅ 构建或下载 OpenClaw Docker 镜像
- ✅ 运行新手引导(提示输入 API 密钥)
- ✅ 生成 Gateway 令牌并写入 .env 文件
- ✅ 通过 Docker Compose 启动服务

五、访问 Control UI
部署完成后,在浏览器中打开:
http://127.0.0.1:18789/
将安装脚本生成的令牌粘贴到 Settings 中即可登录。令牌默认保存在 .env 文件中。
六、配置消息渠道
使用 CLI 容器添加消息渠道,让 OpenClaw 连接到你的通讯工具:
WhatsApp(二维码登录):
docker compose run --rm openclaw-cli channels login
Telegram:
docker compose run --rm openclaw-cli channels add --channel telegram --token "<bot_token>"
Discord:
docker compose run --rm openclaw-cli channels add --channel discord --token "<bot_token>"
七、常见问题与解决方案
1. 镜像构建期间因 OOM 被终止(退出码 137)
原因:虚拟机内存不足,pnpm install 需要至少 2GB 内存。
解决方案:使用更大规格的 VPS 或增加 Swap 分区。
# 创建 4GB Swap sudo fallocate -l 4G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile
2. Control UI 显示 Unauthorized 或需要配对
解决方案:获取新的 dashboard 链接并重新认证:
docker compose run --rm openclaw-cli dashboard --no-open
总结
通过 Docker 部署 OpenClaw,你可以:
- ✅ 环境隔离:容器化运行,不影响宿主机
- ✅ 快速部署:一键脚本 5 分钟完成
- ✅ 易于管理:Docker Compose 统一管理
- ✅ 安全沙箱:智能体工具执行隔离
- ✅ 多渠道集成:WhatsApp/Telegram/Discord/微信
现在,你的专属”AI 打工人”已经 24 小时在线待命了!🎉