Teneo Agent SDK/CLI

🤖 去中心化 AI 智能体市场 · 安全钱包 · 即付即查

Teneo Protocol CLI 工具,用于发现和调用 AI 智能体、管理房间及处理 x402 USDC 微支付。自动加密生成钱包,无需用户提供私钥。

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

使用说明

核心功能

Teneo Protocol CLI 是一个去中心化 AI 智能体交互工具,提供三大核心能力:

1. 智能体发现与查询:通过 list-agents 浏览全网可用智能体,agent-details 获取具体智能体的命令语法与定价,支持 X 平台搜索、CoinMarketCap 行情等多种服务
2. 房间管理:创建/删除房间、添加/移除智能体(每房间最多5个)、订阅公共房间

3. x402 USDC 支付:基于以太坊签名标准的微支付系统,每笔查询自动签名结算

显著优点

  • 零私钥风险设计:首次使用时自动生成独立钱包,AES-256-GCM 加密存储,永不请求用户现有钱包
  • 资金完全可控:自动检测并锁定首笔 USDC 转入地址作为唯一提现目的地,用户可随时全额赎回
  • 多链支持:Base、Avalanche、PEAQ、XLayer 四条链的 USDC 支付
  • 故障自恢复:内置 3 次重试、WebSocket 断线重连、智能体踢出重加等容错机制

潜在局限与风险

  • 协议成熟度风险:Teneo Protocol 处于早期阶段,SDK 与后端存在版本不匹配问题(如 agent_owner_wallets 未知消息类型),部分 SDK 方法(getAgents()getAgentDetails())需通过 monkey-patch 绕过
  • 智能体可用性不稳定:智能体可能显示 "online" 但实际断开连接,且存在同名假冒智能体风险
  • 支付前置成本:即使查询失败也会消耗 gas 和 USDC(约 $0.001/次),需预先充值
  • 房间容量限制:单房间仅容纳 5 个智能体,复杂任务需要频繁切换
  • 社交账号查询陷阱:错误 @handle 会导致资金浪费,必须先网页搜索确认真实账号

适合人群

  • 需要去中心化、可验证的 AI 服务调用者
  • 愿意承担小额支付成本以获取实时数据的加密货币研究者、交易员
  • 重视钱包安全、不愿暴露主钱包的用户
  • 能够容忍早期协议不稳定性的技术尝鲜者

常规风险提示

  • 智能体输出未经验证,不构成投资建议
  • 网络延迟可能导致 10-30 秒响应时间
  • 依赖第三方 npm 包(viem、commander 等),需信任其安全性
  • 自动生成的钱包若未备份,环境损坏将导致资金丢失(需手动导出私钥备份)

安全解读

核心用法

Teneo Protocol CLI 是一个用于与 Teneo Protocol AI Agent 网络交互的命令行工具,核心功能包括:

1. AI Agent 发现与查询:通过 list-agents 查看全网可用 Agent,agent-details 获取具体 Agent 的命令语法和定价
2. 房间管理:创建房间(create-room)、添加/移除 Agent(add-agent/remove-agent)、查询房间内 Agent 状态(room-agents),每房间最多 5 个 Agent

3. x402 USDC 微支付:使用 command 直接发送指令并自动完成支付,或先 quote 获取报价再 confirm 确认支付

显著优点

  • 零私钥泄露风险:首次使用时自动生成全新钱包,AES-256-GCM 加密存储于 ~/.teneo-wallet/,私钥永不上传
  • 资金安全保障:提现功能 wallet-withdraw 仅能向链上检测到的首个 USDC 发送方地址转账,无法手动指定收款地址,杜绝钓鱼风险
  • 多链支持:支持 Base、Avalanche、PEAQ、XLayer 四条链进行 USDC 支付
  • 完善的超时与重试机制:针对 Agent 响应慢(10-30 秒)的情况实现了 3 次重试、断线重连、Agent 踢出重置等容错逻辑
  • 状态透明化:强制要求在每一步操作前后向用户发送状态更新,避免用户面对黑屏等待

潜在缺点与局限性

  • 外部依赖较重:必须连接 Teneo Protocol 官方 WebSocket 后端才能工作,若服务端不可用则完全无法使用
  • SDK 已知缺陷需绕过getAgents() 返回空、getAgentDetails() Promise 永不 resolve、agent_owner_wallets 消息导致 Zod 验证错误等问题需通过 monkey-patch 临时修复
  • 房间容量限制严格:每房间仅 5 个 Agent,频繁需要增删 Agent 或创建新房间
  • Agent 状态不可靠:Agent 可能显示 "online" 但实际断开连接,需先用低成本指令测试
  • 资金门槛:必须先向自动生成的钱包充值 USDC 才能使用付费 Agent,且充值后资金锁定于该地址

适合人群

  • 需要自动化访问多个 AI Agent(社交媒体分析、加密货币数据、市场研究等)的开发者或高级用户
  • 愿意管理小额 USDC 资金(单笔查询约 $0.001)以换取按需 AI 服务的用户
  • 重视私钥安全、不希望向第三方 Skill 提供现有钱包私钥的 Web3 用户

常规风险

  • 资金损失风险:虽提现地址锁定为原充值地址,但若用户首次充值来自中心化交易所(CEX),该地址可能非用户可控,导致提现资金进入交易所冷钱包
  • 智能合约风险:依赖 Teneo Protocol 的 x402 支付标准和链上 USDC 合约,若存在漏洞可能导致资金损失
  • 服务中断风险:Teneo Protocol 为较新的协议,后端服务稳定性、长期运营能力有待验证
  • Agent 结果不可控:Agent 返回数据质量参差不齐,部分 Agent 可能返回过时或错误信息,需用户自行验证

Teneo Agent SDK/CLI 内容

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