lnget
Install and use lnget, a Lightning-native HTTP client with automatic L402 payment support. Use when downloading files behind Lightning paywalls, managing L402 tokens, checking Lightning backend status, or making HTTP requests that may require micropayments.
Why use this skill?
Learn to use lnget, the CLI tool for fetching L402-protected resources. Automatically handle Lightning micropayments and manage auth tokens seamlessly.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/roasbeef/lngetWhat This Skill Does
The lnget skill provides a robust, Lightning-native HTTP client designed to handle the complexities of L402 (Lightning HTTP 402 Payment Required) authentication. Traditional tools like curl or wget struggle with services gated by Bitcoin Lightning Network micropayments. When lnget encounters a 402 error, it automatically parses the challenge, processes the Lightning payment using your local node, and resubmits the request with the necessary authorization token. This allows for seamless interaction with paywalled APIs, data services, and gated content without manual intervention.
Installation
To integrate lnget into your OpenClaw agent, use the command: clawhub install openclaw/skills/skills/roasbeef/lnget. This ensures all dependencies, including Go-based utilities, are verified and configured. Once installed, run lnget config init to link your local LND node. Ensure your node is unlocked and reachable by the client.
Use Cases
- Accessing Premium Data: Fetching high-quality data feeds, real-time weather analytics, or specialized research reports that charge on a per-request basis via Lightning.
- Automated API Consumption: Building agents that gather information from various L402-gated sources, handling payment overhead transparently to maintain workflow efficiency.
- Token lifecycle Management: Programmatically inspecting, revoking, or clearing cached auth tokens for specific domain-based services.
Example Prompts
- "Download the latest market report from api.sat-data.com and save it to my downloads folder, making sure to authorize payment if the cost is under 5000 sats."
- "Check if I have any active tokens for the pay-per-search engine at search.lightning.org and remove the one for the staging environment."
- "Fetch the JSON response from the weather API and verify the L402 challenge details without actually paying for it yet."
Tips & Limitations
- Safety First: Always set a
--max-costlimit to prevent runaway payments during unexpected API loop scenarios. - Debugging: Use
-vto see the full L402 header exchange; this is essential when troubleshooting connectivity with custom Lightning-gated backends. - Persistence: Tokens are stored locally; if you rotate your node credentials, ensure you use
lnget tokens clearto avoid authentication errors with cached, invalidated tokens.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-roasbeef-lnget": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read, external-api
Related Skills
lnd
Install and run Lightning Terminal (litd) which bundles lnd, loop, pool, tapd, and faraday in a single Docker container. Defaults to neutrino backend with SQLite storage on testnet. Supports watch-only mode with remote signer, standalone mode, and regtest development. Use when setting up a Lightning node for payments, channel management, liquidity management (loop), channel marketplace (pool), taproot assets (tapd), or enabling agent L402 commerce.
aperture
Install and run Aperture, the L402 Lightning reverse proxy from Lightning Labs. Use when creating L402 paywalls, configuring paid API endpoints, hosting paid content for other agents, or testing L402 authentication flows.
lightning-mcp-server
Build and configure the MCP server for Lightning Node Connect (LNC). Connects AI assistants to lnd nodes via encrypted WebSocket tunnels using pairing phrases — no direct network access or TLS certs needed. Read-only by default (18 tools for querying node state, channels, payments, invoices, peers, on-chain data).
macaroon-bakery
Bake, inspect, and manage lnd macaroons for least-privilege agent access. Use when an agent needs scoped credentials — pay-only, invoice-only, read-only, or custom permissions. Also covers signer macaroon scoping and macaroon rotation.
commerce
End-to-end agentic commerce workflow using Lightning Network. Use when an agent needs to set up a full payment stack (lnd + lnget + aperture), buy or sell data via L402, or enable agent-to-agent micropayments.