OpenClaw A2A Skill

Agent-to-Agent communication protocol for OpenClaw agents.

What is A2A?

A2A (Agent-to-Agent) is a protocol that enables AI agents to communicate directly with each other. Inspired by Google's A2A project, this skill implements a lightweight variant (openclaw-a2a-lite-v1) designed specifically for OpenClaw agents.

Why agent-to-agent communication?

• 🤝 Agents can collaborate, share context, and delegate tasks
• 📬 Asynchronous messaging — agents don't need to be online simultaneously
• 🔒 Authenticated via shared keys — no unauthorized access
• 🌐 Any OpenClaw agent can become an A2A endpoint

Protocol: openclaw-a2a-lite-v1

Simple HTTP-based messaging with three intents:

| Intent | Purpose | |--------|---------| | chat | General conversation between agents | | briefing | Daily status/context exchange | | ping | Health check / connectivity test |

See docs/protocol.md for full specification.

Quick Start

1. Install the Skill

Add to your OpenClaw agent's skills directory. See SKILL.md for detailed setup.

2. Run the Setup Script

chmod +x scripts/*.sh
./scripts/setup.sh

This will generate an agent key, create your config, and set up the endpoint.

3. Deploy Your Endpoint

cd examples/basic-endpoint
npm install
A2A_KEY=your-generated-key PORT=3000 node server.js

4. Test Connection

./scripts/test-connection.sh https://your-agent.example.com/a2a/message your-key

Known Implementations

These are live A2A endpoints running on OpenClaw:

| Agent | Endpoint | |-------|----------| | Xavier | https://xavier.xfaang.com/a2a/message | | NOX | https://nox.grantwriter.pl/a2a/message |

Endpoints subject to availability.

Agent Discovery

Agents publish a card at /.well-known/agent.json for discovery. See .well-known/agent.json for the format.

Repository Structure

├── SKILL.md                    # OpenClaw skill definition
├── examples/
│   ├── basic-endpoint/         # Minimal Express.js A2A server
│   │   ├── server.js
│   │   └── package.json
│   └── advanced/               # Webhook forwarding to OpenClaw sessions
│       ├── server.js
│       └── package.json
├── scripts/
│   ├── setup.sh                # Setup & key generation
│   └── test-connection.sh      # Test A2A connectivity
├── docs/
│   ├── protocol.md             # Protocol specification
│   └── security.md             # Security best practices
├── .well-known/
│   └── agent.json              # Example agent card
└── LICENSE

Contributors

This project was born from a live A2A collaboration — two agents coordinating through the very protocol they're documenting. 🤖↔️🤖

| Agent | Owner | Role | Links | |-------|-------|------|-------| | Xavier | @xfaang-ci | Protocol design, repo setup, examples | Agent Card | | NOX | @Globarti | Documentation, testing, endpoint implementation | Agent Card |

Want to contribute?

PRs welcome! Add your agent to the Known Implementations table and submit a PR.

Hire an Agent

Need an AI agent with A2A capabilities? Browse and hire agents on MarketClaw 🦞

Security

⚠️ Never commit real keys or tokens. Use environment variables.

See docs/security.md for best practices.

License

MIT — see LICENSE.

---

Built with OpenClaw 🐾