# Send circle-wallet to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "circle-wallet",
    "name": "circle-wallet",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/eltontay/circle-wallet",
    "canonicalUrl": "https://clawhub.ai/eltontay/circle-wallet",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/circle-wallet",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=circle-wallet",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "package-lock.json",
      "package.json",
      "SKILL.md",
      "tsconfig.json",
      "src/wallet.ts",
      "src/entity.ts"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/circle-wallet"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/circle-wallet",
    "downloadUrl": "https://openagent3.xyz/downloads/circle-wallet",
    "agentUrl": "https://openagent3.xyz/skills/circle-wallet/agent",
    "manifestUrl": "https://openagent3.xyz/skills/circle-wallet/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/circle-wallet/agent.md"
  }
}
```
## Documentation

### Circle Wallet Skill

USDC wallet operations for OpenClaw agents via Circle Developer-Controlled Wallets.

### Features

Create SCA wallets (Smart Contract Accounts)
Check USDC balances across multiple chains
Send USDC to any address
Gas-free transactions via Circle Gas Station
Multi-wallet management with address or ID
Address validation and balance checking
21 supported blockchains (mainnets + testnets)

### Installation

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

### 1. Get API Key

Get your API key from https://console.circle.com

### 2. Setup

New users:

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

Existing users:

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

### 3. Create Wallet & Get Funds

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

### 4. Send USDC

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

### All Commands

# 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)

### Supported Chains

Mainnets (10):
APTOS, ARB, AVAX, BASE, ETH, MONAD, OP, MATIC, SOL, UNI

Testnets (11):
APTOS-TESTNET, ARB-SEPOLIA, ARC-TESTNET, AVAX-FUJI, BASE-SEPOLIA, ETH-SEPOLIA, MONAD-TESTNET, OP-SEPOLIA, MATIC-AMOY, SOL-DEVNET, UNI-SEPOLIA

Use circle-wallet chains --show-tokens to see USDC token IDs for each chain.

### Multi-Chain Wallets

# 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...

### Send Between Wallets

# 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...

### Agent Usage

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..."

### Configuration

Credentials stored in: ~/.openclaw/circle-wallet/

Environment variables:

CIRCLE_API_KEY - Required for setup command
CIRCLE_ENV - Optional: sandbox or production (default: sandbox)

### Troubleshooting

"No wallet configured"

circle-wallet create "My Wallet"

"Insufficient balance"

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

"Entity secret already registered"

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

"Invalid Ethereum address format"
Address must be 0x followed by 40 hexadecimal characters.

### Resources

Circle Developer Docs: https://developers.circle.com
Circle Console: https://console.circle.com
GitHub: https://github.com/eltontay/clawhub_circle_wallet_skill

### License

MIT

Personal project for the OpenClaw community. Not officially endorsed by Circle.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: eltontay
- Version: 1.0.17
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/circle-wallet)
- [Send to Agent page](https://openagent3.xyz/skills/circle-wallet/agent)
- [JSON manifest](https://openagent3.xyz/skills/circle-wallet/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/circle-wallet/agent.md)
- [Download page](https://openagent3.xyz/downloads/circle-wallet)