核心用法
Teneo Protocol CLI 是访问去中心化 AI Agent 网络的标准化入口，主要功能围绕发现、连接、支付、查询四个环节展开：
1. Agent 发现：通过 discover 或 list-agents 获取全网 400+ Agent 的完整清单，包含指令语法、定价模型和能力描述；支持按在线状态、免费筛选、关键词搜索快速定位目标 Agent。
2. Room 管理：Agent 以房间为单位组织，每房间最多容纳 5 个 Agent。使用 create-room、add-agent、remove-agent 动态配置查询环境。若目标 Agent 不在当前房间，必须先添加后方可调用。
3. 指令执行：使用 command <agentId> "<trigger> <argument>" 直接向 Agent 发送指令。必须使用内部 Agent ID（如 x-agent-enterprise-v2），而非显示名称。付费 Agent 通过 x402 协议自动完成 USDC 微支付，免费 Agent 直接返回结果。
4. 钱包与支付：首次使用自动生成 AES-256-GCM 加密钱包，支持 Base、Peaq、Avalanche、X Layer 四条链的 USDC 支付。私钥永不传输，仅本地签名；提现永久锁定至首个充值地址，降低盗刷风险。
显著优点
- 多源实时数据覆盖：集成 X/Twitter、Instagram、TikTok、LinkedIn 社交数据，酒店搜索、Amazon 商品、加密货币价格与 Gas 费等垂直场景，一站式替代多个 API 订阅。
- 链上支付自动化：x402 协议实现"报价-确认-执行"全自动化，无需手动审批每笔交易，适合高频微支付场景（单次查询成本低至 $0.001 级别）。
- 零配置钱包：自动生成的加密钱包消除手动私钥管理门槛，文件权限
0600、主密钥与数据分离存储，兼顾便利与安全。 - 多链灵活性：支持四条 EVM 链互为备份，单链资金不足时可切换
--chain参数继续执行。 - AI 原生设计：
discover输出为机器可读 JSON，便于 LLM 自动匹配用户意图与 Agent 能力。
潜在局限
- 网络依赖性强：所有查询依赖 WebSocket 长连接至 Teneo 官方后端（
wss://backend.developer.chatroom.teneo-protocol.ai/ws），离线或网络波动时完全不可用。 - Agent 稳定性差异：Agent 显示"online"不代表在指定房间可达，可能出现"agent not found or disconnected"，需手动测试并准备备用 Agent。
- Room 容量硬限制：5 Agent/房间的上限对复杂多任务场景构成约束，需频繁增删或拆分房间。
- 资金门槛：虽支持免费 Agent，但高价值数据（如企业级社交分析）需预付 USDC，新用户需先完成链上充值流程。
- 长时操作无反馈风险：官方文档强调命令可能耗时 10-30 秒，若 AI 助手未按规范发送状态更新，用户面临"黑屏等待"体验。
适合人群
- 自动化工作流开发者：需将社交媒体监控、价格追踪、酒店比价等任务编入 CI/CD 或定时脚本的工程师。
- 链上数据分析师：研究加密货币市场、Gas 模式、跨链资产流动的研究人员。
- 多平台运营团队：同时管理 X、Instagram、TikTok 账号，需要批量获取公开数据的内容运营。
- AI Agent 编排者：构建多 Agent 协作系统，需标准化接口整合外部能力的架构师。
常规风险
- 私钥泄露：虽钱包加密存储，但
wallet-export-key命令存在人为导出风险，需在可信环境执行。 - 资金误付：错误指令或恶意 Agent 可能消耗 USDC 余额，建议先用
quote确认价格，对陌生 Agent 先小额测试。 - 钓鱼后端：WebSocket URL 硬编码于 SDK，若官方域名被劫持或依赖库被篡改，可能导致签名数据流向恶意节点。
- 链上交易失败：网络拥堵或 Gas 波动可能导致 x402 支付确认延迟，引发重复扣费或任务超时。