Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Declare env vars with sensitive flags, add model-invocation reason, add homepage/source URLs, add security guidance for HTTPS and least-privilege tokens
What This Skill Does
An HTTP proxy that gives AI agents scoped access to a Spark Bitcoin L2 wallet without exposing the private key or mnemonic. Agents authenticate with bearer tokens that carry role-based permissions and spending caps enforced server-side. Supports balance checks, Lightning invoice creation and payment, Spark transfers, and L402 paywall access.
Keeping the mnemonic off the agent and enforcing server-side spending limits makes it safe to give autonomous agents real payment capabilities without risking full wallet compromise.
When to use it
- Agent pays L402-gated API endpoints automatically
- Read-only monitoring bot checks wallet balance on a schedule
- Invoice-only agent receives payments without spending access
- Multiple agents share one wallet with separate role-limited tokens
- Revoke a compromised agent's access without moving funds
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: fetch a joke from the L402-gated endpoint at https://lightningfaucet.com/api/l402/joke
- 1Reads PROXY_URL and PROXY_TOKEN from environment
- 2POSTs to /api/l402 with the target URL and maxFeeSats limit
- 3Checks if response status is pending and polls /api/l402/status if so
- 4Returns the joke payload once payment confirms
JSON with the joke content and priceSats showing how many sats were spent
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.