最近群里好几个朋友都在问我同一个问题OpenClaw 到底怎么落地跑起来说实话第一次搞这个项目的时候我也被它的部署方式折腾了一会文档写得不算差但总有些细节要自己试错。后来我在阿里云的一台 2核4G 的 ECS 上把流程顺了一遍发现真正常用的路径可以压缩成两条命令一条准备环境一条拉起容器整个过程基本能做到“一键秒级部署”。今天就把这套方案完整写出来包括我踩过的坑、调过的参数以及排查问题的思路希望对正在折腾 OpenClaw 的朋友有点帮助。OpenClaw 是一个开源的个人 AI 助手框架核心思路是把大模型能力接到日常工具链里聊天工具、日程、笔记、邮件、语音通话之类的应用都能通过它串起来。你可以理解成给大模型装了一双手和一套通讯录让它不只会聊天还能替你执行任务。这个项目最适合三类人一是想自建 AI 助手的开发者二是对数据隐私有要求、不愿把对话全交给云端产品的用户三是对自动化和 Agent 工作流感兴趣的研究者。配合阿里云 ECS主要是稳定性好、带宽可控、安全组规则灵活而且国内访问速度有保障部署完成后不管接钉钉、飞书还是微信公众号延迟都比较低。下面我会从项目思路、选型考量、完整实操、常见问题排查到扩展玩法一条条讲清楚尽量做到你照着敲就能跑通。1. 项目整体拆解OpenClaw 部署的本质是什么1.1 OpenClaw 到底是什么解决什么问题OpenClaw 本质上是把大模型 API、消息通道、任务执行器三者粘合在一起的运行时。它对外提供统一的接口对内连接各种服务你可以用对话的方式让它查天气、管理待办、整理文档甚至触发定时任务。项目名字里的 Claw 可以理解成“爪子”意思是让 AI 能真正抓到外部工具而不是只在对话框里打转。部署 OpenClaw 要做的核心事情其实就三件有一个能长期运行的环境云服务器。把这个服务跑起来并且配置好大模型的 API 接入。把消息渠道对接进去比如钉钉、飞书、Telegram、微信公众号等。从架构看OpenClaw 本身就提供了容器化方案官方推荐的部署方式就是 Docker。所以我们真正要解决的只是“怎么在阿里云上把 Docker 环境准备到顺手的状态”和“怎么把容器参数一次配对”。1.2 为什么选择阿里云而不是本地机器很多朋友问我能不能用自己电脑跑当然可以但有几个现实问题家里宽带没有公网 IP 或者 IP 经常变聊天工具回调地址不稳定电脑休眠了服务就断了电费和维护成本算下来并不比云服务器便宜。阿里云 ECS 的优势在于公网 IP 固定、安全组可控、带宽可按需调整而且新用户通常有免费试用额度测试阶段基本不花钱。我选择阿里云还有一个原因是它的容器镜像加速服务。国内直连 Docker Hub 拉镜像经常慢到怀疑人生阿里云容器镜像服务提供的个人版加速器可以明显改善这个问题这和后续部署体验直接相关。1.3 “两步部署”的核心思路所谓两步其实是把常用的初始化动作固化成一个命令再把启动动作固化成一个命令。第一步是准备运行环境包括安装 Docker、配置镜像加速、创建数据目录第二步是拉取 OpenClaw 镜像并启动容器同时完成端口映射和持久化目录挂载。这样做的好处是显而易见的不管你是新买的服务器还是以前用过的服务器只要执行这两步环境就一致了。不需要记一堆零散的安装步骤也不容易出现“漏了一步导致服务起不来”的情况。2. 部署前准备ECS 选型、系统镜像和安全组2.1 ECS 实例怎么选才不浪费钱OpenClaw 本身对资源要求不算高真正的资源消耗大头在你后面接入的大模型推理而那个一般通过 API 调用完成不占用本地资源。所以我给你的建议是使用场景推荐规格说明轻量测试/尝鲜2核2G跑单容器够用但并发高时会明显卡顿日常稳定运行2核4G我的推荐配置多接几个渠道也稳同时跑多个 Agent/任务4核8G适合重度使用者例如同时接多个对话渠道磁盘建议选 40G 起步因为 Docker 镜像、日志、附件缓存都会慢慢占空间。带宽方面如果只是普通聊天文本交互5M 峰值足够如果要传图片、语音建议按量计费或者选更高带宽这个看实际需求。2.2 操作系统选择与安全组设置系统镜像我推荐 Ubuntu 22.04 LTS 或 Debian 12原因是 Docker 官方对这两个系统的支持最好命令示例也最常见。CentOS 不是不行但 Stream 版本的配置路径有些差异新手容易踩坑。安全组是大家最容易忽略的环节。阿里云的安全组规则默认只开放少数端口而 OpenClaw 的 Web 服务要对外提供服务就必须在安全组里放行对应端口。我习惯的规则是22 端口只允许自己的 IP 访问避免 SSH 被暴力破解。8080 端口OpenClaw 主服务按需开放如果只是内部调试可先不开放。80/443 端口如果后面要挂域名和 HTTPS 证书这两个必须开放。注意安全组的放行是双向的但阿里云控制台一般只需要配置“入方向”规则即可出方向默认全放行这点不必额外处理。2.3 服务器基础环境检查在跑部署脚本之前先确认几件事登录服务器之后执行uname -a看内核版本确认是 64 位系统执行df -h看磁盘剩余空间free -h看内存。如果磁盘剩余不到 10G建议先清理。这一步看起来很基础但确实有人拿到全新服务器就直接跑脚本结果因为系统镜像没初始化完导致 Docker 装到一半报错。别急这几分钟把基础检查做了能省后面很多事。3. 实操全过程两条命令完成 OpenClaw 部署3.1 第一步一条脚本搞定 Docker 环境我不建议你手动一步步apt install docker.io再配置加速器因为不同系统版本的命令有差异写成一个脚本统一执行才不会出错。以下是我在 Ubuntu 22.04 上验证过的部署脚本你可以直接复制保存为init_env.sh#!/bin/bash # OpenClaw 部署环境初始化脚本 # 适用于 Ubuntu 22.04 / Debian 12 set -e echo 更新系统包索引... apt-get update echo 安装 Docker 依赖... apt-get install -y \ ca-certificates \ curl \ gnupg \ lsb-release echo 添加 Docker 官方 GPG 密钥... install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc chmod ar /etc/apt/keyrings/docker.asc echo 添加 Docker 软件源... echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release echo $VERSION_CODENAME) stable | \ tee /etc/apt/sources.list.d/docker.list /dev/null apt-get update echo 安装 Docker 引擎... apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin echo 配置阿里云镜像加速器... mkdir -p /etc/docker cat /etc/docker/daemon.json EOF { registry-mirrors: [https://你的加速器地址.mirror.aliyuncs.com] } EOF echo 重启 Docker 并设置开机自启... systemctl restart docker systemctl enable docker echo 初始化完成Docker 版本 docker --version脚本里镜像加速器地址需要你到阿里云控制台搜“容器镜像服务”打开个人版找到“镜像加速器”里面会给你一个专属的 HTTPS 地址。这个地址是免费的绑定你的阿里云账号用起来也很稳定。执行方式很简单chmod x init_env.sh ./init_env.sh脚本跑完docker --version能正常输出就说明环境没问题了。3.2 第二步启动 OpenClaw 容器环境准备好之后OpenClaw 的启动就一句话docker run -d \ --name openclaw \ --restart unless-stopped \ -p 8080:8080 \ -v /opt/openclaw:/app/data \ -e CLAW_ENVproduction \ ghcr.io/openclaw/openclaw:latest我来逐项解释一下这些参数为什么这么写-d后台运行不占据当前终端。--name openclaw给容器固定一个名字后续查看日志和重启都方便。--restart unless-stoppedDocker 守护进程启动时自动拉起容器除非你手动 stop 它。服务器重启之后服务能自动恢复这对没有运维经验的人太重要了。-p 8080:8080把容器的 8080 端口映射到宿主机的 8080 端口。OpenClaw 默认监听 8080理论上也可以改成别的但我建议别改减少不必要的干扰。-v /opt/openclaw:/app/data把配置和数据文件持久化到宿主机。这一步一定不能省否则容器更新或重装之后所有配置、会话数据全没了。-e CLAW_ENVproduction指定生产环境模式会关闭一些调试输出减少日志噪音。ghcr.io/openclaw/openclaw:latest官方镜像地址latest 标签跟随最新稳定版。运行成功后会输出一串容器 ID这时候执行docker logs -f openclaw可以看到启动日志看到Server started或类似字样就说明服务已经起来了。用浏览器访问http://你的服务器IP:8080如果安全组放行了端口应该能看到管理界面或者健康检查页面。3.3 配置大模型 API以 DeepSeek 和 DashScope 为例OpenClaw 本身不带大模型它相当于一个调度层需要你提供大模型的 API 才能对话。目前主流的接入方式有两种一种是直接配 OpenAI 兼容接口另一种是配各家云厂商的专用 SDK。阿里云百炼DashScope的接口我实测过和 OpenAI 格式高度兼容所以配置起来非常直接。以阿里云百炼为例你需要在后台创建 API Key然后在 OpenClaw 的配置文件里填写模型名称和 Base URL。模型名称可以用qwen-plus或qwen-max这类通义千问系列Base URL 填 DashScope 提供的兼容地址。如果你用的是 DeepSeek就填 DeepSeek 官方 API 的 Base URL模型填deepseek-chat。配置完成之后一定要在后台的测试面板发一条消息验证。很多人会在这里卡住问题往往是 API Key 填错、Base URL 末尾多了一个斜杠、或者模型名不在你的账号权限范围内。最简单的排查方式是先用curl直接调 API 接口确认返回正常再来看 OpenClaw 的配置。3.4 挂域名和全站 HTTPS如果你的 OpenClaw 要长期使用我强烈建议配域名加 HTTPS。原因很直接很多聊天平台的回调地址要求必须是 HTTPS而裸 IP 加端口的方式在微信、飞书这类平台上根本过不了审核。我的做法是用 Nginx 做反向代理把 80 端口的请求转发到 8080。先安装 Nginxapt-get install -y nginx然后在/etc/nginx/sites-available/openclaw.conf里写转发配置server { listen 80; server_name your-domain.com; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }启用配置并重载 Nginxln -s /etc/nginx/sites-available/openclaw.conf /etc/nginx/sites-enabled/ nginx -t systemctl reload nginxHTTPS 证书我推荐直接用阿里云免费的 SSL 证书在云盾控制台申请验证域名后下载 Nginx 格式的证书文件然后填到 Nginx 配置里。免费证书一般一年有效期到期后重新申请即可具体路径在控制台里都很清晰这里不再展开。4. 常见问题与排查技巧实录4.1 Docker 拉取镜像慢或直接超时这是国内服务器最常见的问题。镜像加速器已经配置了但还是拉不动怎么办先检查 daemon.json 是否生效docker info | grep -A 5 Registry Mirrors如果显示你的加速器地址说明配置没问题。如果没显示那就重启一下 Docker 再试。还有种情况是加速器地址填错了注意阿里云的加速器地址每人是不同的不能直接抄网上别人的。另外latest标签的镜像体积通常比较大第一次拉取慢是正常的耐心等一等不要轻易 CtrlC。实在拉不动的极端情况下可以尝试先拉一个较小的基础镜像测试网络连通性docker pull hello-world如果这个都拉不动那就不是 OpenClaw 的问题而是 Docker 网络本身有问题建议检查服务器 DNS 配置或重启 Docker 服务。4.2 容器启动失败端口占用和内存不足有一种情况是启动瞬间报错port is already allocated说明 8080 端口被占了。执行ss -tlnp | grep 8080看看是谁占用的如果你以前部署过其他服务很可能是端口冲突。解决方式是停掉旧服务或者把 OpenClaw 映射到其他端口比如-p 9090:8080。还有一种情况是明明内存够但容器起来之后又马上退出。这时候别瞎猜直接看日志docker logs --tail 200 openclaw日志里一般会写明原因最常见的是配置文件里的某个路径写错了或者是启动时连不上你配置的 API 服务。OpenClaw 不像很多 Web 应用那样能容忍配置错误它启动阶段会做连接检查连不上就直接退出。4.3 对话时大模型接口返回报错这个问题大多出现在用户接入了自己的 API 之后。常见报错有三种报错信息可能原因解决方案401 UnauthorizedAPI Key 错误或没有对应模型权限重新检查 Key确认模型名是否在白名单内404 Not FoundBase URL 填错接口路径不对对照官方文档确认 Base URL 是否以/v1结尾429 Too Many Requests并发超限或余额不足降低请求频率检查账号余额和限流阈值我用阿里云百炼时遇到最多的是第一种和第三种。第一种通常是复制 Key 时多复制了空格第三种是测试的时候连续发消息触发了限流。这里也顺带说一句别一开始就上qwen-max这类大模型日常对话用qwen-plus或者更小的模型性价比更高。4.4 服务器重启后 OpenClaw 没自动恢复如果你的容器启动命令里写了--restart unless-stopped那 Docker 服务启动时容器应该会自动拉起。如果重启后 OpenClaw 没起来先检查 Docker 服务本身是否正常运行systemctl status docker如果 Docker 没开机自启执行systemctl enable docker再重启测试一遍。还有一种情况是重启时数据目录没挂载好容器虽然起来了但配置丢失这就要检查你的-v挂载路径是否正确以及数据目录权限是否匹配容器内运行用户。5. 进阶玩法把 OpenClaw 玩出价值5.1 接入钉钉、飞书和微信公众号OpenClaw 的价值在于接入你日常用的平台否则只是本地一个没人在乎的 API 服务。以钉钉为例你需要先在钉钉开放平台创建一个企业内部应用拿到 AppKey 和 AppSecret然后配置消息回调地址为https://你的域名/openclaw/callback之类的路径具体路径取决于 OpenClaw 版本。飞书的配置思路类似也是在飞书开放平台建应用然后把回调地址填进去。这块最容易出问题的是回调地址的校验平台会发送一个验证请求如果你的 Nginx 反向代理没有正确透传请求头验证就会失败。所以前面 Nginx 配置里的proxy_set_header四行一定要写全缺了Host大概率出错。5.2 用 systemd 守护 Nginx 和 Docker 服务生产环境最怕服务悄悄挂掉。Docker 那边已经用--restart unless-stopped兜底了Nginx 也可以用 systemd 托管。Ubuntu 上 Nginx 安装后自动就有 systemd 服务你只需要确认systemctl enable nginx另外建议写一个简单的健康检查脚本每分钟用 curl 请求一次健康检查接口如果连续几次失败就通过 Webhook 通知自己。这个不复杂但能让你在用户发现问题之前先知道服务异常。5.3 成本控制、日志清理与数据备份OpenClaw 占用的磁盘主要是日志和数据目录。容器长期运行后/var/lib/docker/containers/下的 json 日志文件会越来越大建议在/etc/docker/daemon.json里加上日志大小限制{ log-driver: json-file, log-opts: { max-size: 50m, max-file: 3 } }改完重启 Docker 才生效。数据备份也很简单因为我们已经把数据目录挂载到/opt/openclaw只需要定期打包这个目录上传到 OSS 就行。我习惯写一个 cron0 3 * * * tar czf /backup/openclaw_$(date \%F).tar.gz /opt/openclaw然后把这个备份文件同步到阿里云 OSS异地容灾都省了。5.4 关联本地部署的大模型从 Ollama 到 Jetson如果你不想用云端 API也可以在另一台机器上本地部署大模型比如用 Ollama 跑一个 7B 模型然后把 OpenClaw 的 Base URL 指向 Ollama 的地址http://内部IP:11434/v1。这样做的好处是数据完全不出内网缺点是回答质量和速度取决于你的硬件。有朋友问过 RK3588 开发板能不能跑我实测下来小模型可以跑但流畅度一般Jetson Orin 系列会好很多能跑更大的模型。整体上如果你追求稳定建议云端 API 和本地模型都配上OpenClaw 支持按场景切换模型日常闲聊用本地小模型重要任务用云端强模型成本和体验都能兼顾。6. 最后说几句实践体会整套部署流程我跑了不止一遍最大的感受是“两步部署”虽然听起来简单但真正决定成败的往往是细节镜像加速器有没有生效、安全组端口有没有开、数据目录有没有挂载、Nginx 请求头有没有透传。任何一步漏了后面都会以很奇怪的方式报错让你误以为是 OpenClaw 本身的问题。如果非要给一句建议我会说先把最小闭环跑通再接花哨功能。我曾经一上来就想把 Obsidian、Teams、邮件全部接好结果配置互相干扰排查了大半天。后来老老实实从容器启动、大模型对话、单一聊天渠道三步走半小时内就全部打通。这个项目的上限很高但地基一定要一步一步打。最后再给你一个小技巧阿里云控制台支持“快照”功能在部署 OpenClaw 之后、开始做复杂配置之前给系统盘打一个快照。这样后面不管怎么折腾一条命令就能回到干净状态省下的时间绝对对得起点这几下鼠标的成本。
OpenClaw两步部署实战：阿里云ECS+Docker容器化AI助手落地
最近群里好几个朋友都在问我同一个问题OpenClaw 到底怎么落地跑起来说实话第一次搞这个项目的时候我也被它的部署方式折腾了一会文档写得不算差但总有些细节要自己试错。后来我在阿里云的一台 2核4G 的 ECS 上把流程顺了一遍发现真正常用的路径可以压缩成两条命令一条准备环境一条拉起容器整个过程基本能做到“一键秒级部署”。今天就把这套方案完整写出来包括我踩过的坑、调过的参数以及排查问题的思路希望对正在折腾 OpenClaw 的朋友有点帮助。OpenClaw 是一个开源的个人 AI 助手框架核心思路是把大模型能力接到日常工具链里聊天工具、日程、笔记、邮件、语音通话之类的应用都能通过它串起来。你可以理解成给大模型装了一双手和一套通讯录让它不只会聊天还能替你执行任务。这个项目最适合三类人一是想自建 AI 助手的开发者二是对数据隐私有要求、不愿把对话全交给云端产品的用户三是对自动化和 Agent 工作流感兴趣的研究者。配合阿里云 ECS主要是稳定性好、带宽可控、安全组规则灵活而且国内访问速度有保障部署完成后不管接钉钉、飞书还是微信公众号延迟都比较低。下面我会从项目思路、选型考量、完整实操、常见问题排查到扩展玩法一条条讲清楚尽量做到你照着敲就能跑通。1. 项目整体拆解OpenClaw 部署的本质是什么1.1 OpenClaw 到底是什么解决什么问题OpenClaw 本质上是把大模型 API、消息通道、任务执行器三者粘合在一起的运行时。它对外提供统一的接口对内连接各种服务你可以用对话的方式让它查天气、管理待办、整理文档甚至触发定时任务。项目名字里的 Claw 可以理解成“爪子”意思是让 AI 能真正抓到外部工具而不是只在对话框里打转。部署 OpenClaw 要做的核心事情其实就三件有一个能长期运行的环境云服务器。把这个服务跑起来并且配置好大模型的 API 接入。把消息渠道对接进去比如钉钉、飞书、Telegram、微信公众号等。从架构看OpenClaw 本身就提供了容器化方案官方推荐的部署方式就是 Docker。所以我们真正要解决的只是“怎么在阿里云上把 Docker 环境准备到顺手的状态”和“怎么把容器参数一次配对”。1.2 为什么选择阿里云而不是本地机器很多朋友问我能不能用自己电脑跑当然可以但有几个现实问题家里宽带没有公网 IP 或者 IP 经常变聊天工具回调地址不稳定电脑休眠了服务就断了电费和维护成本算下来并不比云服务器便宜。阿里云 ECS 的优势在于公网 IP 固定、安全组可控、带宽可按需调整而且新用户通常有免费试用额度测试阶段基本不花钱。我选择阿里云还有一个原因是它的容器镜像加速服务。国内直连 Docker Hub 拉镜像经常慢到怀疑人生阿里云容器镜像服务提供的个人版加速器可以明显改善这个问题这和后续部署体验直接相关。1.3 “两步部署”的核心思路所谓两步其实是把常用的初始化动作固化成一个命令再把启动动作固化成一个命令。第一步是准备运行环境包括安装 Docker、配置镜像加速、创建数据目录第二步是拉取 OpenClaw 镜像并启动容器同时完成端口映射和持久化目录挂载。这样做的好处是显而易见的不管你是新买的服务器还是以前用过的服务器只要执行这两步环境就一致了。不需要记一堆零散的安装步骤也不容易出现“漏了一步导致服务起不来”的情况。2. 部署前准备ECS 选型、系统镜像和安全组2.1 ECS 实例怎么选才不浪费钱OpenClaw 本身对资源要求不算高真正的资源消耗大头在你后面接入的大模型推理而那个一般通过 API 调用完成不占用本地资源。所以我给你的建议是使用场景推荐规格说明轻量测试/尝鲜2核2G跑单容器够用但并发高时会明显卡顿日常稳定运行2核4G我的推荐配置多接几个渠道也稳同时跑多个 Agent/任务4核8G适合重度使用者例如同时接多个对话渠道磁盘建议选 40G 起步因为 Docker 镜像、日志、附件缓存都会慢慢占空间。带宽方面如果只是普通聊天文本交互5M 峰值足够如果要传图片、语音建议按量计费或者选更高带宽这个看实际需求。2.2 操作系统选择与安全组设置系统镜像我推荐 Ubuntu 22.04 LTS 或 Debian 12原因是 Docker 官方对这两个系统的支持最好命令示例也最常见。CentOS 不是不行但 Stream 版本的配置路径有些差异新手容易踩坑。安全组是大家最容易忽略的环节。阿里云的安全组规则默认只开放少数端口而 OpenClaw 的 Web 服务要对外提供服务就必须在安全组里放行对应端口。我习惯的规则是22 端口只允许自己的 IP 访问避免 SSH 被暴力破解。8080 端口OpenClaw 主服务按需开放如果只是内部调试可先不开放。80/443 端口如果后面要挂域名和 HTTPS 证书这两个必须开放。注意安全组的放行是双向的但阿里云控制台一般只需要配置“入方向”规则即可出方向默认全放行这点不必额外处理。2.3 服务器基础环境检查在跑部署脚本之前先确认几件事登录服务器之后执行uname -a看内核版本确认是 64 位系统执行df -h看磁盘剩余空间free -h看内存。如果磁盘剩余不到 10G建议先清理。这一步看起来很基础但确实有人拿到全新服务器就直接跑脚本结果因为系统镜像没初始化完导致 Docker 装到一半报错。别急这几分钟把基础检查做了能省后面很多事。3. 实操全过程两条命令完成 OpenClaw 部署3.1 第一步一条脚本搞定 Docker 环境我不建议你手动一步步apt install docker.io再配置加速器因为不同系统版本的命令有差异写成一个脚本统一执行才不会出错。以下是我在 Ubuntu 22.04 上验证过的部署脚本你可以直接复制保存为init_env.sh#!/bin/bash # OpenClaw 部署环境初始化脚本 # 适用于 Ubuntu 22.04 / Debian 12 set -e echo 更新系统包索引... apt-get update echo 安装 Docker 依赖... apt-get install -y \ ca-certificates \ curl \ gnupg \ lsb-release echo 添加 Docker 官方 GPG 密钥... install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc chmod ar /etc/apt/keyrings/docker.asc echo 添加 Docker 软件源... echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release echo $VERSION_CODENAME) stable | \ tee /etc/apt/sources.list.d/docker.list /dev/null apt-get update echo 安装 Docker 引擎... apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin echo 配置阿里云镜像加速器... mkdir -p /etc/docker cat /etc/docker/daemon.json EOF { registry-mirrors: [https://你的加速器地址.mirror.aliyuncs.com] } EOF echo 重启 Docker 并设置开机自启... systemctl restart docker systemctl enable docker echo 初始化完成Docker 版本 docker --version脚本里镜像加速器地址需要你到阿里云控制台搜“容器镜像服务”打开个人版找到“镜像加速器”里面会给你一个专属的 HTTPS 地址。这个地址是免费的绑定你的阿里云账号用起来也很稳定。执行方式很简单chmod x init_env.sh ./init_env.sh脚本跑完docker --version能正常输出就说明环境没问题了。3.2 第二步启动 OpenClaw 容器环境准备好之后OpenClaw 的启动就一句话docker run -d \ --name openclaw \ --restart unless-stopped \ -p 8080:8080 \ -v /opt/openclaw:/app/data \ -e CLAW_ENVproduction \ ghcr.io/openclaw/openclaw:latest我来逐项解释一下这些参数为什么这么写-d后台运行不占据当前终端。--name openclaw给容器固定一个名字后续查看日志和重启都方便。--restart unless-stoppedDocker 守护进程启动时自动拉起容器除非你手动 stop 它。服务器重启之后服务能自动恢复这对没有运维经验的人太重要了。-p 8080:8080把容器的 8080 端口映射到宿主机的 8080 端口。OpenClaw 默认监听 8080理论上也可以改成别的但我建议别改减少不必要的干扰。-v /opt/openclaw:/app/data把配置和数据文件持久化到宿主机。这一步一定不能省否则容器更新或重装之后所有配置、会话数据全没了。-e CLAW_ENVproduction指定生产环境模式会关闭一些调试输出减少日志噪音。ghcr.io/openclaw/openclaw:latest官方镜像地址latest 标签跟随最新稳定版。运行成功后会输出一串容器 ID这时候执行docker logs -f openclaw可以看到启动日志看到Server started或类似字样就说明服务已经起来了。用浏览器访问http://你的服务器IP:8080如果安全组放行了端口应该能看到管理界面或者健康检查页面。3.3 配置大模型 API以 DeepSeek 和 DashScope 为例OpenClaw 本身不带大模型它相当于一个调度层需要你提供大模型的 API 才能对话。目前主流的接入方式有两种一种是直接配 OpenAI 兼容接口另一种是配各家云厂商的专用 SDK。阿里云百炼DashScope的接口我实测过和 OpenAI 格式高度兼容所以配置起来非常直接。以阿里云百炼为例你需要在后台创建 API Key然后在 OpenClaw 的配置文件里填写模型名称和 Base URL。模型名称可以用qwen-plus或qwen-max这类通义千问系列Base URL 填 DashScope 提供的兼容地址。如果你用的是 DeepSeek就填 DeepSeek 官方 API 的 Base URL模型填deepseek-chat。配置完成之后一定要在后台的测试面板发一条消息验证。很多人会在这里卡住问题往往是 API Key 填错、Base URL 末尾多了一个斜杠、或者模型名不在你的账号权限范围内。最简单的排查方式是先用curl直接调 API 接口确认返回正常再来看 OpenClaw 的配置。3.4 挂域名和全站 HTTPS如果你的 OpenClaw 要长期使用我强烈建议配域名加 HTTPS。原因很直接很多聊天平台的回调地址要求必须是 HTTPS而裸 IP 加端口的方式在微信、飞书这类平台上根本过不了审核。我的做法是用 Nginx 做反向代理把 80 端口的请求转发到 8080。先安装 Nginxapt-get install -y nginx然后在/etc/nginx/sites-available/openclaw.conf里写转发配置server { listen 80; server_name your-domain.com; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }启用配置并重载 Nginxln -s /etc/nginx/sites-available/openclaw.conf /etc/nginx/sites-enabled/ nginx -t systemctl reload nginxHTTPS 证书我推荐直接用阿里云免费的 SSL 证书在云盾控制台申请验证域名后下载 Nginx 格式的证书文件然后填到 Nginx 配置里。免费证书一般一年有效期到期后重新申请即可具体路径在控制台里都很清晰这里不再展开。4. 常见问题与排查技巧实录4.1 Docker 拉取镜像慢或直接超时这是国内服务器最常见的问题。镜像加速器已经配置了但还是拉不动怎么办先检查 daemon.json 是否生效docker info | grep -A 5 Registry Mirrors如果显示你的加速器地址说明配置没问题。如果没显示那就重启一下 Docker 再试。还有种情况是加速器地址填错了注意阿里云的加速器地址每人是不同的不能直接抄网上别人的。另外latest标签的镜像体积通常比较大第一次拉取慢是正常的耐心等一等不要轻易 CtrlC。实在拉不动的极端情况下可以尝试先拉一个较小的基础镜像测试网络连通性docker pull hello-world如果这个都拉不动那就不是 OpenClaw 的问题而是 Docker 网络本身有问题建议检查服务器 DNS 配置或重启 Docker 服务。4.2 容器启动失败端口占用和内存不足有一种情况是启动瞬间报错port is already allocated说明 8080 端口被占了。执行ss -tlnp | grep 8080看看是谁占用的如果你以前部署过其他服务很可能是端口冲突。解决方式是停掉旧服务或者把 OpenClaw 映射到其他端口比如-p 9090:8080。还有一种情况是明明内存够但容器起来之后又马上退出。这时候别瞎猜直接看日志docker logs --tail 200 openclaw日志里一般会写明原因最常见的是配置文件里的某个路径写错了或者是启动时连不上你配置的 API 服务。OpenClaw 不像很多 Web 应用那样能容忍配置错误它启动阶段会做连接检查连不上就直接退出。4.3 对话时大模型接口返回报错这个问题大多出现在用户接入了自己的 API 之后。常见报错有三种报错信息可能原因解决方案401 UnauthorizedAPI Key 错误或没有对应模型权限重新检查 Key确认模型名是否在白名单内404 Not FoundBase URL 填错接口路径不对对照官方文档确认 Base URL 是否以/v1结尾429 Too Many Requests并发超限或余额不足降低请求频率检查账号余额和限流阈值我用阿里云百炼时遇到最多的是第一种和第三种。第一种通常是复制 Key 时多复制了空格第三种是测试的时候连续发消息触发了限流。这里也顺带说一句别一开始就上qwen-max这类大模型日常对话用qwen-plus或者更小的模型性价比更高。4.4 服务器重启后 OpenClaw 没自动恢复如果你的容器启动命令里写了--restart unless-stopped那 Docker 服务启动时容器应该会自动拉起。如果重启后 OpenClaw 没起来先检查 Docker 服务本身是否正常运行systemctl status docker如果 Docker 没开机自启执行systemctl enable docker再重启测试一遍。还有一种情况是重启时数据目录没挂载好容器虽然起来了但配置丢失这就要检查你的-v挂载路径是否正确以及数据目录权限是否匹配容器内运行用户。5. 进阶玩法把 OpenClaw 玩出价值5.1 接入钉钉、飞书和微信公众号OpenClaw 的价值在于接入你日常用的平台否则只是本地一个没人在乎的 API 服务。以钉钉为例你需要先在钉钉开放平台创建一个企业内部应用拿到 AppKey 和 AppSecret然后配置消息回调地址为https://你的域名/openclaw/callback之类的路径具体路径取决于 OpenClaw 版本。飞书的配置思路类似也是在飞书开放平台建应用然后把回调地址填进去。这块最容易出问题的是回调地址的校验平台会发送一个验证请求如果你的 Nginx 反向代理没有正确透传请求头验证就会失败。所以前面 Nginx 配置里的proxy_set_header四行一定要写全缺了Host大概率出错。5.2 用 systemd 守护 Nginx 和 Docker 服务生产环境最怕服务悄悄挂掉。Docker 那边已经用--restart unless-stopped兜底了Nginx 也可以用 systemd 托管。Ubuntu 上 Nginx 安装后自动就有 systemd 服务你只需要确认systemctl enable nginx另外建议写一个简单的健康检查脚本每分钟用 curl 请求一次健康检查接口如果连续几次失败就通过 Webhook 通知自己。这个不复杂但能让你在用户发现问题之前先知道服务异常。5.3 成本控制、日志清理与数据备份OpenClaw 占用的磁盘主要是日志和数据目录。容器长期运行后/var/lib/docker/containers/下的 json 日志文件会越来越大建议在/etc/docker/daemon.json里加上日志大小限制{ log-driver: json-file, log-opts: { max-size: 50m, max-file: 3 } }改完重启 Docker 才生效。数据备份也很简单因为我们已经把数据目录挂载到/opt/openclaw只需要定期打包这个目录上传到 OSS 就行。我习惯写一个 cron0 3 * * * tar czf /backup/openclaw_$(date \%F).tar.gz /opt/openclaw然后把这个备份文件同步到阿里云 OSS异地容灾都省了。5.4 关联本地部署的大模型从 Ollama 到 Jetson如果你不想用云端 API也可以在另一台机器上本地部署大模型比如用 Ollama 跑一个 7B 模型然后把 OpenClaw 的 Base URL 指向 Ollama 的地址http://内部IP:11434/v1。这样做的好处是数据完全不出内网缺点是回答质量和速度取决于你的硬件。有朋友问过 RK3588 开发板能不能跑我实测下来小模型可以跑但流畅度一般Jetson Orin 系列会好很多能跑更大的模型。整体上如果你追求稳定建议云端 API 和本地模型都配上OpenClaw 支持按场景切换模型日常闲聊用本地小模型重要任务用云端强模型成本和体验都能兼顾。6. 最后说几句实践体会整套部署流程我跑了不止一遍最大的感受是“两步部署”虽然听起来简单但真正决定成败的往往是细节镜像加速器有没有生效、安全组端口有没有开、数据目录有没有挂载、Nginx 请求头有没有透传。任何一步漏了后面都会以很奇怪的方式报错让你误以为是 OpenClaw 本身的问题。如果非要给一句建议我会说先把最小闭环跑通再接花哨功能。我曾经一上来就想把 Obsidian、Teams、邮件全部接好结果配置互相干扰排查了大半天。后来老老实实从容器启动、大模型对话、单一聊天渠道三步走半小时内就全部打通。这个项目的上限很高但地基一定要一步一步打。最后再给你一个小技巧阿里云控制台支持“快照”功能在部署 OpenClaw 之后、开始做复杂配置之前给系统盘打一个快照。这样后面不管怎么折腾一条命令就能回到干净状态省下的时间绝对对得起点这几下鼠标的成本。