acp-router

Route plain-language coding requests to ACP runtime or acpx sessions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of directing plain-language coding requests to specialized AI environments like Pi, Claude Code, Codex, OpenCode, Gemini CLI, or ACP harness work, ensuring they are handled either within OpenClaw's ACP runtime or through direct acpx-driven sessions.

Core Features & Use Cases

  • Intelligent Routing: Automatically detects user intent to run code in specific ACP harnesses.
  • Threaded Conversations: Manages the creation and continuation of coding agent threads within ACP environments.
  • Flexible Execution: Supports both OpenClaw's ACP runtime tools and direct acpx CLI execution for maximum flexibility.
  • Use Case: When a user says, "Run this Python script in Claude Code and keep the conversation going," this skill will ensure the request is correctly routed and managed within a dedicated Claude Code session.

Quick Start

Use the acp-router skill to route a request to run a Python script in the codex harness.

Frequently Asked Questions about acp-router

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

FAQPage Schema
How do I route plain-language coding requests to an ACP harness?

To route plain-language coding requests to an ACP harness, the acp-router detects user intent and directs tasks to either OpenClaw ACP runtime sessions or direct acpx-driven sessions. It supports environments like Pi, Claude Code, Codex, OpenCode, and Gemini CLI.

Can I manage threaded conversations in Claude Code through ACP routing?

Yes, you can manage threaded conversations in Claude Code through ACP routing. The acp-router prioritizes the sessions_spawn tool for thread creation, ensuring coding-agent thread requests are correctly routed and managed within dedicated ACP environments.

What is the difference between OpenClaw ACP runtime and direct acpx execution?

The difference between OpenClaw ACP runtime and direct acpx execution lies in session management. ACP runtime utilizes OpenClaw's built-in tools, while direct acpx execution drives sessions via the CLI, offering flexible execution paths for coding agents like Codex or Gemini CLI.

Does acp-router support agentId mapping for coding environments?

Yes, acp-router supports agentId mapping for coding environments. It handles agentId mapping automatically and provides a robust thread spawn recovery policy with automatic local repair attempts to ensure continuous ACP runtime or acpx execution.

Why does my ACP thread spawn fail during code execution?

An ACP thread spawn might fail during code execution due to session mapping errors. The acp-router addresses this by providing a robust thread spawn recovery policy that automatically attempts local repairs to restore the acpx-driven or ACP runtime session.