🚀 OpenClaw (CloudBot) 终极国内部署教程：自定义聚合 API 接入、PM2 保活与飞书协同全指南

# 填入你聚合平台的 API Key
OPENAI_API_KEY=sk-你的聚合平台密钥

# 填入反向代理节点地址，请确保以 /v1 结尾。
# 若主节点波动，可随时切换为备用节点（例如 https://sg.uiuiapi.com/v1）
OPENAI_BASE_URL=https://api1.uiuiapi.com/v1

# 指定默认调用的主力模型
OPENAI_MODEL=gpt-5.2

server {
    listen 443 ssl http2;
    server_name api1.uiuiapi.com sg.uiuiapi.com; # 你的聚合 API 域名

    # ... 这里是你的 SSL 证书配置 ...

    location / {
        # 假设你的后端服务跑在本地 3000 端口
        proxy_pass http://127.0.0.1:3000; 

        # ==========================================
        # 1. 核心：关闭代理缓冲，确保流式输出 (SSE) 实时打字机效果
        # ==========================================
        proxy_buffering off;
        proxy_cache off;

        # ==========================================
        # 2. 核心：大幅延长超时时间，防止长文本生成时 504 超时
        # ==========================================
        # 与后端建立连接的超时时间
        proxy_connect_timeout 300s; 
        # 向后端发送请求的超时时间
        proxy_send_timeout 300s;    
        # 从后端读取响应的超时时间 (最关键，AI 思考时间长就靠它)
        proxy_read_timeout 300s;    

        # ==========================================
        # 3. HTTP/1.1 与长连接支持 (WebSocket / SSE 必备)
        # ==========================================
        proxy_http_version 1.1;
        proxy_set_header Connection "keep-alive";
        # 保持连接不被网关主动掐断
        proxy_set_header Keep-Alive "timeout=300";

        # ==========================================
        # 4. 传递真实 IP 与标准 Header，防止 Invalid URL Prefix 等路由错误
        # ==========================================
        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;
        
        # 如果你之前遇到过严格的跨域限制，可以加上 CORS 头 (按需开启)
        # add_header 'Access-Control-Allow-Origin' '*';
        # add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
        # add_header 'Access-Control-Allow-Headers' 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization';
    }
}

#!/bin/bash

echo "正在加载环境变量..."
if [ -f .env ]; then
  # 读取 .env 文件并导出为环境变量
  export $(grep -v '^#' .env | xargs)
  echo "配置加载成功，当前请求节点为: $OPENAI_BASE_URL"
else
  echo "警告：未找到 .env 文件，请检查路径！"
fi

echo "正在启动 OpenClaw..."
cloudbot gateway

chmod +x start_cloudbot.sh

npm install -g pm2

pm2 start ./start_cloudbot.sh --name "openclaw"

# 1. 生成自启脚本（执行后需复制终端输出的 sudo 命令并再次执行）
pm2 startup

# 2. 保存当前运行列表，写入自启项
pm2 save

# 1. 安装飞书官方插件
cloudbot plugin install @openclaw/feishu

# 2. 填入刚才获取的飞书 App ID
cloudbot config set feishu.appId "你的飞书App_ID"

# 3. 填入刚才获取的飞书 App Secret
cloudbot config set feishu.appSecret "你的飞书App_Secret"

# 4. 强制使用 WebSocket 长连接模式（国内免内网穿透最佳方案）
cloudbot config set feishu.connectionType "websocket"