acp-router

Route ACP harness requests to OpenClaw ACP or direct acpx runtime sessions.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/frankhli843/gemmahermes --skill acp-router-frankhli843
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acp-router
Source: https://github.com/frankhli843/gemmahermes/tree/main/extensions/acpx/skills/acp-router
Command: npx skills add https://github.com/frankhli843/gemmahermes --skill acp-router-frankhli843

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Route ACP harness requests to the appropriate runtime sessions (OpenClaw ACP or direct acpx flows).

Core Features & Use Cases

  • Intent detection and mode selection for OpenClaw ACP runtime vs direct acpx path.
  • OpenClaw ACP runtime path with thread-spawn handling via sessions_spawn and explicit agent mapping.
  • Recovery and install/version policy for ACPX and fallback options to maintain workflow.

Quick Start

Route a harness task through ACP by selecting the runtime path and providing the task details.

Frequently Asked Questions about acp-router

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

FAQPage Schema
How do I route ACP harness tasks to the correct runtime session?

To route ACP harness tasks, the router detects intent and selects the appropriate path, directing requests to OpenClaw ACP runtime sessions or direct acpx flows. It enforces preflight checks before spawning any threads.

How does sessions_spawn handle thread creation for OpenClaw ACP runtime?

Sessions_spawn handles thread creation by spawning new runtime sessions within the OpenClaw ACP path. It maps agents explicitly during the routing process to ensure tasks reach the correct backend.

What's the best way to manage multi-backend routing for coding-agent threads?

Multi-backend routing for coding-agent threads is managed by detecting task intent and selecting the proper runtime path. The router enforces preflight checks and uses sessions_spawn to create threads across various ACP harness backends.

Why does ACPX fail during install or version checks, and how do I recover?

ACPX install or version failures are addressed by the router's codified recovery policies and fallback options. The router enforces version checks and provides fallback paths to maintain workflow continuity when direct acpx flows encounter issues.

Do I need preflight checks before routing to a direct acpx flow?

Yes, preflight checks are required before routing to a direct acpx flow. The router enforces these checks to validate the runtime environment and ensure session management policies are met before task execution.

Can I use the ACP router for session management across different harness backends?

Yes, you can use the ACP router for session management across various harness backends. It selects runtime paths, uses sessions_spawn for thread creation, and applies explicit agent mapping to manage sessions effectively.