circle-wallet

核心用法

Circle Wallet Skill 是面向 OpenClaw 智能代理的开发者控制型钱包集成方案，通过 CLI 工具实现 USDC 的托管式管理。核心流程包含：API 密钥配置 → 实体密钥（Entity Secret）注册 → SCA 智能合约钱包创建 → 多链余额查询与转账。支持通过钱包地址或 ID 自动识别链类型，无需手动指定网络。

显著优点：

• Gas 费抽象：依托 Circle Gas Station 实现测试网及主网的 gas 代付，降低用户操作门槛
• 链抽象设计：21 条区块链（10 主网+11 测试网）统一接口，发送指令自动匹配对应链的 USDC 合约
• SCA 架构：采用智能合约账户（ERC-4337 兼容路径），支持未来可编程权限扩展
• 测试网水龙头：内置 drip 命令一键获取测试网 USDC，便于开发调试

潜在局限：

• 托管模式风险：私钥由 Circle 服务器托管（Developer-Controlled Wallets），非自托管方案，存在第三方信任假设
• 单一资产限制：仅支持 USDC，无 ETH、BTC 等原生资产或多代币管理能力
• 生态锁定：依赖 Circle 的 Gas Station 与节点服务，若服务中断或政策调整将影响可用性
• CLI 交互壁垒：纯命令行操作，无图形界面或移动端适配，对非技术用户友好度低

适合人群：

• 开发测试阶段的 AI Agent 开发者
• 需要快速集成 USDC 支付功能的 OpenClaw 生态构建者
• 愿意接受托管 trade-off 以换取开发效率的中小团队

常规风险：

• API 密钥与 Entity Secret 本地存储于 ~/.openclaw/circle-wallet/，若设备被入侵存在凭证泄露风险
• 主网操作无二次确认机制，误操作指令可能导致资金损失
• 项目为社区个人维护（GitHub: eltontay），非 Circle 官方背书，长期维护与合规审计存不确定性

核心用法

Circle Wallet Skill 是一款面向 OpenClaw 代理的 USDC 钱包管理工具，基于 Circle 官方开发者控制钱包（Developer-Controlled Wallets）SDK 构建。用户通过 CLI 命令完成初始化配置后，可创建 SCA（智能合约账户）钱包、查询多链余额、发送 USDC 转账，并享受 Circle Gas Station 提供的免 Gas 交易服务。

安装后执行 circle-wallet setup 配置 API 密钥与实体密钥，随后即可通过 create、balance、send 等命令管理钱包。Skill 支持 10 条主网与 11 条测试网，交易时自动识别钱包所属链，无需手动指定。测试网用户可通过 drip 命令获取免费 USDC 进行体验。

显著优点

1. 官方 SDK 背书：核心依赖 @circle-fin/developer-controlled-wallets 为 Circle 官方发布，API 端点可信，合规性有保障。
2. 多链原生支持：覆盖以太坊、Base、Arbitrum、Avalanche、Solana 等 21 条链，单 Skill 即可满足跨链资产管理需求。
3. 零 Gas 体验：借助 Circle Gas Station，用户无需持有原生代币即可发送 USDC，显著降低新用户门槛。
4. 代码质量优秀：TypeScript 类型定义完整，无危险函数调用（eval/exec/system），无代码混淆，静态分析得分 95。
5. 隐私合规良好：仅访问 Circle 官方域名，无第三方数据收集，已通过 GDPR、最小权限等合规检查。

潜在局限

1. 敏感凭证明文存储：API 密钥与 Entity Secret 以明文 JSON 形式保存在 ~/.openclaw/circle-wallet/config.json，需用户自行设置文件权限（如 chmod 600）降低泄露风险。
2. 功能边界清晰：仅支持 USDC 与 SCA 钱包，不支持其他代币类型或 EOA 钱包；Gas 免费服务依赖 Circle 基础设施，主网生产环境需确保 Circle 服务可用性。
3. 网络依赖单一：所有操作均依赖 Circle 官方 API，若 Circle 服务端出现异常，Skill 功能将暂时不可用。

适合人群

• OpenClaw Agent 开发者：需要为 AI 代理集成合规、安全的多链 USDC 支付能力。
• DeFi 测试与教学：希望在不持有 ETH/MATIC 等 Gas 代币的情况下，快速体验跨链稳定币转账。
• 企业级 USDC 集成：寻求 Circle 官方技术背书，需满足合规审计要求的团队。

常规风险

• 密钥泄露风险：配置文件若未设限，可能被本地其他进程读取，建议部署时配合系统密钥管理服务或容器隔离。
• 交易不可逆：区块链转账一旦确认无法撤回，使用前务必验证接收地址与金额。
• 测试网与主网区分：drip 命令仅在测试网可用，主网需通过外部渠道充入 USDC。