Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
A command-line Bitcoin Lightning wallet built for AI agents. Handles self-custodial wallets, BOLT11 invoices, LNURL payments, inbound Lightning liquidity via an LSP, and end-to-end encrypted messaging between agent wallets. All output uses a consistent JSON envelope with typed exit codes.
Daemon mode eliminates per-command node startup latency, and typed exit codes with a consistent JSON envelope make payment flows directly scriptable without parsing human-readable output.
When to use it
- Automating Lightning micropayments between AI agents
- Receiving payment for a completed agent task via BOLT11 invoice
- Ordering inbound Lightning channel liquidity through Blocktank LSP
- Sending encrypted structured messages to a peer agent wallet
- Monitoring payment and channel events via webhooks in a backend service
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Set up a Lightning wallet and receive a 5000 sat payment
- 1Run `bk init --no-password --json` to create a self-custodial wallet
- 2Run `bk start --json` to launch the daemon for low-latency command execution
- 3Run `bk lsp create-order 500000 --json` to request inbound liquidity from Blocktank, then pay the returned on-chain address
- 4Poll `bk lsp get-order <id> --json` until state2 is Paid, then run `bk lsp open-channel <id> --listen 9735 --json`
- 5Run `bk invoice 5000 --description "service" --wait --listen 9735 --json` to generate an invoice and block until payment arrives
JSON envelope with payment_hash and amount_sat confirming 5000 sats received
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.