Agent Chat UX 技能评估
核心功能
agent-chat-ux 是一套面向 OpenClaw 控制面板的用户体验增强技能，专注于优化智能体（Agent）管理与聊天交互流程。
主要功能模块
1. 聊天界面增强
- 智能体选择器：当配置多个智能体时，在会话下拉框左侧显示智能体切换菜单
- 按智能体筛选会话：自动过滤仅显示当前选中智能体的会话，按时间倒序排列
- 新建会话按钮：聊天头部右侧添加
+按钮，一键创建新会话（替代/new命令）
2. 智能体创建面板（双模式）
- 手动模式：填写名称、工作空间路径、从 60 个分类 Emoji 中选择图标
- AI 向导模式：用自然语言描述智能体，调用 LLM 自动生成名称、Emoji 和完整 SOUL.md 配置
3. 模型选择器优化
- 移除 Overview 中冗余的只读"主模型"行
- 降级模型从文本输入改为多选下拉框，支持 Ctrl/⌘ 多选
4. 后端 CRUD 方法
agents.create：配置入库 + 工作空间脚手架（SOUL.md、AGENTS.md、USER.md）agents.update/agents.delete：标准更新删除agents.wizard：调用 Anthropic/OpenAI API 生成智能体配置
安全与透明度
| 维度 | 评估 |
|------|------|
| 凭证访问 | `agents.wizard` 按优先级读取 API key：默认配置 → auth profile store → 环境变量（`ANTHROPIC_API_KEY`/`OPENAI_API_KEY`） |
| 外部调用 | 仅向 `api.anthropic.com` 或 `api.openai.com` 发送单条 POST，携带用户描述，无系统信息泄露 |
| 补丁范围 | 严格限定 6 个 agent 相关文件，不涉及 Discord 等无关模块 |
| 输出验证 | LLM 返回 JSON 经结构校验（name≤100字符、emoji≤10字符、soul≥20字符），非法响应拒绝并提示用户 |
| 持久化变更 | 使用 `git apply` 修改源码，需重建 UI 和 gateway，建议操作前备份 |
显著优点
- 工作流闭环：创建智能体后自动刷新列表和配置表单，消除"not found in config"错误
- 多智能体场景优化：会话隔离避免不同智能体的 cron 任务和子智能体会话混杂
- AI 辅助配置：降低 SOUL.md 编写门槛，适合快速原型
- UI 细节完善：Emoji 分类选择器、模型多选降级等提升易用性
局限性与注意事项
- 源码侵入性：必须打补丁并重建，不适合无法修改部署环境的用户
- 凭证依赖：AI 向导功能强制需要 Anthropic/OpenAI API key，无法完全离线使用
- 版本兼容性：补丁可能因上游漂移失败，需手动比对应用
- OAuth 限制：若默认认证为 OAuth/token 模式，需显式配置
api_key类型 profile 或环境变量
适合人群
- 运行自托管 OpenClaw 实例、需要频繁创建/切换多智能体的开发者
- 希望通过 AI 辅助快速生成智能体配置而非手动编写 SOUL.md 的用户
- 对模型稳定性有要求、需要配置多层级降级策略的场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| 配置覆盖 | `agents.update` 直接修改配置，无版本回滚机制，建议配合 `git stash` 使用 |
| API 密钥泄露 | 环境变量或 profile 中的 key 可能被进程读取，需确保运行环境隔离 |
| LLM 生成质量 | AI 生成的 soul 配置可能需要人工调优，不适合直接投入生产 |
| 重建失败 | UI 或 gateway 构建依赖 Node.js/pnpm 生态，环境缺失会导致功能无法启用 |