安装可能出现的主要问题
| 问题 | 原因 | 解决方案 |
|---|---|---|
| Control UI 无法访问 | 返回 "Control UI assets not found" | 配置 gateway.controlUi.root 指向正确的静态文件目录 |
| OpenClaw 服务启动失败 | systemd 服务配置中的版本号与实际安装版本不匹配 (2026.3.11 vs 2026.3.13) | 更新 ~/.config/systemd/user/openclaw-gateway.service 中的版本号 |
| 设备配对问题 | 浏览器访问时提示 "pairing required" | 使用 openclaw devices approve --latest 或 openclaw devices approve <requestId> 批准配对请求 |
升级后出现无法访问控制后台的情况
** Systemd 服务文件 (~/.config/systemd/user/openclaw-gateway.service)**
- 将版本号从
2026.3.11更新为2026.3.13 - 更新
ExecStart路径中的版本号
有用的命令
# 查看设备配对状态
openclaw devices list# 批准最新的配对请求
openclaw devices approve --latest# 批准指定 ID 的配对请求
openclaw devices approve <requestId># 重启网关服务
openclaw gateway restart# 查看网关日志
openclaw logs --limit 50
经验总结
- 设备配对是安全机制，首次访问需要通过 CLI 批准配对请求
- Nginx 配置是正确的，SSL 证书和反向代理都工作正常