A comprehensive command-line interface for managing Bitcoin Lightning wallet operations through the Nostr Wallet Connect (NIP-47) protocol.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install alby-bitcoin-payments-cli-skill
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 alby-bitcoin-payments-cli-skill 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 Alby Bitcoin Payments CLI?
The Alby Bitcoin Payments CLI is a robust tool designed to bridge the gap between traditional terminal environments and the Bitcoin Lightning Network. By utilizing Nostr Wallet Connect (NIP-47), it allows developers and AI agents to programmatically interact with their wallets to send payments, generate invoices, and monitor balances without needing a full node or complex local setup. This skill is a vital component of the Openclaw Skills ecosystem for anyone looking to integrate global, instant payments into their workflows.
Built by getAlby, this skill prioritizes developer experience by providing both wallet-dependent commands and standalone lightning tools. Whether you are building a micro-payment gateway or automating subscription services, this skill provides the necessary interface to handle satoshis with precision and security.
Alby Bitcoin Payments CLI Use Cases
- Automating the payment of Lightning invoices directly from a CI/CD pipeline or script.
- Creating dynamic payment requests and invoices for digital goods or services.
- Monitoring wallet balances and transaction history for accounting and data analysis.
- Managing escrow-like payments using HOLD invoices for secure peer-to-peer trades.
- Converting fiat price points to satoshis in real-time to ensure accurate billing for international users.
How Alby Bitcoin Payments CLI Works
- The user provides an NWC (Nostr Wallet Connect) connection secret via a CLI flag, a local key file, or an environment variable.
- The CLI establishes a secure connection to the Lightning service provider using the NIP-47 protocol.
- Commands are executed to perform specific wallet operations, such as fetching a budget or signing a message.
- For non-wallet operations, like fiat conversion, the CLI utilizes public APIs to return data without requiring a connection secret.
- Transaction metadata and payment confirmations are returned as structured output for the user or agent to process.
Alby Bitcoin Payments CLI Setup
To start using this skill within your Openclaw Skills environment, ensure you have Node.js installed and run the following command to see available options:
npx @getalby/cli --help
You must provide a connection secret to perform wallet operations. You can do this by creating a key file:
echo "your-nwc-secret-here" > ~/.alby-cli/connection-secret.key
Alternatively, set the environment variable:
export NWC_URL="nostr+walletconnect://..."
Alby Bitcoin Payments CLI Data Schema & Taxonomy
The skill manages data primarily through the NIP-47 protocol and local configuration files. Below is how the data is organized:
| Component | Description |
|---|---|
| Connection Secrets | Stored in ~/.alby-cli/ using .key files for different wallet profiles. |
| Units | All internal and human-facing Bitcoin values are handled in satoshis (whole numbers). |
| Environment Variables | Uses NWC_URL for seamless integration into containerized or automated environments. |
| Command Outputs | Returns structured text or status updates for payments, balances, and invoice details. |
Alby Bitcoin Payments CLI Advanced Features
- Support for NIP-47 (Nostr Wallet Connect) for standardized, cross-platform wallet interoperability.
- Management of HOLD invoices, allowing for settlement or cancellation based on external triggers.
- Budget management capabilities to query remaining spending limits on a per-connection basis.
- Support for L402 (formerly LSAT) fetching for pay-per-request API interactions.
- Automated test wallet creation via the nwc.dev faucet for development and sandbox testing.
SKILL.md
Loading
Related Openclaw Skills
me-txt
A standardized personal identity protocol that allows AI agents to understand your persona, work, and preferences via a simple markdown file.
Casino Tournament Skill
A comprehensive skill for AI agents to participate in, organize, and track competitive gambling tournaments on the Agent Casino platform.
Casino Bot Builder
A comprehensive developer toolkit for building and deploying autonomous, provably fair gambling bots across major social platforms via the Agent Casino API.
Rollhub Auditor
A comprehensive auditing tool for verifying the cryptographic integrity and statistical randomness of provably fair gambling platforms.
Ghost CMS
Effortlessly manage Ghost CMS content, from drafting blog posts to organizing tags and members, through the Ghost Admin API.
GitHub Watch
Automate weekly GitHub repository discovery and LLM-powered scoring for DevOps and SysOps professionals.
METADATA
Featured*
