OpenClaw（昵称“龙虾 bot”）作为开源智能体框架，凭借灵活的扩展能力与多端适配性，成为个人与团队搭建专属AI助手的热门选择。而Docker的容器化特性，能完美解决OpenClaw部署中的环境冲突、配置残留等痛点，实现“一键部署、跨平台兼容”。2026年，结合阿里云云端部署与本地多系统部署方案，搭配阿里云千问或免费大模型API，可快速搭建稳定、高效的AI助手系统。
本文基于最新技术实践，详细拆解Docker部署OpenClaw的核心流程，补充2026年阿里云及本地MacOS/Linux/Windows11部署步骤，详解阿里云千问与免费大模型API配置方法，深度解决网络连通、配置残留、权限配对等常见问题，所有代码命令可直接复制执行，助力用户零踩坑完成部署。目前阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。
一、Docker部署核心优势与前置准备
（一）Docker部署核心优势
相比传统部署方式，Docker部署OpenClaw具备三大核心优势：
- 环境隔离：容器化运行避免与本地系统依赖冲突，适配多系统统一部署流程；
- 快速迁移：容器镜像可在阿里云、本地电脑等多环境快速复制，部署一致性高；
- 一键清理：无需手动删除配置文件与依赖，通过Docker命令即可彻底清除残留；
- 官方推荐：OpenClaw官方提供预构建镜像，跳过本地编译，部署效率提升50%。
（二）前置准备
1. 基础工具安装
- Docker Desktop：核心部署工具，支持MacOS、Windows11，下载地址：https://www.docker.com/products/docker-desktop/；
- Git：用于拉取官方仓库，全平台安装命令：
# Windows11（PowerShell管理员模式） choco install git # MacOS（brew安装） brew install git # Linux（Ubuntu 22.04） sudo apt update && sudo apt install -y git - 验证工具：
docker --version（输出≥24.0.0）、git --version（输出≥2.40.0）。
2. 必备凭证获取
部署前需提前获取两大核心凭证，避免流程中断：
- 大模型API Key：访问登录阿里云百炼大模型服务平台，选择阿里云千问（推荐）或免费大模型（如智谱GLM-4.7、DeepSeek），具体获取步骤见第三部分；
- Telegram Bot Token（可选，用于多端交互）：
- 打开Telegram App，搜索@BotFather；
- 发送
/newbot，按提示设置机器人名称（如MyOpenClawBot）与用户名（必须以_bot结尾）； - 接收BotFather返回的Token（格式类似
123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11），复制保存。
3. 网络准备
- 国内用户建议配置网络加速，确保Docker镜像拉取与大模型API调用顺畅；
- Telegram API需特殊网络配置，可通过修改
/etc/hosts锁定IP（解决DNS污染问题）：# MacOS/Linux执行（管理员权限） sudo echo "149.154.167.220 api.telegram.org" >> /etc/hosts # Windows11执行（管理员PowerShell） Add-Content -Path "C:\Windows\System32\drivers\etc\hosts" -Value "149.154.167.220 api.telegram.org"
二、Docker部署OpenClaw核心流程（全平台通用）
Docker部署流程全平台统一，核心分为“环境清理→凭证准备→镜像部署→初始化配置”四步，预计20-40分钟完成。
（一）第一步：彻底清理环境残留（关键步骤）
旧配置与残留容器是导致部署失败的主要原因，需优先执行清理命令：
# 停止所有OpenClaw相关容器
docker stop $(docker ps -q --filter "name=openclaw") 2>/dev/null || true
# 强制删除所有OpenClaw容器
docker rm -f $(docker ps -a -q --filter "name=openclaw") 2>/dev/null || true
# 删除所有OpenClaw相关镜像（含旧版与社区版）
docker rmi $(docker images -q --filter "reference=*openclaw*") 2>/dev/null || true
docker rmi $(docker images -q --filter "reference=ghcr.io/openclaw*") 2>/dev/null || true
# 删除OpenClaw相关Docker卷
docker volume rm $(docker volume ls -q | grep -E 'openclaw|claw') 2>/dev/null || true
# 删除本地配置目录（核心残留文件）
rm -rf ~/.openclaw ~/openclaw 2>/dev/null || true
# Docker系统大扫除（仅清理无用资源，安全无风险）
docker system prune -f --volumes
- 验证清理结果：执行
docker ps -a确认无OpenClaw容器，ls ~/.openclaw提示“无此文件或目录”； - 重启Docker Desktop：确保清理生效（MacOS/Windows11需手动重启，Linux执行
sudo systemctl restart docker）。
（二）第二步：拉取官方仓库与镜像
# 克隆OpenClaw官方仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 配置使用官方预构建镜像（跳过本地编译，最快部署路径）
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
# 解决MacOS Git RPC错误（强制使用HTTP/1.1）
git config --global http.version HTTP/1.1
（三）第三步：一键启动部署脚本
执行官方部署脚本，自动完成镜像拉取、配置向导与容器启动：
# 运行Docker部署脚本（交互式向导）
./docker-setup.sh
脚本执行后，按以下提示完成交互式配置（关键步骤，切勿默认回车）：
- 选择LLM提供商：
- 若使用阿里云千问，选择“Bailian/阿里云千问”；
- 若使用智谱GLM-4.7，选择“Zhipu/Z.AI/Generic”；
- 若使用免费大模型，选择“Generic/Custom”。
- 输入API Key：粘贴提前获取的大模型API Key（如阿里云千问API-Key、智谱GLM-4.7 Key）；
- 指定模型名称：
- 阿里云千问：输入
bailian/qwen3-mini（或qwen3-max）； - 智谱GLM-4.7：输入
zai/glm-4.7； - DeepSeek：输入
deepseek/deepseek-chat。
- 阿里云千问：输入
- 选择消息渠道（可选）：
- 需使用Telegram交互，选择“Telegram (Bot API)”，粘贴Telegram Bot Token；
- 仅本地使用，选择“Web Dashboard”即可。
- 其他配置：默认开启Sandbox模式（安全优先），其余选项直接回车确认。
（四）第四步：启动容器与验证部署
# 重启容器确保配置生效
docker compose down
docker compose up -d
# 查看启动日志（重点检查Telegram连接与模型配置）
docker compose logs -f openclaw-gateway | grep -E 'telegram|model|success'
- 成功标志：日志无“Network request failed”错误，显示“Model configured successfully”“Telegram bot started”；
- 访问Web控制台：浏览器输入
http://127.0.0.1:18789，使用脚本输出的Gateway Token登录，确认控制台正常加载。
（五）第五步：Telegram配对授权（可选）
若配置了Telegram渠道，需完成配对授权才能正常交互：
- 打开Telegram，向创建的Bot发送
/start； - Bot回复“access not configured”+配对码（如
8WLFKW8Z）+用户ID； - 在终端执行授权命令（替换
<配对码>与<用户ID>）：# 进入容器执行授权 docker exec -it openclaw-gateway sh # 批准用户配对 openclaw pairing approve --code <配对码> --user-id <用户ID> # 退出容器 exit - 验证配对：向Telegram Bot发送“你是谁？”，Bot返回人设介绍即配对成功。
三、2026年扩展部署：阿里云+本地多系统方案
除Docker部署外，可根据使用场景选择阿里云云端部署（长期稳定运行）或本地原生部署（数据隐私优先），以下为详细步骤。
（一）阿里云部署流程（适合团队共享）
1. 服务器实例创建：
- 登录阿里云控制台，访问阿里云轻量应用服务器控制台，选择“应用镜像”→“Ubuntu 22.04 LTS”；
- 实例规格选择2核4GB内存、40GB ESSD存储，地域优先选择中国香港（免备案）或华东1（杭州）；
- 设置登录密码，完成订单支付，等待实例状态变为“运行中”。
阿里云用户零基础部署 OpenClaw 喂饭级步骤流程
第一步：点击打开访问阿里云OpenClaw一键部署专题页面。
第二步：打开选购阿里云轻量应用服务器，配置参考如下：
- 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
- 实例：内存必须2GiB及以上。
- 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
- 时长：根据自己的需求及预算选择。
第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。
前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
- 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
- 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
- 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
- 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。
阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：
创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！
- 购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
- 回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
- 在服务器概览页面单击应用详情页签，进入服务器详情页面。
- 端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
- 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
- 获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。
2. 环境配置与部署：
# 通过SSH登录服务器
ssh root@服务器公网IP
# 安装Docker与Git
sudo apt update && sudo apt install -y docker.io git
sudo systemctl start docker && sudo systemctl enable docker
sudo usermod -aG docker $USER && newgrp docker
# 后续步骤参考Docker部署流程（从“克隆仓库”开始）
git clone https://github.com/openclaw/openclaw.git
cd openclaw
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./docker-setup.sh
3. 访问配置：在阿里云安全组开放18789端口，通过http://服务器公网IP:18789访问控制台。
（二）本地MacOS原生部署（非Docker）
# 安装核心依赖
brew install node@22 git docker
brew link --overwrite node@22
# 全局安装OpenClaw
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
# 初始化配置
openclaw onboard
# 按向导配置大模型API与消息渠道
（三）本地Linux原生部署（非Docker）
# 安装依赖
sudo apt update && sudo apt install -y nodejs git
npm install -g openclaw
# 初始化配置
openclaw init --sandbox enable
openclaw gateway start
（四）本地Windows11原生部署（非Docker）
# 管理员模式PowerShell执行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw onboard
openclaw gateway start
四、大模型API配置：阿里云千问与免费方案实操
大模型是OpenClaw的“大脑”，2026年推荐优先选择阿里云千问（稳定性强），基础需求可使用免费大模型API，以下为详细配置步骤。
（一）阿里云千问大模型API配置（首选方案）
- API-Key获取：
- 访问登录阿里云百炼大模型服务平台，完成实名认证；
- 进入“密钥管理”页面，点击“创建API-Key”，生成并复制
API-Key与AccessKey Secret。
- Docker部署配置：
- 在部署脚本的“LLM提供商”步骤选择“Bailian/阿里云千问”；
- 粘贴
API-Key与AccessKey Secret，模型名称输入bailian/qwen3-mini（轻量版）或bailian/qwen3-max（增强版）。
- 命令行手动配置（已部署后修改）：
# 进入容器 docker exec -it openclaw-gateway sh # 配置阿里云千问API openclaw configure --provider bailian # 按提示输入API-Key与AccessKey Secret # 重启服务 openclaw gateway restart # 测试连接 openclaw model test
（二）免费大模型Coding Plan API配置（零成本替代）
以智谱GLM-4.7与DeepSeek为例，配置免费API：
- 智谱GLM-4.7 API配置：
- 访问智谱AI开放平台（
https://open.bigmodel.cn/），注册登录后进入“API Keys”创建Key； - Docker部署时选择“Zhipu/Z.AI/Generic”，粘贴API Key，模型名称输入
zai/glm-4.7。
- 访问智谱AI开放平台（
- DeepSeek API配置：
- 访问DeepSeek开放平台（
https://platform.deepseek.com/），生成免费API Key； - Docker部署时选择“Generic/Custom”，API地址输入
https://api.deepseek.com/v1，粘贴API Key，模型名称输入deepseek/deepseek-chat。
- 访问DeepSeek开放平台（
五、核心配置优化：注入“灵魂”与安全加固
（一）编辑人设与记忆文件（注入灵魂）
通过修改USER.md与MEMORY.md，让OpenClaw更贴合个人需求：
# 进入容器的配置目录
docker exec -it openclaw-gateway sh
cd ~/.openclaw/workspace
# 编辑USER.md（告诉AI你的背景与偏好）
nano USER.md
粘贴以下模板并修改：
# USER.md - 个人信息配置
## 基础背景
- 姓名：XXX
- 职业：开发者/运营/学生
- 常用工具：VS Code、WPS、Telegram
- 工作风格：简洁高效，注重实操性
## 需求偏好
- 回答格式：优先使用Markdown，代码片段需带注释
- 专业方向：聚焦Python开发/内容创作/数据分析
- 禁忌：避免冗长理论，直接给出可执行步骤
编辑MEMORY.md（长期记忆存储）：
nano MEMORY.md
添加常用信息（如团队规范、项目背景），AI会长期记忆并应用。
（二）安全加固配置
- 绑定网关至公网可访问地址：
修改# 编辑配置文件 docker exec -it openclaw-gateway sh nano ~/.openclaw/openclaw.jsongateway配置：{ "gateway": { "host": "0.0.0.0", "port": 18789, "auth": { "enabled": true, "token": "你的Gateway Token" } } } - 仅批准信任用户配对：
# 查看待配对请求 openclaw pairing list # 仅批准指定用户 openclaw pairing approve --code <配对码> --user-id <信任用户ID> # 拒绝其他请求 openclaw pairing reject --all
六、全场景常见问题解答
（一）部署相关问题
问题：执行
./docker-setup.sh提示“权限不足”
解决办法：添加执行权限：chmod +x docker-setup.sh，重新执行。问题：Docker拉取镜像提示“超时”
解决办法：① 配置Docker镜像加速（阿里云容器镜像服务→镜像加速器）；② 切换网络或使用手机热点；③ 手动拉取镜像：docker pull ghcr.io/openclaw/openclaw:latest。问题：启动后Web控制台无法访问（127.0.0.1:18789无响应）
解决办法：① 检查容器是否运行：docker ps | grep openclaw-gateway；② 查看日志定位错误：docker compose logs openclaw-gateway；③ 确认端口未被占用：MacOS/Linux执行lsof -i :18789，Windows执行netstat -ano | findstr :18789，结束占用进程后重启容器。
（二）网络与配对问题
问题：Telegram Bot提示“Network request failed”
解决办法：① 检查/etc/hosts是否添加Telegram API IP；② 确认网络可访问Telegram；③ 重启容器：docker compose restart openclaw-gateway。问题：Telegram发送
/start无回复
解决办法：① 检查Bot Token是否正确，重新创建Token并重新配置；② 查看日志：docker compose logs -f openclaw-gateway | grep telegram，定位错误；③ 确保容器网络正常：docker exec -it openclaw-gateway ping api.telegram.org。问题：配对后仍提示“access not configured”
解决办法：① 确认配对码与用户ID输入正确；② 重新执行授权命令：openclaw pairing approve --code <配对码> --user-id <用户ID>；③ 重启Gateway服务：docker exec -it openclaw-gateway openclaw gateway restart。
（三）大模型相关问题
问题：模型测试提示“API调用失败”
解决办法：① 检查API Key是否过期，重新生成并配置；② 验证网络可访问模型API地址（如阿里云千问：curl https://dashscope.aliyuncs.com/api/v1）；③ 确认模型名称正确（如bailian/qwen3-mini而非qwen3-mini）。问题：免费模型提示“额度不足”
解决办法：① 查看模型额度：登录对应平台控制台查询；② 切换至其他免费模型（如从GLM-4.7切换至DeepSeek）；③ 减少单次请求的上下文长度，降低Token消耗。
（四）配置残留问题
- 问题：重新部署后仍加载旧配置
解决办法：执行“环境清理”步骤后，手动删除容器镜像缓存：docker builder prune -a，再重新部署。
七、总结
2026年，Docker部署OpenClaw已成为最便捷、稳定的选择，通过容器化隔离解决环境冲突，官方预构建镜像跳过编译步骤，配合阿里云千问或免费大模型API，可快速搭建专属AI助手。本文提供的全流程方案，覆盖Docker核心部署、阿里云与本地多系统扩展、大模型配置、人设注入等关键环节，所有代码命令可直接复制执行，小白也能零踩坑完成部署。
使用过程中，建议优先通过Docker部署快速验证功能，再根据需求选择阿里云云端长期运行或本地原生部署保障数据隐私；通过编辑USER.md与MEMORY.md注入“灵魂”，让AI更懂你；同时做好安全加固，仅批准信任用户配对，避免未授权访问。
随着OpenClaw生态的持续完善，Docker部署流程将更加简化，大模型适配也将更广泛。现在就动手部署，体验容器化AI助手带来的高效与便捷吧！
