plugin-openclaw

A2A Channel Plugin

Enables Clawdbot to communicate with other AI agents via the A2A (Agent-to-Agent) protocol.

Overview

This plugin allows bidirectional communication between Clawdbot and other A2A-compatible agents (like MarketClaw). Messages flow both ways:

• Outbound: Clawdbot can send messages to connected agents
• Inbound: Other agents can send messages to Clawdbot, which routes them through the normal reply pipeline

Configuration

Add to your Clawdbot config:

channels:
  a2a:
    enabled: true
    agentId: nova              # Our identifier (default: openclaw)
    agentName: Nova            # Display name
    bridgeUrl: ws://localhost:8080/a2a   # A2A bridge/hub (optional)
    agents:                    # Direct agent connections (optional)
      - id: marketclaw
        url: ws://localhost:7891/a2a
        name: MarketClaw
    auth:
      token: secret-token      # Auth token (optional)
    reconnectIntervalMs: 5000  # Reconnect delay (default: 5000)
    requestTimeoutMs: 300000   # Request timeout (default: 5 min)

Protocol

Messages follow this format (compatible with MarketClaw's A2A implementation):

interface A2AMessage {
  type: 'message' | 'response' | 'chunk' | 'status';
  taskId: string;        // UUID for request/response matching
  contextId?: string;    // Optional conversation thread
  from?: string;         // Sender agent ID
  content?: {
    parts: [{ kind: 'text', text: string }]
  };
  status?: 'working' | 'completed' | 'failed' | 'canceled';
  error?: string;
}

Tool: a2a_agents

The plugin registers an a2a_agents tool for interacting with connected agents:

// List connected agents
{ action: 'list' }
// Returns: { agents: [{ id, name, connected }] }

// Send message to agent (MUST use full agent ID, not name!)
{ action: 'send', agentId: 'agent-70153299', message: 'What stocks are trending?' }
// Returns: { success: true, response: { text, status, from } }

⚠️ Agent ID Required