Messagebox

README

# 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.

## AI Tool: `messagebox`
Agents can use the `messagebox` tool to:
- `send`: Deliver encrypted messages to other identities.
- `inbox`: Retrieve and decrypt incoming messages.
- `acknowledge`: Clean up the server-side inbox after processing.
- `pay`: Send direct P2P BSV payments.

## Architecture
Built with the **OpenClaw Plugin SDK**, this extension uses:
- `@bsv/message-box-client` for network transport.
- `@bsv/sdk` for identity management and encryption.
- SQLite for local message persistence.

## License
MIT