OpenClaw VPS 托管：从零部署到生产级运维的完整指南

1. 引言OpenClaw 是一个开源的 AI 代理框架用于构建可自主执行任务的智能体。将 OpenClaw 部署到 VPS虚拟专用服务器上可以让你的 AI 代理 7×24 小时在线运行不受本地设备断电、断网的影响。本文将从 VPS 选型、环境配置、OpenClaw 安装、服务化部署、安全加固到监控运维带你一步步完成 OpenClaw 的 VPS 托管。2. VPS 选型与基础配置在开始之前我们需要选择一台合适的 VPS。以下是选型建议CPU至少 2 核推荐 4 核以上用于处理并发请求和模型推理。内存至少 4GB推荐 8GB。OpenClaw 运行时会占用较多内存尤其是加载模型时。磁盘至少 40GB SSD用于存放代码、日志和模型缓存。带宽建议 5Mbps 以上保证 API 调用和 Web 界面响应速度。系统推荐 Ubuntu 22.04 LTS 或 Debian 12稳定且社区支持完善。购买 VPS 后首先通过 SSH 登录服务器ssh root你的服务器IP登录后先更新系统并创建普通用户出于安全考虑不建议直接用 root 运行服务apt update apt upgrade -y adduser openclaw usermod -aG sudo openclaw3. 安装 Docker 与 Docker ComposeOpenClaw 官方推荐使用 Docker 部署这样可以避免环境依赖问题。我们先安装 Dockercurl -fsSL https://get.docker.com -o get-docker.sh sh get-docker.sh systemctl enable docker systemctl start docker验证 Docker 是否安装成功docker --version docker compose version如果 Docker Compose 未安装可以单独安装apt install docker-compose-plugin -y4. 获取 OpenClaw 项目OpenClaw 的源码托管在 GitHub 上。我们将其克隆到服务器cd /opt git clone https://github.com/openclaw/openclaw.git cd openclaw查看项目结构ls -la项目目录中通常包含以下关键文件docker-compose.yml容器编排配置。.env.example环境变量模板。config/配置文件目录。data/数据持久化目录。5. 配置环境变量复制环境变量模板并编辑cp .env.example .env nano .env在.env文件中你需要配置以下关键项# 模型 API 配置 OPENAI_API_KEYsk-你的密钥 OPENAI_BASE_URLhttps://api.openai.com/v1 服务端口 OPENCLAW_PORT8080 数据目录 DATA_DIR/opt/openclaw/data 日志级别 LOG_LEVELinfo如果你使用其他模型提供商如 Anthropic、本地 Ollama可以相应修改# 使用 Anthropic Claude ANTHROPIC_API_KEYsk-ant-你的密钥 ANTHROPIC_BASE_URLhttps://api.anthropic.com 使用本地 Ollama OLLAMA_BASE_URLhttp://localhost:11434 OLLAMA_MODELllama3:8b6. 启动 OpenClaw 服务配置完成后使用 Docker Compose 启动服务docker compose up -d查看容器运行状态docker compose ps查看实时日志docker compose logs -f如果一切正常你应该能看到类似以下的日志输出[INFO] OpenClaw server started on port 8080 [INFO] Connected to model provider: OpenAI [INFO] Agent ready to accept tasks7. 配置 Nginx 反向代理与 HTTPS为了安全访问 OpenClaw 的 Web 界面我们使用 Nginx 作为反向代理并配置 HTTPS。首先安装 Nginxapt install nginx -y创建 Nginx 配置文件nano /etc/nginx/sites-available/openclaw写入以下配置server { listen 80; server_name your-domain.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; } }启用配置并重启 Nginxln -s /etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/ nginx -t systemctl reload nginx接下来使用 Certbot 申请免费 SSL 证书apt install certbot python3-certbot-nginx -y certbot --nginx -d your-domain.comCertbot 会自动修改 Nginx 配置并启用 HTTPS。完成后你可以通过https://your-domain.com安全访问 OpenClaw。8. 配置 systemd 服务实现开机自启虽然 Docker 容器默认会随 Docker 启动但为了更精细地控制我们可以创建一个 systemd 服务。创建服务文件nano /etc/systemd/system/openclaw.service写入以下内容[Unit] DescriptionOpenClaw Service Requiresdocker.service Afterdocker.service [Service] Typeoneshot RemainAfterExityes WorkingDirectory/opt/openclaw ExecStart/usr/bin/docker compose up -d ExecStop/usr/bin/docker compose down ExecReload/usr/bin/docker compose restart [Install] WantedBymulti-user.target启用并启动服务systemctl daemon-reload systemctl enable openclaw systemctl start openclaw验证服务状态systemctl status openclaw9. 安全加固生产环境部署必须重视安全。以下是几个关键加固措施9.1 配置防火墙使用 UFW 配置防火墙只开放必要端口apt install ufw -y ufw allow 22/tcp ufw allow 80/tcp ufw allow 443/tcp ufw enable9.2 配置 Fail2ban 防暴力破解apt install fail2ban -y systemctl enable fail2ban systemctl start fail2ban9.3 修改 SSH 默认端口nano /etc/ssh/sshd_config修改Port 22为其他端口如Port 2222然后重启 SSHsystemctl restart sshd9.4 密钥登录替代密码登录ssh-keygen -t ed25519 ssh-copy-id openclaw你的服务器IP然后在sshd_config中禁用密码登录PasswordAuthentication no10. 数据备份策略OpenClaw 的数据对话记录、配置、模型缓存存储在data/目录。建议定期备份。创建一个备份脚本nano /opt/backup.sh写入以下内容#!/bin/bash BACKUP_DIR/backups/openclaw DATE$(date %Y%m%d_%H%M%S) mkdir -p $BACKUP_DIR tar -czf $BACKUP_DIR/openclaw_$DATE.tar.gz /opt/openclaw/data find $BACKUP_DIR -name *.tar.gz -mtime 7 -delete赋予执行权限并加入 crontabchmod x /opt/backup.sh crontab -e添加定时任务每天凌晨 2 点备份0 2 * * * /opt/backup.sh11. 监控与告警生产环境需要实时监控服务状态。我们可以使用 Prometheus Grafana 搭建监控体系也可以先用简单的脚本实现基础监控。以下是一个简单的健康检查脚本nano /opt/health_check.sh#!/bin/bash URLhttps://your-domain.com/health STATUS$(curl -s -o /dev/null -w %{http_code} $URL) if [ $STATUS -ne 200 ]; then echo OpenClaw is down! Status: $STATUS | mail -s OpenClaw Alert adminexample.com docker compose -f /opt/openclaw/docker-compose.yml restart fi同样加入 crontab 每 5 分钟执行一次*/5 * * * * /opt/health_check.sh12. 常见问题排查部署过程中可能会遇到一些问题以下是常见问题及解决方案12.1 容器无法启动查看详细日志docker compose logs --tail100常见原因包括API 密钥错误、端口冲突、数据目录权限不足。12.2 内存不足检查内存使用free -h docker stats如果内存不足可以增加 Swapfallocate -l 4G /swapfile chmod 600 /swapfile mkswap /swapfile swapon /swapfile echo /swapfile none swap sw 0 0 /etc/fstab12.3 模型响应慢检查网络延迟和 API 限流curl -w Time: %{time_total}s\n https://api.openai.com/v1/models13. 总结通过本文的步骤你已经成功将 OpenClaw 部署到 VPS 上并完成了 HTTPS 配置、安全加固、数据备份和监控告警。OpenClaw 的 VPS 托管不仅让 AI 代理 7×24 小时稳定运行还为你后续扩展多代理协作、接入更多工具链打下了坚实基础。建议在生产环境上线前先在测试环境完整演练一遍部署流程确保每个环节都符合预期。