agentwalletapi

What This Skill Does

The agentwalletapi provides a secure, programmatic interface for managing crypto wallets directly from your AI agent environment. By integrating with OpenclawCash, it enables agents to perform complex financial operations across both EVM-compatible networks and Solana. This tool abstracts the complexities of blockchain transactions, allowing your agent to check balances, monitor transaction history, and execute native asset or token transfers with ease. It is designed to act as the financial engine for autonomous agents that require liquidity to pay for services, conduct trades, or manage digital treasury assets.

Installation

To begin, ensure you have the required system dependencies installed, specifically curl and optionally jq for formatted output. Start by running the setup script located in the skill directory: bash scripts/setup.sh. This initializes your environment configuration. Next, navigate to the newly created .env file and input your AGENTWALLETAPI_KEY, which you can obtain by creating a wallet and enabling API access via the OpenclawCash dashboard. If you are operating in a custom environment, you may also set the AGENTWALLETAPI_URL variable, though the default is sufficient for most users.

Use Cases

• Automated Payments: Agents can autonomously pay for compute or subscription services using native tokens.
• Treasury Management: Track balances across multiple EVM and Solana wallets to trigger alerts or rebalancing actions.
• DeFi Interactions: Execute token swaps and liquidity provision using the quote and swap endpoints.
• Asset Transfers: Move assets between internal hot wallets or external addresses based on predefined agent logic.

Example Prompts

1. "Check the current balance of my 'Trading Bot' wallet and list the last five transactions to verify the latest swap result."
2. "Transfer 0.5 ETH from my main wallet to the address 0x71C... and confirm the transaction hash once completed."
3. "Get a quote for swapping 100 USDC to WETH on mainnet, then execute the swap if the slippage is below 0.5%."

Tips & Limitations

• Safety First: Always use read-only commands (like balance or wallets) when testing in a new environment. Never expose your private keys via command-line arguments; use stdin piping for imports to avoid leaving traces in your shell history.
• Permissions: Ensure allowWalletImport is explicitly enabled in the OpenclawCash dashboard only when necessary. High-risk write actions require the --yes flag to prevent accidental execution.
• Network Awareness: Be mindful of network costs. Always verify your current chain context before initiating transfers to avoid transaction failure or asset loss.