首页 资讯 下载 教程 Skills 社群

OpenClaw Web 控制面板使用指南

概述

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 + , 打开配置编辑器

移动端适配

控制面板采用响应式设计,在手机浏览器上也能正常操作。建议在移动端使用时将浏览器设置为桌面模式以获得更好体验。

安全注意事项

  1. 不要将控制面板直接暴露到公网:使用 Tailscale Serve 或 SSH 隧道访问
  2. 启用设备审批:防止未授权设备访问
  3. 定期检查已审批设备列表:移除不再使用的设备
# 查看所有已审批设备
openclaw devices list --approved

# 撤销设备授权
openclaw devices revoke <device-id>

故障排查

控制面板页面空白?

  • 清除浏览器缓存后重试
  • 确认 Gateway 服务正在运行
  • 检查浏览器控制台是否有 JavaScript 错误

配置保存失败?

  • 查看 Schema 校验的错误提示
  • 确认配置文件有写入权限

日志不实时更新?

  • 检查 WebSocket 连接是否正常
  • 尝试刷新页面重新建立连接