第 11 章 OpenClaw Web 控制台详解
🖥️ 本章特色：如果你不想在命令行中操作，OpenClaw 提供了一个功能完整的 Web 控制台（Control UI），让你在浏览器中就能完成聊天、配置、会话管理等大部分操作。本章逐页拆解控制台的每一个功能模块，从首次连接的设备配对到远程访问的安全配置，让你完全掌握这个可视化管理界面。
本章目录：
| 节 | 内容 | 你将学到 |
|---|---|---|
| 1 | 什么是 Web 控制台 | Control UI 的定位、快速访问方式 |
| 2 | 首次连接：设备配对 | 安全机制、配对流程、设备管理 |
| 3 | 核心功能模块 | 聊天、通道管理、会话管理、定时任务、技能管理 |
| 4 | 配置管理与调试 | 配置编辑、调试工具、系统更新 |
| 5 | 会话状态与资源监控 | 状态栏含义、Token 消耗追踪、/status 命令 |
| 6 | 安全机制与远程访问 | 认证方式、Tailscale、远程访问方案 |
| 7 | 总结与进阶 | 核心知识回顾、课后练习 |
1. 什么是 Web 控制台
1.1 Control UI 的定位
Web 控制台（Control UI，基于浏览器的管理仪表盘） 是一个由 OpenClaw Gateway 直接提供服务的浏览器界面。它是你与 OpenClaw 交互的可视化入口，让你无需命令行就能完成日常操作。
你可以把它理解为 OpenClaw 的"驾驶舱"。命令行是工程师的高效工具，但不是每个人都习惯在终端里输入命令。Web 控制台把同样的能力用图形界面呈现出来，降低了使用门槛，同时为高级用户提供了更直观的状态监控。
┌──────────────────────────────────────────────────────┐
│ OpenClaw 的两种交互方式 │
│ │
│ 命令行（CLI） Web 控制台（Control UI） │
│ │
│ 适合： 适合： │
│ - 自动化脚本 - 日常聊天和管理 │
│ - 批量操作 - 可视化监控 │
│ - 高级配置 - 配置编辑 │
│ - 服务器环境 - 新手入门 │
│ │
│ 两种方式功能等价，可以混合使用 │
└──────────────────────────────────────────────────────┘
1.2 快速访问
如果 Gateway 运行在本机，直接在浏览器中打开：
http://127.0.0.1:18789/
或者：
http://localhost:18789/
默认端口是 18789，如果你修改过配置，请使用你设置的端口。
你也可以通过命令行快捷打开：
openclaw dashboard
这条命令会自动调用默认浏览器并跳转到控制台地址。
打开控制台后，如果是首次连接，你会看到一个配对提示。接下来看看如何处理。
2. 首次连接：设备配对
2.1 为什么需要配对
当你从新浏览器或新设备访问控制台时，可能会看到以下提示：
disconnected (1008): pairing required
这是 OpenClaw 的安全机制。控制台不是谁都能访问的，每个设备在首次连接时都需要经过"配对批准"流程。你可以把它理解为"给你的浏览器发一张通行证"。
这个机制防止了局域网内的其他设备未经授权使用你的 OpenClaw 实例。即使有人知道你电脑的 IP 地址和端口，没有经过配对批准也无法访问控制台。
2.2 配对流程
┌──────────────────────────────────────────────────────┐
│ 设备配对流程 │
│ │
│ ① 浏览器访问 http://localhost:18789 │
│ │ │
│ ▼ │
│ ② 控制台检测到新设备，显示 "pairing required" │
│ │ │
│ ▼ │
│ ③ 在命令行中执行： │
│ openclaw devices list → 查看待批准请求 │
│ openclaw devices approve <requestId> → 批准设备 │
│ │ │
│ ▼ │
│ ④ 浏览器自动刷新，连接成功 │
│ │ │
│ ▼ │
│ ⑤ 设备标识保存在浏览器本地存储中 │
│ 下次访问无需重新配对 │
└──────────────────────────────────────────────────────┘
批准步骤：
# 查看待批准的设备请求
openclaw devices list
# 按 requestId 批准设备
openclaw devices approve <requestId>
2.3 配对注意事项
关于设备配对，有几个要点需要了解：
- 🔹 本机自动批准：从本机访问（127.0.0.1 或 localhost）通常会自动批准，无需手动操作
- 🔹 浏览器绑定：每个浏览器配置文件会生成唯一的设备标识。同一个浏览器中，切换配置文件（Profile）会被视为不同设备
- 🔹 清除数据需重新配对：清除浏览器数据或切换浏览器后需要重新配对
- 🔹 设备管理：你可以随时用
openclaw devices list查看已授权的设备，用openclaw devices reject撤销不需要的访问权限
| 操作 | 命令 | 说明 |
|---|---|---|
| 查看设备列表 | openclaw devices list |
列出所有已配对和待批准的设备 |
| 批准设备 | openclaw devices approve <id> |
允许指定设备访问控制台 |
| 拒绝设备 | openclaw devices reject <id> |
拒绝指定设备的访问请求 |
| 撤销已批准设备 | openclaw devices reject <id> |
撤销已经授权的设备 |
安全建议：定期检查已授权设备列表，及时撤销不再使用的设备。如果你的电脑曾经借给他人使用，记得检查是否有陌生设备被批准过。
配对成功后，就可以正式使用控制台了。接下来逐个介绍它的核心功能模块。
3. 核心功能模块
3.1 聊天界面
聊天是控制台的主要功能区域。你可以直接与 AI 对话，通过 WebSocket 实时通信，体验和微信聊天一样自然。
聊天界面的核心特性：
- 🔹 实时流式输出：AI 的回复像打字机一样逐字显示，不需要等待完整生成
- 🔹 工具调用可视化：可以看到智能体调用了哪些工具、传入了什么参数、返回了什么结果，整个过程透明可控
- 🔹 中断运行：如果 AI 的执行方向偏离了你的预期，点击 Stop 按钮或输入
/stop即可立即停止当前任务 - 🔹 历史会话：可以查看和管理过去的对话记录，方便回顾和延续之前的讨论
3.2 通道管理
在通道管理页面，你可以查看和管理所有连接的通讯渠道。
| 功能 | 说明 |
|---|---|
| 状态总览 | 查看 WhatsApp、Telegram、Discord、Slack 等渠道的连接状态（在线/离线/错误） |
| 配对验证 | 扫码登录 WhatsApp 等需要配对验证的渠道 |
| 独立配置 | 每个渠道有独立的配置面板，可以单独调整参数 |
| 插件通道 | 支持通过插件扩展的第三方通道 |
当某个渠道显示红色错误状态时，点击它可以查看详细的错误信息和修复建议。
3.3 会话管理
会话管理页面让你查看所有活跃会话，并为每个会话做独立设置：
- 🔹 切换思维模式：为不同会话设置不同的思考深度（thinking、fast、verbose、reasoning）
- 🔹 指定模型：为单个会话指定不同的大模型，比如让某个会话专门用 Claude 写代码，另一个用通义千问处理日常对话
- 🔹 使用统计：查看每个会话的 Token 消耗、费用估算等使用情况
3.4 定时任务（Automations）
在 Web 界面中可以直接管理定时任务，无需命令行操作：
- 🔹 创建任务：通过表单界面创建新的定时任务，比命令行更直观
- 🔹 编辑和删除：修改已有任务的调度规则、载荷内容和交付方式
- 🔹 立即触发：点击"Run"按钮立即触发任务进行测试，不用等到调度时间
- 🔹 执行历史：查看每次执行的结果、耗时和输出内容
支持三种调度模式：
| 调度模式 | 说明 | 示例 |
|---|---|---|
| at | 一次性，在指定时间执行 | "今天下午 3 点提醒我开会" |
| every | 周期性，按固定间隔重复 | "每 2 小时检查一次邮箱" |
| cron | Cron 表达式，灵活调度 | "每周一到周五早上 8 点" |
定时任务的详细配置方法已在第 8 章深入讲解，控制台提供的是可视化的管理入口。
3.5 技能管理
技能管理页面让你查看和管理所有已安装的技能：
- 🔹 状态查看：查看已安装技能的启用/禁用状态、版本信息
- 🔹 启用或禁用：临时禁用某个技能而不卸载它，方便调试
- 🔹 安装新技能：从 ClawHub 技能市场浏览和安装新技能
- 🔹 更新配置：更新技能所需的 API Key 等配置参数
3.6 节点管理
节点管理页面用于查看已配对的移动设备（iOS/Android）：
- 🔹 连接状态：查看每个节点的在线/离线状态
- 🔹 能力列表：查看节点支持的能力（摄像头、屏幕录制、位置获取、通知管理等）
- 🔹 远程操作：部分操作可以直接在界面上触发，如拍照、获取位置
控制台的核心功能覆盖了日常使用的大部分场景。接下来看看配置管理和调试工具。
4. 配置管理与调试
4.1 配置编辑
控制台提供了一个浏览器内的配置编辑器，让你无需打开文件就能修改 OpenClaw 的配置。
编辑模式有两种：
| 模式 | 适合人群 | 特点 |
|---|---|---|
| 表单模式 | 大多数用户 | 可视化编辑，每个配置项有说明和输入框 |
| 原始 JSON 模式 | 高级用户 | 直接编辑 JSON 文件，适合批量修改 |
配置编辑的安全机制：
- 🔹 配置验证：编辑后可以检查配置是否正确，保存前自动校验格式
- 🔹 冲突保护：配置变更有 base-hash 保护机制，防止多人同时编辑产生冲突
- 🔹 一键重启：修改配置后可直接在界面中重启 Gateway，让变更立即生效
⚠️ 建议：如果你不确定某个配置项的含义，优先使用表单模式。表单模式会显示每个字段的说明，减少误操作的风险。原始 JSON 模式虽然灵活，但写错一个逗号就可能导致配置文件解析失败。
4.2 调试工具
遇到问题时，调试面板是你的第一站。它提供了以下诊断能力：
- 🔹 Gateway 状态：查看 Gateway 进程的运行状态和健康检查结果
- 🔹 模型列表：查看已加载的模型及其连接状态
- 🔹 事件日志：查看系统事件的时间线，追踪消息的流转路径
- 🔹 RPC 调用：手动执行内部 RPC 调用，测试特定功能是否正常
- 🔹 实时日志：实时追踪 Gateway 的运行日志，支持关键词过滤和日志导出
常见排查场景：
| 问题 | 排查方法 |
|---|---|
| AI 不回复消息 | 检查 Gateway 状态 → 查看日志中是否有错误信息 |
| 渠道连接失败 | 检查通道管理页面 → 查看该渠道的详细错误 |
| 工具调用失败 | 在聊天界面查看工具调用的详细输出 → 检查日志中的错误栈 |
| 性能异常 | 查看会话状态中的 Token 消耗 → 检查是否有过长的上下文 |
4.3 系统更新
控制台还提供了系统更新功能：
- 🔹 检查更新：一键检查是否有新版本的 OpenClaw 可用
- 🔹 执行更新：支持包更新（npm）或 Git 更新两种方式
- 🔹 自动重启：更新完成后自动重启 Gateway
- 🔹 更新报告：显示更新内容和变更日志
了解了配置和调试功能，接下来看看如何监控会话的资源消耗。
5. 会话状态与资源监控
5.1 状态栏含义
在聊天界面的底部或顶部，你会看到一个状态栏，显示当前会话的实时使用情况。以一条实际的状态栏为例：
Assistant · 11:54 · ↑18.7k · ↓77 · 2% ctx · qwen3.5-plus
每个字段的含义如下：
| 字段 | 含义 | 示例值 | 说明 |
|---|---|---|---|
| Assistant | 会话类型标识 | Assistant | 表示这是助手会话 |
| 11:54 | 会话持续时间 | 11 分 54 秒 | 从会话开始到现在的时长 |
| ↑18.7k | 上行 Tokens | 18,700 | 你发送的内容消耗的 Token 数 |
| ↓77 | 下行 Tokens | 77 | AI 回复消耗的 Token 数 |
| 2% ctx | 上下文使用率 | 2% | 当前上下文占模型窗口总量的比例 |
| qwen3.5-plus | 当前模型 | qwen3.5-plus | 当前会话使用的大模型名称 |
上下文使用率（ctx） 是一个值得关注的指标。当它接近 100% 时，说明会话的上下文窗口快满了，OpenClaw 会自动进行上下文压缩（Context Compaction），把早期的对话内容摘要化以腾出空间。如果你发现回复质量下降，可能是上下文压缩导致了信息丢失，此时可以开启新会话。
5.2 /status 命令
如果你想看更详细的会话状态（包括成本估算），可以在聊天中输入 /status 命令。输出示例：
🦞 OpenClaw 2026.3.24 (4a95717)
🧠 Model: dashscope/qwen3.5-plus
🧮 Tokens: 20k in / 384 out · 💵 Cost: $0.0000
📚 Context: 20k/1.0m (2%)
🧵 Session: agent:main:main
⚙️ Runtime: direct · Think: off · Reasoning: on
这些信息让你随时了解当前会话的资源消耗和运行状态。对于关心成本控制的用户，建议定期查看 Token 消耗情况，避免单个会话积累过多上下文导致费用飙升。
掌握了状态监控，接下来看看控制台的安全机制和远程访问方案。
6. 安全机制与远程访问
6.1 认证方式
控制台支持多种认证方式，适应不同的部署场景：
| 认证方式 | 适用场景 | 安全级别 |
|---|---|---|
| Token 认证 | 默认方式，Gateway 自动生成 | 🟢 高 |
| 密码认证 | 自定义密码登录（不持久化存储） | 🟡 中 |
| Tailscale 身份认证 | 通过 Tailscale 组网，自动认证 | 🟢 高 |
Token 认证是最常见的默认方式。Gateway 在启动时会自动生成一个 Token，你需要在浏览器中提供这个 Token 才能访问控制台。Token 保存在浏览器本地存储中，下次访问时自动携带。
Tailscale 身份认证是最安全的远程访问方式。如果你使用 Tailscale 组网，可以配置为通过 Tailscale 用户身份自动认证，无需额外的 Token 或密码。
6.2 设备身份
每个连接控制台的设备都会生成唯一的密钥对，用于标识设备身份。这意味着：
- 🔹 首次连接需要配对批准
- 🔹 密钥保存在浏览器本地存储中
- 🔹 可以随时撤销设备的访问权限
- 🔹 清除浏览器数据后需要重新配对
6.3 远程访问方案
如果你需要从外网（不在同一局域网）访问控制台，有几种方式：
| 方案 | 安全性 | 易用性 | 推荐程度 |
|---|---|---|---|
| Tailscale | 🟢 高（自动 HTTPS） | 🟢 高（零配置组网） | ⭐⭐⭐ 强烈推荐 |
| 内网穿透（frp、ngrok） | 🟡 中（取决于配置） | 🟡 中（需要额外工具） | ⭐⭐ 可用 |
| 直接暴露端口 | 🔴 低（HTTP 明文） | 🟢 高（最简单） | ❌ 不推荐 |
Tailscale 方案详解：
Tailscale 是一个基于 WireGuard 协议的零配置组网工具。安装后，你的所有设备（电脑、手机、平板）会形成一个虚拟局域网，即使它们分布在不同的物理网络中。
使用 Tailscale 访问 OpenClaw 控制台的优势：
- 🔹 自动 HTTPS：Tailscale 提供加密通道，不需要自己配置 SSL 证书
- 🔹 零配置：安装 Tailscale 客户端后，设备自动组网，无需端口转发或防火墙配置
- 🔹 身份认证：可以配置为通过 Tailscale 用户身份认证，无需额外的 Token
6.4 自定义访问路径
如果你需要将控制台挂载到其他路径下（比如反向代理场景），可以在配置中设置：
{
"gateway": {
"controlUi": {
"basePath": "/openclaw/"
}
}
}
设置后，访问 URL 变为 http://host:18789/openclaw/。这在将 OpenClaw 集成到已有的 Web 管理面板时非常有用。
7. 总结与进阶
7.1 本章核心知识回顾
OpenClaw Web 控制台是一个功能完整的浏览器仪表盘，覆盖了日常使用的大部分操作：
| 功能模块 | 核心能力 | 使用频率 |
|---|---|---|
| 聊天 | 与 AI 实时对话、工具调用可视化 | 每天 |
| 通道管理 | 查看和管理消息渠道连接状态 | 配置时 |
| 会话管理 | 切换模型、思维模式、查看统计 | 按需 |
| 定时任务 | 创建、编辑、触发、查看历史 | 按需 |
| 技能管理 | 安装、启用、禁用、配置技能 | 按需 |
| 节点管理 | 查看移动设备连接和能力 | 按需 |
| 配置编辑 | 表单或 JSON 模式编辑配置 | 偶尔 |
| 调试工具 | 日志追踪、状态检查、RPC 调用 | 排错时 |
7.2 最佳实践
- 🔹 首次使用：先通过
openclaw setup完成引导配置，系统会自动生成必要的认证信息 - 🔹 远程访问：优先使用 Tailscale（自动 HTTPS），避免直接暴露 HTTP 端口到公网
- 🔹 设备管理：定期用
openclaw devices list查看已授权设备，及时撤销不需要的 - 🔹 配置编辑：使用表单模式更安全，原始 JSON 模式适合高级用户
- 🔹 日志调试：遇到问题时先到 Debug 面板查看状态和日志，很多问题可以快速定位
7.3 课后练习
-
基础题：打开 Web 控制台，逐个浏览每个功能模块的页面。截图记录你当前有几个已连接的通道、几个活跃会话、几个已安装的技能。
-
进阶题：在控制台的状态栏中找到当前会话的上下文使用率（ctx），然后在对话中进行 5 轮深度讨论，观察 ctx 百分比的变化。在聊天中输入
/status查看详细的 Token 消耗统计。 -
思考题：假设你需要在出差时从酒店的网络远程访问家里电脑上的 OpenClaw 控制台。你会选择哪种远程访问方案？列出你的选择理由和安全注意事项。
本章完
本文为《OpenClaw 实战指南》系列第 11 篇。下一章，我们将学习 OpenClaw 的进阶配置，探索更多高级功能和优化技巧。