=============================================
OpenClaw Docker 部署 · 完整速查手册
适用：Docker 安装、排错、命令解释
制作时间：2026.03.13

一、基础 Docker 命令

删除旧容器（重新部署必用）

docker rm -f openclaw

查看容器日志（看报错/运行状态）

docker logs openclaw

进入容器内部执行命令

docker exec -it openclaw bash

二、最终稳定 Docker 运行命令

安装 + 修复BUG + 自动保活（最常用）

docker run -d --name openclaw -p 8000:8000 --restart always python:3.10-slim sh -c “pip install openclaw tenacity && sed -i ‘/TimeoutError/d’ /usr/local/lib/python3.10/site-packages/openclaw/init.py && sleep infinity”

使用下面的命令，上面的会有需要升级pip的问题

docker run -d --name openclaw --restart always python:3.10-slim sh -c "pip install --root-user-action=ignore --upgrade pip openclaw && sed -i '/TimeoutError/d' /usr/local/lib/python3.10/site-packages/openclaw/__init__.py && sleep infinity"

三、命令逐段翻译

docker run = 创建并运行容器
-d = 后台运行
–name openclaw = 容器名称
-p 8000:8000 = 端口映射：电脑8000 → 容器8000
–restart always = 崩溃自动重启
python:3.10-slim = 精简Python环境
sh -c “命令” = 容器内执行多条命令
pip install … = 安装依赖
sed -i ‘/TimeoutError/d’ = 修复官方代码BUG
sleep infinity = 让容器永不退出

四、源码安装命令（官方推荐）

docker run -d --name openclaw -p 8000:8000 python:3.10-slim sh -c “apt update && apt install -y git && git clone https://github.com/shmoli2024/openclaw.git && cd openclaw && pip install -r requirements.txt && pip install . && python -m cmdop start”

五、所有报错 + 原因 + 解决方案

1. 报错：No module named ‘tenacity’
   原因：依赖缺失
   解决：pip install tenacity

2. 报错：ImportError: cannot import name ‘TimeoutError’
   原因：官方代码BUG
   解决：sed -i ‘/TimeoutError/d’ 删除错误行

3. 报错：openclaw: command not found
   原因：项目未提供命令入口
   解决：无法修复（官方问题）

4. 报错：No module named openclaw.main
   原因：无法用python -m启动
   解决：无法修复

5. 报错：git: not found
   原因：精简镜像无git
   解决：apt install -y git

6. 报错：apt 源连接失败
   原因：国内网络问题
   解决：放弃源码安装

7. 警告：Running pip as the root user
   说明：Docker内正常，无需处理

8. 警告：apt does not have a stable CLI interface
   说明：正常提示，无需处理

六、3个核心神秘命令解释

1. sed -i ‘/TimeoutError/d’ 文件
   → 删除代码中报错的错误行

2. sh -c “命令1 && 命令2”
   → 让Docker一次性执行多条命令

3. sleep infinity
   → 让容器保持运行，不自动关闭

七、最终结论

dacker安装openclaw已完成

八、已掌握技能
✅ Docker 基础命令
✅ 端口映射
✅ 安装Python依赖
✅ 修复代码BUG
✅ 排查错误日志
✅ 理解Docker与本地环境差异