BreezClaw

Name: BreezClaw
Rating: 78
Author: onesandzeros-nz

Self-custodial Bitcoin and Lightning wallet for AI agents. Powered by Breez SDK Spark.

Install

bash

# 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

2. Add to OpenClaw Config

Edit ~/.openclaw/openclaw.json:

json

{
  "plugins": {
    "entries": {
      "breezclaw": {
        "enabled": true,
        "config": {
          "breezApiKey": "YOUR_BREEZ_API_KEY",
          "network": "mainnet"
        }
      }
    }
  }
}

3. Restart

bash

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 amount
•lightning — BOLT11 invoice
•bitcoin — 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

code

"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