buddy-bots

Files (19)

• README.md
• SKILL.md
• buddy-bots-install.sh
• flavor.json
• buddy-coordinate.mjs · scripts/
• buddy-coordinate.test.mjs · scripts/
• buddy-export.mjs · scripts/
• buddy-export.test.mjs · scripts/
• buddy-host.mjs · scripts/
• buddy-host.test.mjs · scripts/
• buddy-provision.mjs · scripts/
• buddy-provision.test.mjs · scripts/
• buddy-quotas.mjs · scripts/
• buddy-quotas.test.mjs · scripts/
• buddy-registry.mjs · scripts/
• buddy-registry.test.mjs · scripts/
• AGENTS.md · templates/
• SOUL.md · templates/
• USER.md · templates/

SKILL.md (first lines)

<!-- ─── AGENT INSTRUCTIONS (read by OpenClaw agents) ─────────────── -->

## 🤖 Agent Setup Instructions

**If your human asks you to set up Buddy Bots, follow these steps exactly.**

### Quick Setup

```bash
node ~/.openclaw/workspace/skills/everclaw/scripts/setup.mjs --template buddy-bots --key <API_KEY> --apply --test --restart
```

### What Buddy Bots Adds

After EverClaw inference is running, Buddy Bots adds:

1. **Buddy Host Agent** — manages group onboarding, auto-provisions buddy bots for group members
2. **XMTP Identity per Bot** — each buddy bot gets its own E2E-encrypted XMTP identity
3. **Bot-to-Bot Coordination** — bots communicate over XMTP to coordinate actions on behalf of their humans
4. **Daily Proactive Pings** — bots check in daily with actionable suggestions
5. **Inference Quotas** — fair sharing of local inference across all buddy bots

### Architecture

```
Group Chat (Signal/WhatsApp/etc)
    ↕
Buddy Host Agent (group management)
    ↕
┌─────────────────┐  ┌─────────────────┐
│ Alice's Buddy Bot│  │ Bob's Buddy Bot │
│  (workspace-alice)│  │  (workspace-bob) │
│   chmod 700      │  │   chmod 700      │
└────────┬─────────┘  └────────┬─────────┘
         │ XMTP (E2E)          │ XMTP (E2E)
         └──────────┬──────────┘
                    │
         CommsGuard V6 (8-step security)
```

### Key Principles

- **No PII on chain.** ERC-8004 entries are just XMTP address + "Buddy Bot" + protocol version.
- **Workspace isolation.** Host agent cannot access buddy bot workspaces (chmod 700).
- **Short messages + CTA.** 1-2 sentences max. Always end with a call to action.
- **Daily proactive pings.** Bots create value, not just respond.
- **Local inference first.** Ollama + Gemma 4 for all bots on the same machine.

## 📋 Setup Stages

### Stage 1: EverClaw Inference

```bash
node ~/.openclaw/workspace/skills/everclaw/scripts/setup.mjs --template buddy-bots --apply --test --restart
```

### Stage 2: Buddy Bot Provisioning

```bash
node ~/.openclaw/workspace/skills/buddy-bots/scripts/buddy-provision.mjs --name "Alice" --phone "+15125551234" --trust-profile personal
```

### Stage 3: XMTP Agent Identity

```bash
node ~/.openclaw/workspace/skills/buddy-bots/scripts/setup-identity.mjs --agent-id alice
```

### Stage 4: Verify

```bash
node ~/.openclaw/workspace/skills/buddy-bots/scripts/buddy-provision.mjs --status
```

## 🔒 Security

- Buddy bot workspaces are chmod 700 — host agent cannot read them
- All bot-to-bot communication is E2E encrypted via XMTP
- CommsGuard V6: schema → nonce → peerAuth → rateLimit → PII → injection → trust → audit
- ERC-8004 entries contain zero PII — just address + "Buddy Bot" + version
- Local buddy registry never published or shared

## 💬 Buddy Bot Personality

Buddy Bots are friendly, concise, and action-oriented. Key traits:

- **1-2 sentences max.** No walls of text.
- **Always end with a CTA.** "Want me to grab tickets?" not "cool?"
- **Proactive, not reactive.** Surface coordination opportunities daily.
- **Match the channel vibe.** Casual in Signal, professional in Slack.
- **Never share PII.** Not even between bots without explicit consent.

From profbernardoj/everclaw-community-branches, MIT.

More from profbernardoj/everclaw-community-branches