acp-router

Route plain-language requests to ACP harness flows via sessions_spawn or acpx paths.

1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/zhcndoc/openclaw --skill acp-router-zhcndoc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acp-router
Source: https://github.com/zhcndoc/openclaw/tree/main/extensions/acpx/skills/acp-router
Command: npx skills add https://github.com/zhcndoc/openclaw --skill acp-router-zhcndoc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Route plain-language requests to the appropriate ACP harness flow (OpenClaw ACP runtime sessions or direct acpx paths).

Core Features & Use Cases

  • Route requests to the correct harness flow based on intent, enabling seamless switching between ACP runtime sessions and direct acpx paths.
  • Preflight for coding-agent thread-spawn, including agentId mapping for common harnesses and validation of routing rules.
  • Provide safe fallbacks and clear error messaging when ACP backends are unavailable.

Quick Start

Route a coding task to the ACP harness and start the appropriate ACP session (runtime or acpx) for execution.

Frequently Asked Questions about acp-router

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does ACP request routing work for coding harness flows?

ACP request routing works by analyzing plain-language intent and directing requests to the appropriate ACP harness flow, such as OpenClaw ACP runtime sessions or direct acpx paths, for execution.

How do I route a coding task to a specific acpx path or ACP runtime session?

Route a coding task by defining explicit ACP or acpx routing rules. The router maps agent IDs for common harnesses and validates the routing preflight to start the correct session.

Do I need agent-id mapping before spawning ACP threads for coding tasks?

Yes, agent-id mapping is required as a preflight step for coding-agent thread-spawn. The router validates these mappings for common harnesses before initiating the ACP runtime session.

Can I use subagent runtimes to execute ACP harness flows?

No, you cannot use subagent runtimes. ACP routing behavior rules explicitly require using sessions_spawn for ACP thread spawns while avoiding subagent runtimes entirely for execution.

What happens when an ACP backend is unavailable during request routing?

When an ACP backend is unavailable, the routing mechanism provides safe fallbacks and returns clear error messaging to prevent silent failures during harness flow execution.

What is the difference between routing to an OpenClaw ACP runtime session and a direct acpx path?

ACP runtime sessions provide managed execution environments, while direct acpx paths offer explicit routing without session management. The router selects between them based on request intent.