1. 项目概述一个非托管的DeFi智能体如果你在Telegram上用过那些需要你导入私钥才能交易的DeFi机器人心里总会有点发毛。毕竟把钱包的控制权交给一个第三方机器人就像把家门钥匙给了陌生人。今天要聊的这个项目Gundwane彻底改变了这个游戏规则。它是一个完全非托管的DeFi智能体你可以通过Telegram聊天的方式让它帮你检查余额、执行代币兑换、跨链桥接、管理投资组合策略、设置价格警报甚至运行定投计划。最关键的是你的资产始终在你的钱包里机器人永远碰不到你的私钥。这一切的核心是一个叫做EIP-7702的新标准。简单来说它允许你给你的钱包找一个“临时管家”。你通过一个Telegram内置的小程序Mini App签署一份一次性的授权指定一个“管家合约”和“管家钥匙”也就是机器人的操作员密钥。之后机器人就可以用这把“管家钥匙”代表你通过那个“管家合约”来执行交易。而你作为钱包的真正主人随时可以撤销这份授权。这就像你给了钟点工一张只能开你家大门的门禁卡他只能在规定时间进来打扫但拿不走你保险柜里的任何东西而且你随时可以注销这张卡。这个项目不是一个简单的脚本合集而是一个完整的、生产就绪的SaaS产品架构。它集成了LI.FI作为跨链路由与执行层原生支持Sui这条非EVM公链并内置了ENS域名服务。整个技术栈覆盖了从智能合约Solidity/Foundry、前端Next.js/React、后端插件TypeScript到AI智能体OpenClaw的全链路。接下来我会带你深入拆解它的设计思路、实操细节并分享我在搭建和测试过程中踩过的坑和总结的经验。2. 架构深度解析为何选择“委托”而非“托管”2.1 核心设计哲学用户主权至上在传统托管方案中用户资产被集中管理平台拥有绝对控制权这带来了单点故障和信任风险。而非托管方案虽然安全但用户体验往往繁琐每次交易都需要用户手动签名确认。Gundwane的设计哲学是在两者之间找到完美平衡在不牺牲用户资产控制权的前提下提供接近托管方案的流畅体验。EIP-7702的委托机制正是实现这一目标的钥匙。它不是一个权宜之计而是以太坊账户抽象演进路径上的一个重要里程碑旨在为智能合约钱包和外部代理操作提供标准化的授权框架。2.2 技术架构全景图整个系统的数据流和控制流可以概括为以下几步这也是理解其工作原理的钥匙用户入口用户在Telegram中与gundwane_bot对话。请求路由用户的自然语言指令被OpenClaw网关即Telegram机器人接收并解析。能力执行网关调用defi-agent-plugin中对应的工具函数如defi_get_balance,defi_send_transaction。身份与授权插件通过后端API由Mini App提供解析用户的Telegram ID获取其对应的链上钱包地址并检查EIP-7702委托状态。交易构建与执行对于需要链上操作的动作如兑换插件通过LI.FI获取最优报价和交易数据然后使用机器人的操作员私钥代表用户调用DeFiAgentDelegate合约的execute函数。资产始终在用户钱包DeFiAgentDelegate合约在收到指令后会从用户的EOA外部账户中发起真正的交易。资金自始至终没有离开过用户的钱包。这个架构的精妙之处在于职责分离用户拥有资产所有权和最终的授权/撤销权。机器人操作员拥有交易提议和执行权但无资产支配权。委托合约作为可信的中介验证操作员签名并代表用户执行交易。2.3 关键组件选型理由OpenClaw作为智能体框架选择OpenClaw而非LangChain或其他框架是因为其与Telegram生态的原生深度集成以及其“技能(Skill)”和“工作空间(Workspace)”的概念非常适合构建具有特定人格和长期记忆的对话式代理。SOUL.md定义了机器人“Gundwane”简洁、主动、链抽象的人格这让交互更自然。Privy作为嵌入式钱包Privy提供了无缝的Telegram OAuth登录和嵌入式钱包创建用户无需安装MetaMask或记录助记词。它同时支持EVM和Sui链并且其服务端API可以安全地将Telegram ID映射到钱包地址这对机器人识别用户至关重要。LI.FI作为统一流动性层自己集成各个DEX和跨链桥的API是噩梦。LI.FI提供了一个聚合接口能自动找到最优路径无论是单链兑换还是跨链桥接并返回可直接广播的交易数据。这极大地简化了开发并将复杂的路由逻辑外包给专业服务。Sui作为非EVM首站集成Sui展示了项目的链抽象野心。Sui的Move语言和对象模型与EVM差异巨大成功集成意味着架构具备良好的扩展性未来接入Aptos、Solana等链会更容易。3. 核心实现细节与实操要点3.1 EIP-7702委托合约剖析DeFiAgentDelegate合约是这个系统的信任基石。让我们看看它的核心机制// 简化逻辑 contract DeFiAgentDelegate { // 使用ERC-7201为每个用户存储其授权的操作员地址 // 映射关系user address - operator address bytes32 private constant _OPERATOR_SLOT ...; function execute(address to, uint256 value, bytes calldata data) external returns (bytes memory) { address user _getUserForOperator(msg.sender); // 验证调用者是否为授权操作员 require(user ! address(0), Unauthorized); // 关键这里是从user的地址发起调用而不是合约本身或操作员 (bool success, bytes memory result) user.call{value: value}(abi.encodePacked(data, to)); require(success, Execution failed); return result; } function _getUserForOperator(address operator) internal view returns (address) { // 从ERC-7201存储槽中读取对应的用户地址 return ...; } }关键点与避坑指南user.call与address(to).call的区别这里使用的是user.call(abi.encodePacked(data, to))。user是EOA地址但EOA通常不能作为调用者执行代码。这里的技巧是data字段中编码的实际上是一个对to地址的调用。这通常需要配合EIP-3074的AUTH和AUTHCALL或者更复杂的账户抽象方案。在EIP-7702的完整实现中授权过程会设置一个临时部署在用户地址的“委托代码”使得这个call能够成功。在测试时务必验证这种委托调用模式在目标链上的兼容性。CREATE2确定性部署项目使用CREATE2和固定的salt来部署合约确保其在所有支持的EVM链上具有相同的地址。这简化了前端和配置用户只需记住一个合约地址。部署脚本中的salt需要妥善保管并保持机密否则他人可能用相同的参数抢注地址。操作员私钥管理BOT_PRIVATE_KEY是系统的最高机密。一旦泄露攻击者虽然无法盗取资金因为无法绕过委托合约但可以代表已授权的用户发起恶意交易如将资产转移到攻击者地址。必须使用硬件安全模块HSM或云服务商提供的密钥管理服务如AWS KMS、GCP Secret Manager来存储和管理此私钥绝不可硬编码在环境变量文件或代码中尤其是在生产环境。3.2 Telegram Mini App用户 onboarding 流程Mini App是用户旅程的起点其核心任务是安全地完成EIP-7702授权。标准流程用户在Telegram中点击机器人发送的链接打开内嵌的Mini App。使用Telegram账号登录Privy后端会创建或关联一个嵌入式钱包。前端通过Privy的useSign7702Authorization钩子为每条支持的链如Ethereum, Base生成并签署授权消息。签名被发送到Mini App的后端API后端使用机器人的私钥广播这些授权交易上链。实操心得与注意事项HTTPS是必须的Telegram要求Mini App必须通过HTTPS服务。本地开发时可以使用ngrok或cloudflared隧道来暴露一个HTTPS地址。npm run dev通常运行在http://localhost:3000你需要用ngrok http 3000来获取一个临时HTTPS URL并配置到BotFather的Mini App设置中。授权交易Gas费为用户广播授权交易需要支付Gas费。这部分费用由项目方承担。在测试网阶段没问题但在主网这需要纳入成本考量。一种方案是初期由项目方补贴后期在LI.FI的交易手续费中预留一部分来覆盖这部分成本。Privy的服务器端上下文在Mini App的API路由如/api/wallet/[id]中获取用户钱包信息时必须使用Privy的服务器端SDK并传入PRIVY_APP_SECRET和PRIVY_AUTHORIZATION_KEY进行认证。确保这些密钥有严格的访问控制。3.3 DeFi 插件工具函数的实现defi-agent-plugin是机器人的“手”和“眼”。每个工具函数都是一个独立的模块。以defi_get_portfolio为例它需要根据Telegram User ID调用后端API获取用户在所有链上的钱包地址。并行查询每条链的RPC提供商获取该地址的原生币余额。通过LI.FI的/v1/tokens接口或链上合约调用获取主流ERC-20/Sui Token的余额。汇总数据并尝试通过ENS或Sui Name Service解析地址的反向域名让展示更友好。性能优化技巧并行查询使用Promise.all来并发查询多条链的余额而不是串行可以大幅降低响应延迟。缓存策略余额和价格信息可以短暂缓存如5-10秒避免对RPC和API的过度请求。对于不常变动的数据如ENS域名缓存时间可以更长。错误隔离某一条链的RPC请求失败不应导致整个portfolio查询失败。应该捕获单个链的错误返回部分数据并附上错误信息。3.4 LI.FI集成交易的生命周期LI.FI是整个DeFi操作的引擎。理解其工作流至关重要。一次成功的Swap请求处理流程用户请求“swap 0.1 ETH for USDC on Base”解析与路由OpenClaw解析意图调用defi-agent-plugin的相应工具。获取报价插件调用LI.FI的/v1/quote接口关键参数包括fromChainId: 8453 (Base)fromAmount: “100000000000000000” (0.1 ETH的wei单位)fromTokenAddress:0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE(LI.FI表示原生币的通用地址)toTokenAddress: USDC在Base上的合约地址。skipSimulation:必须设为true。因为EIP-7702委托钱包在模拟时会被识别为合约导致模拟失败。呈现报价机器人将LI.FI返回的报价预计获得的USDC数量、预计Gas费、预计耗时、推荐的路由协议以清晰格式发送给用户并附带“批准”和“拒绝”按钮。用户批准用户点击“批准”。构建执行交易如果是原生ETH兑换直接使用defi_send_transaction工具传入LI.FI返回的transactionRequest。如果是ERC-20兑换需要先授权。使用defi_approve_and_send工具它会构建一个批量交易第一笔是approve授权给委托合约第二笔是实际的swap交易。这确保了原子性。执行与监控插件使用机器人的私钥调用委托合约的execute或executeBatch方法。然后通过LI.FI的/v1/status接口轮询交易状态直到确认或超时。关于Slippage滑点的实战经验 LI.FI的默认滑点设置可能不适合所有情况。项目代码中设置了10%的默认滑点这对于高波动性代币或低流动性池是安全的但对于主流币对如ETH/USDC可能过高导致成交价格不理想。最佳实践实现一个动态滑点系统。可以根据代币的波动率从Coingecko API获取、流动性池深度以及市场状态如是否处于极端行情来动态调整。同时在defi_set_strategy工具中允许用户设置个人偏好的默认滑点。3.5 Sui链集成处理非EVM的差异集成Sui是项目的一大亮点也带来了独特的挑战。核心差异处理表方面EVM (如 Ethereum, Base)Sui (Move VM)账户模型基于账户的余额模型基于对象的拥有权模型Token交互需要approve授权然后transferFrom直接转移CoinT对象无需授权交易签名secp256k1签名keccak256哈希Ed25519签名Blake2b哈希交易构建使用viem库结构为{to, data, value...}使用mysten/suiSDK构建TransactionBlock链ID整数如 1, 8453超长整数9270000000000000执行工具defi_send_transaction/defi_approve_and_senddefi_send_sui_transactionSui交易签名的具体步骤代码层面获取交易数据从LI.FI获取的Sui兑换报价中包含已序列化的TransactionBlock字节。构建签名消息不能直接签名原始字节。需要使用Sui SDK的messageWithIntent函数在交易数据前添加特定的“意图”前缀然后对结果进行Blake2b哈希。import { messageWithIntent, IntentScope } from mysten/sui.js; const intentMessage messageWithIntent(IntentScope.TransactionData, txBytes); const digest blake2b(intentMessage, { dkLen: 32 });通过Privy签名调用Privy服务端的rawSignAPI传入用户的SuiwalletId和上一步得到的digest。Privy使用对应的Ed25519私钥进行签名。序列化签名将签名结果和公钥按照Sui格式序列化。执行交易将序列化的交易字节和签名一起发送到Sui网络执行。注意事项Sui的Gas费支付方式与EVM不同。EVM是账户支付而Sui交易中必须指定一个CoinSUI对象来支付Gas费并且这个对象会被消耗。在构建交易时SDK通常会帮你自动选择并拆分一个Gas Coin。需要确保用户钱包里有足够的SUI来支付Gas。3.6 ENS集成提升用户体验ENS集成让机器人变得更“人性化”。除了基础的解析功能项目还实现了.eth域名注册。域名注册的Commit-Reveal流程 这是为了防止抢跑front-running。假设用户想注册myname.eth。Commit提交承诺机器人调用ENS注册控制器合约的makeCommitment函数生成一个基于随机数和域名的承诺哈希然后提交这个哈希上链。这一步花费少量Gas。等待等待至少60秒通常建议1-2分钟。这个等待期使得任何看到你Commit的交易的人无法抢在你前面完成注册。Reveal揭示并注册等待期过后机器人调用register函数传入真实的域名、用户地址、注册年限和承诺的随机数。合约会验证哈希匹配然后完成注册并扣费。在代码中defi-agent-plugin需要实现这两个步骤并在Mini App中引导用户完成这个两阶段流程。同时在HEARTBEAT.md中配置定期检查提醒用户域名即将到期是一个很好的增值服务。4. 环境配置与部署实战4.1 多环境变量管理项目涉及多个组件环境变量容易混乱。建议使用direnv或编写一个统一的setup_env.sh脚本。关键环境变量清单与获取方式变量名所属组件获取方式安全等级BOT_PRIVATE_KEYBot, Mini-App Backend由项目方生成并严格保管绝密PRIVY_APP_SECRETMini-App BackendPrivy Dashboard - App Settings绝密PRIVY_AUTHORIZATION_KEYMini-App BackendPrivy Dashboard - App Settings绝密LIFI_API_KEYBotLI.FI Developer Dashboard机密OPENAI_API_KEYBotOpenAI Platform机密TELEGRAM_BOT_TOKENBot通过 BotFather 创建机器人获得机密ALCHEMY_API_KEY(或类似)Contracts, PluginAlchemy/Infura等RPC服务商机密GRAPH_API_KEYBot (ENS)The Graph Studio非必需有免费替代安全建议为生产环境和测试环境使用完全不同的密钥集。使用.env.example作为模板但确保真实的.env或.env.local文件被加入.gitignore。考虑使用Vercel/Netlify的环境变量管理、AWS Parameter Store或HashiCorp Vault来管理生产环境变量。4.2 合约部署详解部署脚本使用Foundry和Makefile支持一键多链部署。cd contracts # 1. 准备环境 cp .env.example .env # 编辑 .env填入 DEPLOYER_PRIVATE_KEY 和 RPC URLs source .env # 2. 编译 forge build # 3. 测试强烈建议 forge test -vvv # -vvv 输出详细日志便于调试 # 4. 部署到指定链 make deploy CHAINSsepolia base部署过程解析make deploy会调用Makefile中的目标。Makefile会为CHAINS变量中的每个链名循环执行一个部署命令。对于每个链它会调用一个Forge脚本例如script/Deploy.s.sol。该脚本使用CREATE2和预设的salt来部署DeFiAgentDelegate合约。确保DEPLOY_SALT在.env中设置并且每次部署同一套网络时使用相同的salt才能保证合约地址一致。脚本会输出部署的合约地址和交易哈希。务必记录下这个地址它需要被配置到Mini App和Bot的环境变量中。避坑指南Gas费不足部署到主网需要足够的ETH作为Gas。确保部署账户在主网和每条目标Layer2上都有资金。RPC稳定性使用可靠的RPC提供商如Alchemy, Infura。公共RPC可能在部署大型合约时失败或超时。验证合约部署后立即在Etherscan/Basescan等区块浏览器上验证合约源代码。这能建立社区信任也是很多前端工具如Privy与合约正确交互所必需的。4.3 机器人部署Docker vs 本地Docker部署推荐用于生产cd telegram-bot cp .env.example .env # 编辑 .env填入所有必要的环境变量 docker-compose up -d --builddocker-compose.yml文件通常定义了至少两个服务一个是OpenClaw网关本身另一个可能是用于监控或日志的辅助服务。这种方式隔离性好易于版本管理和水平扩展。本地部署用于开发调试# 1. 全局安装OpenClaw (如果尚未安装) npm install -g openclaw/cli # 2. 安装插件 openclaw plugins install ../defi-agent-plugin # 3. 复制工作空间配置 cp -r workspace/* ~/.openclaw/workspace/ cp openclaw.json ~/.openclaw/ # 4. 设置环境变量并运行 export TELEGRAM_BOT_TOKEN‘YOUR_TOKEN’ openclaw gateway本地部署可以方便地使用console.log或调试器进行问题排查。OpenClaw的工作空间文件SOUL.md,AGENTS.md,HEARTBEAT.md定义了机器人的行为和人格可以在~/.openclaw/workspace/下直接修改并实时生效。5. 常见问题排查与实战心得5.1 授权失败EIP-7702签名无效症状用户在Mini App点击“激活”后交易广播失败或后续机器人执行交易时被合约拒绝。排查步骤检查签名消息在Mini App前端使用Privy的useSign7702Authorization钩子时确保传入正确的delegateContractAddress部署的委托合约地址和operator机器人EOA地址。验证链ID确保为每条链签署的授权消息中的chainId是正确的。Sepolia是11155111Base是8453别弄混。检查委托合约状态在区块浏览器上查询委托合约使用类似operators(userAddress)的读函数看机器人的操作员地址是否已被成功注册。回顾合约部署确认部署的合约地址与环境变量DELEGATE_CONTRACT_ADDRESS完全一致一个字符都不能差。5.2 LI.FI交易模拟失败症状调用LI.FI的/v1/quote接口时即使设置了skipSimulationtrue返回的transactionRequest在执行时仍失败。可能原因与解决Gas估算问题skipSimulationtrue时LI.FI无法精确估算Gas。需要确保委托合约的execute函数有足够的Gas Limit。可以在插件中手动为交易设置一个较高的Gas Limit例如比普通转账高50%。代币余额不足用户EOA中的代币余额不足以支付交易额Gas费。在执行前插件应通过defi_get_balance进行预检查。路径失效从获取报价到用户点击批准可能有几秒到几分钟的延迟此时最优路径的汇率可能已发生变化。LI.FI返回的报价通常有有效期如15秒。可以考虑在呈现给用户时显示时间戳并在执行前用相同的参数快速请求一次新报价进行验证。5.3 Sui交易签名错误症状Sui交易在签名或广播时失败提示“Invalid signature”或“Signer not authorized”。排查清单验证WalletId确保从Privy后端API获取的suWalletId是正确的并且对应的是Sui链类型的钱包。检查消息哈希确认在调用PrivyrawSign之前对交易字节进行了正确的messageWithIntent和Blake2b哈希处理。可以将生成的digest与使用Sui CLI本地签名生成的digest进行对比。序列化格式确保最终的签名序列化格式符合Sui的要求通常是signature || publicKey || signature_scheme_flag。Gas Coin确认交易中包含了有效的Gas Coin对象。可以通过Sui SDK的transactionBlock.setGasPayment来指定。5.4 机器人无响应或指令误解症状用户发送消息后机器人长时间不回复或回复的内容与指令无关。解决方向检查OpenClaw日志运行docker-compose logs -f或直接查看OpenClaw进程的输出看是否有错误信息。常见问题包括API密钥失效、网络连接超时、插件加载失败。审查技能(Skill)配置skills/目录下的SKILL.md文件定义了机器人如何处理特定领域的指令。确保lifi兑换、ens域名等技能的描述清晰准确包含了正确的工具调用示例和规则。调整Agent人格workspace/SOUL.md文件定义了机器人的性格。如果它太“啰嗦”或太“简洁”可以修改这个文件。例如增加“始终在执行交易前请求用户最终确认”的规则。监控心跳HEARTBEAT.md中可能配置了定期任务如检查价格警报。如果这些任务执行异常可能会阻塞对话线程。检查心跳任务的日志和错误处理。5.5 生产环境运维建议监控与告警对关键服务Bot后端、Mini App API、RPC连接设置健康检查。使用Uptime Robot或类似的监控服务。对错误率、响应延迟设置告警。日志聚合将Docker容器的日志导出到集中式服务如Datadog、Sentry或ELK Stack便于问题追踪。数据库持久化OpenClaw默认可能使用内存存储对话状态。对于生产环境需要配置持久化存储如PostgreSQL以防止机器人重启后丢失用户上下文和策略。速率限制为你的Mini App后端和Bot对LI.FI、RPC等外部服务的调用添加速率限制和重试机制避免因请求过多被限制。灾难恢复定期备份机器人的配置和工作空间文件。制定私钥泄露、合约漏洞等安全事件的应急响应预案。这个项目将前沿的账户抽象标准、多链DeFi聚合和AI智能体技术结合提供了一个极具前瞻性的非托管金融助手范本。从技术探索到产品化每一步都充满了挑战但解决这些挑战的过程正是构建下一代链上应用的核心能力。