OpenClaw Dashboard 无法登录:systemd 缺失导致 Gateway 服务未启动
解决 OpenClaw Dashboard 无法登录的问题。原因是 systemd 服务不可用(如 FreeBSD jail),导致 Gateway 服务未启动。解决方法是手动执行 openclaw gateway 命令并指定端口和详细模式。此外介绍了 onboard 配置流程及安全警告。

解决 OpenClaw Dashboard 无法登录的问题。原因是 systemd 服务不可用(如 FreeBSD jail),导致 Gateway 服务未启动。解决方法是手动执行 openclaw gateway 命令并指定端口和详细模式。此外介绍了 onboard 配置流程及安全警告。


微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
执行 openclaw dashboard 命令后无法登录 Web 控制面板,通常是因为 OpenClaw 的 Gateway 服务没有启动。在 systemd 不可用的环境(如 FreeBSD jail)中尤为常见。
openclaw onboard: 配置向导openclaw dashboard: 显示 Web 控制面板登录信息openclaw gateway --verbose: 启动网关并输出详细日志openclaw gateway start: 尝试启动网关服务(依赖 systemd)运行状态检查时,Gateway 显示 unreachable:
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 │
│ Gateway service │ systemd not installed │
└─────────────────┴───────────────────────────────────────────────────────────────────────────────────────────────────┘
本地测试连接失败:
curl http://localhost:18789/
curl: (7) Failed to connect to localhost port 18789 after 0 ms: Connection refused
尝试手动启动网关提示服务禁用或 systemd 不可用:
openclaw gateway start
# Output: Gateway service disabled... systemd user services are unavailable...
该机器运行在 FreeBSD jail 环境中,没有安装 systemd,导致 openclaw gateway start 无法通过系统服务管理启动进程。
使用以下命令直接在前台启动网关,指定端口和详细模式:
openclaw gateway --port 18789 --verbose
成功启动后的关键日志示例:
[gateway] listening on ws://0.0.0.0:18789 (PID 98100)
[websocket] ← open remoteAddr=192.168.1.2
启动时可能收到警告:
⚠️ Gateway is binding to a non-loopback address. Ensure authentication is configured before exposing to public networks.
这是因为配置文件中的 allowedOrigins 包含了局域网 IP。若需移除该限制,可编辑配置文件,删除类似 http://192.168.1.12:18789 的条目。
完成基础配置流程:
openclaw onboard
按提示完成以下步骤:
配置完成后,即可使用 Dashboard 链接控制 OpenClaw。
openclaw security audit --deep 检查安全性。