【七】Web 端初始化配置的详细步骤

以下是针对 Ubuntu 24.04.2 桌面版（或 Windows WSL2）的完整操作指南，确保你能顺利从 TUI 切换并流畅使用 Web 端。

Web 端必须依赖 Gateway（网关服务） 才能连接，先启动服务。

打开新终端 ：
保持当前配置终端不开，另开一个新的 PowerShell/Terminal。
启动网关 ：
bash 复制代码
```
openclaw gateway
```
成功标志 ：
看到 ✅ Gateway running on http://0.0.0.0:18789 或类似输出，说明服务已就绪。不要关闭此终端！

如果刚完成 TUI 安装，直接重新运行配置向导：

执行初始化 ：
bash 复制代码
```
openclaw onboard
```
关键选择 ：
当出现 How do you want to hatch your bot? 时：
- 按方向键 ↓ 选中 Hatch in Web UI（不要选 TUI）。
- 按回车确认。
关联 AI 模型 ：
按照提示填入你的 API Key（如 OpenAI、Claude 等），系统会自动在后台生成配置文件。

打开浏览器 ：
在本地浏览器输入地址：
http://localhost:18789
(注意：端口默认是 18789，如果被占用，启动网关时终端会显示具体端口号)
输入授权码 ：
首次访问会要求输入 Token，直接复制终端启动日志（openclaw gateway 输出）中的 Access Token 粘贴即可。
核心功能体验 ：
- 对话界面：支持 Markdown 渲染、代码高亮、图片预览。
- Agent 管理：在 Web 端可以更轻松地配置 Skills（技能）和插件。
- 状态监控：实时查看网关连接状态和资源占用。

如果启动时提示端口被占，改用自定义端口：

bash 复制代码

# 例如使用 8899 端口
openclaw gateway --port 8899

浏览器访问：http://localhost:8899

现在你可以直接启动 openclaw gateway 然后在浏览器访问对应端口，享受全图形化的操作体验了！