alby-bitcoin-payments-cli-skill

What This Skill Does

The alby-bitcoin-payments-cli-skill acts as a powerful bridge between your AI agent and the Bitcoin Lightning Network. Leveraging the NIP-47 (Nostr Wallet Connect) protocol, this skill allows your agent to perform complex wallet operations securely via the command line. Whether you need to manage your personal funds, automate invoice generation, or perform currency conversions, this skill provides a robust interface to interact with your preferred Alby-compatible Lightning wallet.

Installation

To integrate this skill into your agent, run the following command in your terminal:

clawhub install openclaw/skills/skills/rolznz/alby-bitcoin-payments-cli-skill

Ensure you have Node.js installed, as the skill utilizes npx to execute the underlying Alby CLI tool. You will need to provide your NWC connection secret either via a local file (e.g., ~/.alby-cli/connection-secret.key) or the NWC_URL environment variable to enable wallet-based commands.

Use Cases

This skill is highly versatile. You can use it to:

• Automated Payments: Program your agent to pay invoices instantly upon receiving a request.
• Merchant Services: Automatically create and wait for payment on invoices for products or services.
• Budget Management: Frequently check your wallet balance or transaction history to stay within financial boundaries.
• Financial Calculations: Quickly convert between fiat currencies and satoshis without switching to a browser.
• Testing & Development: Use the provided faucet command to spin up a temporary wallet for testing your AI workflows.

Example Prompts

1. "Check my current Alby wallet balance and list the last 5 transactions."
2. "Create an invoice for 5000 sats and save it to my records."
3. "Convert 10 USD into satoshis using the current market rate."

Tips & Limitations

• Security First: Never expose your connection secret in plain text within chat logs or share it with unauthorized users. The agent is configured to treat these as sensitive; ensure you follow the file-based storage recommendations.
• Unit Awareness: Always verify that amounts are in satoshis before executing commands, as the CLI tool expects raw units.
• Wallet Support: While this works with any NWC-compatible provider, Alby Hub is recommended for its robust multi-wallet and permission management features.