核心用法
Base Wallet 是一套面向 AI Agent 的加密货币钱包基础设施，允许智能体自主创建和管理以太坊兼容钱包（Base 链），无需浏览器扩展或人工介入。
主要功能模块：
- 程序化钱包创建：通过 CLI 脚本生成新钱包，支持环境变量输出（推荐）、文件存储（需显式授权）或 JSON 格式
- SIWE 认证：完整支持 Sign-In with Ethereum 协议，生成符合 EIP-4361 标准的签名消息
- 链上操作：余额查询、ETH 转账、合约交互（通过 ethers.js）
- BaseMail 集成：使用钱包签名注册 @basemail.ai 邮箱服务
安全架构：
采用分层安全设计，默认使用环境变量传递敏感信息，私钥不落盘；提供可选的文件存储模式，自动设置 600 权限并隔离于 ~/.openclaw/wallets/。
显著优点
1. 真正的自主代理能力：Agent 可独立创建身份、签名认证、执行交易，无需人类持有私钥或点击确认
2. 无浏览器依赖：纯 Node.js 实现，适合服务器/容器化部署，摆脱 MetaMask 等扩展的限制
3. 安全优先设计：v1.1.0 将文件存储改为 opt-in，默认 --env 模式避免私钥持久化；审计日志记录关键操作
4. 标准兼容性：基于 ethers.js v6，完整支持 Ethereum 签名规范，可与任意兼容 SIWE 的服务对接
5. 轻量集成：单一依赖（ethers），脚本即拿即用
潜在缺点与局限性
- 托管风险：若使用
--managed模式，私钥以明文形式存储于本地文件，虽设 600 权限但仍存在文件系统泄露风险 - 无硬件安全模块：不支持 TPM、HSM 或安全 enclave，私钥在内存中可被同进程代码访问
- 单签设计：仅支持 EOA（外部拥有账户），无多签、无智能合约钱包功能（如 Safe）
- 网络限定：仅预配置 Base 主网与 Sepolia 测试网，其他 L1/L2 需手动配置 RPC
- 审计日志局限：日志存于本地
~/.base-wallet/audit.log，无防篡改或远程聚合机制 - 依赖中心化 RPC：默认使用 Coinbase 提供的 RPC 端点，存在可用性与隐私考量
适合人群
- 构建 Web3 AI Agent 的开发者（需要链上身份但不想管理浏览器钱包）
- 自动化交易/DeFi 策略机器人开发者
- 需要 SIWE 服务端认证的 AI 服务（如基于钱包的访问控制）
- 原型验证与测试网场景（快速生成临时钱包）
常规风险
| 风险类别 | 说明 | 缓解建议 |
|---------|------|---------|
| 私钥泄露 | 环境变量被导出、日志泄露、进程内存转储 | 使用专用密钥管理服务（KMS/Vault），生产环境禁用 `--managed` |
| 供应链攻击 | ethers.js 或被篡改 | 锁定依赖版本，启用 npm audit |
| 误转账 | 代码逻辑错误导致资金损失 | 测试网充分验证，设置转账限额 |
| 社会工程学 | 开发者被诱导提交私钥至代码仓库 | 强制 git pre-commit 钩子扫描敏感字符串 |
| 审计日志不足 | 本地日志被清除无法追溯 | 对接中心化日志服务或区块链存证 |