OpenClaw Web控制面板使用指南

前言

OpenClaw 提供了一个内置的 Web Dashboard，让你可以通过浏览器直观地管理和监控 AI 网关的方方面面。从实时对话到系统状态，从配置调整到设备管理，Dashboard 是日常运维中最常用的工具。本文将完整介绍 Dashboard 的各项功能和使用方法。

启动 Dashboard

Dashboard 有两种启动方式：

随网关自动启动

当你启动 OpenClaw 网关时，Dashboard 默认同时启用：

openclaw gateway --port 18789
# Dashboard 已在 http://localhost:18789/dashboard 可用

独立启动

你也可以单独启动 Dashboard 服务：

openclaw dashboard
# 默认在 http://localhost:18789/dashboard 启动

openclaw dashboard --port 8080
# 指定自定义端口

访问与认证

在浏览器中打开 Dashboard 地址后，如果配置了密码，你需要先完成认证：

{
  "gateway": {
    "dashboardPassword": "your-strong-password"
  }
}

输入密码后，Dashboard 会生成一个会话 Token，在浏览器关闭前保持登录状态。

生产环境中强烈建议设置密码，尤其是当 host 配置为 "0.0.0.0" 时。

主页面：概览

登录后首先看到的是概览页面，它以卡片形式展示系统的核心状态：

状态卡片

运行时间：网关已运行的时长
活跃频道：当前已连接的即时通讯频道数量及名称
今日消息：当天处理的消息总数
活跃会话：当前有活跃对话的用户数
模型状态：各模型提供商的可用性和响应延迟
系统资源：CPU、内存占用情况

实时消息流

概览页面底部是一个实时消息流，显示所有频道的最新消息。你可以按频道或用户过滤，方便实时监控 AI 的回复质量。

会话管理

Dashboard 的会话管理功能是日常使用最频繁的模块。

会话列表

左侧面板列出所有活跃和历史会话，按最近活跃时间排序。每个会话条目显示：

用户名称和头像（如有）
来源频道图标
最后一条消息的摘要
最后活跃时间

对话界面

点击某个会话后，右侧显示完整的对话内容。你可以在这里：

阅读历史：滚动查看完整的对话记录
直接对话：以 AI 助手的身份发送消息（用于测试或人工接管）
查看分支：树形会话中的分支以可视化方式展示，点击分支节点可以切换查看
删除消息：删除指定的消息及其所有子节点
导出对话：将当前会话导出为 JSON 或纯文本格式

新建对话

你也可以在 Dashboard 中直接开始与 AI 对话，用于快速测试配置效果：

点击"新建对话"按钮
选择目标 Agent
开始输入消息

Dashboard 对话的会话数据存储在 web_dashboard.jsonl 文件中。

频道监控

频道监控页面展示所有已配置频道的详细状态：

信息项	说明
连接状态	在线 / 离线 / 重连中
最后心跳	最近一次心跳时间
消息统计	今日收发消息数
错误计数	最近 24 小时的错误次数
延迟	消息处理平均延迟

对于出现问题的频道，你可以点击"重新连接"按钮尝试重连，或点击"查看日志"查看该频道的详细日志。

Agent 管理

如果你配置了多个 Agent，Dashboard 提供了可视化的 Agent 管理界面：

查看 Agent 列表：所有已配置 Agent 的概览
编辑 Agent：修改 Agent 的名称、模型、系统提示词等配置
查看统计：每个 Agent 的消息量、活跃用户数、平均响应时间
路由规则：查看和编辑多 Agent 路由配置

在 Dashboard 中修改的配置会自动写回 openclaw.json，无需手动编辑文件。

模型测试

模型测试（Playground）页面让你在不经过任何频道的情况下直接与模型对话：

选择模型提供商和具体模型
自定义系统提示词和参数（temperature、maxTokens 等）
上传图片测试视觉能力
查看原始 API 请求和响应

这个功能在调试模型配置、对比不同模型的回复质量时非常有用。

设备管理

设备管理页面用于管理已配对的移动设备：

查看设备列表：所有已配对设备的名称、平台、最后活跃时间
生成配对码：点击按钮生成新的配对码或二维码
移除设备：撤销设备的访问权限
推送测试：向指定设备发送测试推送通知

日志查看

Dashboard 内置了一个日志查看器，支持：

实时跟踪：类似 tail -f 的实时日志流
级别过滤：按 debug、info、warn、error 过滤
搜索：全文搜索日志内容
时间范围：选择查看特定时间段的日志

配置编辑器

Dashboard 提供了一个在线配置编辑器，可以直接修改 openclaw.json：

语法高亮和自动补全
保存前自动验证配置合法性
一键热重载（无需重启网关）
修改历史记录，可以回滚到之前的版本

# 热重载也可以通过命令行触发
openclaw reload

系统信息

系统信息页面展示 OpenClaw 的运行环境：

OpenClaw 版本号
Node.js 版本
操作系统信息
配置文件路径
数据目录大小
已加载的技能列表
MCP Server 连接状态

Dashboard 配置选项

你可以在 openclaw.json 中自定义 Dashboard 的行为：

{
  "gateway": {
    "dashboard": {
      "enabled": true,
      "path": "/dashboard",
      "theme": "auto",
      "language": "zh-CN",
      "refreshInterval": 5000,
      "maxLogLines": 1000
    }
  }
}

参数	说明
`path`	Dashboard 的 URL 路径
`theme`	主题：`auto`、`light`、`dark`
`language`	界面语言
`refreshInterval`	数据刷新间隔（毫秒）
`maxLogLines`	日志查看器最大行数

移动端访问

Dashboard 采用响应式设计，可以在手机浏览器中正常使用。你也可以将 Dashboard 添加到手机桌面作为 PWA（渐进式 Web 应用）使用，获得接近原生应用的体验。

在 iOS Safari 中：点击分享按钮 → 添加到主屏幕。在 Android Chrome 中：点击菜单 → 安装应用。

安全建议

始终设置 dashboardPassword
如果从公网访问，务必启用 HTTPS
定期检查设备管理页面，移除不再使用的设备
考虑使用反向代理（Nginx/Caddy）添加额外的访问控制

总结

OpenClaw 的 Web Dashboard 是一个功能全面的管理界面，涵盖了从实时监控到配置编辑的所有运维需求。它让你无需记忆命令行参数，就能直观地管理 AI 网关的各个方面。建议将 Dashboard 作为日常管理的主要入口，配合命令行工具处理自动化和批量操作。