Circle钱包技能

通过Circle开发者控制钱包为OpenClaw代理提供USDC钱包操作。

功能

• 创建SCA钱包（智能合约账户）
• 跨多条链检查USDC余额
• 向任意地址发送USDC
• 通过Circle Gas Station实现免Gas费交易
• 支持通过地址或ID进行多钱包管理
• 地址验证与余额查询
• 支持21条区块链（主网+测试网）

安装

clawhub install circle-wallet
cd ~/.openclaw/workspace/skills/circle-wallet
npm install
npm link

快速开始

1. 获取API密钥

从以下网址获取您的API密钥：https://console.circle.com

2. 设置

新用户：

circle-wallet setup --api-key your-api-key

现有用户：

circle-wallet configure --api-key your-key --entity-secret your-secret

3. 创建钱包并获取资金

circle-wallet create "My Wallet"
circle-wallet drip                    # Testnet only
circle-wallet balance

4. 发送USDC

circle-wallet send 0x... 10 --from 0x...

所有命令

# Setup
circle-wallet setup --api-key <key>                          # Generate and register entity secret
circle-wallet configure --api-key <key> --entity-secret <s>  # Use existing credentials
circle-wallet config                                         # View configuration

# Chains
circle-wallet chains                   # List all supported blockchains
circle-wallet chains --show-tokens     # Show USDC token IDs
circle-wallet chains --mainnet         # Mainnets only
circle-wallet chains --testnet         # Testnets only

# Wallets
circle-wallet create [name] [--chain <blockchain>]   # Create new SCA wallet
circle-wallet list                                    # List all wallets with balances
circle-wallet balance [wallet-id]                     # Check balance

# Transactions
circle-wallet send <to> <amount> [--from <wallet-id-or-address>]  # Auto-detects chain from wallet
circle-wallet drip [address]                                       # Get testnet USDC (sandbox only)

支持的链

主网（10个）：APTOS、ARB、AVAX、BASE、ETH、MONAD、OP、MATIC、SOL、UNI

测试网（11个）：APTOS-测试网、ARB-SEPOLIA、ARC-测试网、AVAX-FUJI、BASE-SEPOLIA、ETH-SEPOLIA、MONAD-测试网、OP-SEPOLIA、MATIC-AMOY、SOL-开发网、UNI-SEPOLIA

使用circle-wallet chains --show-tokens命令查看各链的USDC代币ID。

使用示例

多链钱包

# Create wallets on different chains (default: ARC-TESTNET for sandbox)
circle-wallet create "Arc Wallet" --chain ARC-TESTNET
circle-wallet create "Base Wallet" --chain BASE-SEPOLIA
circle-wallet create "Polygon Wallet" --chain MATIC-AMOY

# Send automatically uses the correct chain for each wallet
circle-wallet send 0xRecipient... 5 --from 0xArcWallet...
circle-wallet send 0xRecipient... 3 --from 0xPolygonWallet...

钱包间转账

# Create two wallets
circle-wallet create "Wallet 1"
circle-wallet create "Wallet 2"

# Fund first wallet
circle-wallet drip

# Send from wallet 1 to wallet 2 (using addresses)
circle-wallet send 0xWallet2Address... 5 --from 0xWallet1Address...

代理使用

User: "Check my wallet balance"
Agent: [circle-wallet balance] "You have 42.5 USDC"

User: "Send 10 USDC to 0x123..."
Agent: [circle-wallet send 0x123... 10] "Sent! TX: 0xabc..."

配置

凭据存储于：~/.openclaw/circle-wallet/

环境变量：

• CIRCLE_API_KEY- 设置命令必需
• CIRCLE_ENV- 可选值：sandbox或production（默认：sandbox）

故障排除

"未配置钱包"

circle-wallet create "My Wallet"

"余额不足"

circle-wallet drip              # Testnet only
# Or fund wallet externally for mainnet

"实体密钥已注册"

circle-wallet configure --api-key <key> --entity-secret <secret>

"以太坊地址格式无效"地址必须以0x开头，后跟40个十六进制字符。

资源

• Circle开发者文档：https://developers.circle.com
• Circle控制台：https://console.circle.com
• GitHub：https://github.com/eltontay/clawhub_circle_wallet_skill

许可证

MIT

为OpenClaw社区开发的人项目。非Circle官方认可。