home / skills / openclaw / skills / agent-crypto-wallet

agent-crypto-wallet skill

safe

This skill helps agents interact with OpenclawCash wallets to transfer assets, check balances, and manage wallets across EVM and Solana networks.

npx playbooks add skill openclaw/skills --skill agent-crypto-wallet

Review the files below or copy the command above to add this skill to your agents.

Files (5)

SKILL.md

758 B

---
name: agentwalletapi
description: Deprecated legacy skill entry. Use the current OpenClawCash skill instead.
license: Proprietary
compatibility: Deprecated. Use the current OpenClawCash skill at https://clawhub.ai/macd2/open-claw-cash
metadata:
  author: agentwalletapi
  version: "1.9.1"
  required_env_vars:
    - AGENTWALLETAPI_KEY
  optional_env_vars:
    - AGENTWALLETAPI_URL
  required_binaries:
    - curl
  optional_binaries:
    - jq
---

# Deprecated

This legacy OpenClawCash skill is deprecated and should no longer be used.

Use the current OpenClawCash skill instead:
https://clawhub.ai/macd2/open-claw-cash

Do not continue setup with this legacy copy.
Install the replacement skill from the URL above and follow its current instructions.

Overview

This skill integrates OpenclawCash wallet API for AI agents to manage EVM and Solana wallets programmatically. It enables listing wallets, checking native and token balances, preparing quotes, executing swaps and transfers, and performing agent-safe wallet lifecycle actions. Use it when an agent must hold, move, or query on-chain assets under API-key policies.

How this skill works

The skill issues authenticated HTTP calls to OpenclawCash agent endpoints using an X-Agent-Key header. Typical flow: discover wallets, query token balances, get a swap quote (EVM only), then execute transfers or swaps; responses include txHash values for on-chain confirmation. It supports ERC-20 and SPL tokens, native coin transfers, and policy-aware operations like wallet creation or import when the API key permits.

When to use it

Autonomously send native coin or token transfers from an agent-managed wallet
Check multi-chain balances (EVM + Solana) before making trading or payout decisions
Execute programmatic token swaps (Uniswap on EVM, Jupiter on Solana)
Create or import wallets under API-key governance for agent use
Fetch curated token lists or on-chain transaction history for auditing

Best practices

Always call /api/agent/wallets first to identify available wallets and their chain
Check token balances before preparing a transfer or swap to avoid 400 insufficient balance errors
Request a Uniswap quote before swap execution on EVM to validate rates and slippage
Include explicit chain in payloads (chain: "evm" | "solana") when the wallet could exist on multiple chains
Respect API-key policy limits (creation/import gated and rate-limited); handle 429 Retry-After responses

Example use cases

Agent pays external services by sending native coin from a managed wallet after verifying balance
Trading bot checks balances, requests an EVM quote, and executes a Uniswap swap via the agent swap endpoint
Compliance agent lists wallet transactions and compiles merged on-chain + app-recorded history
Deployment script programmatically creates or imports a wallet for a new autonomous agent under API-key policy controls
Payout system sends stablecoin (USDC) to multiple recipients via token transfers while verifying platform fee and gas requirements

FAQ

How do I authenticate requests?

Include your API key in the X-Agent-Key header and send JSON (Content-Type: application/json). The skill loads the key from the skill folder .env for CLI use.

Can I transfer any ERC-20 or SPL token?

Yes — EVM endpoints accept any valid ERC-20 contract address; Solana endpoints accept any valid SPL mint address. Curated token lists are also available per network.

What protections exist for transfers?

Wallets may have policy constraints such as whitelists and per-transaction spending limits; policy violations return an error with an explanatory message.