balance-management

What This Skill Does

The balance-management skill for OpenClaw is a powerful utility designed to streamline your financial operations within the Routstr ecosystem. It serves as your primary gateway for monitoring and managing your account's fiscal health directly from your terminal. The tool provides real-time access to your current balance, allowing you to view your funds in both satoshis (sats) and Bitcoin (BTC). Beyond simple balance reporting, it tracks historical usage statistics, including your total expenditure and the volume of requests processed, giving you granular insight into your service consumption patterns.

Furthermore, the skill automates the treasury management process. Whether you need to replenish your balance via Lightning Network invoices or redeem Cashu tokens, the included shell scripts handle the transaction orchestration securely. It also enables you to poll the status of pending invoices, ensuring that you always stay informed about the state of your top-up transactions without leaving your command line interface.

Installation

To install this skill, use the ClawHub package manager. Run the following command in your terminal:

clawhub install openclaw/skills/skills/sh1ftred/routstr-balance-management

Ensure that you have your API configuration correctly initialized in ~/.openclaw/openclaw.json. This file acts as the bridge between the skills and the Routstr API, housing your authentication keys and preferred account settings.

Use Cases

This skill is ideal for:

• Power users who need to track spending metrics across multiple Routstr-powered services.
• Developers or autonomous agents that require automated top-ups to maintain service uptime.
• Bitcoin enthusiasts who prefer managing finances using native Lightning/Cashu workflows rather than traditional web interfaces.
• Systems administrators managing resource allocation for AI agents, needing to verify payments and usage before scaling requests.

Example Prompts

1. "What is my current Routstr balance in sats, and how much have I spent in total so far?"
2. "Please generate a Lightning invoice for 5000 sats so I can top up my account."
3. "Can you check if the invoice with ID inv_12345 has been paid yet?"

Tips & Limitations

• Verification: Always verify the invoice ID returned by create_invoice.sh before sharing it with a wallet app.
• Configuration: Keep your ~/.openclaw/openclaw.json file secure as it contains your API credentials. Do not share this file with unauthorized users.
• Dependencies: This skill assumes you have a configured connection to the Routstr API. If the command fails, verify your network connectivity and ensure the configuration file permissions are set correctly.