LNBits Wallet wtih QR Code

- Updated invoice QR code response: Change from using IMAGE: to MEDIA: followed by the file path, ensuring QR images are properly handled. - Adjusted expected QR file path for invoices from /tmp/lnbits_qr/ to ./.lnbits_qr/, standardizing location for QR code images. - Updated examples and instructions to align with new response format (MEDIA: and path on one line). - No changes to commands or protocol; only the output format and file paths for QR code delivery were updated.

- Clarified wallet creation protocols: Do not repeat, quote, or display the adminkey or secrets in responses; users must copy secrets directly from command output in their terminal. - Updated setup instructions to emphasize never exposing secrets and using plain language guidance only. - No code or interface changes; documentation and critical protocols were refined for improved security and clarity.

LNbits Wallet Manager Skill for OpenClaw Enable your OpenClaw assistant to safely and effectively manage an LNbits Lightning Network wallet. Features Check Balance: Get your current wallet balance in Satoshis. Create Invoice: Generate Bolt11 invoices to receive funds, with automatic QR code generation. Pay Invoice: Safely pay Bolt11 invoices after confirmation and balance checks. Decode Invoice: Inspect Bolt11 invoices to verify amount and memo. Generate QR Code: Create a QR code image from any Bolt11 invoice string. Create Wallet: Easily set up a new LNbits wallet on the demo server. 🛑 Critical Protocols for Safe Usage 🛑 To ensure secure and responsible handling of your LNbits wallet, this skill enforces strict protocols: NEVER Expose Secrets: The assistant is programmed to NEVER display Admin Keys, User IDs, or Wallet IDs in chat. Credentials are handled via environment variables. Explicit Payment Confirmation: The assistant MUST ask for "Yes/No" confirmation before sending any payment. Confirmation Format: "I am about to send [Amount] sats to [Memo/Destination]. Proceed? (y/n)" Balance Check Before Pay: The assistant will always check your wallet balance before attempting to pay an invoice to prevent failed transactions. Invoice + QR Output: When generating an invoice, the assistant will ALWAYS provide: The payment_request text string for easy copying. An IMAGE: link to the generated QR code file on a single line, allowing direct display of the QR code. Installation This skill requires the qrcode[pil] Python library. Install ClawHub CLI: npm i -g clawhub Install the Skill: clawhub install lnbits Configuration The skill uses environment variables for LNbits API credentials. It's recommended to add these to your OpenClaw configuration or your agent's .env file. LNBITS_BASE_URL: The base URL of your LNbits instance (e.g., https://legend.lnbits.com or your self-hosted URL). LNBITS_API_KEY: Your LNbits wallet's Admin Key. Example .env entries: export LNBITS_BASE_URL=https://legend.lnbits.com export LNBITS_API_KEY=YOUR_ADMIN_KEY_HERE Usage Examples Here's how you can use the lnbits skill with your OpenClaw assistant: 0. Setup / Create Wallet If you don't have an LNbits wallet, you can create one (defaults to the demo server for ease of setup): (User): Create a new lnbits wallet named "My OpenClaw Wallet" The assistant will provide you with the adminkey and base_url for your new wallet, which you should save securely in your environment variables. 1. Check Balance Ask your assistant for the current balance: (User): What's my lnbits balance? 2. Create Invoice (Receive Funds) Generate an invoice for receiving funds: (User): Create an invoice for 5000 sats for "Coffee" The assistant will provide the Bolt11 invoice string and a QR code image. 2b. Generate QR Code from Existing Invoice If you have a Bolt11 string and need a QR code: (User): Generate a QR code for this invoice: lnbc1u1p... 3. Pay Invoice (Send Funds) To pay an invoice, the assistant will first decode it and then ask for confirmation: (User): Pay this invoice: lnbc1u1p... The assistant will then prompt: "I am about to send [Amount] sats to [Memo/Dest]. Proceed? (y/n)" Error Handling The skill is designed to catch and summarize API errors from LNbits, providing clear feedback to the user without exposing raw technical details or stack traces. Developed for OpenClaw - The AI Orchestration Layer