buddy-bots

Agent Skills › EverClaw/EverClaw › buddy-bots

buddy-bots

GitHub

用于配置 Agent-to-Agent 社交协调技能，通过 XMTP 实现多代理间端到端加密通信与协作，支持群组管理、身份生成及安全隔离。

flavors/buddybots.org/SKILL.md EverClaw/EverClaw

Trigger Scenarios

用户要求设置 Buddy Bots 需要部署多智能体协调环境

Install

npx skills add EverClaw/EverClaw --skill buddy-bots -g -y

More Options

Non-standard path

npx skills add https://github.com/EverClaw/EverClaw/tree/main/flavors/buddybots.org -g -y

Use without installing

npx skills use EverClaw/EverClaw@buddy-bots

指定 Agent (Claude Code)

npx skills add EverClaw/EverClaw --skill buddy-bots -a claude-code -g -y

安装 repo 全部 skill

npx skills add EverClaw/EverClaw --all -g -y

预览 repo 内 skill

npx skills add EverClaw/EverClaw --list

SKILL.md

Frontmatter

{
    "name": "buddy-bots",
    "version": "0.1.0",
    "homepage": "https:\/\/buddybots.org",
    "metadata": {
        "openclaw": {
            "tags": [
                "buddy-bots",
                "social",
                "coordination",
                "xmtp",
                "agent-to-agent",
                "groups",
                "everclaw",
                "morpheus",
                "erc-8004",
                "privacy"
            ],
            "emoji": "🤝",
            "install": {
                "note": "Buddy Bots uses the EverClaw installer with a Buddy Bots template. curl | bash installer available at get.buddybots.org.",
                "method": "git clone (recommended)"
            },
            "network": {
                "local": [
                    {
                        "port": 8082,
                        "purpose": "Morpheus proxy-router — blockchain session management"
                    },
                    {
                        "port": 8083,
                        "purpose": "Morpheus-to-OpenAI proxy — translates OpenAI API to proxy-router"
                    }
                ],
                "outbound": [
                    {
                        "host": "api.mor.org",
                        "purpose": "Morpheus API Gateway — model inference and session management"
                    },
                    {
                        "host": "base-mainnet.public.blastapi.io",
                        "purpose": "Base L1 RPC — ERC-8004 agent registry"
                    },
                    {
                        "host": "provider.mor.org",
                        "purpose": "Morpheus P2P network — direct inference via staked sessions"
                    },
                    {
                        "host": "api.venice.ai",
                        "purpose": "Venice API — primary inference provider (when configured)"
                    }
                ]
            },
            "requires": {
                "env": [
                    {
                        "name": "WALLET_PRIVATE_KEY",
                        "optional": true,
                        "description": "Morpheus wallet private key — injected at runtime from macOS Keychain. NEVER stored on disk."
                    },
                    {
                        "name": "ETH_NODE_ADDRESS",
                        "default": "https:\/\/base-mainnet.public.blastapi.io",
                        "optional": true,
                        "description": "Base mainnet RPC endpoint for blockchain operations."
                    }
                ],
                "bins": [
                    "curl",
                    "node"
                ]
            },
            "credentials": [
                {
                    "name": "Wallet Private Key",
                    "storage": "macOS Keychain (never on disk)",
                    "required": false,
                    "description": "Required only for local P2P inference (MOR staking). Not needed for API Gateway mode."
                },
                {
                    "name": "Morpheus API Gateway Key",
                    "storage": "openclaw.json providers config",
                    "required": false,
                    "description": "Free API key from app.mor.org. Community bootstrap key included for initial setup."
                }
            ],
            "persistence": {
                "services": [
                    {
                        "name": "com.morpheus.router",
                        "purpose": "Proxy-router for Morpheus P2P inference",
                        "mechanism": "launchd KeepAlive (macOS)"
                    },
                    {
                        "name": "com.morpheus.proxy",
                        "purpose": "OpenAI-compatible proxy translating to Morpheus",
                        "mechanism": "launchd KeepAlive (macOS)"
                    },
                    {
                        "name": "ai.openclaw.guardian",
                        "purpose": "Gateway health watchdog with billing-aware escalation",
                        "mechanism": "launchd StartInterval (macOS)"
                    }
                ],
                "directories": [
                    "~\/morpheus\/ — proxy-router binary, config, session data",
                    "~\/.openclaw\/workspace\/skills\/everclaw\/ — inference skill files",
                    "~\/.openclaw\/workspace\/skills\/buddy-bots\/ — buddy bot provisioning and coordination",
                    "~\/.openclaw\/logs\/ — guardian logs"
                ]
            }
        }
    },
    "description": "Agent-to-agent social coordination. Create a group, every member gets their own buddy bot. Bots talk over XMTP to coordinate real-world actions on behalf of their humans. Built on EverClaw + XMTP + ERC-8004."
}

🤖 Agent Setup Instructions

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

Quick Setup

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:

Buddy Host Agent — manages group onboarding, auto-provisions buddy bots for group members
XMTP Identity per Bot — each buddy bot gets its own E2E-encrypted XMTP identity
Bot-to-Bot Coordination — bots communicate over XMTP to coordinate actions on behalf of their humans
Daily Proactive Pings — bots check in daily with actionable suggestions
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

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

Stage 2: Buddy Bot Provisioning

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

Stage 3: XMTP Agent Identity

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

Stage 4: Verify

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