什么是 AgentWallet？

AgentWallet 是为自主代理设计的强大金融集成方案，使它们能够轻松驾驭去中心化经济。通过利用 Openclaw Skills 库中的这项技能，开发人员可以赋予其代理在三个主要生态系统（Solana、Base 和 Ethereum）中管理原生代币和 USDC 的能力。该技能利用 BIP-39 助记词来推导所有支持链的地址，确保一个私钥即可管理您的整个跨链投资组合。

该技能以安全第一的理念构建，确保私钥在内存中按需推导，绝不持久化到日志或聊天记录中。无论您是在构建交易机器人、支付代理还是 DAO 贡献者，该技能都为安全、自动化的金融操作提供了必要的基础设施。

下载入口:https://github.com/openclaw/skills/tree/main/skills/voltagemonke/agent-wallet-usdc

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

AgentWallet 应用场景

• 用户与代理之间的自主支付处理和代币转账。
• 自动化的 USDC 跨链桥接，以优化不同网络间的流动性。
• 多链资产的实时投资组合监控和余额报告。
• 为在 Openclaw Skills 环境中需要专用金融身份的新 AI 代理实例提供安全入驻。

1. 用户通过环境变量提供 BIP-39 助记词，或通过安全命令生成新助记词。
2. 该技能使用标准推导路径推导特定链的地址：Solana 使用 m/44'/501'/0'/0'，EVM 链使用 m/44'/60'/0'/0/0'。
3. 当请求交易时，代理会解析自然语言指令并将其映射到相应的区块链脚本。
4. 该技能与公共或自定义 RPC 端点交互，以获取余额或广播已签名的交易。
5. 对于跨链转移，该技能利用 Circle CCTP V2 在源链上销毁 USDC，并在证明后在目标链上铸造。

AgentWallet 配置指南

要将此功能集成到您的 Openclaw Skills 设置中，请遵循以下配置步骤：

1. 生成或导入钱包：使用 CLI 创建新钱包或手动更新配置。

node scripts/wallet.js create

2. 配置环境变量：编辑 .env 文件以包含您的助记词和网络偏好。

WALLET_SEED_PHRASE="您的十二个单词助记词"
NETWORK=mainnet # 默认为 testnet
SOLANA_RPC=https://your-custom-rpc.com

3. 测试连接性：验证代理是否可以查看其推导出的地址。

node scripts/wallet.js addresses

AgentWallet 数据架构与分类体系

AgentWallet 使用结构化方法来管理多链数据和资产。以下是该技能使用的元数据分类：

name: agent-wallet
description: Multi-chain wallet management for AI agents. Create wallets, check balances, transfer tokens (USDC/native), and bridge cross-chain. Use when agents need to send/receive payments, check funds, or manage crypto wallets. Supports Solana, Base, and Ethereum. Trigger phrases include "create wallet", "check balance", "send USDC", "transfer", "my addresses", "wallet status".

AgentWallet

Multi-chain wallet skill for AI agents. One seed phrase, all chains.

Quick Reference

Setup

New Wallet

User: "Create a new wallet"

Generates BIP-39 seed phrase, derives addresses for all chains. Shows seed ONCE with security warning.

Import Existing Wallet

User: "Import my wallet"

Response: "Add your seed phrase to .env as WALLET_SEED_PHRASE, then say 'Show my addresses' to verify."

No seed phrases in chat for imports - security first.

Environment

# Required for wallet operations
WALLET_SEED_PHRASE="your twelve word seed phrase goes here"

# Optional
NETWORK=testnet          # testnet (default) or mainnet
SOLANA_RPC=              # Custom Solana RPC (defaults to public)
BASE_RPC=                # Custom Base RPC (defaults to public)
ETH_RPC=                 # Custom Ethereum RPC (defaults to public)

Commands

Create Wallet

Run: node scripts/wallet.js create

Output format:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
?? NEW WALLET GENERATED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

??  CRITICAL: Save this seed phrase securely!
    It will NOT be shown again.
    Anyone with this phrase can access your funds.

Seed Phrase:
┌────────────────────────────────────────────┐
│ word1 word2 word3 word4 word5 word6        │
│ word7 word8 word9 word10 word11 word12     │
└────────────────────────────────────────────┘

Your Addresses:
├─ Solana:   7xK9...mP4q
├─ Base:     0x7a3B...4f2E
└─ Ethereum: 0x7a3B...4f2E (same as Base)

Add to .env:
WALLET_SEED_PHRASE="word1 word2 word3 ..."

Network: TESTNET
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Show Addresses

Run: node scripts/wallet.js addresses

Shows derived addresses without exposing seed.

Check Balance

Run: node scripts/wallet.js balance [chain]

• node scripts/wallet.js balance - All chains
• node scripts/wallet.js balance solana - Solana only
• node scripts/wallet.js balance base - Base only

Output includes native token + USDC balance per chain.

Transfer

Run: node scripts/wallet.js transfer

Examples:

• node scripts/wallet.js transfer solana USDC 10 7xK9fR2...
• node scripts/wallet.js transfer base ETH 0.01 0x7a3B...
• node scripts/wallet.js transfer solana SOL 0.5 7xK9fR2...

Supported tokens per chain:

• Solana: SOL, USDC
• Base: ETH, USDC
• Ethereum: ETH, USDC

Bridge (Cross-Chain)

Run: node scripts/wallet.js bridge

Bridges USDC between chains using Circle CCTP V2.

Examples:

• node scripts/wallet.js bridge base solana 10 - Bridge 10 USDC from Base to Solana
• node scripts/wallet.js bridge ethereum base 50 - Bridge 50 USDC from Ethereum to Base
• node scripts/wallet.js bridge solana ethereum 25 - Bridge 25 USDC from Solana to Ethereum

Note: Bridging takes 1-5 minutes (burn → attestation → mint). Requires USDC on source chain plus native tokens for gas.

Chain Info

Run: node scripts/wallet.js chains

Lists supported chains, networks, and USDC contract addresses.

Derivation Paths

All chains derive from single BIP-39 seed:

EVM chains share the same address (same derivation path).

Security Model

• One seed per agent - Each agent instance isolated
• Seed shown once - Only at creation, never logged
• Memory only - Private keys derived on-demand, never persisted
• No chat import - Seeds added via .env only (except generation)

Error Handling

Chain References

For RPC endpoints, USDC addresses, and chain-specific details, see references/chains.md.