🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Bitcoin Wallet using Breez Spark SDK

by @robertclarkson

Self-custodial Bitcoin and Lightning wallet for AI agents. Send and receive sats via Lightning Network, Spark, or on-chain Bitcoin. Use when: checking bitcoin balance, sending/receiving payments, generating Lightning invoices, managing wallet operations. Requires the BreezClaw plugin and a Breez API key.

Versionv1.0.0
Downloads2,350
Stars⭐ 4
TERMINAL
clawhub install bitcoin-wallet

πŸ“– About This Skill


slug: breezclaw name: BreezClaw description: "Self-custodial Bitcoin and Lightning wallet for AI agents. Send and receive sats via Lightning Network, Spark, or on-chain Bitcoin. Use when: checking bitcoin balance, sending/receiving payments, generating Lightning invoices, managing wallet operations. Requires the BreezClaw plugin and a Breez API key." version: 1.0.0 author: onesandzeros-nz keywords: bitcoin, lightning, wallet, breez, spark, sats, payments, self-custodial, breezclaw homepage: https://github.com/onesandzeros-nz/BreezClaw

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 amount
  • lightning β€” BOLT11 invoice
  • bitcoin β€” On-chain address
  • Payment Flow

    Always two-step:

    1. wallet_prepare_send β†’ Show fees 2. 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

    πŸ’‘ 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