Cardano Wallet Skill for OpenClaw

Generate, restore, and manage Cardano wallets with QR code funding support

Overview

The Cardano Wallet skill provides tools for AI agents to:

• Generate new Cardano wallets (24-word mnemonic)
• Restore wallets from existing mnemonics
• Generate QR codes for easy wallet funding
• Check wallet balances (requires Blockfrost API key)
• Securely backup wallet credentials

Tools

cardano_generate_wallet

Generate a new Cardano wallet with 24-word mnemonic phrase.

Parameters:

• network (optional): "Preprod" or "Mainnet" (default: "Preprod")

Returns:

• address: Cardano address (addr1...)
• vkey: Payment verification key
• credentialsPath: Path to encrypted credentials

Example:

const wallet = await cardano_generate_wallet({ network: 'Preprod' });
console.log('Address:', wallet.address);

cardano_restore_wallet

Restore a wallet from existing mnemonic phrase.

Parameters:

• mnemonic (required): 24-word mnemonic phrase
• network (optional): "Preprod" or "Mainnet"
• agentIdentifier (optional): Identifier to save credentials

Example:

const wallet = await cardano_restore_wallet({
  mnemonic: 'word1 word2 ... word24',
  network: 'Preprod'
});

cardano_generate_funding_qr

Generate QR code for wallet funding. Returns QR code as data URL.

Parameters:

• address (optional): Cardano address
• agentIdentifier (optional): Wallet identifier
• network (optional): "Preprod" or "Mainnet"

Returns:

• qrDataUrl: QR code as data URL (can be displayed in image)
• address: Wallet address
• faucetUrl: Preprod faucet URL (if Preprod network)

Example:

const qr = await cardano_generate_funding_qr({
  agentIdentifier: 'my-wallet',
  network: 'Preprod'
});
// Display qr.qrDataUrl as image

cardano_get_wallet_balance

Get wallet balance in ADA and lovelace. Requires Blockfrost API key.

Parameters:

• agentIdentifier (required): Wallet identifier
• network (optional): "Preprod" or "Mainnet"
• blockfrostApiKey (optional): Blockfrost API key (or use env var)

Environment Variables:

• BLOCKFROST_API_KEY: Blockfrost API key
• BLOCKFROST_PREPROD_API_KEY: Preprod API key
• BLOCKFROST_MAINNET_API_KEY: Mainnet API key

Example:

const balance = await cardano_get_wallet_balance({
  agentIdentifier: 'my-wallet',
  network: 'Preprod'
});
console.log('Balance:', balance.ada, 'ADA');

cardano_backup_wallet

Securely backup wallet credentials (encrypted).

Parameters:

• agentIdentifier (required): Wallet identifier
• network (optional): "Preprod" or "Mainnet"

Returns:

• backupData: Encrypted backup JSON

Wallet Funding Workflow

1. Generate wallet:

   const wallet = await cardano_generate_wallet({ network: 'Preprod' });