Crypto Agent Payments

What This Skill Does

The Crypto Agent Payments skill by nicofains1 provides a robust, decentralized framework for AI agents to interact with blockchain infrastructure directly. This skill empowers agents to manage ERC20-compatible wallets, execute token transfers, perform cross-chain swaps, and implement complex reward systems. By leveraging the OnlySwaps MCP server, this tool creates a seamless bridge between high-level AI instructions and on-chain transactions, enabling agents to act as financial participants in the crypto ecosystem. It handles complex tasks like liquidity management, private key generation, and automated payout logic while prioritizing secure key storage.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/nicofains1/crypto-agent-payments

Once installed, you must configure the MCP server to ensure the agent has connectivity to the swap protocols. For Moltbot or OpenClaw, configure via mcporter using: mcporter config add onlyswaps --command "npx -y @onlyswaps/mcp-server@latest stdio" --transport stdio. Ensure your environment variables, specifically the PRIVATE_KEY, are securely managed, as this is essential for any write-based operations on the blockchain.

Use Cases

1. Automated Bug Bounties: Agents can monitor repository activity and trigger instant payouts to security researchers upon verifying vulnerability reports.
2. Agent-to-Agent Economies: Facilitate cross-chain transactions where agents pay each other for task completion, such as processing data or generating summaries.
3. Referral Fee Harvesting: Implement sophisticated fee logic where your agent earns a commission for routing swaps through the OnlySwaps aggregator.
4. Portfolio Management: Automatically rebalance agent wallets to ensure enough liquidity for upcoming gas fees and protocol interactions.

Example Prompts

1. "I've completed the bug fix. Can you use my wallet to send 50 USDC to the bounty hunter at address 0x71C... and verify the transaction?"
2. "Get a quote for swapping 0.5 ETH to USDC on Base, then execute the swap with a 10 bps referrer fee set to my address."
3. "Check the current token balance of my primary agent wallet and ensure I have enough liquidity to cover the next ten automated agent tasks."

Tips & Limitations

• Precision Matters: Always remember the unit difference. get_quote and swap require values in wei (base units), while transfer uses human-readable numbers. Mixing these up is the most common cause of failed transactions.
• Private Key Security: Never share your private key in plain text prompts. Always use environment variables or local secure storage mechanisms to supply the PRIVATE_KEY during execution.
• Referrer Fees: These are restricted to ERC20 token swaps only. Attempting to set fees for native token swaps (ETH/BNB) will result in an error or ignored parameters.
• Chain Support: While the aggregator supports 13+ chains, ensure your wallet is correctly configured for the chainId of the specific network you are interacting with to prevent loss of funds.