问题原因
执行 openclaw dashboard 命令后无法登录 Web 控制面板,通常是因为 OpenClaw 的 gateway 服务未启动。常见于 systemd 服务不可用的环境(如 FreeBSD jail)。
命令说明
openclaw onboard: 配置向导openclaw dashboard: 显示 Web 控制面板登录信息openclaw gateway --verbose: 启动网关(前台模式)openclaw gateway start: 启动网关服务(依赖 systemd)
状态检查
运行 openclaw status 查看服务状态:
OpenClaw status Overview
┌─────────────────┬───────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Item │ Value │
├─────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────────┤
│ Gateway │ local · ws://127.0.0.1:18789 (local loopback) · unreachable (connect failed: connect ECONNREFUSED)│
│ Gateway service │ systemd not installed │
└─────────────────┴───────────────────────────────────────────────────────────────────────────────────────────────────┘
解决方法
由于系统缺少 systemd,需手动启动网关服务:
openclaw gateway --port 18789 --verbose
若出现 Gateway is binding to a non-loopback address 警告,请检查配置文件 openclaw.json,移除非本地地址绑定配置(如 http://192.168.1.12:18789),确保仅允许 localhost 访问。
基础配置
- Onboarding: 运行
openclaw onboard进行安全与权限配置。 - AI 模型: 选择 Custom Provider 或星河社区免费模型。
- Skills: 根据需求安装依赖(如 github, obsidian 等),新手建议 Skip。
- Hooks: 启用 hooks 以支持自动化操作(如 session-memory)。
配置完成后再次运行 openclaw gateway 即可正常访问 Web 控制面板。


