小智资讯百科 OpenClaw OpenClaw WebUI 控制界面使用指南

OpenClaw WebUI 控制界面使用指南

什么是 OpenClaw Control UI

OpenClaw Control UI 是一个 Web 界面,让你通过浏览器管理 OpenClaw,不用敲命令行。它运行在 Gateway 服务上,默认地址是 http://localhost:18789/

如何打开 WebUI

本地访问

如果 Gateway 在同一台电脑上运行,访问很简单:

  1. 确保 Gateway 在运行。没有的话,执行:
openclaw gateway
  1. 打开浏览器,访问:
  • http://127.0.0.1:18789/
  • 或 http://localhost:18789/
  1. 第一次连接需要输入认证信息:
  • Token:Gateway token(onboarding 向导生成的,或者手动创建)
  • Password:Gateway 密码(临时用的,关闭浏览器后失效)

远程访问

想在其他设备上访问,有两种方式:

用 Tailscale Serve(推荐)

这种方式最安全,提供 HTTPS 加密。

  1. 启动 Gateway 时启用 Tailscale Serve:
openclaw gateway --tailscale serve
  1. 浏览器打开:
  • https://<你的-tailscale-节点名>/

绑定到 Tailnet + Token

不想用 Tailscale Serve 的话,可以直接绑定 tailnet:

  1. 启动 Gateway:
openclaw gateway --bind tailnet --token "$(openssl rand -hex 32)"
  1. 浏览器打开:
  • http://<你的-tailscale-ip>:18789/
  1. 在 UI 设置里粘贴生成的 token。

设备配对

从新浏览器或设备连接时,需要配对。如果看到 “disconnected (1008): pairing required”,这样做:

  1. 列出待批准请求:
openclaw devices list
  1. 批准设备:
openclaw devices approve <requestId>
  1. 刷新浏览器页面。

本地连接(127.0.0.1)会自动批准。远程连接需要手动批准。换个浏览器或清除了浏览器数据后需要重新配对。

WebUI 能做什么

聊天

  • 和模型实时对话
  • 看工具调用和输出
  • 可以中止正在运行的对话

渠道管理

  • WhatsApp/Telegram/Discord/Slack 状态管理
  • 二维码登录
  • 渠道配置

会话管理

  • 看会话列表
  • 设置 thinking/verbose 模式

定时任务

  • 添加、编辑、运行、启用/禁用定时任务
  • 查看历史记录

技能管理

  • 启用/禁用技能
  • 安装技能
  • 更新 API 密钥

节点管理

  • 看已配对的节点

配置管理

  • 编辑配置文件 ~/.openclaw/openclaw.json
  • 应用配置并重启

日志和调试

  • 看实时日志
  • 导出日志
  • 手动 RPC 调用

更新

  • 运行更新并重启

如何关闭 WebUI

临时关闭

想暂停访问但保持 Gateway 运行:

撤销已配对的设备:

openclaw devices revoke --device <id> --role <role>

或者编辑配置文件,改 bind 设置。

永久关闭

完全停止 Gateway:

openclaw gateway stop

或者如果 Gateway 在前台运行,按 Ctrl+C

安全注意事项

HTTP vs HTTPS

用纯 HTTP 打开仪表板(比如 http://<lan-ip>),浏览器会在非安全上下文运行,会阻止 WebCrypto。默认情况下,OpenClaw 会阻止没有设备身份的连接。

推荐:

  • 用 HTTPS(Tailscale Serve)
  • 或在本地打开(http://127.0.0.1:18789/)

配置选项

如果必须在不安全的 HTTP 环境里用,可以改配置:

允许不安全认证:

{
  "gateway": {
    "controlUi": { "allowInsecureAuth": true },
    "bind": "tailnet",
    "auth": { "mode": "token", "token": "replace-me" }
  }
}

禁用设备身份验证(危险):

{
  "gateway": {
    "controlUi": { "dangerouslyDisableDeviceAuth": true },
    "bind": "tailnet",
    "auth": { "mode": "token", "token": "replace-me" }
  }
}

dangerouslyDisableDeviceAuth 会关闭设备身份检查,安全风险很大。紧急用完后赶紧改回来。

总结

OpenClaw Control UI 让管理 OpenClaw 更方便。本地访问直接去 http://localhost:18789/,远程访问推荐用 Tailscale Serve。记得用 HTTPS,保护好 token。

上一篇
下一篇

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

返回顶部