概述
OpenClaw 自带一个基于 Vite + Lit 构建的单页应用(SPA)Web 控制面板,提供图形化的管理和交互界面。本文将逐一介绍控制面板的核心功能。
访问控制面板
本地访问
控制面板运行在 Gateway 的同一端口上,默认地址:
http://127.0.0.1:18789
在浏览器中打开即可访问。
通过 Tailnet 访问
如果已配置 Tailscale Serve,可以从 Tailnet 内的其他设备访问:
https://your-machine.tail-xxxxx.ts.net
详见 Tailscale 远程访问教程。
设备配对审批
首次从新设备访问控制面板时,需要完成配对审批流程:
# 查看待审批的设备列表
openclaw devices list
# 审批指定设备
openclaw devices approve <device-id>
设备审批后,后续访问无需重复验证。
核心功能
聊天界面
控制面板提供完整的聊天交互界面,支持流式响应:
- 实时显示 AI 回复(流式传输)
- 支持 Markdown 渲染
- 代码块语法高亮
- 消息历史浏览
频道管理
可视化管理所有已配置的频道:
控制面板 → 频道管理
├── 查看各频道连接状态
├── 启用/禁用频道
├── 编辑频道配置
└── 查看频道消息统计
支持的操作:
- 查看频道实时连接状态(在线/离线/错误)
- 一键启用或禁用指定频道
- 在线编辑频道参数
会话跟踪
监控所有活跃会话的状态:
- 查看当前活跃会话数量
- 每个会话的消息数和最后活跃时间
- 会话的作用域和关联频道
- 手动重置指定会话
定时任务调度(Cron)
通过控制面板管理定时任务:
控制面板 → 定时任务
├── 查看所有已配置的 Cron 任务
├── 创建新任务(支持 Cron 表达式)
├── 查看任务执行历史
└── 手动触发任务运行
技能管理
浏览和管理已安装的技能插件:
- 查看所有可用技能及状态
- 启用/禁用指定技能
- 查看技能的门控条件是否满足
- 管理 ClawHub 安装的第三方技能
配置编辑
控制面板内置了带 Schema 校验的配置编辑器:
控制面板 → 配置
├── 可视化编辑 openclaw.json
├── Schema 校验(实时提示错误)
├── 自动补全配置字段
└── 保存前预览变更差异
Schema 校验能在保存前发现配置错误,避免因配置问题导致服务异常。
实时日志流
控制面板支持实时日志流查看,无需登录服务器:
控制面板 → 日志
├── 实时滚动日志输出
├── 按级别过滤(debug/info/warn/error)
├── 关键词搜索
└── 日志导出
健康监控
集中查看系统健康状态:
- Gateway 运行时间和资源使用
- 各频道连接状态汇总
- 模型 API 响应延迟
- 内存和 CPU 使用趋势
界面操作技巧
快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl + K |
快速搜索/命令面板 |
Ctrl + L |
清空当前聊天 |
Ctrl + , |
打开配置编辑器 |
移动端适配
控制面板采用响应式设计,在手机浏览器上也能正常操作。建议在移动端使用时将浏览器设置为桌面模式以获得更好体验。
安全注意事项
- 不要将控制面板直接暴露到公网:使用 Tailscale Serve 或 SSH 隧道访问
- 启用设备审批:防止未授权设备访问
- 定期检查已审批设备列表:移除不再使用的设备
# 查看所有已审批设备
openclaw devices list --approved
# 撤销设备授权
openclaw devices revoke <device-id>
故障排查
控制面板页面空白?
- 清除浏览器缓存后重试
- 确认 Gateway 服务正在运行
- 检查浏览器控制台是否有 JavaScript 错误
配置保存失败?
- 查看 Schema 校验的错误提示
- 确认配置文件有写入权限
日志不实时更新?
- 检查 WebSocket 连接是否正常
- 尝试刷新页面重新建立连接