审批 UI

一个用于管理 OpenClaw 设备配对、频道审批以及实时终端的网页控制台——全部可通过浏览器完成。

安装

将本文件夹放置于以下路径：

~/.openclaw/workspace/projects/p1

你的文件结构应如下所示：

~/.openclaw/workspace/projects/p1/
├── SKILL.md
├── server.py
└── templates/
    ├── channel_approvals.html
    ├── dashboard.html
    ├── device_pairings.html
    ├── index.html
    ├── login.html
    └── terminal.html

依赖要求

安装 Python 依赖项：

pip install flask flask-socketio

⚠️ 重要提示 — 运行前请务必修改以下配置

该技能默认附带占位凭证（placeholder credentials），你必须在使用前进行修改：

打开 server.py 文件，并在文件顶部附近更新以下变量值：

示例：

export FLASK_SECRET_KEY="$(python3 -c 'import secrets; print(secrets.token_hex(32))')"
export SERVER_AUTH_PASSWORD="your-strong-api-password-here"

切勿使用默认配置运行。 任何知晓默认凭证的人都可登录并访问你的终端及网关 token。

凭证说明

本系统包含两层独立的身份认证机制：

1. 控制台登录认证（ADMIN_USERNAME / ADMIN_PASSWORD）—— 保护 Web UI 页面（控制台、设备配对、频道审批、终端）。
2. API 密码认证（AUTH_PASSWORD / 环境变量 SERVER_AUTH_PASSWORD）—— 保护后端 API 接口（/pair、/sync、/approve），供程序化调用。这些接口未在 Web UI 中暴露，专为自动化脚本设计。

两项凭证均应设为高强度且互不相同的值。

使用方法

启动服务：

cd ~/.openclaw/workspace/projects/p1
python3 server.py

随后在浏览器中打开 http://127.0.0.1:9100。

功能特性

• 控制台（Dashboard） —— 首页，提供快速跳转至所有功能模块的导航入口。
• 设备配对（Device Pairings） —— 查看待处理与已配对的浏览器/设备连接；批准或拒绝配对请求；一键复制网关 token 到剪贴板。
• 频道审批（Channel Approvals） —— 审核并批准待处理的频道配对请求（Telegram、Discord、WhatsApp 等）；通过 Socket.IO 实现实时更新。
• 终端（Terminal） —— 基于 xterm.js 的全交互式浏览器终端会话。

工作原理

• 直接读取 ~/.openclaw/devices/pending.json 和 ~/.openclaw/devices/paired.json 获取设备配对状态。
• 从 ~/.openclaw/credentials/*-pairing.json 读取频道配对请求。
• 从 ~/.openclaw/openclaw.json → gateway.auth.token 提取网关 token。
• 审批/拒绝操作通过调用 openclaw devices approve 和 openclaw devices reject CLI 命令实现。
• 无需外部数据库 —— 所有数据均来自 OpenClaw 自身的状态文件。

安全须知

• 仅限本地访问 —— 服务默认绑定到 127.0.0.1。除非你将其置于具备 TLS 加密与强身份认证的反向代理之后，否则请勿更改为 0.0.0.0。
• 终端访问权限 —— 终端功能提供对本机的完整 Shell 访问权限。如无需此功能，可移除 /terminal 路由及 terminal.html 模板。
• 敏感文件读取 —— 应用会读取你的 openclaw.json（含网关 token）、设备配对文件及凭证配对文件。任何能访问 Web UI 的用户均可查看这些数据。
• API 接口保护 —— POST /pair、POST /sync 和 POST /approve 接口接收含 password 字段的 JSON 请求。这些接口受 AUTH_PASSWORD 保护，专为脚本/自动化调用设计，不面向 Web UI 开放。

配置项

标签

ui dashboard pairings approvals terminal web