acp-router Skill:12 种 Coding Agent 的统一路由与智能分发方案
总结
acp-router 是 OpenClaw 官方开源的多 Agent 路由 Skill,能够把「用自然语言让 AI 干活」的请求,智能分派到 Claude Code、Cursor、Copilot、OpenCode、Gemini CLI、Qwen、Kiro、Kimi 等 12 种主流 Coding Agent 引擎上执行。它解决的是异构 Agent 生态下的「语言接口统一」问题——用户只管说想干什么,Skill 自动选引擎、自动建会话、自动传导任务。2026-07-16 更新当日即登上 SkillsMP trending,目前项目主仓库 star 数高达 384k,是近期最值得关注的多 Agent 协同基础设施之一。
功能与原则
acp-router 的核心能力是意图检测 + 引擎路由。当用户请求在某个特定 Coding Agent 中执行任务时(如”帮我用 Claude Code 写个排序算法”),Skill 会拦截该请求,依据 AgentId 映射规则分发到对应的 ACP runtime 或 acpx CLI 路径。
两大路由模式:
– OpenClaw ACP Runtime 路径(默认):通过 sessions_spawn + runtime:"acp" 创建托管会话,完整生命周期管理
– Direct acpx 路径(”telephone game”模式):通过 exec 直接调用 acpx CLI,适合纯中继任务
核心设计原则:不爬 PTY、不用 subagent runtime 作为控制层、不强制用户手动跑 CLI——能自动化的全部自动化。
认可度
- GitHub Star:384,196(openclaw/openclaw 主仓库,截至 2026-08-03)
- Forks:80,719
- 更新时间:2026-07-16(SkillsMP 显示当日 trending)
- 作者:openclaw(官方维护)
- 属于 OpenClaw 生态核心扩展,项目整体在 GitHub 长期稳居高星仓库行列
链接
GitHub:https://github.com/openclaw/openclaw
SKILL.md 直接地址:https://github.com/openclaw/openclaw/tree/main/extensions/acpx/skills/acp-router
原作者
openclaw — OpenClaw 开源组织,专注于 AI Coding Agent 的跨平台协同基础设施,GitHub 官方仓库 star 数 384k,插件生态覆盖全球主流 Coding Agent。
介绍
OpenClaw 是一个 AI Coding Agent 运行时框架,支持同时调度多种外部 Agent(Claude Code、Cursor、Copilot 等)。但在实际使用中,用户往往不知道该用哪个 Agent、怎么建会话、怎么把任务传过去——acp-router 就是来解决这个门槛的。
这个 Skill 维护了一个完整的 AgentId 映射表,涵盖 12 种引擎:openclaw、claude(code)、codex、copilot、cursor、droid(Factory Droid)、opencode、gemini、iflow、kilocode、kimi、kiro、qwen。用户只需在请求中命名目标引擎,Skill 自动完成身份路由、会话创建和任务下发。
对于需要「并行跑多个 Agent」或「跨引擎传递上下文」的场景,acp-router 还提供了 sessions_spawn + thread:true 的标准路径,保证每个引擎都在独立会话中运行,不互相干扰。
特点
- 多引擎统一路由:支持 12 种主流 Coding Agent,一个 Skill 全部搞定
- 意图自动检测:Skill 会在每次请求时判断是否需要路由,不需要用户显式触发
- 双路径设计:ACP Runtime(托管会话)和 Direct acpx(中继模式)并存,缺省自动选最优路径
- 会话生命周期管理:通过
sessions_spawn管理线程,任务完成后可自动清理 - 故障自愈:当 ACP 后端不可用时,Skill 会自动尝试本地修复 acpx 并重启 Gateway,减少用户干预
- 零 CLI 依赖:用户不需要手动运行任何命令行,Skill 内部处理所有 exec 调用
使用方法
acp-router 不是给人直接用的 Skill,而是 OpenClaw Agent 的内部路由引擎。当 OpenClaw 接收到包含目标引擎名称的请求时,自动激活。
安装方式(复制给 Claude/Codex/其他 Assistant):
# 安装 acp-router Skill
# 来源:https://github.com/openclaw/openclaw/tree/main/extensions/acpx/skills/acp-router
基本调用示例——用户说”spawn 一个 codex ACP session 线程告诉它说 hi”:
{
"task": "Say hi.",
"runtime": "acp",
"agentId": "codex",
"thread": true,
"mode": "session"
}
OpenClaw Agent 收到该请求后,自动调用 acp-router 路由逻辑,在后台创建 codex 会话并下发任务。
使用场景与人群
适用场景:
– 多引擎并行开发(同时向 Claude Code + Cursor + Gemini 发任务)
– 跨引擎任务传递(让 Claude Code 生成代码,交给 Cursor 做 lint)
– 异构团队协作(不同成员偏好不同 Agent,统一入口管理)
– 自动化流水线(定时任务触发多 Agent 协同)
目标用户:
– 使用 OpenClaw 作为主控层的开发者
– 需要调度多个 Coding Agent 的 AI 工程团队
– 研究多 Agent 协同的研究者
输入与输出案例
案例 1:指定引擎创建会话
输入(用户):
“用 Claude Code 帮我写一个快速排序,然后让 Cursor 帮我做代码审查”
Skill 路由行为:
– 识别 “Claude Code” → agentId:”claude”,通过 ACP Runtime 创建会话并下发写排序任务
– 识别 “Cursor” → agentId:”cursor”,第二个 sessions_spawn 创建审查会话
– 两个会话并行运行,结果通过 OpenClaw 统一汇总返回
案例 2:故障自愈场景
输入(用户):
“在后台启动一个 Gemini CLI 线程帮我分析这个 API 文档”
路由过程:
1. Skill 尝试通过 ACP Runtime 创建线程
2. 若 ACP 后端不可用 → 自动触发 acpx 本地安装/修复
3. 修复后重试 ACP spawn
4. 若仍失败才向用户报告具体错误,并提供 Direct acpx 备选路径
评论区
登录后可评论。