acp-router

Route user requests to the appropriate OpenClaw ACP harness path.

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/zyj18860969891-byte/openclaw-railway --skill acp-router-zyj18860969891-byte
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acp-router
Source: https://github.com/zyj18860969891-byte/openclaw-railway/tree/main/extensions/acpx/skills/acp-router
Command: npx skills add https://github.com/zyj18860969891-byte/openclaw-railway --skill acp-router-zyj18860969891-byte

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Route user requests to the correct ACP harness path (runtime or direct acpx) to execute coding-harness tasks.

Core Features & Use Cases

  • Intent routing: Detects user intent and routes to the appropriate ACP runtime or direct acpx flow.
  • AgentId mapping: Maps common harness names (pi, codex, claude, etc.) to agent IDs for consistent routing.
  • Thread/spawn guardrails: Enforces preflight checks and safe thread creation guidelines to avoid unsafe harness usage.
  • Use Case: When a user asks to run code in Codex or Gemini, the router directs prompts to the correct backend session and handles lifecycle automatically.

Quick Start

Provide a sample request to spawn an ACP harness thread for the codex agent using the router.

Frequently Asked Questions about acp-router

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

FAQPage Schema
How do I route user requests to the correct OpenClaw ACP harness path?

To route user requests to the correct OpenClaw ACP harness path, the acp-router detects user intent and directs prompts to either the runtime or direct acpx flow. It applies preflight checks and maps agent names to ensure accurate routing for coding-harness tasks.

How does agent ID mapping work for ACP harness thread spawning?

Agent ID mapping for ACP harness thread spawning works by translating common harness names like pi, codex, and claude into consistent agent IDs. The router uses these mappings to enforce preflight checks and direct session handling across multiple backends.

Can I use acp-router for session lifecycle management across multiple backends?

Yes, you can use acp-router for session lifecycle management across multiple backends. It handles session spawning, thread creation, and mode parameters automatically, applying safe fallback guidance to prevent unsafe harness usage during runtime or direct acpx flows.

What's the best way to execute coding-harness tasks using direct acpx flows?

The best way to execute coding-harness tasks using direct acpx flows is through explicit runtime selection with preflight checks. The router directs prompts to the correct backend session, handling thread spawning and agent-name mappings to ensure safe and consistent execution.

Why does ACP harness routing require preflight checks before thread creation?

ACP harness routing requires preflight checks before thread creation to enforce safe thread spawning guidelines and avoid unsafe harness usage. These checks validate runtime selection and session parameters, ensuring correct session handling and preventing errors across backend flows.

Does acp-router support both runtime and direct acpx execution modes?

Yes, acp-router supports both runtime and direct acpx execution modes. It implements explicit runtime selection based on detected user intent, applying preflight checks and safe fallback guidance to route coding-harness tasks to the appropriate execution path.