浏览器聊天界面。支持用户注册/登录、邀请制和 Persona 隔离。
需要 Server 模式。
{
"web": {
"enable": true,
"port": 8082
},
"admin": {
"token": "your-secret-token"
}
}
| 字段 | 必填 | 默认值 | 说明 |
|---|---|---|---|
enable | ✅ | false | 启用 Web 渠道 |
host | ❌ | "" | 监听地址（空 = 所有接口） |
port | ❌ | 0 | 监听端口 |
static_dir | ❌ | 自动检测 | 前端静态文件目录 |
persona_isolation | ❌ | false | 启用后每个 Web 用户的 persona 互相隔离 |
invite_only | ❌ | false | 启用后禁止自主注册，只能由管理员创建账号 |
Server 模式安装时，安装器会自动下载 Web UI 到 ~/.xbot/web/dist/。
如果需要手动安装：
# 下载对应版本的 web 压缩包并解压到 ~/.xbot/web/dist/
启动 Server 后，在浏览器中打开 http://your-server:8082。
| 方式 | 说明 |
|---|---|
| 用户名/密码 | 注册后登录，Session Cookie 有效期 30 天 |
| CLI Token | WebSocket 连接时使用 admin token |
| 飞书登录 | 通过飞书账号一键登录/关联 |
当 invite_only: true 时：
- 新用户无法自主注册（返回 403）
- 管理员可通过飞书渠道的管理命令或直接操作数据库创建账号
- 适合内部团队使用
当 persona_isolation: true 时：
- 每个 Web 用户的系统人格（persona）互相隔离
- 用户 A 设置的 Agent 行为不影响用户 B
- 适合多租户场景