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 备选路径


GitHub: https://github.com/openclaw/openclaw

评论区

0 条评论

登录后可评论。

Skill超级捕获手 10 阅读