OpenClaw VPS 部署教程：Docker 安装、域名绑定与 HTTPS 配置

在VPS上部署OpenClaw，很多教程只教你怎么跑起来，但域名绑定和HTTPS配置才是生产环境的关键。主机选这篇教程从Docker安装开始，一步步带你完成OpenClaw的完整部署，包括Nginx反向代理、DNS解析和SSL证书申请，避免踩坑。

OpenClaw VPS 部署前的准备

VPS 和域名基础要求

• 系统：Ubuntu 22.04 或 Debian 12（推荐，包管理方便）

• 配置：至少2核4G内存，OpenClaw运行需要一定资源，尤其涉及AI Agent调用时

• 域名：提前解析到VPS的IP，例如 `openclaw.yourdomain.com`

• 端口：放行80、443（Web服务）和OpenClaw默认端口（假设为3000，具体以官方文档为准）

安装 Docker 和 Docker Compose

apt update && apt upgrade -y

apt install -y ca-certificates curl gnupg lsb-release

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg –dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

echo "deb [arch=$(dpkg –print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null

apt update && apt install -y docker-ce docker-ce-cli containerd.io

systemctl enable docker && systemctl start docker

apt install -y docker-compose-plugin

安装完成后，运行 `docker –version` 和 `docker compose version` 确认。

Docker 安装 OpenClaw

拉取镜像并启动容器

OpenClaw官方通常提供Docker镜像。以通用命令为例：

docker pull openclaw/openclaw:latest

mkdir -p /opt/openclaw/data

docker run -d \
–name openclaw \
-p 3000:3000 \
-v /opt/openclaw/data:/app/data \
-e OPENCLAW_CONFIG=/app/data/config.yml \
–restart unless-stopped \
openclaw/openclaw:latest

如果官方推荐使用 `docker-compose.yml`，则创建文件：
yaml
version: '3.8'
services:
openclaw:
image: openclaw/openclaw:latest
container_name: openclaw
ports:
– "3000:3000"
volumes:
– ./data:/app/data
environment:
– OPENCLAW_CONFIG=/app/data/config.yml
restart: unless-stopped

然后 `docker compose up -d` 启动。

检查容器运行状态

docker ps | grep openclaw
docker logs openclaw –tail 20

若启动失败，常见原因是端口被占用或配置文件缺失。先看日志再排查。

域名绑定与 HTTPS 配置

配置 Nginx 反向代理

安装 Nginx：

apt install -y nginx
systemctl enable nginx && systemctl start nginx

创建站点配置文件：

nano /etc/nginx/sites-available/openclaw

写入以下内容（注意替换域名和端口）：
nginx
server {
listen 80;
server_name openclaw.yourdomain.com;

location / {
proxy_pass http://127.0.0.1:3000;
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;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}

启用配置并测试：

ln -s /etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/
nginx -t
systemctl reload nginx

此时通过 `http://openclaw.yourdomain.com` 应能访问 OpenClaw 界面。如果打不开，检查防火墙是否放行80端口。

使用 Certbot 申请 SSL 证书

安装 Certbot 和 Nginx 插件：

apt install -y certbot python3-certbot-nginx

执行证书申请：

certbot –nginx -d openclaw.yourdomain.com

按照提示输入邮箱并同意协议。Certbot 会自动修改 Nginx 配置，添加 HTTPS 和重定向。完成后访问 `https://openclaw.yourdomain.com` 确认。

强制 HTTPS 与自动续期

Certbot 默认已添加重定向。验证：

cat /etc/nginx/sites-available/openclaw

自动续期由 systemd timer 处理，无需额外操作。测试续期：

certbot renew –dry-run

老鸟叮嘱

1.端口放行：VPS 防火墙（如 ufw）必须放行 80、443，OpenClaw 内部端口 3000 不需要对外暴露，仅 Nginx 反向代理即可。不要直接暴露 3000 端口到公网。
2.数据持久化：务必挂载数据卷，否则容器删除后配置丢失。建议定期备份 `/opt/openclaw/data`。
3.API Key 安全：OpenClaw 如果调用外部 AI 服务（如 OpenAI），API Key 通过环境变量或配置文件传入，不要写死在代码里，也不要在 Nginx 日志中暴露。
4.资源监控：AI Agent 类工具可能占用大量内存，建议设置 Docker 资源限制，例如在 `docker run` 中添加 `–memory=2g`。
5.日志排查：遇到 502 错误，先检查 OpenClaw 容器是否正常运行，再查看 Nginx 错误日志 `/var/log/nginx/error.log`。

FAQ

Q1：OpenClaw 需要什么最低配置？

A：至少 2 核 4G 内存，推荐 4 核 8G。如果同时运行本地模型（如 Ollama），配置需更高。

Q2：Docker 安装后无法访问 OpenClaw 怎么办？

A：先执行 `docker logs openclaw` 查看容器日志，确认服务是否启动。然后检查 VPS 防火墙和云平台安全组是否放行了 80/443 端口。本地可用 `curl http://127.0.0.1:3000` 测试容器内服务是否正常。

Q3：HTTPS 证书申请失败，提示域名解析错误？

A：确保域名已正确解析到 VPS 的 IP，且 DNS 生效。可以用 `dig openclaw.yourdomain.com` 验证。

Q4：OpenClaw 配置文件中需要修改哪些关键项？

A：通常需要设置 API Key、数据库连接（如有）、监听地址（建议保持 0.0.0.0:3000）。具体字段以官方文档为准，不要照搬网上旧教程。

Q5：如何升级 OpenClaw 版本？

A：拉取新镜像，停止并删除旧容器，重新用相同参数启动。注意数据卷挂载路径不变，配置不会丢失。

Q6：Nginx 反向代理后 WebSocket 连接一直断开？

A：检查 Nginx 配置中是否添加了 Upgrade 和 Connection 头，以及 `proxy_read_timeout` 是否设置足够长（如 60s）。OpenClaw 如果使用 WebSocket 进行实时通信，必须保留上述配置。

OpenClaw 部署完成后，记得定期检查容器日志和证书续期状态。生产环境建议使用 Docker Compose 管理，方便后续扩展服务。

—

**相关阅读：**

– [VPS 部署 AI 工具需要哪些基础？Linux、Docker、Nginx 和域名配置入门](https://www.zhujixuan.com/jishujiaocheng/9747.html)
– [Hermes Agent VPS 部署教程：Docker Compose 安装和初始化配置](https://www.zhujixuan.com/jishujiaocheng/9872.html)
– [VPS部署AI工具100讲：AI Agent、Codex、Claude Code、Hermes Agent、Ollama与自动化工作流实战教程](https://www.zhujixuan.com/jishujiaocheng/9606.html)