OpenClaw 部署教程：从零搭建 AI Agent 生产环境

一、环境准备

推荐配置

安装基础依赖

sudo apt update && sudo apt upgrade -y
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
sudo apt install docker-compose-plugin -y
docker --version
docker compose version

二、克隆仓库与配置

git clone https://github.com/openclaw/openclaw.git
cd openclaw
cp .env.example .env

核心配置项：

OPENAI_API_KEY=sk-xxxxxxxx
OPENAI_BASE_URL=https://api.deepseek.com/v1
POSTGRES_USER=openclaw
POSTGRES_PASSWORD=your_strong_password
POSTGRES_DB=openclaw_prod
REDIS_PASSWORD=redis_password
APP_URL=https://your-domain.com

注意：生产环境务必修改所有默认密码。

三、服务编排与启动

docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d
docker compose exec api python manage.py migrate
docker compose exec api python manage.py createsuperuser

四、配置 Nginx 反代

server {
    listen 443 ssl;
    server_name your-domain.com;
    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 300s;
    }
}

五、健康检查

docker compose ps
curl https://your-domain.com/api/health

验证清单：

• 管理后台能正常登录
• 创建测试 Agent 能收到回复
• Worker 日志无 ERROR
• 数据库连接数正常

六、需要部署协助？

如果首次部署遇到问题，LocalClaw（insman.cn） 上有多位专注 OpenClaw 部署的服务商，提供从环境搭建到后期维护的完整交付服务。

完整部署通常 2-3 小时可完成。