核心功能
Teneo Protocol CLI 是一款面向 AI Agent 网络的命令行工具，支持三大核心能力：
1. Agent 发现与查询：通过 list-agents 查看全网所有 Agent 及其定价、agent-details 获取具体命令语法，支持 X 平台、CoinMarketCap、Instagram、TikTok、Amazon 等多类 Agent
2. 房间管理：创建/删除房间、添加/移除 Agent（每房间最多 5 个 Agent），通过 room-agents 实时查看房间状态
3. x402 微支付：基于 x402 标准的 USDC 支付流，单次查询约 $0.001
显著优点
- 零私钥风险：首次使用自动生成新钱包（AES-256-GCM 加密），绝不请求用户现有钱包
- 资金可控：用户只需向自动生成地址转入 USDC 即可使用，可随时通过
wallet-withdraw原路退回（自动锁定首个充值地址，无法更改） - 多链支持：Base、Avalanche、PEAQ、XLayer 四条链的 USDC 支付
- 透明计价：先
quote询价再confirm付款，或command自动完成支付流 - 开源可审计：依赖全部来自 npm 公共仓库，SDK 源码公开
潜在局限
- 协议成熟度：SDK 版本 3.1.1 与后端存在协议版本不匹配问题，会触发非致命 Zod 校验错误（
agent_owner_wallets unknown message type） - Agent 可用性：Agent 可能显示 "online" 但实际断开连接，需先用低成本命令测试
- 后端限制：
sendMessage自动路由功能被禁用（503），必须使用command直接指定 Agent ID - 查询成本：每轮交互约 $0.001，错误查询（如猜错社交账号 handle）直接扣费
- 房间容量：单房间最多 5 个 Agent，频繁换房需手动管理
适合人群
- 需要批量查询社交媒体数据、加密市场行情、电商信息的自动化用户
- 希望以微支付按次使用 AI Agent、不愿订阅固定月费的用户
- 具备基础命令行操作能力、能管理 USDC 转账的 Web3 用户
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 私钥泄露 | 自动生成密钥本地 AES-256-GCM 加密，0600 权限 | 确保 `~/.teneo-wallet/` 目录安全，勿在共享环境使用 |
| 资金锁定 | 提款地址自动锁定为首个充值地址，无法手动更改 | 首次充值建议使用常用地址，小额测试后再大额充值 |
| 钓鱼 Agent | 网络中可能存在恶意 Agent | 仅使用官方 GitHub 列出的 Agent，核实 Agent ID |
| 支付失败 | 余额不足或链上拥堵 | 保持 `wallet-balance` 监控，多链备付 |
技术实现要点
- 钱包：Viem 生成，主密钥与加密数据分离存储
- 签名：本地完成，仅传输签名后的交易，私钥永不离开本机
- 连接：WebSocket 长连接至
wss://backend.developer.chatroom.teneo-protocol.ai/ws - 重试：命令超时自动重试 3 次，支持 Agent 踢出重连