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

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

一、 前置准备：确保服务正常运行

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

1. 打开新终端：
   保持当前配置终端不开，另开一个新的 PowerShell/Terminal。
2. 启动网关：

   openclaw gateway
   

3. 成功标志：
   看到 ✅ Gateway running on http://0.0.0.0:18789 或类似输出，说明服务已就绪。不要关闭此终端！

二、 初始化配置（Web 端专属）

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

1. 执行初始化：

   openclaw onboard
   

2. 关键选择：
   当出现 How do you want to hatch your bot? 时：
   • 按方向键 ↓ 选中 Hatch in Web UI（不要选 TUI）。
   • 按 回车 确认。
3. 关联 AI 模型：
   按照提示填入你的 API Key（如 OpenAI、Claude 等），系统会自动在后台生成配置文件。

三、 登录与使用 Web 控制面板

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

四、 常见问题速查（保姆级排障）

1. 端口占用报错

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

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

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

2. Web 端打不开/超时

• 检查网关：确认 openclaw gateway 终端是否在运行，未运行则无法访问。
• 检查防火墙：Ubuntu 下允许端口：

  sudo ufw allow 18789
  

• WSL2 用户：需使用 WSL2 的 IP 访问，或直接用 localhost。

3. 配置丢失/命令找不到

• 回到之前的解决步骤，确保安装时选择了 Yes (Yes to all)，保证全局环境变量写入。
• 验证：运行 openclaw --version 能显示版本号即正常。

五、 快捷操作总结

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

如何联系我

• 给我发邮件：code_captain@163.com，并说明来意；
• 评论区留言；