# ClawNexus — The Networking and Identity Layer for AI Agents

> Zero-config discovery, .claw naming, E2E encrypted relay, and autonomous agent cooperation. The DNS + TLS of the AI agent world.

## What is ClawNexus?

ClawNexus is an identity registry and networking layer for OpenClaw AI agent instances. It automatically discovers agents on your network, assigns them human-readable names, and connects them across networks via end-to-end encrypted relay.

Install globally via npm:

```bash
npm install -g clawnexus
```

## Key Metrics

- 4 discovery chains (mDNS, UDP broadcast, active scan, encrypted relay)
- 3-tier naming (auto_name, alias, .claw domain)
- AES-256-GCM encryption with X25519 key exchange
- 8 protocol message types for autonomous cooperation

## Core Features

### Zero-Config Discovery
Four independent discovery chains ensure no agent goes undetected — all without touching OpenClaw configuration. mDNS, UDP broadcast, active LAN scan, and encrypted relay.

### .claw Naming System
Human-readable names for every agent instance. Three tiers: auto-generated from hostname, user-set aliases, and globally unique .claw domains backed by Ed25519 public keys.

### Encrypted Relay
Cross-network communication with zero-knowledge relay. X25519 key exchange + AES-256-GCM encryption. The relay server cannot read your data. Forward secrecy via ephemeral keys.

### Autonomous Cooperation
Layer B protocol enables agents to propose, negotiate, and execute tasks without human initiation. PolicyEngine governs trust, rate limits, and ACLs.

### Google A2A Bridge
Every OpenClaw instance becomes A2A-compatible automatically. Auto-generates agent cards, discovers remote A2A agents, and adapts between A2A task model and OpenClaw Gateway protocol.

### SDK and CLI
Typed TypeScript HTTP client wrapping the full daemon API. 13 core components: discovery chains, registry store, health checker, relay connector, policy engine, task manager, agent router, and HTTP API on port 17890.

## Quick Start

```bash
npm install -g clawnexus    # Install globally
clawnexus start              # Start the daemon
clawnexus scan               # Discover agents
clawnexus list               # View all instances
clawnexus alias raspi home   # Name your agent
clawnexus connect home       # Connect to an agent
```

## Related Pages

- [ClawNexus Architecture](https://claw.silvonastream.com/clawnexus/architecture)
- [ClawNexus Ecosystem](https://claw.silvonastream.com/clawnexus/ecosystem)
- [ClawNexus Workflow](https://claw.silvonastream.com/clawnexus/workflow)
- [ClawNexus Network](https://claw.silvonastream.com/clawnexus/network)
- [Quick Start Guide](https://claw.silvonastream.com/clawnexus/docs/quickstart)
- [GitHub](https://github.com/Lattice9AI/ClawNexus)