（2756期）Acp Router – ACP 编码代理智能路由中枢

ACP 编码代理智能路由中枢 智能路由 Pi/Claude/Codex 等 ACP 编码代理请求，支持原生 ACP 运行时与 acpx CLI 双通道，强制修复与自动降级保障高可用。 使用说明 核心用法 acp-router 是 OpenClaw 内部用于调度 ACP（Agent Communication Protocol）编码代理的路由中枢。当用户要求「在 Pi/Claude Code/Codex/OpenCode/Gemini/Kimi 中运行」时，该技能决定通过 sessions_spawn 走原生 ACP 运行时，还是通过 acpx CLI 走「传话游戏」直连模式。 强制前置检查：创建任何 ACP 编码代理线程前，必须先读取本技能，随后只能用 sessions_spawn（runtime: "acp"、thread: true），禁止再用 message(action="thread-create")。 模式选择： OpenClaw ACP 运行时（默认）：sessions_spawn + ACP 生命周期管理，支持会话持久化、线程隔离、自动网关管理。 Direct acpx 路径（备用）：exec 调用本地 acpx 二进制，适用于 ACP 后端不可用或用户仅需「中继指令」场景。 故障自愈：若 ACP 后端异常，技能强制执行本地修复——安装插件固定版 acpx、验证版本、重启网关、重试一次，仅当修复失败后才提供降级选项（再次重试 ACP 或切 acpx），绝不默认 fallback 到 subagent 运行时。 显著优点 双通道高可用：原生 ACP 与 acpx CLI 互为备份，网关故障时可无缝降级。 强制前置校验：避免开发者在 ACP 线程创建时误用旧 API，降低集成错误率。 自动修复闭环：从依赖安装到网关重启的全自动修复流程，减少人工介入。 确定性会话命名：oc-<harness>-<conversationId> 规则确保同一会话上下文可复用。 版本锁定安全：强制使用 extensions/acpx 本地固定版本，防止全局 acpx 漂移导致的不兼容。 潜在缺点与局限性 复杂故障仍需人工：若 ~/.acpx/config.json 配置损坏或网络阻断，自动修复后仍需用户确认重试。 CLI 依赖本地 Node：acpx 路径依赖本地 Node/npm 环境，容器化场景需预装依赖。 异步队列隐式阻塞：默认等待队列完成，未显式加 --no-wait 时可能延迟响应。 权限敏感：网关重启、npm install 需文件系统与进程权限，受限环境可能触发权限错误。 适合人群 需同时调度多个外部编码代理（Pi、Claude、Codex 等）的 OpenClaw 开发者 构建 ACP 集成工作流的平台工程师 追求高可用、可自愈的自动化运维场景 常规风险 供应链风险：acpx 及底层适配器（如 @zed-industries/claude-agent-acp）来自 npm，需信任 Zed 等第三方包。 会话泄露：若未正确调用 sessions close，远程 harness 会话可能长期驻留。 命令注入：task 与 prompt 直接透传至 exec，需确保上游已做输入校验。 原始说明 Route plain-language requests for Pi, Claude Code, Codex, OpenCode, Gemini CLI, or ACP harness work into either OpenClaw ACP runtime sessions or direct acpx-...