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.