agent-wallet

🪙 安全自托管多链加密资产管理

开源自托管多链钱包方案,采用军事级本地加密与限时会话令牌,让 AI 代理在零私钥暴露风险下安全执行加密资产操作。

收藏
10k
安装
2.3k
版本
v1.0.7
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

Agent Wallet 是一款专为 AI 代理设计的自托管加密货币钱包管理技能,通过封装开源的 agent-wallet-cli 工具,实现了对 Ethereum、Solana、Polygon、Arbitrum、Base 等多链资产的非托管式管理。该技能采用"用户掌握私钥,代理仅持临时令牌"的安全架构,在保障资金主权的同时,赋予 AI 执行转账、签名、查账等操作的能力。

核心用法遵循"初始化-解锁-会话操作"的三段式流程。首次使用需通过 stdin 管道输入密码完成钱包初始化(init)或导入(import),生成加密存储在本地 ~/.agent-wallet-cli/ 的密钥库。随后通过 unlock 命令获取限时会话令牌(wlt_...,默认1小时有效期),后续所有操作(转账、签名、查余额)均通过 --token 参数使用该令牌,无需再次暴露密码。操作完成后可通过 lock 命令立即终止会话,形成完整的权限生命周期管理。

显著优点体现在其安全架构设计与多链支持能力。采用 Argon2id 密钥派生算法与 AES-256-GCM 加密标准保护本地存储,配合基于时间的会话令牌机制,确保 AI 代理在运行期间无法接触用户密码或助记词。技能支持 EVM 生态(含 L2)与 Solana 主流网络,原生兼容 ETH、SOL 及 USDC、USDT 等代币别名,并提供 --dry-run 功能用于转账预演。开源 MIT 协议与零服务器架构(仅连接公共区块链 RPC)进一步降低了信任门槛,满足隐私极客与去中心化信仰者的需求。

潜在缺点与局限性不容忽视。首先,该技能依赖外部 npm 包 agent-wallet-cli,虽然开源但由个人开发者维护(T3 来源),缺乏第三方安全审计背书,用户需自行承担供应链风险。其次,操作流程对非技术用户存在门槛,如 stdin 管道输入、会话令牌生命周期管理、助记词备份等概念需要一定 Linux/CLI 基础。此外,作为自托管方案,用户需自行承担密钥备份与恢复责任,一旦丢失助记词或遗忘密码,资产将永久不可找回,不存在"找回密码"的后门。

适合的目标群体主要为具备区块链安全知识的技术型用户与量化交易开发者。适合需要自动化管理多链资产、执行定时转账、批量归集资金或集成至交易策略的 DeFi 高级用户,以及重视资金主权、拒绝托管服务的加密原住民。不适合加密货币新手、寻求"一键理财"的被动投资者或需要客服支持恢复账户的传统金融用户。

使用该技能存在常规风险与操作建议。资金安全风险是首要考量,尽管有 --dry-run 预演,但区块链交易的不可撤销性意味着任何地址输入错误或合约交互失误都可能导致资产永久损失。依赖风险方面,npm 包的更新可能引入破坏性变更或安全漏洞,建议固定版本安装并定期审计源码。性能上,公共 RPC 的响应速度与速率限制可能影响高频操作体验。建议仅在隔离环境(如 Docker 容器或专用虚拟机)中部署,使用短时长会话令牌(默认1小时),大额操作前务必进行小额测试,并确保钱包 lock 策略的自动化执行,避免会话令牌在闲置期间被恶意利用。

安全解读

核心功能

Agent Wallet 是 agent-wallet-cli 的文档型 Skill 封装,专为 AI 代理设计的多链加密钱包管理工具。支持以太坊、Solana、Polygon、Arbitrum、Base 等主流公链,涵盖原生代币与 ERC-20/SPL 标准代币的余额查询、转账、授权管理、消息签名及交易历史查看等完整功能。

显著优点

安全架构设计:采用自托管模式,私钥本地以 Argon2id + AES-256-GCM 加密存储,无中心化服务器参与;通过会话令牌(wlt_...)机制实现"代理不触密码"——用户手动解锁后仅向 AI 传递有时限的访问令牌(默认1小时,最长24小时),从源头隔离密钥泄露风险。

多链与自动化友好:统一 CLI 接口覆盖 EVM 系与 Solana 生态,支持 HD 钱包(BIP-39)与 JSON 格式输出,便于脚本集成与自动化工作流。密码强制通过 stdin 管道输入,规避 shell history 与进程列表泄露。

开源可审计:MIT 许可证,完整源码托管于 GitHub,用户可自行验证实现逻辑与 npm 包一致性。

潜在局限与风险

  • 来源可信度限制:个人开发者(T3 级别)维护,缺乏组织背书与成熟审计流程,供应链攻击风险相对较高。
  • 封装层安全边界:Skill 本身仅为 Markdown 文档,不含可执行代码,实际安全依赖底层 CLI 工具——用户必须自行审计源码,无法仅凭本报告判断资金安全性。
  • 操作不可逆性:区块链交易一旦签名广播即不可撤销,代理自动化场景下缺乏人工二次确认环节(--yes 强制跳过交互)。
  • 凭证管理负担:用户需安全保管助记词、主密码及会话令牌,任何环节泄露均可能导致资产损失。

适合人群

  • 具备加密钱包使用经验、能理解自托管风险的技术用户
  • 需要为 AI 代理配置自动化加密资产操作的开发者
  • 愿意投入时间审计开源代码的安全意识较强者
  • 小额资金测试、非大额资产管理的场景

常规风险控制建议

1. 源码审计先行:克隆 GitHub 仓库审查加密实现与网络请求逻辑
2. 测试网验证:首次使用在 Sepolia/Devnet 完整跑通流程

3. 最小权限原则:手动解锁后代入会话令牌,永不向代理暴露 WALLET_PASSWORD

4. 短时效会话:使用默认 1 小时令牌,及时 lock 释放

5. 隔离环境运行:专用容器或虚拟机,避免共享环境密码泄露

agent-wallet 内容

手动下载zip · 2.9 kB
SKILL.mdtext/markdown
请选择文件