A comprehensive AI agent tool for managing Bitcoin Lightning Network wallets via the LNbits API with integrated safety protocols.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install lnbits-with-qrcode
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install lnbits-with-qrcode 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 LNbits Wallet Manager?
The LNbits Wallet Manager is a specialized skill designed to bridge the gap between AI agents and the Bitcoin Lightning Network. By leveraging Openclaw Skills, developers can equip their agents with the ability to manage wallet liquidity, execute payments, and generate invoices using natural language commands or automated scripts. This skill prioritizes security and transparency, ensuring that sensitive administrative keys are never exposed in chat interfaces.
This integration allows for seamless financial interactions within a terminal or developer environment. Whether you are building automated micro-payment systems or simply need a quick way to check your sats, this skill provides a robust framework for LNbits interaction. By utilizing Openclaw Skills, you benefit from standardized error handling and mandatory confirmation workflows that prevent accidental fund transfers.
LNbits Wallet Manager Use Cases
- Paying Bolt11 invoices securely after verifying payment details.
- Generating micro-payment invoices with automatic QR code creation for visual sharing.
- Monitoring Lightning wallet balances for real-time liquidity management.
- Programmatic wallet creation on demo servers for rapid prototyping and testing.
- Decoding Lightning invoices to inspect transaction metadata before proceeding with a payment.
How LNbits Wallet Manager Works
- The agent connects to the LNbits instance using the configured API key and base URL.
- When a balance check is requested, the agent queries the account state to ensure sufficient liquidity.
- For invoice generation, the agent calls the LNbits API to create a Bolt11 string and simultaneously generates a local QR code image.
- For outbound payments, the agent decodes the invoice first to present the user with the exact amount and destination.
- A mandatory manual confirmation step is triggered before the agent executes the final payment command.
- All media outputs, such as QR codes, are linked directly in the response for immediate user access.
LNbits Wallet Manager Setup
To get started with this skill within the Openclaw Skills ecosystem, ensure your environment is properly configured:
- Install the required Python dependencies:
pip install qrcode[pil]
- Export your LNbits credentials as environment variables:
export LNBITS_API_KEY="your_admin_key_here"
export LNBITS_BASE_URL="https://legend.lnbits.com"
- If you need to create a new wallet for testing:
python3 scripts/lnbits_cli.py create --name "Agent Wallet"
LNbits Wallet Manager Data Schema & Taxonomy
The skill manages data through a combination of API responses and local file storage for media assets. Below is the metadata taxonomy used by Openclaw Skills:
| Attribute | Description | Data Type |
|---|---|---|
payment_request |
The Bolt11 string used for Lightning Network transactions. | String |
qr_file |
Path to the generated PNG file containing the invoice QR code. | File Path |
balance |
Current wallet balance measured in Satoshis. | Integer |
memo |
Optional description or label for the transaction. | String |
adminkey |
Sensitive administrative key (handled via environment variables only). | Secret |
LNbits Wallet Manager Advanced Features
- Strict Secret Masking: Automatically prevents the display of Admin Keys or Wallet IDs in the agent's output logs.
- Automated QR Generation: Built-in PIL integration to convert any Bolt11 string into a scannable image instantly.
- Safety-First Workflows: Mandatory balance checks and decoding steps are baked into the payment lifecycle of Openclaw Skills.
- CLI Interoperability: Directly interfaces with lnbits_cli.py for high-performance execution outside of standard API wrappers.
SKILL.md
Loading
Related Openclaw Skills
skill-guard
A pre-install security gate that scans ClawHub skills for prompt injections and malicious payloads using mcp-scan.
clawtan
A strategic board game skill that enables agents to play a lobster-themed version of Catan through a dedicated command-line interface.
Trails Cross-Chain Integration
A comprehensive developer toolkit for integrating Trails cross-chain infrastructure to enable seamless token swaps, payments, and smart contract execution across multiple blockchains.
Sequence Builder CLI
A powerful CLI for managing Sequence smart wallets, blockchain projects, and token transfers designed for AI agents and automation.
Argus Edge
A sophisticated prediction market betting engine designed to identify edge and optimize stakes using the Kelly criterion.
Binance Watchlist Scanner
A high-performance technical analysis tool that scans 20 Binance spot pairs and ranks them by real-time signal strength.
METADATA
Featured*
