ACP Harness 与本地工具

这是 OpenClaw 新手最容易混淆的一点。

本地工具是什么

本地工具是当前会话直接可调用的第一方能力，比如：

• read
• write
• edit
• exec
• memory_search
• sessions_send

特点：

• 低延迟
• 适合当前上下文直接处理
• 结果能立即回注

ACP Harness 是什么

ACP harness 更像把任务路由到外部 agent/runtime 执行。

适合：

• 用户明确指定某种 coding agent
• 任务复杂且持续时间长
• 需要 thread-bound 持续会话
• 需要和外部 runtime 的能力模型对齐

该怎么选

用本地工具

当任务是：

• 读一个文件
• 改一段代码
• 跑一条命令
• 查记忆
• 做短平快的局部修复

用 ACP harness

当任务是：

• “用 codex / claude code / gemini 帮我做这个”
• 需要独立线程长期运行
• 需要更像外包给另一个执行体

为什么不能混用概念

如果用户表达的是 ACP 意图，却被错误地当成本地 shell 来做，会导致：

• 线程语义错位
• 状态管理混乱
• 结果回传链路不一致
• 用户预期落空