夜雨聆风OpenClaw 是一个功能强大的 AI 助手框架，可以理解为一个“AI 机器人中枢”。它能接入 QQ、飞书 等多个聊天平台，让你在任何地方都能和 AI 对话。同时支持接入各种大模型（如 DeepSeek、通义千问、Claude 等），还能通过 Skills 扩展技能（比如写公众号文章、代码开发等）。简单说：一个能干活、能聊天、能接入各种平台的 AI 管家。
写在前面
最近想在国内服务器上部署 OpenClaw，本以为是个简单的 Docker 拉取运行的事，结果还是踩了不少坑的，于是打算踩到的坑和解决方案记录下来，希望对遇到困难的朋友们有所帮助。
我的环境
服务器：国内某云 CentOS 7.x 目标：部署 OpenClaw + QQ 机器人
踩坑实录
坑一：CentOS 7版本过低，Node 22+ 版本无法安装
现象： 安装小龙虾需要比较新的node版本，一般是推荐 node 22+ 以上。 在这里我安装node时候，是采用的官方教程。具体的安装命令如下：
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line# Download and install nvm:curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash# in lieu of restarting the shell\. "$HOME/.nvm/nvm.sh"# Download and install Node.js:nvm install 24# Verify the Node.js version:node -v # Should print "v24.14.1".# Verify npm version:npm -v # Should print "11.11.0".
然而在 nvm install 后，执行node -v，就会有以下各种的报错。
ounter(lineounter(lineounter(lineounter(line$ node -vnode: /lib64/libc.so.6: version `GLIBC_2.18' not found (required by node)node: /lib64/libc.so.6: version `GLIBC_2.25' not found (required by node)node: /lib64/libc.so.6: version `GLIBC_2.28' not found (required by node)
原因： CentOS 7 自带的 glibc 版本是 2.17，Node.js 新版本（18+）需要更高版本的 glibc，而 CentOS 7 的 glibc 版本太老了。，所以也就没法安装node 22+。
最终解决： 放弃在宿主机直接装，拥抱 Docker。Docker 容器内有完整的运行时环境，彻底绕过宿主机库兼容性问题。
坑二：网络不通，拉取镜像超时
现象： 我根据openclaw的官方docker安装教程，首先第一步将 git仓库拉下来，然后在项目根路径，执行镜像构建命令
./scripts/docker/setup.sh
这块的报错就不贴出来了，就是在构建镜像时候，各种依赖的库由于网络问题拉不下来，卡住。没法下一步。
尝试过的无效方案：
配置 Docker 镜像加速器（阿里云/腾讯云，不太好使） 反复重试（大部分时间失败） 用国外的小机器作为http代理，然后配置国内服务器的docker http代理（可能是国外的小机器性能太差，配置代理是成功的，但是还是各种网络问题卡住，不能完全的拉下来）
配置了 HTTP_PROXY/HTTPS_PROXY，curl 能通但 docker pull 死活不走代理。
原因： Docker 守护进程的 systemd 配置不读这些环境变量，需要专门配置。
尝试过的无效方案：
export HTTP_PROXY=...（没用，docker pull 无视）修改 ~/.docker/config.json（部分生效，但 ghcr.io 仍然不行
最终解决： 放弃代理思路，改用镜像搬运。
🎯 核心解决方案：镜像搬运工（最终版）
经历了以上所有坑之后，我找到了一个100% 可靠的方法：用一台能顺畅访问外网的机器（比如你的电脑开加速 或国外服务器）拉取镜像，打包成 tar 文件，传到国内服务器加载。
完整操作流程
第一步：在 Mac（或国外服务器）上拉取镜像和打包
# 注意：国内服务器一般是 x86_64 架构，Mac M芯片要加 --platformdocker pull --platform linux/amd64 ghcr.io/openclaw/openclaw:latest# 导出为 tar 文件docker save -o openclaw.tar ghcr.io/openclaw/openclaw:latest# 压缩一下，传输更快gzip openclaw.tar
第二步：传输到国内服务器
# 用 scp 或 rsyncscp openclaw.tar.gz root@你的国内服务器IP:/root/
第三步：在国内服务器上导入并运行
# 解压并导入gunzip -c openclaw.tar.gz | docker load# 运行容器docker run -d \--name openclaw \--restart unless-stopped \--network host \-v /root/openclaw/config:/home/node/.openclaw \-v /root/openclaw/workspace:/home/node/.openclaw/workspace \-e TZ=Asia/Shanghai \ghcr.io/openclaw/openclaw:latest
为什么这个方法靠谱？
其他小坑与避坑指南
配置文件权限问题
现象：容器启动后报 EACCES: permission denied, mkdir '/home/node/.openclaw/agents'
解决：
chown -R 1000:1000 /root/openclaw
Web UI 无法访问
现象：浏览器打开 http://IP:18789 显示 origin not allowed 或 pairing required
解决：修改配置文件 /root/openclaw/config/openclaw.json，更改里面的里的 "allowedOrigins": ["*"],
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line{"gateway": {"port": 18789,"bind": "0.0.0.0","controlUi": {"allowedOrigins": ["*"],"dangerouslyDisableDeviceAuth": true}}}
总结：国内部署的最优路径
如果你也在国内服务器上部署 OpenClaw，我的建议是：
放弃在宿主机直接装，拥抱 Docker，也出于一定的安全角度考量 放弃代理、镜像加速，直接用“镜像搬运”法 准备一台能顺畅访问外网的机器（你的电脑+科学 或一台海外服务器） 一条命令拉取，一条命令打包，一条命令传输，一条命令导入
这套流程不仅适用于 OpenClaw，也适用于任何在国内拉取困难的 Docker 镜像。希望你能少踩坑，顺利部署！
