BreezClaw for Openclaw

A self-custodial financial layer for AI agents to send and receive Bitcoin and Lightning payments autonomously.

robertclarkson
v1.0.0
Feb 1, 2026
4
2.5k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install bitcoin-wallet

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install bitcoin-wallet using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is BreezClaw?

BreezClaw is a specialized tool within the library of Openclaw Skills designed to provide AI agents with native financial autonomy. By integrating the Breez SDK Spark, it allows agents to manage a self-custodial wallet without relying on third-party custodial services. This capability is essential for developers building agents that need to pay for resources, accept tips, or manage micro-transactions independently.

As part of the broader ecosystem of Openclaw Skills, BreezClaw ensures that financial operations are handled with technical precision. It bridges the gap between LLM-driven logic and the Bitcoin blockchain, supporting multiple payment protocols including Lightning Network, Spark, and traditional on-chain transactions. This makes it an indispensable asset for any developer looking to monetize AI workflows or enable machine-to-machine payments.

BreezClaw Use Cases

  • Enabling autonomous agents to pay for API usage or cloud computing credits using Bitcoin.
  • Generating reusable Spark addresses or Lightning invoices for AI-generated services.
  • Facilitating micro-payments between different AI agents within a multi-agent system.
  • Creating automated financial assistants that can monitor balances and transaction histories.

How BreezClaw Works

  1. The skill establishes a secure connection to the Breez SDK using your unique API key.
  2. When an agent needs to move funds, it initiates a wallet_prepare_send command to calculate fees and verify the destination.
  3. The system enforces a mandatory two-step confirmation process to ensure financial safety before execution.
  4. Upon confirmation, the wallet_send tool executes the transaction across the Lightning Network or on-chain.
  5. Openclaw Skills manage the persistence of wallet data and transaction logs within the local filesystem for consistent state tracking.

BreezClaw Setup

To integrate this skill into your environment, first clone the repository into your local extensions folder and build the assets:

cd ~/.openclaw/extensions
git clone https://github.com/onesandzeros-nz/BreezClaw.git breezclaw
cd breezclaw
npm install
npm run build

Next, configure your Breez API key and network settings in your main configuration file located at ~/.openclaw/openclaw.json:

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

Finally, restart your gateway to enable the new Openclaw Skills features.

BreezClaw Data Schema & Taxonomy

BreezClaw maintains a structured data hierarchy to ensure transaction integrity and security within Openclaw Skills:

Component Description
Wallet Storage Encrypted wallet files stored at ~/.openclaw/breezclaw/.
Mnemonic Seed The primary recovery key, protected by internal security protocols.
Transaction Ledger A searchable history of all sent and received payments with timestamps.
Payment Methods Support for spark (reusable), lightning (BOLT11), and bitcoin (on-chain) schemas.

BreezClaw Advanced Features

  • Support for Spark reusable addresses allowing for static payment endpoints for agents.
  • Integrated LNURL resolution to simplify sending sats to human-readable addresses.
  • Granular wallet status monitoring including connection states and detailed node information.
  • Two-phase commit architecture for all outgoing payments to prevent unauthorized automated spending.
  • Compatibility with various Openclaw Skills for complex automated financial workflows.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*