用途:为 AI 智能体提供受控的链上运行环境。私钥与签名留在智能体运行时之外;智能体提交描述意图的 pact,由钱包所有者批准后,智能体只能在授权边界内操作;被拦截的请求返回带原因和可选重试建议的结构化错误。
主要能力:支持多链与代币操作(转账、合约调用、消息签名);pact 按允许的链、代币、操作类型、单笔与累计额度上限、有效期进行授权,生命周期为 pending_approval → active → completed/expired/revoked/rejected;pact 自带 API key,交易须使用 pact["api_key"],超限返回 PolicyDeniedError。
安装与用法:安装 caw CLI:curl -fsSL https://raw.githubusercontent.com/CoboGlobal/cobo-agentic-wallet/master/install.sh | bash,并 export PATH="$HOME/.cobo-agentic-wallet/bin:$PATH";执行 caw onboard --wait 初始化钱包与 TSS Node;用 caw wallet current --show-api-key 获取凭据并设置 AGENT_WALLET_API_URL、AGENT_WALLET_API_KEY、AGENT_WALLET_WALLET_ID。SDK 安装:pip install cobo-agentic-wallet 或 npm install @cobo/agentic-wallet。核心流程为两阶段:用 onboarding key 提交 pact 并轮询至 active,再用 pact 作用域 key 执行交易,并为每笔逻辑交易设置唯一 request_id 以保证幂等。
框架集成:提供 LangChain、OpenAI Agents SDK、CrewAI、Agno、Vercel AI SDK、Mastra 的 Python/TypeScript 集成,以及 MCP 服务(python -m cobo_agentic_wallet.mcp,或 uvx cobo-agentic-wallet[mcp]),可用 include_tools/exclude_tools 收窄工具面。
适用场景与限制:适合需要链上操作的智能体与自动化流水线。测试网可用 caw faucet deposit 领水、chain_id=SETH 等。注意 EVM nonce 需顺序提交,CLI 退出码 0 不代表操作成功,需检查 JSON 中的 success;方法名可能随 SDK 版本变化,以 PyPI/npm 为准。支持链包括 Ethereum、Base、Arbitrum、Optimism、Polygon、BNB Smart Chain、Avalanche C-Chain、Solana 等。