BreezClaw

What This Skill Does

BreezClaw is a powerful, self-custodial Bitcoin and Lightning wallet extension designed specifically for OpenClaw AI agents. It leverages the robust Breez SDK Spark to provide seamless, programmatic access to the Bitcoin economy. By integrating this skill, your agent gains the ability to perform high-velocity transactions on the Lightning Network, interact with Spark addresses, and manage traditional on-chain Bitcoin transactions directly from your command environment. It transforms your agent from a passive assistant into a financial actor capable of handling payments, invoicing, and balance tracking securely and autonomously.

Installation

To install BreezClaw, first navigate to your OpenClaw extensions directory. Execute the following commands to clone the repository and build the environment: cd ~/.openclaw/extensions git clone https://github.com/onesandzeros-nz/BreezClaw.git breezclaw cd breezclaw && npm install && npm run build

Once built, obtain your API key from the Breez dashboard and add it to your ~/.openclaw/openclaw.json configuration file within the plugins section. Ensure you specify your desired network (mainnet or testnet) and restart your gateway using openclaw gateway restart to finalize the integration.

Use Cases

BreezClaw is ideal for automating micro-payments within decentralized applications or AI agent ecosystems. Use it to receive payments for services your agent provides by generating lightning invoices, or to settle debts and subscriptions programmatically. It is also excellent for monitoring agent-managed escrow accounts or managing operational capital held in Bitcoin. Developers can leverage it to bridge the gap between AI task completion and verifiable value transfer.

Example Prompts

1. "Check my current wallet balance and tell me how many sats I have in total."
2. "Generate a Lightning invoice for 2500 sats for the design work I just completed."
3. "Send 1000 sats to the provided Lightning address after showing me the network fee estimate."

Tips & Limitations

Always follow the two-step payment flow: first execute wallet_prepare_send to verify fee estimates, and only proceed to wallet_send after explicit confirmation. Because this is a self-custodial wallet, you are solely responsible for your mnemonic backup. Never share your recovery phrase. Keep in mind that Lightning Network liquidity can occasionally fluctuate, so check wallet_info if a transaction fails to confirm.