控制 UI（浏览器�?

控制 UI 是一个由网关服务的小�?Vite + Lit 单页应用�?

  • 默认：http://<host>:18789/
  • 可选前缀：设�?gateway.controlUi.basePath（例�?/openclaw�?

它直接在同端口上与网�?WebSocket 通信�?

快速打开（本地）

如果网关在同一台计算机上运行，请打开�?

如果页面加载失败，请先启动网关：openclaw gateway�?

认证通过 WebSocket 握手提供�?

  • connect.params.auth.token
  • connect.params.auth.password 仪表板设置面板允许您存储令牌；密码不会持久化�? 入职向导默认生成网关令牌，因此在首次连接时请在此粘贴�?

设备配对（首次连接）

当您从新浏览器或设备连接到控�?UI 时，网关需�?一次性配对批�? �?即使您在同一 Tailnet 上且 gateway.auth.allowTailscale: true。这是防止未经授权访问的安全措施�?

*您将看到�? “disconnected (1008): pairing required”

*批准设备�?

# 列出待处理请�?
openclaw devices list

# 按请�?ID 批准
openclaw devices approve <requestId>

批准后，设备会被记住，无需重新批准，除非您使用 openclaw devices revoke --device <id> --role <role> 撤销它。请参阅设备 CLI 了解令牌轮换和撤销�?

*注意�?

  • 本地连接（127.0.0.1）会自动批准�?
  • 远程连接（LAN、Tailnet 等）需要明确批准�?
  • 每个浏览器配置文件生成唯一设备 ID，因此切换浏览器或清除浏览器数据将需要重新配对�?

现在可以做什�?

  • 通过网关 WS 与模型聊天（chat.history、chat.send、chat.abort、chat.inject�?
  • 在聊天中流式传输工具调用 + 实时工具输出卡片（代理事件）
  • 频道：WhatsApp/Telegram/Discord/Slack + 插件频道（Mattermost 等）状�?+ 二维码登�?+ 每频道配置（channels.status、web.login.*、config.patch�?
  • 实例：存在列�?+ 刷新（system-presence�?
  • 会话：列�?+ 每会话思�?详细覆盖（sessions.list、sessions.patch�?
  • 定时任务：列�?添加/编辑/运行/启用/禁用 + 运行历史（cron.*�?
  • 技能：状态、启�?禁用、安装、API 密钥更新（skills.*�?
  • 节点：列�?+ 能力（node.list�?
  • 执行审批：编辑网关或节点允许列表 + 询问 exec host=gateway/node 的策略（exec.approvals.*�?
  • 配置：查�?编辑 ~/.openclaw/openclaw.json（config.get、config.set�?
  • 配置：应�?+ 验证后重启（config.apply）并唤醒最后活动的会话
  • 配置写入包括 base-hash 防护以防止并发编辑冲�?
  • 配置模式 + 表单呈现（config.schema，包括插件和频道模式）；原始 JSON 编辑器仍然可�?
  • 调试：状�?健康/模型快照 + 事件日志 + 手动 RPC 调用（status、health、models.list�?
  • 日志：网关文件日志的实时尾部，带过滤/导出（logs.tail�?
  • 更新：运行包/git 更新 + 重启（update.run）并带重启报�?