核心功能
agent-chat-ux 是 OpenClaw 生态系统的官方 UI/UX 增强技能,深度重构了控制面板的代理管理与聊天交互体验。其核心能力围绕三大场景展开:
1. 聊天界面代理切换(Session-Centric UX)
- 代理选择器:在聊天头部会话下拉框左侧新增代理选择器,自动过滤当前代理的会话列表
- 会话隔离:彻底解决多代理场景下 cron 任务、子代理会话混杂的问题,会话按代理 ID 隔离并按时间倒序排列
- 快捷新建:
+按钮一键创建新会话,替代/new命令
2. AI 向导创建代理(Zero-to-Agent)
自然语言描述 → AI 生成完整代理配置(名称、emoji、SOUL.md 身份定义)→ 一键确认创建。大幅降低代理配置门槛,无需手动编写 Markdown 身份文件。
3. 模型配置优化
- 主模型与回退模型分离,回退模型改为标准多选下拉框(支持 Ctrl/⌘ 多选)
- 运行时按顺序尝试回退模型,应对速率限制或上下文溢出
显著优点
- 官方维护:作者 Charles Sears 为 OpenClaw 核心开发者,代码质量与兼容性有保障
- 补丁原子化:6 个补丁文件各负责单一职责,失败时可独立回滚
- 安全加固 v1.2.1:
- LLM 输出严格 JSON Schema 校验(name≤100字符, emoji≤10字符, soul≥20字符)
- 非 JSON 或结构不符直接拒绝,禁止自动创建
- 认证回退机制:OAuth 场景自动降级至 api_key 凭证或环境变量
局限与风险
| 类别 | 说明 |
|------|------|
| **安装复杂度** | 需源码补丁 + 双端构建(UI + Gateway),非「即装即用」型插件 |
| **破坏性变更** | 修改 `~/openclaw` 源码,建议 `git stash` 备份 |
| **外部依赖** | `agents.wizard` 直接调用 Anthropic/OpenAI API,需有效 API Key |
| **版本敏感** | 上游源码漂移可能导致补丁冲突,需手动核对行号 |
适合人群
- 运行 OpenClaw 自托管实例的中高级用户
- 需频繁创建/切换多代理的开发者或团队
- 对模型稳定性要求高、需配置 fallback 链的生产环境
安全等级说明
- S级:官方来源、完整透明文档、输出校验、最小权限凭证访问
- 唯一降级因素:需修改源码并访问外部 API,但已提供完整缓解措施