1. 引言OpenClaw 是一个开源的 AI 代理框架允许开发者构建、部署和管理自主 AI 代理。将 OpenClaw 部署到 VPS虚拟专用服务器上可以获得稳定的运行环境、公网访问能力和 7×24 小时持续运行的优势。本文将从服务器选型、环境配置、部署流程到生产环境优化完整演示如何在 VPS 上托管 OpenClaw。2. 服务器选型与准备工作在开始部署之前需要选择合适的 VPS 并完成基础环境配置。以下是推荐的服务器配置要求配置项最低要求推荐配置CPU1 核2 核及以上内存1 GB4 GB 及以上磁盘20 GB SSD40 GB SSD带宽1 Mbps5 Mbps 及以上操作系统Ubuntu 20.04Ubuntu 22.04 LTS完成服务器购买后首先通过 SSH 登录服务器并更新系统软件包ssh rootyour_server_ip 更新系统软件包 apt update apt upgrade -y 安装基础工具 apt install -y curl wget git build-essential ufw3. 安装 Docker 与 Docker ComposeOpenClaw 官方推荐使用 Docker 进行部署这样可以避免环境依赖问题并简化升级流程。以下是安装 Docker 和 Docker Compose 的完整步骤# 安装 Docker curl -fsSL https://get.docker.com -o get-docker.sh sh get-docker.sh 验证 Docker 安装 docker --version 安装 Docker Compose 插件 apt install -y docker-compose-plugin 验证 Docker Compose docker compose version 将当前用户加入 docker 组避免每次使用 sudo usermod -aG docker $USER newgrp docker4. 获取 OpenClaw 并配置环境变量OpenClaw 的部署需要准备 API 密钥和基础配置文件。首先创建项目目录并克隆配置模板# 创建项目目录 mkdir -p /opt/openclaw cd /opt/openclaw 下载官方 docker-compose 模板 curl -O https://raw.githubusercontent.com/openclaw/openclaw/main/docker-compose.yml 创建环境变量文件 nano .env在.env文件中配置以下关键环境变量# OpenClaw 核心配置 OPENCLAW_API_KEYyour_secure_api_key_here OPENCLAW_PORT8080 OPENCLAW_LOG_LEVELinfo LLM 提供商配置以 OpenAI 为例 OPENAI_API_KEYsk-your_openai_api_key OPENAI_MODELgpt-4o 数据库配置 POSTGRES_DBopenclaw POSTGRES_USERopenclaw POSTGRES_PASSWORDyour_db_password 时区设置 TZAsia/Shanghai5. 使用 Docker Compose 启动服务环境变量配置完成后即可启动 OpenClaw 服务。以下命令将拉取镜像并启动所有依赖服务# 拉取镜像并启动服务 docker compose up -d 查看服务运行状态 docker compose ps 查看实时日志 docker compose logs -f openclaw服务启动后可以通过以下命令验证 OpenClaw 是否正常运行# 检查健康检查接口 curl http://localhost:8080/health 预期输出示例 {status:ok,version:1.2.3,uptime:42}6. 配置 Nginx 反向代理与 HTTPS为了提供安全的公网访问需要配置 Nginx 反向代理和 SSL 证书。首先安装 Nginx 和 Certbotapt install -y nginx certbot python3-certbot-nginx创建 Nginx 站点配置文件nano /etc/nginx/sites-available/openclaw写入以下反向代理配置server { listen 80; server_name openclaw.example.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; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; } }启用站点配置并申请 SSL 证书# 启用站点 ln -s /etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/ nginx -t systemctl reload nginx 申请 SSL 证书 certbot --nginx -d openclaw.example.com7. 配置防火墙与安全加固安全是生产环境部署的关键环节。配置 UFW 防火墙并限制不必要的端口访问# 配置 UFW 防火墙 ufw default deny incoming ufw default allow outgoing ufw allow 22/tcp ufw allow 80/tcp ufw allow 443/tcp ufw enable 查看防火墙状态 ufw status verbose同时建议配置 Fail2ban 防止暴力破解 SSH 登录apt install -y fail2ban systemctl enable fail2ban systemctl start fail2ban8. 编写自动化部署脚本为了简化后续的部署和升级流程可以编写一个自动化部署脚本。创建deploy.sh#!/bin/bash set -e echo OpenClaw 部署脚本 进入项目目录 cd /opt/openclaw 拉取最新代码和镜像 git pull origin main || true docker compose pull 备份当前数据库 docker compose exec -T postgres pg_dump -U openclaw openclaw backup_$(date %Y%m%d_%H%M%S).sql 重启服务 docker compose up -d --remove-orphans 健康检查 sleep 10 if curl -sf http://localhost:8080/health /dev/null; then echo ✅ OpenClaw 部署成功 else echo ❌ 健康检查失败请查看日志 docker compose logs --tail50 openclaw exit 1 fi赋予脚本执行权限并运行chmod x deploy.sh ./deploy.sh9. 配置日志轮转与监控告警生产环境需要完善的日志管理和监控机制。配置 Docker 日志轮转# 创建 Docker daemon 配置 nano /etc/docker/daemon.json{ log-driver: json-file, log-opts: { max-size: 10m, max-file: 3 } }重启 Docker 使配置生效并设置系统监控systemctl restart docker 安装监控工具 apt install -y htop netdata systemctl enable netdata systemctl start netdata10. 常见问题排查在部署过程中可能会遇到一些常见问题以下是典型的排查方法10.1 容器无法启动# 查看容器日志 docker compose logs openclaw 检查环境变量是否完整 docker compose config10.2 端口被占用# 查看端口占用情况 ss -tlnp | grep 8080 释放端口或修改 .env 中的端口配置10.3 数据库连接失败# 检查数据库容器状态 docker compose ps postgres 查看数据库日志 docker compose logs postgres11. 总结本文完整演示了在 VPS 上托管 OpenClaw 的全流程包括服务器选型、Docker 环境搭建、服务配置、反向代理、安全加固和自动化部署。通过 Docker Compose 可以显著简化部署和升级流程配合 Nginx 反向代理和 HTTPS 加密能够为生产环境提供稳定、安全的 AI 代理服务。建议在实际部署中根据业务规模调整资源配置并定期备份数据库和更新镜像版本。
