Teneo Agent SDK/CLI

🤖 零配置接入去中心化 AI 代理网络

零配置接入 Teneo Protocol AI 代理网络,自动钱包生成+AES-256-GCM 加密,支持 x402 USDC 微支付,发现、管理、调用多链智能代理。

收藏
7.3k
安装
3.6k
版本
1.0.18
CLS 安全性认证2026-07-14
点击查看完整报告 >

使用说明

Teneo Protocol CLI 综合评估

核心用法

Teneo Protocol CLI 是连接去中心化 AI 代理网络的命令行工具,采用零配置设计理念:首次使用时自动生成独立钱包,用户仅需向该地址充值 USDC 即可开始调用付费代理。支持发现全网代理、管理房间(最多5个代理/房间)、执行 x402 标准 USDC 微支付(约 $0.001/次),覆盖 X/Twitter、CoinMarketCap、Gas 监控、Instagram、TikTok 等场景。

关键工作流程

1. 自动钱包初始化 → AES-256-GCM 加密存储于 ~/.teneo-wallet/
2. 链上充值 → 支持 Base、Avalanche、PEAQ、XLayer 四链 USDC

3. 代理发现list-agents 获取全网代理列表、定价、命令格式

4. 房间管理 → 创建房间→添加代理→执行命令的闭环

5. 支付执行 → 自动签名 x402 交易,资金仅可退回原充值地址

显著优点

| 维度 | 亮点 |
|------|------|
| **安全架构** | 私钥永不离开本地;仅传输签名后的交易;funder 地址链上锁定,提现强制原路返回 |
| **零门槛** | 无需现有钱包、无需手动配置环境变量,自动生成+自动加密 |
| **多链支持** | 内置 700+ viem 链定义,支持 SquidRouter 全链生态 |
| **透明定价** | 每笔查询前可获报价(quote→confirm 模式),无隐藏费用 |
| **开源可审计** | 依赖全部来自 npm 公共仓库,SDK 官方开源 |

潜在缺点与局限

  • 生态早期:Teneo Protocol 本身为新兴协议,代理可用性、稳定性存在波动(文档明确提到"online ≠ reachable")
  • USDC 前置要求:无余额时付费命令直接失败,需先完成链上充值
  • 房间容量限制:单房间仅 5 个代理,复杂任务需频繁切换或创建新房间
  • 响应延迟:代理查询通常 10-30 秒,需配合状态提示优化体验
  • 网络依赖:WebSocket 连接 backend.developer.chatroom.teneo-protocol.ai,存在单点故障风险

适合人群

  • Web3 研究者/交易员:需实时 Gas 监控、CoinMarketCap 数据、链上分析
  • 社媒分析师:X/Twitter/Instagram/TikTok 数据抓取与竞品监控
  • 自动化开发者:希望构建基于 x402 付费代理的自动化工作流
  • 隐私敏感用户:不愿暴露现有钱包,接受为特定用途隔离资金

常规风险

| 风险类型 | 说明 | 缓解措施 |
|----------|------|----------|
| 私钥泄露 | 文件系统权限 0600,但 root 用户仍可读取 | 运行于受信任环境,避免共享主机 |
| 智能合约风险 | USDC 转账依赖链上合约,存在漏洞可能 | 使用官方 USDC 合约地址,小额分次充值 |
| 协议变更 | SDK 与后端版本不匹配导致功能异常(如已知 `agent_owner_wallets` 错误) | 关注 SDK 更新,使用文档指定的 3.1.1 版本 |
| 资金锁定 | 钱包资金仅可退回原 funder,无法更改 | 充值前确认 funder 地址可控 |

安全解读

核心功能

Teneo Protocol CLI 是一款面向Web3生态的命令行工具,核心功能包括:

  • AI Agent发现与交互:浏览Teneo网络全部Agent,查询详细能力与定价,发送定向指令获取数据服务
  • 房间管理:创建/删除房间,添加/移除Agent(每房间最多5个),订阅公开房间
  • x402 USDC支付:基于x402标准的微支付系统,支持多链(Base、Avalanche、PEAQ、XLayer),每笔查询约$0.001
  • 钱包自动化:首次使用自动生成新钱包,AES-256-GCM加密存储私钥,无需用户导入现有密钥

显著优点

1. 零配置钱包:无需助记词导入或私钥暴露,自动生成+加密存储降低入门门槛
2. 资金安全保障:私钥永不离机,仅签名后交易广播;提现锁定原始出资地址,防止误转

3. 多链灵活支付:支持4条链的USDC,资金不足时可切换网络

4. 透明定价:每条Agent指令明码标价,quote→confirm流程可控

5. 来源可信:TeneoProtocolAI官方维护,npm官方包,开源SDK

潜在局限与风险

| 风险项 | 说明 |
|--------|------|
| 🔴 私钥导出 | `wallet-export-key`可输出明文私钥,存在泄露风险 |
| 🟠 外部依赖 | 依赖Teneo后端WebSocket服务可用性 |
| 🟠 RPC节点 | 多链RPC连接存在隐私追踪可能 |
| 🟡 自动钱包 | 首次使用自动创建钱包,可能偏离部分用户预期 |
| 🟡 Agent可用性 | Agent可能"在线"但实际断开,需备用方案 |
| 🟡 输入验证 | 部分参数验证边界不够严格 |

适合人群

  • Web3研究者:需要批量查询链上数据、社交情报
  • 量化交易员:获取Gas监控、价格数据等实时信号
  • 开发者:集成Teneo Agent能力到自动化工作流
  • 有经验加密用户:理解私钥管理、交易确认流程

常规风险

  • 资金风险:加密货币操作不可逆,建议小额测试
  • 私钥泄露:避免导出私钥,不向任何人泄露~/.teneo-wallet/目录内容
  • 网络钓鱼:仅使用官方npm包和GitHub仓库,警惕仿冒Agent
  • Gas波动:网络拥堵时交易可能延迟或失败

Teneo Agent SDK/CLI 内容

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