第 11 章 Web 界面与客户端

prev:
  text: '第10章 安全防护与威胁模型'
  link: '/cn/adopt/chapter10'
next:
  text: '附录 A：学习资源汇总'
  link: '/cn/appendix/appendix-a'​

第十一章 Web 界面与客户端

终端太硬核？本章介绍龙虾的各种图形界面——网页版、桌面版、终端 UI，总有一款适合你。

前置条件：已完成第二章 OpenClaw 手动安装，Gateway 正常运行。

0. 选一款你喜欢的方式

四种原生界面，全部连接同一个 Gateway，可以随意切换或同时使用：

不知道选哪个？ 想管配置 → Dashboard；想聊天 → WebChat；macOS 用户 → Control UI；SSH 远程 → TUI。

1. Web Dashboard（控制面板）

Dashboard 是 OpenClaw 的主力管理界面，运行在浏览器里，涵盖配置、历史对话、渠道状态、技能、定时任务等一切。

启动

openclaw dashboard
​

浏览器自动打开 http://localhost:18789，没自动打开就手动输入这个地址。

远程访问

Gateway 在远程服务器上时，用 SSH 隧道把端口转到本地（详见第九章 远程访问）：

# 在本地电脑执行
ssh -N -L 18789:127.0.0.1:18789 user@远程服务器
# 然后浏览器打开 http://localhost:18789
​

// 认证配置示例
{
  gateway: {
    auth: {
      mode: "token",             // token | password
      token: "${OPENCLAW_GATEWAY_TOKEN}",
      allowTailscale: true,      // Tailscale 设备免认证
    },
  },
}
​

{
  gateway: {
    port: 19000,   // 改为其他端口
  },
}
​

openclaw gateway --port 19000
​

2. WebChat（内置 Web 聊天）

Gateway 内置的聊天界面，零配置、开箱即用——不需要注册任何平台账号。

打开

浏览器访问 http://localhost:18789，或在 Dashboard 中点击 Chat 入口。

WebChat 最适合首次测试和技能调试。发送 /status 可快速检查 Gateway 状态。

{
  gateway: {
    http: {
      endpoints: {
        chatCompletions: { enabled: true },
      },
    },
  },
}
​

3. Control UI（macOS 桌面客户端）

macOS 专属的原生桌面应用（OpenClaw.app）：菜单栏常驻、原生通知、无需终端即可管理 Gateway。

安装

通过 AutoClaw 安装时通常已包含。也可单独安装：

brew install --cask openclaw
​

在「应用程序」中找到 OpenClaw.app，双击打开。

连接远程 Gateway

Settings → General → "OpenClaw runs" → 选 Remote over SSH → 填入服务器地址。App 自动管理 SSH 隧道，WebChat 开箱即用（详见第九章 远程访问）。

4. TUI（终端聊天）

不需要浏览器，不需要 GUI，直接在终端里聊。SSH 远程、服务器、Docker 容器——任何有终端的地方都能用。

启动

openclaw tui
​

交互模式，输入消息回车发送。或者单次发送：

openclaw agent --message "帮我写一个 Python hello world"
​

openclaw agent --message "分析这段代码的安全性" --thinking high
​

openclaw agent --message "查看今天的日程" --agent home
openclaw agent --message "审查这个 PR" --agent work
​

# 让龙虾解释一段代码
cat script.py | openclaw agent --message "解释这段代码"

# 让龙虾分析日志
openclaw logs --limit 50 --plain | openclaw agent --message "有什么异常？"
​

5. 界面选择指南

四种界面连接同一个 Gateway，可以同时用——WebChat 里的对话在 Dashboard 的 Conversations 里也能查到。

6. 常见问题

Dashboard 显示连接失败？

先确认 Gateway 在跑：openclaw gateway status，没跑就 openclaw gateway restart。

端口 18789 被占用？

# macOS / Linux
ss -tlnp | grep 18789
# Windows
netstat -ano | findstr 18789
​

换端口方法见上文"更改 Dashboard 端口"折叠块。

WebChat 发消息没有回复？

依次检查：① openclaw status 确认 Gateway 和 Agent 正常；② openclaw logs --follow 发一条消息看有无报错；③ 确认 API Key 有效（详见第五章）。

远程服务器上能用 WebChat 吗？

可以。SSH 隧道后在本地浏览器访问 http://localhost:18789；Tailscale 用户直接用 Tailscale IP 访问（详见第九章）。

Control UI 只有 macOS？

是的。Windows / Linux 用户用 Dashboard，或社区桌面客户端 ClawX。