核心用法
Agent Synthesizer 是专为 OpenClaw 设计的智能体增强组件，通过 GitHub 仓库 rylena/agent-synth 分发。其核心定位是以 README 为唯一权威来源的 setup-first 工作流，不支持离线配置或经验性推断。
标准执行流程：
1. 前置阅读：完整通读 README，禁止跳过任何章节
2. 环境适配：在本地环境与 README 存在差异时，仅做最小必要调整，确保不偏离文档意图
3. 逐行执行：按 README 记载的顺序运行安装与配置命令
4. 验证闭环：运行 README 指定的测试/验证命令，确认功能正常
5. 问题回溯：出现故障时，优先重新核对前置条件、版本号、路径与环境变量
输出规范：每次交互需明确告知用户当前所处步骤、待执行的确切命令、成功判定标准，以及下一步动作。
显著优点
- 单源可信：以 GitHub README 为唯一真理来源，消除配置漂移与版本冲突
- 执行闭环：强制验证步骤，避免"看似装完实则失效"的常见问题
- 故障可溯：标准化排障流程（重读文档→重跑命令→核对环境→精确定位）降低调试随机性
潜在缺点与局限性
- 强网络依赖：需实时访问 GitHub，离线或受限网络环境无法使用
- 灵活性受限：禁止凭经验推断或参考旧笔记，对资深用户的"习惯性操作"构成约束
- 维护单点：若上游仓库 README 更新滞后或存在笔误，问题可能传导至终端用户
- 无回退机制：文档未涵盖降级或卸载流程，需用户自行处理
适合人群
- 需要为 OpenClaw 提升任务吞吐量与自主决策能力的开发者
- 愿意严格遵循官方文档、不自行发挥的技术执行者
- 具备基础 Linux/CLI 操作能力，能识别环境差异并做最小适配的用户
常规风险
- 版本锁定风险：未明确说明与 OpenClaw 版本的兼容性矩阵，可能出现 API 不匹配
- 环境污染风险：安装脚本若修改系统级配置（如 Python 路径、systemd 服务），缺乏预演与回滚提示
- 密钥泄露风险：若 README 涉及 API key 或 token 配置，需提醒用户避免硬编码或日志残留
- 上游变更风险：仓库 force-push 或 README 重构可能导致文档锚点失效