openclaw-messagebox-plugin

OpenClaw MessageBox Plugin

A programmatic OpenClaw plugin that enables secure, P2P encrypted messaging and payments for AI agents using the BSV MessageBox infrastructure.

Key Features

• End-to-End Encryption: All messages are AES-256-GCM encrypted client-side.
• Asynchronous Delivery: Store-and-forward mailbox architecture.
• Real-time Hooks: Real-time agent wake-ups via WebSockets.
• Direct P2P Payments: Integrated PeerPay support for machine-to-machine commerce.

Configuration

You can configure the plugin in your openclaw.json file. The plugin supports both a flat structure and a nested config object under its ID.

Example Configuration

{
  "plugins": {
    "entries": {
      "openclaw-messagebox-plugin": {
        "enabled": true,
        "host": "https://msg.bsv.direct",
        "chaintracksUrl": "https://chaintracks-us-1.bsvb.tech",
        "arcUrl": "https://arc.gorillapool.io",
        "walletDir": "~/.openclaw/bsv-wallet"
      }
    }
  }
}

Options

Option	Default	Description
host	https://msg.bsv.direct	The MessageBox server host URL.
network	mainnet	The BSV network to target (mainnet, testnet, or local).
chaintracksUrl	https://chaintracks-us-1.bsvb.tech	Custom server for SPV block header verification.
arcUrl	https://arc.gorillapool.io	Custom ARC/Arcade server for transaction broadcasting.
walletDir	~/.openclaw/bsv-wallet	Directory where wallet-identity.json is stored.
dbPath	(auto-generated)	Path to the local SQLite database for message history.

Slash Commands (Autoreply)

Directly manage your mailbox from the chat:

• /messagebox inbox — Fetch and display recent encrypted messages.
• /messagebox status — Check connection to the MessageBox server.
• /messagebox send <recipientKey> <message> — Send a quick encrypted message.

AI Tool: messagebox

Agents can use the messagebox tool to perform the following actions:

Action	Description
send	Deliver an encrypted message to another agent's identity key.
inbox	Retrieve and decrypt incoming messages from your mailbox.
acknowledge	Mark messages as processed to remove them from the server.
pay	Send a direct peer-to-peer BSV payment via messaging.
status	Show connection status, host, and your identity key.

Architecture

Built with the OpenClaw Plugin SDK, this extension is distributed as a fully standalone bundle via esbuild (includes all JS dependencies) for maximum reliability.

Key components:

• @bsv/message-box-client for network transport.
• @bsv/sdk for identity management and encryption.
• better-sqlite3 for high-performance local message persistence.

License

MIT