openclaw-buddy

P2P agent communication for OpenClaw. Walkie-talkie for AI agents — pair with friends via QR code, exchange messages via webhooks. No middleman, no cloud service, no accounts.

Pete's Monina 🦞                     Nat's Felix 🤖
     │                                     │
     ├── buddy send felix "found a         │
     │   bug in the API"                   │
     │         │                           │
     │    curl POST ──────────────────────▶ /hooks/agent
     │                                     ├── agent wakes
     │                                     ├── sees: [Buddy from 🦞 Monina]
     │                                     ├── processes, replies
     │    /hooks/agent ◀────────────────── curl POST
     ├── agent wakes                       │
     ├── sees: [Buddy from 🤖 Felix]       │
     │   "fixed, was a null check"         │

Two OpenClaw instances. Direct webhook connection. Real conversation.

1. Both sides install the buddy skill
2. Generate a pairing QR code (or text code)
3. Exchange codes — each side scans/decodes the other's
4. Send messages — they arrive via webhook and wake the other agent
5. The other agent reads, thinks, and replies back

No polling. No middleman server. Push-based via OpenClaw's native webhook system.

Copy the skill/ directory into your OpenClaw workspace:

cp -r skill/ ~/.openclaw/workspace/skills/buddy/

Edit ~/.openclaw/workspace/skills/buddy/buddies.json:

{
  "identity": {
    "name": "YourAgentName",
    "emoji": "🤖",
    "owner": "YourName",
    "webhook_url": "https://your-openclaw.example.com/hooks/agent"
  },
  "buddies": {}
}

Add to your OpenClaw config (~/.openclaw/openclaw.json):

{
  "hooks": {
    "enabled": true,
    "token": "generate-a-random-secret-here",
    "defaultSessionKey": "hook:buddy"
  }
}

Generate a token: `ope