问题现象
执行 openclaw dashboard 命令后，无法登录 Web 控制面板。
状态检查
OpenClaw status Overview
┌─────────────────┬───────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Item │ Value │
├─────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────────┤
│ Dashboard │ http://192.168.1.12:18789/ │
│ OS │ linux 5.15.0 (x64) · node 24.12.0 │
│ Gateway │ local · ws://127.0.0.1:18789 (local loopback) · unreachable (connect failed: connect ECONNREFUSED)│
│ Gateway service │ systemd not installed │
└─────────────────┴───────────────────────────────────────────────────────────────────────────────────────────────────┘
错误日志
curl http://localhost:18789/
curl: (7) Failed to connect to localhost port 18789 after 0 ms: Connection refused
原因分析
OpenClaw 的 gateway 服务未启动。在部分虚拟机或 FreeBSD jail 环境中，由于 systemd 不可用，导致服务无法自动拉起。
尝试启动显示：
openclaw gateway start
# Gateway service disabled. Start with: openclaw gateway install
# systemd user services are unavailable; install/enable systemd or run the gateway under your supervisor.
解决方法
手工启动 gateway 进程：
openclaw gateway --port 18789 --verbose
成功启动后，Gateway 监听地址为 ws://0.0.0.0:18789。
注意事项
启动时可能收到如下警告：
Gateway is binding to a non-loopback address. Ensure authentication is configured before exposing to public networks.
这是因为配置了非本地地址访问。若需限制安全，请移除配置文件中的公网 IP 白名单项。
配置 Onboard
使用 openclaw onboard 进行初始化配置，包括 AI 模型 Provider 和 Skill 安装。新手建议启用 Hooks 以获得完整自动化体验。
最终验证
再次执行 openclaw gateway 即可正常浏览控制面板。
