AI小龙虾OPENCLAW官网部署指南

本指南详细说明AI小龙虾OPENCLAW官方网站的完整部署流程,包括环境准备、配置、部署步骤和维护说明。

部署前提条件

1 服务器要求

• 操作系统: Ubuntu 20.04 LTS 或更高版本
• CPU: 2核以上
• 内存: 4GB 以上
• 存储: 50GB 可用空间
• 网络: 公网IP，开放80/443端口

2 软件依赖

• Node.js 16+
• Nginx 1.18+
• Git 2.20+
• PM2 5.0+
• Docker 20.10+ (可选)

部署步骤

1 环境初始化

# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装基础工具
sudo apt install -y curl wget vim git nginx
# 安装Node.js
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt install -y nodejs
# 验证安装
node --version
npm --version

2 获取项目代码

# 克隆项目
git clone https://github.com/openclaw/website.git
cd website
# 安装依赖
npm install
# 构建项目
npm run build

3 环境配置

3.1 配置文件

# 复制环境变量模板
cp .env.example .env
# 编辑配置
vim .env

3.2 关键配置项

# 应用配置
APP_NAME=OPENCLAW
APP_ENV=production
APP_KEY=your_secret_key_here
APP_URL=https://openclaw.ai
# API配置
API_URL=https://api.openclaw.ai
API_KEY=your_api_key_here
# 数据库配置（如有）
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=openclaw
DB_USERNAME=admin
DB_PASSWORD=secure_password

4 Nginx配置

# /etc/nginx/sites-available/openclaw.conf
server {
    listen 80;
    server_name openclaw.ai www.openclaw.ai;
    # 重定向到HTTPS
    return 301 https://$server_name$request_uri;
}
server {
    listen 443 ssl http2;
    server_name openclaw.ai www.openclaw.ai;
    # SSL证书配置
    ssl_certificate /etc/ssl/certs/openclaw.crt;
    ssl_certificate_key /etc/ssl/private/openclaw.key;
    # 静态文件服务
    root /var/www/openclaw/dist;
    index index.html;
    # 反向代理API请求
    location /api/ {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
    # 静态资源缓存
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}

5 启动应用

# 使用PM2管理进程
npm install -g pm2
pm2 start ecosystem.config.js
pm2 save
pm2 startup
# 启用Nginx配置
sudo ln -s /etc/nginx/sites-available/openclaw.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

SSL证书配置

1 使用Let's Encrypt

# 安装Certbot
sudo apt install certbot python3-certbot-nginx -y
# 获取证书
sudo certbot --nginx -d openclaw.ai -d www.openclaw.ai
# 设置自动续期
sudo certbot renew --dry-run

监控与维护

1 监控配置

# 安装监控工具
npm install -g clinic
# 配置日志轮转
sudo vim /etc/logrotate.d/openclaw

2 备份策略

# 创建备份脚本
vim /opt/backup-openclaw.sh

#!/bin/bash
# 备份脚本内容
BACKUP_DIR="/backup/openclaw"
DATE=$(date +%Y%m%d_%H%M%S)
# 备份数据库
mysqldump -u $DB_USER -p$DB_PASS $DB_NAME > $BACKUP_DIR/db_$DATE.sql
# 备份配置文件
tar -czf $BACKUP_DIR/config_$DATE.tar.gz /var/www/openclaw/.env
# 保留最近7天备份
find $BACKUP_DIR -type f -mtime +7 -delete

故障排查

常见问题及解决方案

问题	可能原因	解决方案
502 Bad Gateway	应用未启动	检查PM2状态：pm2 status
SSL证书错误	证书过期	续期证书：sudo certbot renew
静态资源404	Nginx配置错误	检查root路径和文件权限
API连接失败	端口被占用	检查端口占用：sudo netstat -tlnp

更新部署

1 自动更新脚本

#!/bin/bash
# update-openclaw.sh
cd /var/www/openclaw
git pull origin main
npm install
npm run build
pm2 restart all

2 回滚流程

# 回滚到上一个版本
git reset --hard HEAD~1
npm run build
pm2 restart all

安全建议

1. 防火墙配置

   sudo ufw allow ssh
   sudo ufw allow 'Nginx Full'
   sudo ufw enable

2. 定期更新

   # 每周执行
   sudo apt update && sudo apt upgrade -y
   npm update

3. 安全扫描

   # 使用安全扫描工具
   npm audit

性能优化

1 CDN配置

• 配置Cloudflare或阿里云CDN
• 启用Brotli压缩
• 配置HTTP/2

2 缓存策略

• 浏览器缓存优化
• Redis缓存配置
• 数据库查询优化

联系方式

如需技术支持：

• 文档：https://docs.openclaw.ai
• 邮箱：support@openclaw.ai
• GitHub Issues：项目仓库Issue板块

---

版本记录

• v1.0.0 (2024-01-15): 初始版本
• v1.1.0 (2024-02-01): 增加Docker部署选项

注意: 部署前请确保已阅读并理解所有配置项，生产环境部署建议先在测试环境验证。

标签： AI小龙虾 OPENCLAW