acp-router

Route natural language requests to AI coding harnesses and ACP runtime sessions.

386k|81.1k|Updated Nov 24, 2025
One-click install
npx skills add https://github.com/openclaw/openclaw --skill acp-router-openclaw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acp-router
Source: https://github.com/openclaw/openclaw/tree/main/extensions/acpx/skills/acp-router
Command: npx skills add https://github.com/openclaw/openclaw --skill acp-router-openclaw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the process of directing plain-language requests to various AI coding environments like Pi, Claude Code, Codex, Gemini, or ACP harness work, ensuring they are handled by the appropriate runtime sessions.

Core Features & Use Cases

  • Intelligent Routing: Automatically directs coding tasks to the correct AI harness (Pi, Claude Code, Codex, Gemini, etc.).
  • Session Management: Manages sessions within the OpenClaw ACP runtime or directly via acpx for a "telephone game" flow.
  • Threaded Conversations: Ensures coding-agent thread requests are initiated correctly through sessions_spawn for ACP harness threads.
  • Use Case: When you ask OpenClaw to "run this code in Pi," this skill intercepts the request, identifies "Pi" as the target harness, and initiates a session using the ACP runtime.

Quick Start

Ask OpenClaw to spawn a new thread for codex to say hello.

Frequently Asked Questions about acp-router

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

FAQPage Schema
How do I route natural language requests to AI coding harnesses like Pi or Codex?

To route natural language requests to AI coding harnesses, this Skill intercepts your plain text, identifies the target environment such as Pi or Codex, and initiates a session using either the OpenClaw ACP runtime or direct acpx-driven sessions.

What is the best way to spawn a new coding-agent thread in an ACP harness?

The best way to spawn a coding-agent thread in an ACP harness is using the sessions_spawn action. This Skill prioritizes sessions_spawn for thread creation and actively avoids using message(action="thread-create") for ACP harness threads.

Does this routing approach support Gemini CLI and Claude Code sessions?

Yes, this routing approach fully supports Gemini CLI and Claude Code sessions. It intelligently directs coding tasks to various AI environments including Pi, Codex, OpenCode, and ACP harness work via the correct runtime sessions.

How do I manage sessions between the OpenClaw ACP runtime and acpx?

You manage sessions by routing tasks into either the OpenClaw ACP runtime or directly via acpx for a telephone game flow. This Skill streamlines the process of directing plain-language requests to the appropriate runtime environment.

Why should I use a dedicated router instead of sending messages directly to AI coding assistants?

Using a dedicated router ensures your coding tasks are handled by the appropriate runtime sessions and initiated correctly. It streamlines directing plain-language requests to environments like Pi, Claude Code, or Codex without manual session configuration.

What happens when I ask OpenClaw to run code in a specific AI harness?

When you ask OpenClaw to run code in a specific AI harness, the Skill intercepts the request, identifies the target like Pi, and initiates a session using the ACP runtime to execute the task.