核心用法
MetaMask Agent Wallet 是一种让AI代理自主执行区块链交易的技能，通过沙盒化的浏览器环境和严格的权限护栏实现安全自动化。核心使用流程包括：安装依赖后创建独立的Chrome用户配置文件，生成全新的MetaMask钱包（必须与主钱包隔离），注入小额资金用于代理操作，并通过 permissions.json 配置多维约束条件。
代理支持的操作涵盖连接dApp、执行代币兑换（swap）、转账（send）、消息签名和余额查询等。所有交易在执行前必须通过本地守卫层（guard.ts）的校验，包括每日/单笔支出上限、链ID白名单、合约地址白名单、禁止调用的方法选择器，以及高价值交易的二次确认机制。
显著优点
1. 纵深隔离架构：代理钱包与主钱包完全分离，配合独立的Chrome配置文件，从物理层面阻断资产混同风险。
2. 可编程权限护栏：支持六维度的精细化控制（支出限额、链筛选、协议白名单、方法黑名单、审批阈值、全局撤销），远超传统"只读API"模式。
3. 全链路可审计：所有交易意图、守卫校验结果和最终链上结果均持久化到本地日志，便于事后追溯与异常检测。
4. Gator协议前瞻兼容：架构预留与Gator链上权限证明系统的集成接口，未来可迁移至无需信任的链上权限管理。
潜在局限与风险
- 浏览器自动化固有脆弱性：依赖Playwright控制浏览器扩展，面临DOM选择器漂移、MetaMask扩展更新导致的UI自动化失效风险。
- 价格预言机中心化：
price.ts模块需估算USD价值以执行限额检查，但未披露价格来源，可能存在操纵或失效风险。 - 签名操作的双刃剑：
sign命令虽标记"谨慎使用"，但缺乏方法级别的强制白名单，恶意dApp可能诱导签名导致资产损失（如permit2钓鱼）。 - 密钥托管模糊性：技能文档未明确种子短语的存储加密机制（
~/.agent-wallet/chrome-profile的权限与加密状态未知）。 - 跨链桥与复杂交互盲区：当前护栏设计针对单链DEX优化，对跨链桥、聚合器、借贷协议的复杂多步骤交互的拦截能力存疑。
适合人群
- 量化交易者/DeFi策略开发者：需自动化执行套利、再平衡等策略，但接受资金上限约束的进阶用户。
- DAO财库管理员：希望授权社区经理或AI代理执行常规支付，同时通过白名单和限额控制风险的机构用户。
- Web3自动化测试工程师：需要模拟真实用户交互进行协议测试的开发者。
常规风险
| 风险类别 | 具体表现 | 缓释建议 |
|---------|---------|---------|
| 权限配置错误 | 过高的每日限额或过于宽泛的协议白名单 | 遵循"最小权限原则"，初始配置极低限额并逐步放宽 |
| 浏览器会话劫持 | 恶意软件读取未加密的Chrome配置文件 | 确保`~/.agent-wallet`目录权限为700，考虑磁盘加密 |
| 钓鱼dApp诱导 | 代理被引导至伪装界面签署恶意消息 | 严格限制`allowedProtocols`，禁用任意`sign`操作 |
| 智能合约漏洞 | 白名单内的协议本身存在被攻击风险 | 协议白名单需经安全审计，保持小额资金原则 |
| 自动化无限循环 | 代码缺陷导致高频交易耗尽限额或Gas | 设置合理的`perTx`限额，监控异常交易频率 |