lightning

What This Skill Does

The Lightning skill for OpenClaw integrates the Lightning Node Interface (LNI) directly into your AI agent, allowing it to perform Bitcoin transactions across the Lightning Network. It is designed to act as a bridge between your digital assistant and your preferred Bitcoin wallet backend. Whether you use a self-hosted node like Core Lightning (CLN), LND, or Phoenixd, or prefer convenience via custodial services like Strike and Blink, this skill provides a unified command interface to handle payments, generate invoices, decode network details, and manage local contacts. It simplifies complex Lightning operations into natural language or concise command-line interactions.

Installation

1. Navigate to the skill directory: cd ~/workspace/skills/lightning.
2. Execute npm run download to fetch the required LNI binaries for your system architecture.
3. Create a configuration file at ~/.lightning-config.json in your home directory.
4. Populate the JSON with the appropriate credentials for your specific backend (e.g., node URL, macaroons, runes, or NWC connection strings).
5. Ensure your node or service is accessible to the agent and restart the OpenClaw service.

Use Cases

• Automated Payments: Allow your agent to pay for premium API services or digital assets on your behalf.
• Merchant Integration: Generate invoices for products or services directly within the chat interface.
• Wallet Management: Quickly check node balance and status without opening a dedicated wallet GUI.
• Nostr Integration: Utilize NWC (Nostr Wallet Connect) to link mobile or remote wallets to your agent securely.

Example Prompts

• "/lightning invoice 5000 Payment for consulting services"
• "/lightning pay lnurl1dp68gurn8ghj7mrwwehkcup0ppnkjctjyp3n"
• "/lightning history 5"

Tips & Limitations

Critical Safety Note: This skill operates in 'Reckless Mode'. Because the agent has the authority to sign transactions, you must treat your LNI credentials as you would treat a physical wallet. Never expose the agent to public chat endpoints, and strictly limit the balance on connected wallets. Always double-check destination addresses, and prefer using Bolt12 or Lightning Addresses for improved security and ease of use. Always maintain backups of your seed phrases if using non-custodial backends like Breez/Spark.