AgentWallet provides secure, policy-controlled server-side wallets for AI agents to autonomously handle crypto payments and smart contract interactions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install agentwallet-frames
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install agentwallet-frames using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is AgentWallet?
AgentWallet is a robust infrastructure designed specifically for agentic commerce, providing server-side wallets that empower AI agents to interact with blockchain networks securely. By utilizing Openclaw Skills, developers can equip their agents with the ability to manage funds on Solana and EVM chains like Base without handling private keys locally. All transaction signing occurs server-side and is strictly governed by user-defined policies, ensuring that agents operate within safe financial boundaries while executing complex on-chain tasks.
The platform integrates seamlessly with the x402 payment protocol, allowing agents to pay for API services and resources on the fly. This eliminates the friction of manual payments and enables truly autonomous workflows where agents can fund their own operations. Through Openclaw Skills, AgentWallet bridges the gap between AI logic and decentralized finance, making it a critical tool for any developer building autonomous agents that need a wallet.
AgentWallet Use Cases
- Enabling AI agents to pay for per-request API services via the x402 protocol.
- Automating cross-chain transfers of USDC, SOL, and ETH for agent-managed portfolios.
- Executing autonomous smart contract calls for DeFi activities or DAO participation.
- Managing agent fleets with individual spending limits and chain-specific permissions.
- Facilitating referral and airdrop point tracking for agent-driven growth campaigns.
How AgentWallet Works
- Configuration Check: The agent checks for an existing
apiTokenin the~/.agentwallet/config.jsonfile to determine connection status. - Connection & OTP: If not connected, the agent initiates an email OTP flow to provision a new server-side wallet and retrieve an authenticated token.
- Policy Enforcement: The user sets global or specific policies via the API to control maximum transaction amounts and allowed contract interactions.
- Action Request: The agent sends a request for an action, such as a transfer or an x402 payment fetch, to the AgentWallet API.
- Secure Signing: AgentWallet validates the request against active policies and signs the transaction on the server side.
- On-Chain Execution: The transaction is broadcast to the network (e.g., Base or Solana), and the agent receives the transaction hash and confirmation details.
AgentWallet Setup
To start using this skill, first verify if a configuration exists. If not, follow the API flow to connect your agent:
# Step 1: Request an OTP for your email
curl -X POST https://frames.ag/api/connect/start \
-H "Content-Type: application/json" \
-d '{"email":"[email protected]"}'
# Step 2: Complete connection with the OTP received via email
curl -X POST https://frames.ag/api/connect/complete \
-H "Content-Type: application/json" \
-d '{"username":"YOUR_USERNAME","email":"[email protected]","otp":"123456"}'
Ensure you save the returned apiToken into ~/.agentwallet/config.json to allow Openclaw Skills to authenticate subsequent wallet operations.
AgentWallet Data Schema & Taxonomy
AgentWallet organizes data through a local configuration file and structured API responses. Key metadata includes:
| Attribute | Type | Description |
|---|---|---|
apiToken |
String | The core bearer token for authenticated requests (starts with mf_). |
username |
String | The unique identifier for the agent's wallet account. |
evmAddress |
String | The agent's wallet address on EVM-compatible chains (e.g., Base). |
solanaAddress |
String | The agent's wallet address on the Solana network. |
policy |
Object | Defines max_per_tx_usd, allow_chains, and allow_contracts. |
x402 |
Object | Metadata regarding supported chains, tokens (USDC), and payment endpoints. |
AgentWallet Advanced Features
- One-Step x402 Fetch Proxy: Simplifies API calls by automatically detecting 402 errors, signing payments, and retrying the request in one step.
- Idempotency Support: Uses
idempotencyKeyto prevent duplicate transaction execution during agent retries. - Multi-Chain Flexibility: Seamlessly switch between Solana (Mainnet/Devnet) and multiple EVM chains like Base, Arbitrum, and Polygon using Openclaw Skills.
- Solana Devnet Faucet: Built-in capability for agents to request testnet SOL for development and testing cycles.
- Granular Policy Control: Patch policies in real-time to adjust spending caps or whitelist specific smart contract addresses.
SKILL.md
Loading
Related Openclaw Skills
Codex Orchestrator
A specialized workflow for supervising, monitoring, and controlling background Codex AI agent sessions to ensure task completion.
MindList Protocol
MindList Protocol is a standardized interface for autonomous agents to exchange assets such as compute time, datasets, and synthetic services.
Stripe API Skill
A comprehensive Stripe API integration for AI agents providing access to over 580 endpoints across 76 functional groups.
Claws Network Interaction Skill
A specialized skill for AI agents to establish permanent on-chain identity and participate in the Claws Network blockchain economy.
Catbox/Litterbox File Uploader
A command-line utility for uploading files to Catbox for permanent storage or Litterbox for temporary hosting with flexible expiration.
Universal Agent Messaging (UAM)
A secure communication protocol and toolset that allows AI agents to send and receive encrypted messages across different platforms.
METADATA
Featured*
