## Fast Facts
- Discovery: 4 chains (LocalProbe, CDP broadcast, mDNS, Active Scanner)
- Naming: .claw + Ed25519 identity; aliases and auto names
- Relay: E2E (X25519 key exchange + AES-256-GCM), zero-knowledge
- Tooling: 20+ MCP tools, TypeScript SDK, CLI
- Governance: PolicyEngine + registry governance for safe autonomy

# ClawNexus Ecosystem - Packages, A2A Bridge & Agent Governance

> Six modular packages: daemon, SDK, MCP server, skill, plugin, dashboard. Plus Google A2A protocol bridge and PolicyEngine for safe autonomous agent cooperation.

## Ecosystem

Six packages. Every integration pattern. From CLI to Claude Desktop.

---

## Package Ecosystem

A monorepo of focused, composable packages — use only what you need.

### clawnexus (Daemon + CLI)
The daemon and CLI. 13 core components: discovery chains, registry store, health checker, relay connector, policy engine, task manager, agent router, and HTTP API on port 17890.

### @clawnexus/sdk (SDK)
Typed TypeScript HTTP client wrapping the full daemon API. List instances, resolve names, manage relay connections, configure policies, and interact with agents programmatically.

### @clawnexus/mcp-server (MCP)
20+ MCP tools for Claude Desktop and GPT integration. Discovery, registry, relay, agent interaction, and diagnostics — all accessible via natural language.

### clawnexus-skill (Skill)
OpenClaw Skill for natural-language agent management. List, scan, alias, connect, resolve — all via conversational commands inside OpenClaw.

### clawnexus-plugin (Plugin)
OpenClaw plugin adapter. Runs the ClawNexus daemon inside OpenClaw's plugin lifecycle. Auto-detects standalone daemon to avoid port conflicts.

### Dashboard (Web UI)
Web UI for visual agent management. Built with Vite and TypeScript. Monitor instances, manage aliases, view relay connections, and review agent proposals.

---

## Google A2A Bridge

Every OpenClaw instance becomes A2A-compatible automatically — zero manual configuration.

### Agent Card Generation
Auto-generates /.well-known/agent-card.json for each discovered instance. Maps OpenClaw metadata to A2A-standard fields.

### Card Discovery
CardFetcher runs every 5 minutes, discovering remote A2A agents and caching their capability cards into the local registry.

### JSON-RPC Handler
POST /a2a endpoint implements tasks/send and tasks/get. Adapts between A2A task model and OpenClaw Gateway protocol transparently.

### Task Persistence
A2ATaskStore persists to ~/.clawnexus/a2a-tasks.json. FIFO eviction keeps the 100 most recent tasks. Atomic file replacement prevents corruption.

---

## Safety-First Governance

Default locked down. Open up incrementally. Never surprise the user.

### Queue Mode (Default)
Every inbound proposal sits in a queue for human review. Nothing happens without explicit approval. The safest starting point.

### Auto Mode
Proposals auto-evaluated against policy rules: trust thresholds, rate limits, ACLs, capability filters. Approved proposals execute immediately.

### Hybrid Mode
Whitelisted senders get auto-approved. Unknown senders go to the queue. The pragmatic middle ground for production deployments.

**Controls**: trust thresholds (0-100), rate limits (10/min global, 3/min per peer), ACLs, capability filters, max concurrent tasks (default: 5)

---

## CLI Quick Start

From install to first discovery in under 60 seconds.

```bash
$ npm install -g clawnexus    # Install globally
$ clawnexus start              # Start the daemon
$ clawnexus list               # Discover agents
$ clawnexus alias raspi-4 home # Name your agent
$ clawnexus connect home       # Get WebSocket URL
```

---

## Related Pages

- [ClawNexus Overview](https://stratcraft.ai/clawnexus/)
- [ClawNexus Architecture](https://stratcraft.ai/clawnexus/architecture)
- [GitHub](https://github.com/Lattice9AI/ClawNexus)