【六】OpenClaw 从 TUI 切换到 Web 端完整方案

🎯 OpenClaw 从 TUI 切换到 Web 端完整方案

当前处于 OpenClaw 初始化（onboard）的「机器人孵化方式选择」步骤，已选择 TUI（终端界面），以下是切换到 Web 端的完整操作指南：

---

一、初始化阶段直接切换（未完成 TUI 配置）

如果还没走完 TUI 初始化流程，最稳妥的方式是重新执行 onboard 并选择 Web 端：

1. 终止当前 TUI 流程 ：在终端按 Ctrl + C 中断当前向导

2. 重新执行初始化 ：

   # Windows 管理员 PowerShell / Linux 终端
   openclaw onboard

3. 在「How do you want to hatch your bot?」步骤 ：

   • 选择 「Hatch in Web UI」（若未显示，按方向键切换选项）
   • 按回车确认，后续会自动生成 Web 端访问链接（默认 http://localhost:18789）

4. 浏览器访问链接：完成配置后，直接在浏览器打开对应地址即可进入 Web 管理面板

---

二、已完成 TUI 初始化，后续切换 Web 端

如果已经用 TUI 完成了初始化，无需重新配置，直接通过以下命令启动 Web 端：

步骤1：启动 OpenClaw 网关服务

# Windows / Linux 通用
openclaw gateway

• 终端会输出网关状态、Web UI 访问地址（默认 http://localhost:18789）和访问令牌

步骤2：打开 Web 控制面板

# 自动在默认浏览器打开 Web 端
openclaw dashboard

• 若浏览器未自动打开，手动访问：http://127.0.0.1:18789（或终端显示的自定义端口）
• 输入终端提供的访问令牌，即可进入 Web 管理界面，实现：
  • 可视化聊天交互
  • 网关状态监控
  • 技能/插件管理
  • 会话管理等功能

---

三、TUI 与 Web 端的核心区别

特性	TUI（终端界面）	Web UI（浏览器界面）
交互方式	纯终端命令行	图形化浏览器界面
适用场景	服务器/SSH 远程操作、无图形界面环境	本地可视化管理、调试、日常使用
启动命令	openclaw tui	openclaw dashboard
访问地址	终端内直接运行	http://localhost:18789（默认）

---

四、常见问题排查

1. Web 端访问失败

   • 确认 openclaw gateway 已正常启动（终端显示「Gateway running」）

   • 检查端口 18789 未被占用，可指定自定义端口：

     openclaw gateway --port 8889

2. 初始化时无 Web UI 选项

   • 升级 OpenClaw 到最新版：npm install -g openclaw@latest
   • 重新执行 openclaw onboard，选项会自动显示

3. TUI 与 Web 端会话同步

   • 两者共享同一个 agent:main:main 会话，TUI 发送的消息会同步到 Web 端，反之亦然

---

五、补充说明

• 你截图中的 Hatch in TUI (recommended) 是官方推荐的初始化方式，不影响后续切换 Web 端 ，TUI 仅为初始化交互界面，完成后可随时通过 openclaw dashboard 启动 Web 端
• Web 端仅支持本地访问，若需远程访问需额外配置端口转发/反向代理（不建议公网直接暴露）