问题分析
执行 OpenClaw dashboard 命令后,无法登录 Web 控制面板。经排查,原因是 OpenClaw 的 gateway 服务未正常启动。在 systemd 不可用的系统(如 FreeBSD jail)中,服务无法通过守护进程自动拉起。
状态检查
openclaw status
输出显示 Gateway service 为 systemd not installed,Gateway 连接失败:
│ Gateway │ local · ws://127.0.0.1:18789 (local loopback) · unreachable (connect failed: connect ECONNREFUSED 127.0.0.1:18789) │
│ Gateway service │ systemd not installed │
本地测试端口连通性:
curl http://localhost:18789/
# curl: (7) Failed to connect localhost port 18789 after 0 ms: Connection refused
命令说明
openclaw onboard:配置向导openclaw dashboard:显示 Web 控制面板登录信息openclaw gateway --verbose:启动网关并输出详细日志openclaw gateway start:尝试启动网关服务(依赖 systemd)
解决方案
由于系统缺少 systemd,需手动前台启动网关服务。
openclaw gateway --port 18789 --verbose
成功启动后的关键日志片段:
[gateway] ⚠️ Gateway is binding to a non-loopback address.
[gateway] listening on ws://0.0.0.0:18789 (PID ...)
[browser/server] Browser control listening on http://127.0.0.1:18791/ (auth=token)
此时即可访问 Dashboard URL 进行控制。
配置流程
1. 初始化配置
运行 onboard 命令进入配置向导:
openclaw onboard
根据提示阅读安全警告,建议基线包括 Pairing/allowlists、Sandbox + least-privilege tools 等。
2. 接入 AI 模型
选择 Custom Provider,支持任何兼容 OpenAI 或 Anthropic 的端点。可配置第三方免费模型接口。
3. 技能模块 (Skills)
安装缺失的技能依赖,如 github、obsidian 等。若无需特定功能,可选择 Skip for now。
4. 自动化 Hooks
新手用户建议启用所有四个 hooks 以获得完整自动化体验:
- boot-md
- bootstrap-extra-files
- command-logger
- session-memory
配置完成后显示 Onboarding complete。
注意事项
网络绑定警告
启动时可能收到警告:
⚠️ Gateway is binding to a non-loopback address. Ensure authentication is configured before exposing to public networks.
此情况通常因配置文件 allowedOrigins 中包含非本地地址(如内网 IP)导致。建议检查配置文件,移除不必要的公网 IP 绑定,仅保留 localhost 或 127.0.0.1 以确保安全。
安全审计
定期运行安全审计命令:
openclaw security audit --deep
openclaw security audit --fix
确保工具权限最小化,避免敏感信息泄露。


