用命令行把脉

在打开浏览器之前，我们先回到熟悉的终端（Terminal），用一句简单的命令给系统做个“体检”。
这一步至关重要，能帮你排除 90% 的连接故障。
在终端输入：

openclaw doctor

这个命令就像医生查房，会自动检查一系列关键指标。
它会检查 Node.js 版本是否满足要求 ( >= 22 )、必要的系统依赖是否已安装、Gateway 连接是否正常、已配置的模型 API Key 是否有效、守护进程状态以及网络连通性。
如果所有检查都通过，你会看到一片赏心悦目的绿色“OK”。
如果出现红叉，别慌，根据提示修复即可。
确认无误后，我们可以再明确地启动或查看 Gateway 状态：

openclaw gateway start
openclaw gateway status

当你看到 Gateway: running 或者类似的提示时，恭喜你，这只“龙虾”的心脏开始跳动了。

打开 Web UI，看见它的脸

Gateway 在后台默默工作，我们需要一个界面来和它交互。
OpenClaw 内置了 Web UI，启动 Gateway 后可在浏览器中访问管理界面。

$ openclaw dashboard

默认情况下，OpenClaw Gateway 监听 18789 端口。

重要提示：如果你使用的是 v2026.3.7 及以上的版本，首次访问 Web UI 可能会遇到强制认证的要求。这是因为最新版本引入了一个 Breaking Change：Gateway 认证现在要求显式设置 gateway.auth.mode。
你必须明确选择 token 或 password 认证方式，不再有“无认证”的默认选项。这是为了修复此前暴露在互联网上的 30,000+ 未认证实例的安全隐患。
如果你没有在配置文件中设置认证，Gateway 将拒绝启动。解决方法是在 openclaw.json 中添加认证配置：