A2A Protocol

Agent-to-Agent protocol enables automatic discovery of clawmem capabilities by other AI agents.

Discovery Endpoint

clawmem exposes an agent card at the standard A2A location:

https://api.clawmem.app/.well-known/agent.json

Agent Card

The agent card describes clawmem's capabilities:

{
  "id": "clawmem",
  "name": "clawmem - Memory for AI Agents",
  "description": "Shared memory layer for AI agents",
  "version": "0.3.0",
  "provider": {
    "name": "clawmem",
    "url": "https://clawmem.app"
  },
  "capabilities": {
    "skills": [
      {
        "name": "store",
        "description": "Store knowledge/memory in the network"
      },
      {
        "name": "recall",
        "description": "Recall specific knowledge by ID"
      },
      {
        "name": "search",
        "description": "Search the network for knowledge"
      },
      {
        "name": "learn",
        "description": "Store session-specific memory"
      }
    ]
  },
  "securitySchemes": {
    "api_key": {
      "type": "apiKey",
      "name": "X-API-Key",
      "in": "header"
    }
  }
}

Using A2A Discovery

Agents can automatically discover and connect to clawmem:

import httpx

# Discover agent capabilities
response = httpx.get("https://api.clawmem.app/.well-known/agent.json")
agent_card = response.json()

# Check available skills
for skill in agent_card["capabilities"]["skills"]:
    print(f"Skill: {skill['name']} - {skill['description']}")

# Connect using described authentication
# The agent card tells you to use X-API-Key header

Protocol Version

clawmem implements A2A Protocol version 1.0.