acp-router

Route user requests to ACP harnesses and manage sessions in OpenClaw ACP runtime or acpx.

4|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/Agent-Pattern-Labs/sparse-kernel --skill acp-router-agent-pattern-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acp-router
Source: https://github.com/Agent-Pattern-Labs/sparse-kernel/tree/main/extensions/acpx/skills/acp-router
Command: npx skills add https://github.com/Agent-Pattern-Labs/sparse-kernel --skill acp-router-agent-pattern-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires acpx, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies the process of routing plain-language requests to various ACP harnesses, ensuring they are executed in the correct runtime environment.

Core Features & Use Cases

  • Routing Requests: Directs user requests to the appropriate ACP harness, such as OpenClaw ACP, Codex, or Copilot, based on the input.
  • Session Management: Handles the creation and management of ACP harness sessions for continuous work flow.
  • Mode Selection: Offers two execution paths - OpenClaw ACP runtime and direct acpx-driven sessions.
  • AgentId Mapping: Provides defaults for agent IDs corresponding to different ACP harnesses.
  • ACPX Install and Version Policy: Enforces the use of a specific version of acpx for direct execution.
  • Direct acpx Path: Enables driving harness sessions directly using the acpx CLI.
  • Harness Aliases in acpx: Defines aliases for different ACP harnesses within acpx.
  • Failure Handling: Implements robust failure handling for common issues like missing commands or busy queues.

Quick Start

To route a request to OpenClaw ACP, use the command: acp-router run "Query for weather forecast".

Frequently Asked Questions about acp-router

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

FAQPage Schema
How do I route requests to an ACP harness for execution?

To route requests to an ACP harness, you can use the acp-router command. It directs plain-language input to the correct runtime, such as OpenClaw ACP or Codex, managing execution and session creation automatically.

What is the difference between OpenClaw ACP runtime and direct acpx sessions?

OpenClaw ACP runtime and direct acpx sessions are two execution modes offered by acp-router. OpenClaw manages execution within its runtime, while direct acpx sessions drive harnesses directly using the acpx CLI.

Do I need acpx installed to manage ACP harness sessions?

Yes, acpx is a required dependency for managing ACP harness sessions. The acp-router enforces a specific acpx version policy and uses the CLI to enable direct execution paths and define harness aliases.

How does ACP session management handle common execution failures?

ACP session management implements robust failure handling for common issues like missing commands or busy queues. It provides fallback options to ensure your request routing continues smoothly despite runtime interruptions.

Can I use acp-router with multiple ACP harnesses like Codex and Copilot?

Yes, acp-router supports routing to various ACP harnesses including Codex and Copilot. It provides default agent ID mappings and defines harness aliases within acpx to direct requests to the correct environment.

What's the best way to start routing a plain-language query to OpenClaw ACP?

The best way to start routing a query is using the command: acp-router run "Your query here". This initiates session creation, selects the appropriate execution mode, and routes the input to the OpenClaw ACP runtime.