openclaw部署后访问后台显示404/502或空白页，主因是后端未启动、.env缺失secret_key、postgresql未运行、nginx代理路径末尾多斜杠、静态资源未生成或allowed_hosts配置错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw部署完成后访问后台地址（如 http://localhost:8000/admin）显示 404、502 或空白页，说明后端服务未正确暴露或前端静态资源未生成。
确认后端服务是否已启动
进入部署目录，执行 docker ps 查看容器运行状态。若没有看到 openclaw-backend 或 openclaw-api 容器，说明服务根本没起来。
运行 docker logs openclaw-backend --tail 50 查看最近日志。出现 django.core.exceptions.ImproperlyConfigured: The SECRET_KEY setting must not be empty 错误，说明 【.env 文件缺失或 SECRET_KEY 未填写】，必须补全环境变量后重新启动。
如果日志中提示 Connection refused 且伴随数据库连接信息，检查 PostgreSQL 容器是否在运行 → 执行 docker ps | grep postgres → 若无输出，先启动数据库容器再重启 backend。
验证 Nginx 是否正确代理后台路径
打开部署目录下的 nginx/conf.d/openclaw.conf，确认 location 块包含如下配置：
location /admin { proxy_pass http://backend:8000/admin; }
若写成 location /admin/（末尾带斜杠），会导致 Django 的 static URL 解析失败，后台页面加载 CSS/JS 时全部 404 —— 这是常见原因，务必删除末尾斜杠。
自动备份 OpenClaw 整体配置到远程存储（支持任意 rclone 后端：COS、S3、FTP、SFTP、WebDAV等）。 触发场景： - 创建/配置自动备份任务 - 设置备份周期、保留份数、目标目录 - 手动触发备份 - 查看/恢复备份 - OpenClaw 运行异常时的提醒
修改后执行 docker exec -it openclaw-nginx nginx -s reload 重载配置。若提示 nginx: [emerg] unknown directive "proxy_pass"，说明 Nginx 镜像未启用 proxy 模块，需换用 nginx:alpine 或 nginx:mainline 官方镜像。
生成并挂载后台静态资源
OpenClaw 后台依赖 collectstatic 生成的前端资源，Docker 环境下常被忽略。
方法一：进入 backend 容器手动执行docker exec -it openclaw-backend sh → cd /app → python manage.py collectstatic --noinput
方法二：构建镜像时固化静态文件
在 Dockerfile 中 backend 构建阶段添加：RUN python manage.py collectstatic --noinput
【必须在 CMD 之前执行，否则容器启动时不生效】
方法三：挂载 host 本地 static 目录
在 docker-compose.yml 的 backend service 下添加 volumes：- ./static:/app/staticfiles
然后确保 host 上存在 ./static 目录，并提前运行过 collectstatic。
检查 Django ALLOWED_HOSTS 配置
第一步：打开 backend/settings.py 或 .env 中的 ALLOWED_HOSTS 变量。
第二步：若部署在本地测试，必须包含 127.0.0.1 和 localhost；若通过域名访问，如 claw.example.com，则 【该域名必须精确匹配，不支持通配符 *.example.com】。
第三步：重启 backend 容器使配置生效。
