核心用法
Coding Lead 是一个智能任务路由引擎,核心解决"什么任务该用什么方式执行"的决策问题。它将编码任务按复杂度三级分类:
- Simple(单文件<60行):直接本地执行,使用 read/write/edit/exec 工具
- Medium(2-5文件):优先尝试 ACP(Agent Coordination Protocol)智能代理,失败自动回退本地执行
- Complex(架构级/多模块):完整规划 → ACP → 分块回退执行
ACP 路由是核心差异化能力。系统支持 sessions_spawn(runtime="acp") 和 acpx CLI 双路径,自动检测可用性。内置 claude/codex 双代理策略:claude 擅长跨文件推理与复杂重构,codex 适合快速迭代与沙盒探索。
上下文管理采用磁盘化策略——将项目信息、代码片段、历史决策写入 .openclaw/context-<task>.md,ACP 代理从磁盘读取而非 prompt 嵌入,节省约90% token。支持多项目并行(最多2个 ACP 会话),通过 cwd 隔离零交叉污染。
显著优点
1. 智能降级保障:ACP 失败/超时/空输出时自动回退本地执行,永不静默失败
2. 跨会话记忆:集成 smart-agent-memory,记录决策与教训,突破 Claude Code 单会话记忆限制
3. 工具链柔性适配:所有工具(qmd、memory、acp)均为可选,自动检测并回退到 grep/手动等基础方案
4. 标准分层清晰:项目级标准(CLAUDE.md/.cursorrules)与团队级标准分离,避免重复嵌入 prompt
5. 技术栈向导:内置 PHP/Laravel、Vue、Flutter、Tailwind 等偏好栈,新建项目有明确提案流程
潜在局限
- 平台依赖:ACP 核心依赖 openclaw 生态(
openclaw.json、acpx),非标准环境需手动配置代理路径 - Windows 路径复杂:动态检测 ACPX/AGENT 路径的逻辑在 Windows 上较为繁琐
- 并行度保守:硬性限制最多2个并行 ACP 会话,超大项目可能受限
- Tech Stack 偏向明显:PHP/Vue/Flutter 优先,非此技术栈用户需频繁覆盖配置
- 安全边界人工依赖:虽禁止在
~/.openclaw/内 spawn,但最终代码审查仍需人工介入
适合人群
- 多项目并行开发者:需要同时处理2个以上代码库,依赖跨会话上下文记忆
- Claude Code 重度用户:已使用 Claude Code 作为主力 IDE,希望规范化 ACP 调用
- 团队技术负责人:需要统一跨项目编码标准与安全变更控制流程
- 复杂重构场景:涉及多文件、跨模块的架构调整,需要深度推理能力
常规风险
| 风险场景 | 缓解措施 |
|---------|---------|
| ACP 代理失控输出 | 设置超时、空输出检测、3次智能重试后强制回退 |
| 配置文件损坏 | 禁止在 `~/.openclaw/` 内执行编码任务 |
| 跨项目污染 | 严格 `cwd` 隔离 + 项目标签化的 memory 记录 |
| 代理选择偏见 | 代码审查强制换用不同代理(claude 写 → codex 审)|
| 机密泄露 | 内置规则禁止硬编码 secrets,DB 变更强制走 SQL 脚本 |
综合评估:Coding Lead 是 OpenClaw 生态中连接"本地轻量执行"与"云端智能代理"的桥梁型技能,设计成熟、回退机制完善,但生态绑定度较高,适合已投入该工具链的团队深度使用。