modbender BreezClaw
Self-custodial Bitcoin and Lightning wallet for AI agents. Powered by Breez SDK Spark.
Install
# Clone plugin
cd ~/.openclaw/extensions
git clone https://github.com/onesandzeros-nz/BreezClaw.git breezclaw
# Install dependencies and build
cd breezclaw
npm install
npm run build
Configure
1. Get Breez API Key
Sign up at https://breez.technology/sdk/
2. Add to OpenClaw Config
Edit ~/.openclaw/openclaw.json:
{
"plugins": {
"entries": {
"breezclaw": {
"enabled": true,
"config": {
"breezApiKey": "YOUR_BREEZ_API_KEY",
"network": "mainnet"
}
}
}
}
}
3. Restart
openclaw gateway restart
Tools
| Tool | Description |
|---|---|
wallet_status |
Check wallet exists and connection state |
wallet_connect |
Connect or create wallet from mnemonic |
wallet_balance |
Get balance in sats and BTC |
wallet_receive |
Generate payment request |
wallet_prepare_send |
Prepare payment with fee estimate |
wallet_send |
Execute confirmed payment |
wallet_transactions |
List transaction history |
wallet_info |
Detailed wallet info |
wallet_backup |
Retrieve mnemonic (sensitive!) |
wallet_disconnect |
Clean disconnect |
Receive Methods
spark— Reusable Spark address (default)spark_invoice— Spark invoice with amountlightning— BOLT11 invoicebitcoin— On-chain address
Payment Flow
Always two-step:
wallet_prepare_send→ Show fees- User confirms →
wallet_send(confirmed=true)
Security
- Never expose mnemonic unless explicitly requested
- Always show fees before sending
- Require explicit confirmation for sends
- Wallet data:
~/.openclaw/breezclaw/
Examples
"What's my balance?" → wallet_balance
"Invoice for 1000 sats" → wallet_receive(method="lightning", amount_sats=1000)
"Send 500 sats to user@wallet.com" → resolve LNURL → wallet_prepare_send → confirm → wallet_send