cashu

What This Skill Does

The Cashu skill enables the OpenClaw agent to interact with the Nutshell CLI, a robust and privacy-focused implementation of the Cashu ecash protocol. It allows the agent to function as a self-custodial financial assistant, enabling it to check balances, receive ecash tokens, and interact directly with the Lightning Network. By managing ecash locally, the skill provides a bridge for agents to handle micro-payments or larger transactions without needing to manage complex, full-node Bitcoin infrastructure.

Installation

To enable this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/a1denvalu3/cashu

Ensure that the cashu CLI is installed on your system using pipx or pip. The agent requires the CASHU_DIR and MINT_URL environment variables to be defined in the agent's environment configuration to authenticate and interact with your preferred mint.

Use Cases

1. Micropayment Automation: Automatically pay for digital goods or services by resolving Lightning invoices or Lightning addresses via the agent.
2. Private Value Transfer: Send ecash tokens directly to other users or addresses securely.
3. Financial Monitoring: Use the agent to keep track of your available balance and pending tokens in your Cashu wallet.
4. Liquidity Management: Easily create invoices to receive Bitcoin payments from external sources into your private ecash balance.

Example Prompts

1. "Check my current wallet balance for the mint at https://8333.space:3338 and tell me if I have any pending tokens."
2. "Pay this Lightning invoice: [bolt11_string] using my current wallet configuration."
3. "Create a new Lightning invoice for 500 sats so I can receive funds into my wallet."

Tips & Limitations

• The --yes Flag: This is the most critical requirement for agent integration. Since the agent cannot interact with terminal prompts, you must ensure the --yes flag is always utilized in commands to prevent the process from hanging on confirmation requests.
• Environment Variables: Always verify that CASHU_DIR and MINT_URL are exported in the environment where the OpenClaw agent runs; otherwise, the skill will fail to locate the wallet or the mint.
• Security: As this is a financial tool, ensure your server environment is secure. Never expose private wallet data or API keys in logs or shared configurations.