Multi-Agent Tenant Upgrade

核心功能

agent-chat-ux 是 OpenClaw 生态系统的核心界面增强技能，将单代理聊天界面升级为完整的多代理工作空间管理系统。

主要功能模块

1. 智能代理管理系统

• 聊天头部集成代理选择器下拉菜单，支持多代理快速切换
• 每代理独立会话空间，会话列表按代理自动过滤、按时间倒序排列
• 一键新建会话按钮（+），替代 /new 命令操作

2. AI 智能创建向导

• 双模式代理创建：手动配置或自然语言描述生成
• AI Wizard 调用配置模型自动生成代理名称、表情符号及完整 SOUL.md 人格定义
• 内置 103 个精选表情符号分类选择器，支持实时预览

3. 会话历史深度查看器

• 独立模态窗口展示完整对话历史
• 支持按代理、角色（User/Assistant/System/Tool）多维过滤
• 全文搜索（300ms 防抖）+ 分页加载（100 条/页）

4. 会话标签页重构

• 友好名称替代技术密钥（如 "Cron: pipedream-token-refresh"）
• 代理身份列展示表情符号+人格名称
• CSS Grid 精确对齐布局，支持代理筛选下拉

5. 认证透明度增强（v1.5.0）

• 聊天控制栏实时显示认证模式徽章：OAuth（绿）/ API（靛蓝）/ Fallback（橙）
• 通过 auth.status RPC 读取 lastGood 配置，追溯最后成功请求使用的认证方式

6. 精细化配置管理

• 代理概览页始终可编辑：名称、表情符号、工作路径
• 多选下拉替代文本输入的回退模型配置
• 代理专属 Cron 统计（作业数、下次唤醒时间）

安全与架构设计

凭证处理：agents.wizard 遵循三层降级策略——默认配置 → api_key 类型认证档案 → 环境变量（ANTHROPIC_API_KEY/OPENAI_API_KEY），OAuth 令牌绝不会用于原始 HTTP 调用。

补丁范围：严格限定 9 个核心文件，修改前自动备份，支持 git stash 回滚。

LLM 输出验证：Wizard 生成内容强制校验 JSON 结构、字段长度限制（name≤100字符，emoji≤10字符，soul≥20字符），拒绝非结构化响应。

适用场景

• 多代理协作开发环境（主代理 + 专项子代理 + 定时任务代理）
• 需要审计追踪的敏感对话场景（认证徽章提供透明度）
• 非技术用户友好的代理管理（AI Wizard 降低配置门槛）
• 高频会话切换的客服/运维场景（智能筛选 + 历史检索）

局限性与风险

• 安装复杂度：需应用 11+ git 补丁并重建 UI/Gateway，上游版本漂移可能导致补丁冲突
• 凭证暴露风险：Wizard 后端需读取 API 密钥，虽有多层保护但需信任执行环境
• 模型依赖：AI 生成功能受配置模型能力影响，低端模型可能生成质量不足的代理定义
• 状态同步：大规模代理列表（50+）可能存在前端渲染性能瓶颈

版本演进

v1.5.0 新增认证徽章与 Pipedream/Zapier 标签页代理切换修复；v1.4.0 重构会话系统与历史查看器；v1.3.0 完善内联编辑与表情符号持久化。