llm_wallet

What This Skill Does

The llm-wallet skill enables OpenClaw agents to manage crypto wallets and perform secure micropayments using the x402 protocol. Designed specifically for the Polygon blockchain, it facilitates the use of USDC stablecoins to pay for API access or data services that require a financial transaction. By managing wallet keys, tracking balances, and enforcing strict spending limits, it acts as a robust financial intermediary for automated agents. The skill handles the entire lifecycle of an x402 payment, from checking if a payment is required to executing the transaction and registering APIs as reusable tools for future tasks.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/akshatgada/llm-wallet Once installed, you can initialize your local wallet using llm-wallet create. Always ensure you have configured your spending limits immediately after wallet creation to maintain strict control over automated spending.

Use Cases

This skill is ideal for agents that require access to premium data sources, such as real-time financial market APIs, advanced weather prediction services, or academic research databases that charge per request. It automates the micropayment flow, allowing your agent to research, request access, pay, and consume data without manual intervention after the initial approval. Additionally, it serves as a secure vault for your agent's digital assets, ensuring that all interactions with decentralized finance protocols remain within user-defined constraints.

Example Prompts

1. "Check my current USDC balance on the Polygon Amoy testnet and set a daily spending limit of 2 USDC so I can start accessing the premium weather service."
2. "I need to use the weather_api tool. Please check the cost for London data, show me the transaction details, and wait for my approval to pay."
3. "List all my currently registered paid APIs and tell me how much I have spent on transactions this week."

Tips & Limitations

Always prioritize setting conservative spending limits when first using the skill. While llm-wallet automates payments, the protocol requires explicit user interaction for authorization. Ensure you are using the correct network; the default is set to Polygon Amoy for safety. Be aware that transaction fees (gas) on Polygon are typically low, but they are separate from the USDC payment amount. Keep your private keys secure and never share them with unauthorized entities. If you encounter issues with payments, use llm-wallet check-payment to verify the endpoint's x402 requirements before attempting to call the service.