╔══════════════════════════════════════════════════════════════╗
║ ║
║ _ ___ ___ ___ _ _ ║
║ /_\ / __| _ \ | _ )_ __(_)__| |__ _ ___ ║
║ / _ \ (__| _/ | _ \ '_|| / _` / _` |/ -_) ║
║ /_/ \_\___|_| |___/|_| |_\__,_\__, \___| ║
║ |___/ ║
║ https://github.com/xiwan/acp-bridge ║
║ ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ IM Agents 🦞 OpenClaw 🐎 Hermes ║
║ CLI Agents 🤖 Claude Code 🤖 Kiro 🤖 Codex ║
║ 🤖 OpenCode 🤖 Qwen 🤖 Trae ... ║
║ Lite Agents 🏭 Harness Agents ║
║ ║
╚══════════════════════════════════════════════════════════════╝
Multi-Agent Mesh · Connect · Orchestrate · Scale
A multi-agent orchestration platform that exposes local CLI agents (Kiro, Claude Code, Codex, Qwen, OpenCode, Hermes, etc.) as HTTP services via ACP, with pipeline orchestration and IM-driven async workflows.
You have powerful CLI agents on a dev machine. You want the rest of your team — or your bots — to use them too.
| Scenario | How ACP Bridge Helps |
|---|---|
| Team AI gateway | One EC2 runs Kiro + Claude + Codex; everyone calls them via HTTP — no local install needed |
| IM-driven development | Send a Discord/Feishu message → agent executes → result pushed back to chat |
| Async code tasks | Submit a refactor or review job, go grab coffee, get notified when it's done |
| Multi-agent orchestration | Chain agents in sequence, race them in parallel, or let them debate in conversation mode |
| Prompt-as-a-service | Define reusable prompt templates; non-technical users pick a template and fill in variables |
| Agent marketplace | Same harness-factory binary + different profiles = code reviewer, DevOps helper, translator — all behind one API |
curl -fsSL https://raw.githubusercontent.com/xiwan/acp-bridge/main/install.sh | bashcd acp-bridge
uv sync
uv run main.py
# No config.yaml needed — auto-detects installed agent CLIscurl -s -X POST http://localhost:18010/runs \
-H "Authorization: Bearer $ACP_BRIDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"agent_name": "kiro",
"input": [{"parts": [{"content": "Say hello", "content_type": "text/plain"}]}]
}'📖 Docker, systemd, config file setup → Getting Started
| Document | Description |
|---|---|
| Getting Started | Installation, Docker, prerequisites, systemd, Web UI |
| Tutorial | End-to-end: Discord → Agent → Discord in 5 minutes |
| Configuration | config.yaml reference, Codex + LiteLLM proxy setup |
| Agents | Supported agents, compatibility matrix, install commands |
| API Reference | All HTTP endpoints with examples |
| Pipelines | Multi-agent orchestration: sequence, parallel, race, conversation |
| Async Jobs | Background tasks, webhook callback, IM push |
| Webhooks | Webhook formats, auth (token vs HMAC), payload examples |
| Client Usage | acp-client.sh CLI client |
| Tools Proxy | OpenClaw tools integration |
| Security | Auth model, deployment shapes, prompt injection |
| Process Pool | Connection lifecycle, LRU eviction, OOM protection |
| Testing | Agent compliance tests, integration test suite |
| Troubleshooting | Common issues and fixes |
| Agent Spec | ACP JSON-RPC protocol for writing new agents |
| # | Title | Date | Link |
|---|---|---|---|
| 1 | acpbridge:让龙虾和爱马仕沟通 | 2026-04-20 | BV1QsowBAEg3 |
| 2 | 让openclaw指挥多agent干活 | 2026-04-01 | BV1gD9EBzEQQ |
| 3 | openclaw: acp-brige支持容器了 | 2026-03-19 | BV1t8wyztEuM |
| 4 | 实现了openclaw用ACP来调用claude code | 2026-03-09 | BV1kbPDzgE8R |
See CHANGELOG.md for full version history. Current: v0.16.0
See CONTRIBUTING.md for guidelines. Issues and PRs welcome.
Apache License 2.0. See LICENSE.