acp-router

Route natural language coding requests to ACP runtime or acpx sessions.

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

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 efficient execution either within OpenClaw's ACP runtime or via direct acpx-driven sessions.

Core Features & Use Cases

  • Intelligent Routing: Automatically determines the best path for coding tasks based on user intent and system availability.
  • ACP Harness Integration: Seamlessly integrates with various ACP (AI Coding Partner) harnesses for code generation, debugging, and execution.
  • Threaded Conversations: Manages coding sessions within threads for organized, context-aware development.
  • Use Case: When you ask to "run this Python script in Claude Code," the skill routes it to the Claude Code ACP runtime, creating a new thread for the session.

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 coding tasks to an AI coding environment?

Route natural language coding tasks to AI environments by mapping user-specified harness names to an agentId. This determines the best execution path, directing requests into ACP runtime sessions or direct acpx-driven sessions.

How do I manage coding-agent thread requests for Pi or Claude Code?

Manage coding-agent thread requests by prioritizing the sessions_spawn function for thread creation. This organizes context-aware development sessions within OpenClaw's ACP runtime or specific harness paths like Claude Code.

Can I run coding tasks directly with acpx without using the full ACP runtime?

Execute coding tasks directly with acpx by bypassing the ACP runtime. The routing mechanism maps your harness name to an agentId and enforces ACPX install and version policies to validate direct execution.

Does this routing approach support Gemini CLI and OpenCode environments?

Gemini CLI and OpenCode are fully supported alongside Pi, Claude Code, and Codex. The routing system processes plain-language requests and seamlessly integrates these specific AI Coding Partner harnesses for execution.

What are the requirements for direct acpx path execution?

Direct acpx path execution requires enforcing strict ACPX install and version policies. The system validates these requirements after mapping your specified harness name to the correct agentId before running the session.

What is the best way to spawn a new thread for a specific coding agent?

Spawn a new coding agent thread by asking OpenClaw to create the session for your specified harness. The system intelligently routes the request, prioritizing sessions_spawn to initialize the context-aware thread within the correct ACP runtime.