Zerion CLI：给AI Agent提供加密货币能力

📅 2026-05-18 · 📄 约 4200 字

引言

当AI Agent开始具备执行加密货币交易的能力，会发生什么？传统意义上，加密货币操作——查询链上资产、兑换代币、跨链转账——都需要人类手动操作钱包、签署交易、理解复杂的链上逻辑。而Zerion CLI正在将这一切彻底改变。

Zerion CLI是由Zerion团队打造的一款命令行工具，核心理念是让AI Agent能够原生访问加密货币能力。通过标准化的接口，AI Agent可以查询任意钱包的资产组合、执行链上交易、管理Agent Token与安全策略，所有操作均可编程化、自动化，无需人工干预。

本文将从技术架构、核心功能、身份验证、支持的区块链生态、合作伙伴技能，以及实际应用场景等多个维度，全面解析Zerion CLI如何为AI Agent提供加密货币能力。

Zerion CLI是什么

Zerion CLI是Zerion官方发布的开源命令行工具，基于zeriontech/zerion-ai代码库维护。它将Zerion久经考验的链上数据能力封装为一组Bash命令，任何能够调用命令行工具的AI Agent都可以直接使用。

从功能定位上看，Zerion CLI分为两大类操作：

  • 只读操作：分析钱包资产、持仓、交易历史、盈亏数据，无需签名权限
  • 写操作：Swap（兑换）、Bridge（跨链）、Send（转账）、Sign（签名），需要钱包签名和Agent Token授权

这种读/写分离的设计思路，让AI Agent可以在不获得完整钱包控制权的前提下，完成复杂的金融分析。只有在执行实际交易时，才需要通过精心配置的安全策略（Policy）来约束操作范围。

核心技能体系：六大模块

Zerion CLI的技能被组织为标准的agentskills.io格式，每个技能对应一个SKILL.md文件，可以被各类AI编码助手（Cline、Claude Code、Cursor等）直接安装使用。

zerion-analyze：钱包分析（只读）

zerion-analyze是使用频率最高的技能，因为它回答的是加密货币领域最基础的问题："这个钱包里有什么？"

该技能支持以下核心命令：

  • zerion analyze <address>：完整分析，包括资产组合、持仓、交易历史和盈亏
  • zerion portfolio：查询组合总价值和单日变化
  • zerion positions：列出代币持仓和DeFi头寸（支持按协议分组）
  • zerion history：查询交易历史（解析为Trade、Send、Receive、Mint、Approve等类型）
  • zerion pnl：计算已实现和未实现盈亏（含手续费统计）

zerion-analyze最大的技术亮点在于其DeFi头寸的语义化解析能力。例如，当查询一个Aave V3存款地址时，它会将存款（Deposit）和借款（Loan）分别标记，并计算净头寸价值（Net Value）。对于LP（流动性提供者）头寸，相同group_id的多个代币会被合并为一个分组展示，而非机械地罗列每种代币数量。这使得AI Agent能够真正"理解"一个复杂DeFi组合的结构，而非仅仅返回一堆原始数据。

zerion-analyze支持x402协议（按次付费模式），无需API Key即可调用，每次请求费用约0.01 USDC。

zerion-trading：链上交易执行

zerion-trading是Zerion CLI的"执行层"，负责所有需要链上签名的事务：Swap（同链兑换）、Bridge（跨链转账）和Send（链内转账）。

Swap（同链兑换）：用户指定源链、金额、源代币和目标代币，CLI会自动寻找最优路由并执行交易。支持的链包括Ethereum、Base、Arbitrum、Solana等主要网络。

Bridge（跨链）：跨链操作支持两种报价模式——多报价模式和自动执行模式。使用--cheapest标志选择输出金额最大的报价，使用--fast标志选择确认时间最短的报价。Bridge的核心价值在于，AI Agent可以在一条链上查询资产，然后在另一条链上完成部署或投资，真正实现跨链自动化工作流。

Send（转账）：支持原生代币（ETH、SOL）和ERC-20代币的链内转账。

所有写操作都需要API Key和Agent Token才能执行，x402按次付费模式不适用于写操作，这是出于安全的考虑——防止未授权的自动化交易。

zerion-sign：链下签名

zerion-sign专门处理不需要立即上链的签名操作，典型场景包括：签署EIP-191格式的普通消息、EIP-712格式的结构化类型数据（这是DApp登录、授权等场景的标准签名格式），以及各类许可（Permit）签名。

对于AI Agent而言，zerion-sign的意义在于：许多DeFi协议在执行操作前要求先签署一个链下许可（Off-chain Signature），这一步传统上必须由人类手动完成。zerion-sign让AI Agent可以独立完成整个授权流程，从而打通了一些需要"先许可、后操作"的复杂工作流。

zerion-wallet：钱包管理

zerion-wallet负责钱包的创建、导入、列表、充值、备份和删除操作。这一模块是Zerion CLI的"基础设施层"，为整个系统提供钱包抽象能力。

值得注意的是，zerion-wallet基于Open Wallet Standard（OWS）构建，这是一个跨链钱包标准，旨在统一不同区块链上钱包的行为差异。这意味着即便支持多条链，AI Agent也只需学习同一套统一的钱包管理接口。

zerion-agent-management：Agent Token与策略管理

这是Zerion CLI安全体系的核心模块，也是实现"安全自动化"的关键所在。

传统的API Key模式存在一个根本问题：拥有API Key就等于拥有完整的钱包控制权。将这样的Key交给AI Agent存在巨大风险——一个Bug或恶意指令可能导致全部资产被转移。而Zerion的Agent Token机制通过细粒度的策略约束，解决了这一问题。

Agent Token（代理令牌）是一组带有约束规则的签名凭证。每个Token可以附加多条策略（Policy），策略中可以定义：

  • Chain Lock（链锁）：限制Token只能在特定链上操作，例如将交易锁定在Base链
  • Allowlist（白名单）：只允许与白名单中的合约地址交互，例如只允许与Uniswap路由交互
  • Deny Rules（拒绝规则）：明确禁止某些操作，例如禁止approve（授权）操作防止地毯跑路
  • Expiry（过期时间）：设置Token的有效期，过期后自动失效，防止长期风险暴露

这种"最小权限"设计，使得即便AI Agent被引导执行恶意交易，也会在Policy层面被拦截。例如，开发者创建一个"仅在Solana链上购买SOL，且总价值不超过100美元"的策略，AI Agent就绝无可能执行超出这一范围的操作。

身份验证：API Key与x402双轨并行

Zerion CLI设计了两种并行的身份验证机制，适用于不同的使用场景：

API Key模式

用户需要在Zerion Dashboard（dashboard.zerion.io）注册并获取API Key。开发环境Key以zk_dev_开头，当前限额为每分钟120次请求、每天5000次请求。对于日常开发和测试，这一限额完全够用。

API Key模式通过HTTP Basic Auth传递凭证，是最标准的集成方式。

x402按次付费模式

x402是一种新兴的微支付协议，允许用户无需预注册API Key，直接用USDC按次支付API调用费用，每次约0.01 USDC。这对于偶发性使用或测试场景极为便利。

x402模式需要用户提供自己的钱包私钥（EVM或Solana），CLI会自动完成支付握手。例如：

export WALLET_PRIVATE_KEY="0x..."
zerion wallet analyze 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --x402

x402支持EVM（Base链）和Solana两条链。CLI会自动检测私钥格式并选择对应的链进行支付。这种设计大大降低了使用门槛——用户无需注册任何账号，只需连接自己的钱包即可。

支持的区块链网络

Zerion CLI的覆盖范围相当广泛，截至目前已支持：

  • 14条EVM兼容链：Ethereum、Base、Arbitrum、Avalanche、BNB Chain、Polygon、Optimism、Gnosis Chain、Zora、Fantom、Metis、Kava、Horizon，以及2024年新上线的高性能公链Monad
  • Solana：作为非EVM链的代表，Solana的支持体现了Zerion对多链时代的战略判断

这种"14+EVM+Solana"的覆盖，几乎涵盖了当前主流DeFi和NFT活动的全部战场。对于AI Agent而言，这意味着只需掌握同一套CLI接口，即可访问几乎所有主流链上的加密资产数据。

合作伙伴技能生态

Zerion CLI的技能系统支持生态合作伙伴贡献自定义技能，形成了以Zerion CLI为底座的开放生态。以下是几个值得关注的项目：

vaults.fyi 收益优化技能组

vaults.fyi贡献了一组7个与Zerion CLI深度集成的收益管理技能，包括：

  • yield-optimizer：将钱包持仓与行业基准对比，发现闲置资产和收益机会
  • deposit：Vault尽职调查+带风险预检的安全存款
  • rebalance：完整退出-进入Vault的换仓流程，含跨链桥接
  • risk-monitor：实时监控风险评分下降和异常资金流动

这组技能将Zerion的"资产可见性"与vaults.fyi的"收益智能"结合，构成了一个"查看+分析+执行"的完整闭环。

MPC钱包与预测市场技能

MoonPay贡献了多个支付入口相关的技能，包括通过信用卡/银行转账购买加密货币（zerion-moonpay-onramp）、USD银行转账到Iron虚拟账户（zerion-moonpay-iron），以及与Polymarket等预测市场交互（zerion-moonpay-predict）。这些技能让AI Agent不仅能操作已有的加密资产，还能从传统金融体系获取法币入口。

Somnia区块链技能

Somnia贡献了两个技能：链信息与gas模型查询（zerion-somnia-blockchain）和事件驱动的订阅机制（zerion-somnia-reactivity）。后者基于WebSocket+Solidity处理器，为AI Agent提供了实时链上事件推送能力，这对于需要即时响应链上事件的Agent场景（如MEV套利、清算监测）尤为重要。

AI Agent实际应用案例

理解了Zerion CLI的技术能力之后，我们来看一些具体的AI Agent应用案例，这些案例均基于Zerion CLI构建。

XGBoost预测+自主交易的SOL/USDC Agent

这是一个将机器学习与链上执行结合的交易Agent。它的工作流程是：

  1. 通过Birdeye API获取SOL/USDC实时市场数据
  2. 计算14个技术指标（RSI、MACD、布林带等）作为XGBoost分类模型的输入特征
  3. 模型输出价格方向预测（UP/DOWN）和置信度
  4. 如果置信度超过阈值，调用Zerion CLI执行SOL→USDC或USDC→SOL的Swap操作
  5. 所有交易受Zerion Policy约束（Solana链锁、最大金额限制）

该Agent提供Telegram Bot作为交互界面，默认运行在Paper Trading模式（只记录交易不真实上链），配置钱包后可切换为实盘模式。

DCA定投Agent

一个每小时自动购买ETH的定投Agent，基于Zerion CLI构建。通过Zerion Policy限制交易只能在Solana链执行，且每次金额不超过预设值。Agent在后台静默运行，无需人工干预。

自主组合再平衡Agent

一个基于技术分析的自助再平衡工具，持续监控钱包组合偏离目标配置的情况。当某资产占比偏离超过阈值时，触发Zerion Swap操作将其调整回目标比例。支持Solana和Base双链策略，政策层限制只允许与白名单中的DEX合约交互。

安装与配置

Zerion CLI的安装非常简便，一条命令即可完成所有初始化工作：

npx -y zerion-cli init -y --browser

该命令会完成三件事：全局安装CLI、引导配置API Key、自动检测并安装技能到所有已安装的AI编码助手（Cline、Claude Code、Cursor等）。

如果仅需要安装CLI本体（不含技能安装）：

npm install -g zerion-cli

Zerion CLI要求Node.js 20及以上版本。

对于特定的AI编码助手，有各自的插件安装方式：

  • Claude Code：/plugin marketplace add zeriontech/zerion-ai
  • OpenAI Codex CLI：codex plugin marketplace add zeriontech/zerion-ai
  • agentskills.io生态：npx skills add zeriontech/zerion-ai

为什么Zerion CLI对AI Agent生态重要

Zerion CLI的出现解决了一个根本性的生态问题：AI Agent如何安全、可控地参与加密货币经济？

在此之前，AI Agent要操作加密货币，通常需要直接暴露私钥或依赖中心化的API服务。前者有巨大的安全风险，后者则有单点故障和信任问题。Zerion CLI通过Policy机制和Open Wallet Standard，在保证安全性的同时提供了足够灵活的执行能力。

更重要的是，Zerion选择了一条开放生态的道路。通过agentskills.io标准，任何人都可以为Zerion CLI贡献新的技能，这使得围绕Zerion CLI形成的不是单一工具，而是一个不断扩展的能力网络。收益优化、支付入口、预测市场——这些原本分散的加密货币能力，现在可以通过Zerion CLI这一共同接口被AI Agent调用。

随着AI Agent在自主金融领域的应用越来越广泛，Zerion CLI所扮演的角色，可能会类似于AWS S3在云服务中的地位——成为一个不可或缺的基础能力层。

结论

Zerion CLI为AI Agent提供了通往加密货币世界的标准化桥梁。通过模块化的技能设计、安全的Agent Token机制、灵活的Policy约束，以及广泛的链覆盖，它让AI Agent能够以安全、可审计的方式执行从"查看钱包"到"执行交易"的完整工作流。

无论是构建自主交易Agent、收益优化机器人，还是复杂的多链资产管理工具，Zerion CLI都提供了足够的基础设施支撑。随着生态伙伴技能的不断丰富，Zerion CLI的能力边界还将持续扩展。

对于AI开发者而言，Zerion CLI是当前最完整、最安全的"给AI Agent提供加密货币能力"的解决方案之一。它代表了加密货币基础设施与AI Agent技术融合的一个重要方向——让机器能够像人类一样操作加密货币，甚至比人类更精确、更安全地执行复杂策略。