a2a-setup

a2a-setup is a skill for Claude Code, Codex from win4r/openclaw-a2a-gateway. It costs 130 tokens per session (2,267 once invoked), scanned D, original, MIT.

A setup guide for connecting two or more OpenClaw servers so their agents can communicate through the A2A Gateway plugin. A2A is a protocol for agent-to-agent communication.

In plain words
What is it for?
Use it to install the gateway, register it in OpenClaw, and add communication peers over a network such as a local network or Tailscale.
Why use it?
It gives you the installation and configuration steps needed to connect servers without working out the plugin setup from scratch.

Skill for Claude CodeCodex

Which agent this was written for is unclear — built for openclaw. Also seen: built for openclaw.

Good fit Use it to install the gateway, register it in OpenClaw, and add communication peers over a network such as a local network or Tailscale.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/win4r/openclaw-a2a-gateway/skill
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add win4r/openclaw-a2a-gateway --skill skill
Clone the repo
git clone --depth 1 https://github.com/win4r/openclaw-a2a-gateway

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for a2a-setup

README.md
[![agentmods](https://agentmods.dev/badge/skills/win4r/openclaw-a2a-gateway/skill/github.svg)](https://agentmods.dev/skills/win4r/openclaw-a2a-gateway/skill)
Your own site
<a href="https://agentmods.dev/skills/win4r/openclaw-a2a-gateway/skill"><img src="https://agentmods.dev/badge/skills/win4r/openclaw-a2a-gateway/skill/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for a2a-setup

Your own site · 80×15
<a href="https://agentmods.dev/skills/win4r/openclaw-a2a-gateway/skill"><img src="https://agentmods.dev/badge/skills/win4r/openclaw-a2a-gateway/skill.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 130 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,267 The whole file, excluding the scripts and references it only reads on demand.
Security scan D 3 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00130 $0.02267
Opus 5 $0.00065 $0.01133
Sonnet 5 $0.00026 $0.00453
Haiku 4.5 $0.00013 $0.00227

Measured 9d ago against content hash a7e8a5daca84, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade D, and why

a2a-setup scanned grade D with 3 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

The scan reads SKILL.md. This mod also ships 4 executable files (scripts/a2a-peers.mjs, scripts/a2a-ping.mjs, scripts/a2a-send.mjs, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

sudo tailscale up

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

curl -fsSL https://tailscale.com/install.sh | sh

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s http://localhost:18800/.well-known/agent-card.json | python3 -m json.tool
skill/SKILL.md · 235 lines

How it starts

The opening of the file, as written. The whole thing — 235 lines — stays where its author put it; the contents beside it link to each section on GitHub.

A2A Gateway Setup

Configure the OpenClaw A2A Gateway plugin for cross-server agent-to-agent communication using the A2A v0.3.0 protocol.

Prerequisites

  • OpenClaw ≥ 2026.3.0 installed and running on each server
  • Network connectivity between servers (Tailscale recommended, LAN or public IP also work)
  • Node.js ≥ 22

Step 1: Install the Plugin

mkdir -p <WORKSPACE>/plugins
cd <WORKSPACE>/plugins
git clone https://github.com/win4r/openclaw-a2a-gateway.git a2a-gateway
cd a2a-gateway
npm install --production

Replace <WORKSPACE> with the agent workspace path. Find it with:

openclaw config get agents.defaults.workspace

Step 2: Register Plugin in OpenClaw

Get current allowed plugins first to avoid overwriting:

openclaw config get plugins.allow

Then add a2a-gateway to the existing array (do NOT drop existing plugin ids):

# Example only — include your existing plugins too
openclaw config set plugins.allow '["<existing...>", "a2a-gateway"]'
openclaw config set plugins.load.paths '["<ABSOLUTE_PATH>/plugins/a2a-gateway"]'
openclaw config set plugins.entries.a2a-gateway.enabled true

Critical: Use the absolute path in plugins.load.paths. Relative paths will fail.

Step 3: Configure Agent Card

openclaw config set plugins.entries.a2a-gateway.config.agentCard.name '<AGENT_NAME>'
openclaw config set plugins.entries.a2a-gateway.config.agentCard.description '<DESCRIPTION>'
openclaw config set plugins.entries.a2a-gateway.config.agentCard.url 'http://<REACHABLE_IP>:18800/a2a/jsonrpc'
openclaw config set plugins.entries.a2a-gateway.config.agentCard.skills '[{"id":"chat","name":"chat","description":"Bridge chat/messages to OpenClaw agents"}]'

URL field rules

Field Points to Example
agentCard.url JSON-RPC endpoint (default) http://100.x.x.x:18800/a2a/jsonrpc
peers[].agentCardUrl Agent Card discovery (preferred) http://100.x.x.x:18800/.well-known/agent-card.json

Read the full file on GitHub · 235 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 235 lines · 130 tokens per session scan D a7e8a5daca84

Subscribe to this mod's changes

a2a-setup is a skill published in the GitHub repository win4r/openclaw-a2a-gateway (555 stars, last pushed 1mo ago), licensed MIT. It adds 130 tokens to every session and 2,267 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it D with 3 findings (asks for root, downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

clawteam

Multi-agent swarm orchestration. USE THIS (not delegatetask) when the user says team/swarm/multi-agent/clawteam/parallel-agents/agent-team, or asks for multi-perspective analysis (stocks, research, code review, strategy). Spawns N Hermes workers in tmux windows with git worktree isolation, file-based inboxes, and a…

win4r/ClawTeam-OpenClaw · 103 tokens

clawteam

Multi-agent swarm coordination via the ClawTeam CLI. Use when the user wants to create agent teams, spawn multiple agents to work in parallel, coordinate tasks with dependencies, broadcast messages between agents, monitor progress via kanban board, or launch pre-built team templates (hedge-fund, code-review…

win4r/ClawTeam-OpenClaw · 106 tokens

ClawTeam

This skill should be used when the user asks to "create a team", "spawn agents", "assign tasks", "coordinate multiple agents", "check team status", "view kanban board", "send messages between agents", "manage team tasks", "monitor team progress", or mentions "clawteam", legacy "oh", "multi-agent coordination", "team…

win4r/ClawTeam-OpenClaw · 200 tokens

lesson

Store a lesson learned from the current conversation. Triggered by /lesson command. Use when Master signals that the recent conversation contains a pitfall, fix, or key insight that should be persisted to long-term memory.

CortexReach/memory-lancedb-pro · 45 tokens

edgefinder-cli

Use the EdgeFinder CLI for NFL, NBA, and MLB analysis, plus NFL/NBA schedules, standings, Polymarket odds, and portfolio lookups from the terminal.

andrewnexys/edgefinder-cli · 39 tokens

edgefinder

Use EdgeFinder for NFL, NBA, and MLB sports betting analysis, schedules, standings, odds, and Polymarket portfolio analysis.

andrewnexys/edgefinder-cli · 30 tokens