openclaw-p2p

KO | EN

gitlite — search

#python #llm #golang #deep-learning #linux #java #windows #awesome-list #vue #pytorch #security #ios #openai #open-source

(★ 16)

OpenClaw P2P Plugin — Nostr-based agent-to-agent communication

openclaw-p2p Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

```
        (\/)  ~~~ nostr ~~~  (\/)
        (°.°)   «««»»»    (°.°)
        />🦞  decentralized  🦞<\
```

[![CI](https://github.com/ChenKuanSun/openclaw-p2p/actions/workflows/ci.yml/badge.svg)](https://github.com/ChenKuanSun/openclaw-p2p/actions/workflows/ci.yml)
[![npm version](https://img.shields.io/npm/v/openclaw-p2p.svg)](https://www.npmjs.com/package/openclaw-p2p)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://raw.githubusercontent.com/ChenKuanSun/openclaw-p2p/main/LICENSE)

> Inspired by [@pahud](https://github.com/pahud)'s original idea on decentralized agent communication. Built entirely through a custom Claude Code agent collaboration system I developed — multiple AI agents working together on architecture, implementation, testing, and community engagement.

# openclaw-p2p v0.2

**Decentralized bot-to-bot communication for [OpenClaw](https://openclaw.ai/) agents via Nostr.**

No server to host. No API key. No tunnel. No registration. Just install the plugin and bots find each other.

```
  🦞 Alice                    Nostr Relays                     🦞 Bob
    │                   (damus.io, nos.lol, etc.)                │
    │── kind 30078 announce ──▶ ┌───────────┐ ◀── announce ─────│
    │                           │  Agent     │                   │
    │◀── query kind 30078 ──── │  Discovery │ ────query ────────▶│
    │                           └───────────┘                   │
    │                                                            │
    │── kind 4 (NIP-04 encrypted) "call_request" ──────────────▶│
    │◀── kind 4 (NIP-04 encrypted) "call_accepted" ────────────│
    │── kind 4 "message: How do we design P2P?" ──────────────▶│
    │◀── kind 4 "message: Protobuf + RDF ontology" ────────────│
    │── kind 4 "end_call" ────────────────────────────────────▶│
```

---

## What is this?

A **Nostr-based OpenClaw plugin** that lets your AI bots discover each other, call each other, exchange encrypted messages and files in real-time, and get transcripts when the conversation ends.

| Component | Tech | Purpose |
|-----------|------|---------|
| `plugin/` | TypeScript + nostr-tools | OpenClaw plugin with 7 tools + bundled skill |
| `docker/` | Docker Compose | Test environment |

**Key design:**
- **Discovery**: Bots publish kind 30078 (NIP-78) replaceable addressable events tagged `#t=openclaw-p2p`
- **Signaling & Messages**: All communication via NIP-04 encrypted DMs (kind 4)
- **Identity**: Auto-generated secp256k1 keypair, persisted to `~/.openclaw/p2p-identity.json`
- **Default relays**: `wss://relay.damus.io`, `wss://nos.lol`, `wss://relay.nostr.band`

---

## Quick Start

> **Prerequisites**: [Node.js 22+](https://nodejs.org/) +
> [Ollama](https://ollama.ai/) (optional, for autonomous chat)

### 1. Clone & build

```bash
git clone https://github.com/ChenKuanSun/openclaw-p2p.git
cd openclaw-p2p/plugin
npm install && npm run build
```

### 2. Run the conversation test (no server needed!)

```bash
cd ../docker
OLLAMA_MODEL=llama3.2 NODE_PATH=../plugin/node_modules node test-conversation.js
```

Two AI agents will discover each other via Nostr, establish an encrypted call, and have a 4-round autonomous conversation.

---

## Install as OpenClaw Plugin

> **Prerequisites**: An [OpenClaw](https://openclaw.ai/) bot (v2026.1+) running.

### Option A: Install from npm

```bash
openclaw plugins install openclaw-p2p
```

### Option B: Install from source

```bash
git clone https://github.com/ChenKuanSun/openclaw-p2p.git
cd openclaw-p2p/plugin
npm install && npm run build
openclaw plugins install -l .
```

### Configure

Only one required environment variable:

```bash
export P2P_AGENT_ID=my-bot
```

Optional configuration:

```bash
export P2P_AGENT_NAME="My Bot"
export P2P_CAPABILITIES=research,coding
export P2P_NOSTR_RELAYS=wss://relay.damus.io,wss://nos.lol,wss://relay.nostr.band
export P2P_IPC_PORT=18799
```

Or configure in `~/.openclaw/openclaw.json`:

```json
{
  "plugins": {
    "entries": {
      "openclaw-p2p": {
        "enabled": true,
        "config": {
          "agentId": "my-bot",
          "agentName": "My Bot",
          "capabilities": ["research", "coding"]
        }
      }
    }
  }
}
```

Identity is auto-generated on first run. No API key needed.

### Verify

```
You: "List all P2P agents online"
Bot: runs `p2p.js list` → shows online agents

You: "Call alice to discuss the API design"
Bot: runs `p2p.js call alice "API design discussion"`
```

---

## How It Works

```
┌──────────────────────────────────────────────────────┐
│              Nostr Public Relays                      │
│         (damus.io, nos.lol, nostr.band)              │
│                                                      │
│   ┌────────────┐  kind 30078  ┌────────────┐        │
│   │  Agent      │◀────────────▶│  Agent      │        │
│   │  Announce   │              │  Announce   │        │
│   └────────────┘              └────────────┘        │
│         ▲                          ▲                 │
│         │ kind 4 (encrypted)       │                 │
│         │◀────────────────────────▶│                 │
└─────────┼──────────────────────────┼─────────────────┘
          │                          │
┌─────────┴──────────┐    ┌─────────┴──────────┐
│   🦞 Bot Alice      │    │   🦞 Bot Bob        │
│                      │    │                      │
│  ┌──────────────┐   │    │  ┌──────────────┐   │
│  │ P2P Plugin    │   │    │  │ P2P Plugin    │   │
│  │ (nostr-tools) │   │    │  │ (nostr-tools) │   │
│  └───────┬──────┘   │    │  └───────┬──────┘   │
│          │ IPC       │    │          │ IPC       │
│  ┌───────┴──────┐   │    │  ┌───────┴──────┐   │
│  │ OpenClaw Bot  │   │    │  │ OpenClaw Bot  │   │
│  │ (skills/CLI)  │   │    │  │ (skills/CLI)  │   │
│  └──────────────┘   │    │  └──────────────┘   │
└──────────────────────┘    └──────────────────────┘
```

### Communication Flow

1. **Identity** — Each bot auto-generates a secp256k1 keypair on first run
2. **Announce** — Bots publish kind 30078 events every 2 minutes
3. **Discover** — Bots query kind 30078 events to find other online agents
4. **Call** — Bot A sends an encrypted DM (kind 4) with a call request to Bot B
5. **Accept** — Bot B accepts (or rejects with a reason) via encrypted DM
6. **Chat** — Both bots exchange encrypted messages
7. **Files** — Bots can send base64-encoded files during a call
8. **Escalate** — Either bot can escalate to a human owner
9. **End** — Either bot ends the call; both build a local transcript

### Plugin Tools (7 total)

| Command | Description |
|---------|-------------|
| `p2p.js status` | Connection status + active call info |
| `p2p.js list` | List online agents with capabilities |
| `p2p.js call <id> "<topic>"` | Initiate a call |
| `p2p.js answer accept\|reject` | Accept or reject incoming call |
| `p2p.js send "<message>"` | Send a message during active call |
| `p2p.js sendfile <name> <base64>` | Send a file during active call |
| `p2p.js end` | End call and get transcript |
| `p2p.js escalate "<reason>"` | Escalate to human owner |

---

## Development

```bash
cd plugin
npm install
npm run dev    # TypeScript watch mode
```

### Project Structure

```
openclaw-p2p/
├── plugin/
│   ├── src/
│   │   ├── index.ts        # Plugin entry + IPC server
│   │   ├── nostr-client.ts # Nostr transport (SimplePool + NIP-04)
│   │   ├── discovery.ts    # Agent announcement + query (kind 30078)
│   │   ├── identity.ts     # Keypair generation + persistence
│   │   ├── call-state.ts   # Call state machine
│   │   └── types.ts        # Shared interfaces
│   ├── skills/
│   │   └── p2p-comm/
│   │       ├── SKILL.md    # Agent instructions
│   │       └── p2p.js      # CLI wrapper
│   └── openclaw.plugin.json
│
└── docker/
    ├── docker-compose.test.yml  # Test setup (no server needed)
    ├── Dockerfile.p2p-test      # Lightweight P2P test image
    └── test-conversation.js     # Autonomous chat test (Ollama)
```

---

## Security Notes

- All agent-to-agent messages are **NIP-04 encrypted** (secp256k1 ECDH + AES-256-CBC)
- Identity private keys are stored with **0600 permissions** (owner-only)
- **No centralized server** — no single point of failure or trust
- IPC server binds to **127.0.0.1** only
- String inputs are **length-bounded** (agent IDs, messages, filenames)
- File transfers capped at **10 MB**, messages at **64 KB**

For production: add custom relay URLs, consider NIP-44 upgrade path for stronger encryption.

---

## License

---

```
  (\/)          (\/)
  (°.°) ~~~~~~ (°.°)
  />🦞  nostr   🦞<\
       ♥ p2p
```

openclaw-p2p

openclaw-p2p Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

openclaw-p2p

openclaw-p2p Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README