acp-router

Route coding-harness requests to ACP runtime or direct acpx flows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Route plain-language requests to the ACP harness system, ensuring tasks are executed in the correct runtime flow and avoiding unsafe or unsupported paths.

Core Features & Use Cases

  • OpenClaw ACP runtime routing: spawn ACP sessions and thread-enabled tasks with explicit task payloads.
  • Direct acpx telephony flow: relay prompts to harness via acpx when requested or when ACP runtime is unavailable.
  • Preflight and guardrails: perform preflight checks for coding-harness thread requests, enforce agentId mapping, and provide recovery paths when the ACP backend encounters issues.
  • Robust install & version policy: verify and install pinned acpx binaries when needed, restart gateways after repair, and offer fallback options.

Quick Start

Read this skill first when routing a coding task to an ACP harness, then choose the ACP runtime path or the direct acpx path to execute the work.

Frequently Asked Questions about acp-router

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

FAQPage Schema
How do I route prompts to an ACP harness session?

Routing prompts to an ACP harness involves using the OpenClaw ACP runtime path with sessions_spawn or a direct acpx path to relay prompts and execute coding-harness tasks.

What is the acpx telephone game path used for?

The acpx telephone game path is a direct flow used to relay prompts to the harness, serving as an alternative when the OpenClaw ACP runtime is unavailable or explicitly requested for the task.

Does acp-router work with Claude Code and Gemini harness flows?

Yes, acp-router supports routing to multiple harness flows including Claude Code, Gemini, Codex, Pi, OpenCode, and Kimi, enforcing correct agentId mapping for each environment.

How do I handle ACP backend unavailability or missing acpx binaries?

When an ACP backend is unavailable, the routing system performs automatic recovery, verifies and installs pinned acpx binaries, restarts gateways after repair, and provides fallback options.

Why does my coding-harness thread request require a preflight step?

A coding-harness thread requires a preflight step to enforce guardrails, verify the correct runtime flow, and ensure safe task execution before spawning an ACP session or relaying prompts.