Ubuntu 上docker部署 OpenClaw

前言

最近在Ubuntu云服务器上部署OpenClaw，原本设想很简单，不就是Docker拉镜像、跑容器嘛。可实际操作起来，却是一路磕磕绊绊——从镜像拉取超时、到配置镜像源不生效，再到命令输入上的低级失误，整个过程堪称一部“踩坑大全”。折腾了好一阵子才最终搞定。把这段经历整理出来，既是对自己排查过程的复盘，也希望能给遇到类似问题的朋友提个醒，或许能帮大家避开这些弯路。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

一、初始尝试：默认源拉取，反复超时报错

一开始，我按最常规的流程，在终端输入了 docker pull openclaw/openclaw。心想，接下来就该是看着进度条欢快前进的画面了。结果呢？终端一直卡在“Pulling from openclaw/openclaw”这一步，等了分把钟，直接弹出一个冷冰冰的 timeout 错误，提示“net/http: request canceled while waiting for connection”。

第一反应是命令敲错了？反反复复查了几遍，镜像名确认无误。再执行，同样的错误再次上演。这时才回过味来：问题的核心，大概率出在网络上。国内环境直连Docker Hub官方仓库，网络状况不稳，云服务器到海外仓库的链路延迟高，拉取请求根本无法正常响应，最后只能以超时告终。

二、踩坑升级：配置镜像源，却因操作失误未生效

意识到是网络问题，解决方案就很明确了：换用国内的Docker镜像翻跟斗。我选了常用的网易163源，照着网上搜到的命令，在终端里输入：echo '{"registry-mirrors": ["https://hub-mirror.c.163.com"]}' | sudo tee /etc/docker/daemon.json。系统提示配置文件写入成功，我便信心满满地再次尝试拉取镜像。谁知，熟悉的超时错误又一次出现，毫无改善。

这就奇怪了，明明配了镜像源，怎么一点用都没有？试着用 docker info | grep Registry 检查配置是否生效，结果终端一片空白，没有任何关于镜像源的输出。这说明配置根本没加载进去。

一番排查后，发现了两个关键失误：

第一，输入命令时，输入法不小心处在全角模式，导致管道符“|”实际上是个“全角字符”。虽然终端回显显示写入成功，但配置文件的内容很可能已经异常了。

第二，也是更常见的疏忽：配置完镜像源后，忘了重启Docker服务。Docker引擎没有重新加载配置，当然还在傻傻地尝试连接默认的国外源。

于是，切换到英文半角输入法，重新执行配置命令，并紧接着输入 sudo systemctl restart docker 重启服务。心想这次总该成了吧？结果拉取镜像时，超时依旧。推测原因，可能是网易源对于这个特定的OpenClaw镜像同步不够及时，或者当时节点有些问题。

三、最终解决：更换国内维护镜像，顺利拉取成功

一个镜像源不行，那就换一个。这次转向了阿里云的国内维护镜像（经验表明，这类由国内厂商维护的镜像，同步往往更及时，对国内服务器也更友好）。执行的命令换成了：docker pull registry.cn-hangzhou.aliyuncs.com/qiluo-images/openclaw:latest。

命令回车后，终端立刻出现了期盼已久的下载进度条，再也没出现超时提示。虽然中间下载速度有点波动，但整体过程非常顺利。几分钟后，镜像拉取完成。输入 docker images 查看，OpenClaw镜像已经安安静静地躺在本地列表里了。后续只需要创建容器，就能正常部署使用。

四、踩坑总结与关键注意事项

回顾这次OpenClaw的部署，步骤本身不复杂，却因为几个细节问题屡屡受挫。总结下来，有这么三个核心注意事项，能帮你避开大多数类似的坑：

国内环境优先使用国内Docker镜像源：这是个大前提。直接拉取Docker Hub官方镜像，网络不稳定是常态。优先选择中科大、阿里云、网易等国内镜像源，能极大提升成功率与下载速度。

配置镜像源后必须重启Docker服务：这一点至关重要，却很容易被忽略。修改了 daemon.json 配置文件后，务必要执行 sudo systemctl restart docker 来重启服务，让新配置生效，否则前面的操作等于白费。

命令输入务必注意细节：终端对命令的格式非常敏感。特别是符号（如管道符“|”）、空格以及镜像名称的大小写。操作时，请确保输入法处于英文半角状态，仔细核对，避免因手误导致命令执行失败。

五、常用有效命令汇总（直接复制可用）

为了方便大家快速操作，这里把本次部署过程中验证有效的命令汇总如下，可以直接复制到终端使用：

# 1. 配置阿里云Docker镜像源（推荐国内环境）
echo '{"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]}' | sudo tee /etc/docker/daemon.json

# 2. 重启Docker服务，使镜像源配置生效
sudo systemctl restart docker

# 3. 拉取OpenClaw国内镜像（成功率最高）
docker pull registry.cn-hangzhou.aliyuncs.com/qiluo-images/openclaw:latest

# 4. 查看本地镜像，确认拉取成功
docker images

# 5. 若Docker未正常运行，重启Docker服务
sudo systemctl restart docker

结语

很多技术部署过程，问题往往不出在命令本身，而在于一些容易疏忽的细节。这次踩坑经历也再次印证了，遇到报错别慌，按照清晰的思路一步步排查——先查网络连通性，再查配置是否正确加载，最后检查命令细节——问题总能找到解决的办法。希望这篇实录能带来一些帮助，祝各位部署顺利！