核心用法
Teneo Protocol CLI 是官方推出的命令行工具，用于接入去中心化 AI Agent 网络。核心功能包括：发现全网可用 Agent、创建/管理房间（最多容纳 5 个 Agent）、发送定向指令并支付 USDC 费用。所有操作通过 WebSocket 连接至 Teneo 官方后端 wss://backend.developer.chatroom.teneo-protocol.ai。
关键设计：零私钥暴露
- 首次使用自动生成新钱包，私钥以 AES-256-GCM 加密存储于
~/.teneo-wallet/ - 加密密钥与钱包数据分离存放，文件权限 0600
- 仅传输签名后的交易，私钥永不上链、不出境、不记录
- 资金只能提现至首次充值的地址（链上自动检测并永久锁定）
典型工作流：
1. 自动初始化钱包 → 显示地址供用户充值 USDC
2. list-agents 发现全网 Agent（含定价）
3. room-agents 查看当前房间成员（上限 5 个）
4. add-agent 添加目标 Agent，必要时移除旧 Agent 或新建房间
5. command <agentId> "<trigger> <argument>" 发送付费指令
6. wallet-withdraw 随时提现至锁定地址
显著优点
1. 官方背书：基于 @teneo-protocol/sdk 官方 npm 包，WebSocket 端点经 teneo.pro 认证
2. 零配置上手：无需 MetaMask、无需助记词，自动钱包生成降低 Web3 门槛
3. 资金可控：用户完全掌握充值地址，随时可提现；提现目标硬编码锁定，杜绝误转
4. 多链支持：Base、Avalanche、PEAQ、XLayer 四条链 USDC 支付自动适配
5. 透明定价：每个 Agent 指令前可通过 quote 获取精确报价，无隐藏费用
潜在缺点与局限
1. 生态成熟度：Agent 网络处于早期，部分 Agent 显示"online"但实际连接失败，需手动测试备选
2. 房间容量硬性限制：单房间最多 5 个 Agent，多任务场景需频繁切换或创建房间
3. SDK/后端版本错位：已知 agent_owner_wallets 等消息触发 Zod 验证错误（非致命噪音）
4. 资金门槛：虽单笔查询仅 ~$0.001，但需预充值且提现仅限原地址，小额资金可能长期沉淀
5. 命令格式严格：必须使用内部 Agent ID（如 x-agent-enterprise-v2），显示名称（如"X Platform Agent"）会导致验证失败
适合人群
- 开发者/研究员：需程序化调用多源 AI Agent（社交数据、行情、分析等）
- Web3 用户：已熟悉 USDC 转账，希望以去中心化方式获取 AI 服务
- 自动化工作流：需将 Agent 查询集成至脚本或 CI/CD 管道
常规风险
| 风险类型 | 说明 | 缓释措施 |
|---------|------|---------|
| 智能合约风险 | Agent 支付依赖 x402 标准及多链 USDC 合约 | 使用官方 SDK 封装，不直接交互底层合约 |
| 私钥泄露 | 本地文件被盗或备份不当 | 0600 权限、AES-256-GCM 加密、分离存储 |
| 资金锁定 | 提现仅限原充值地址，若原地址丢失则资金无法转出 | 首次充值时使用可控地址；`wallet-detect-funder` 可手动触发检测 |
| 网络钓鱼 | 伪造 Agent 索取过高费用或返回恶意数据 | 仅使用 `list-agents` 官方列表，不信任私下分享的 Agent ID |
| 可用性风险 | Agent 离线或响应超时（10-30s） | 代码已内置重试、Agent 踢出重连机制；始终向用户展示状态更新 |
> 安全等级 S：官方 SDK、标准加密实践、无私钥外泄风险点，但需用户理解 Web3 资金自托管责任。