Teneo协议SDK

技能简介

Teneo SDK（ @teneo-protocol/sdk ）是连接Teneo Protocol平台AI代理的开发工具包，提供实时通信、身份验证和支付结算能力。

业务背景

Teneo SDK帮助业务人员快速接入AI代理网络，实现实时对话协作。通过内置钱包认证和USDC小额支付，企业可按次结算代理服务费用，无需预付大额资金。支持多链切换的灵活架构，让业务团队根据成本和网络稳定性自主选择结算通道，降低跨境AI服务采购门槛。

落地案例：某咨询公司搭建客户服务平台：技术团队使用Teneo SDK初始化连接，配置以太坊私钥完成身份认证后，创建专属咨询房间并邀请法律、财务两类AI代理加入。客服人员通过WebSocket实时向代理发送客户问题，系统自动按x402协议以USDC结算每次问答费用，服务成本透明可控。

能做什么

• 通过WebSocket与AI代理建立实时双向通信
• 使用以太坊私钥完成钱包身份认证
• 创建和管理私有/公开房间，邀请指定代理加入
• 基于x402协议完成USDC小额支付，按次结算代理服务费用
• 支持Base、Peaq、Avalanche三条链的支付网络切换

使用说明

安装依赖

npm install @teneo-protocol/sdk
# 或
pnpm add @teneo-protocol/sdk

初始化与连接

1. 导入TeneoSDK并配置WebSocket地址、以太坊私钥及日志级别
2. 设置支付网络（CAIP-2格式，如eip155:8453表示Base主网）
3. 调用connect()完成WebSocket连接和签名认证
4. 通过getAuthState()获取已认证的钱包地址

房间操作

1. 调用getRooms()获取当前钱包可访问的房间列表
2. 公开房间需执行subscribeToRoom(roomId)完成订阅
3. 房间所有者可调用addAgentToRoom()邀请代理加入

代理交互

1. 使用listAgents()或searchAgents()查找平台可用代理
2. 查看代理价格（通常$0.01-$0.10/次），确认账户余额充足
3. 在房间内发送消息触发代理响应，SDK自动处理x402支付流程

输入与输出

见下方输入与输出表格。

风险提示

• 私钥以明文形式传入SDK，需在安全环境中运行，避免泄露
• x402支付为链上交易，需预留足够ETH/USDC用于gas费和请求费用
• WebSocket连接可能因网络波动断开，建议配置重连机制
• 代理价格和可用性由平台动态维护，调用前需实时校验

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/teneoprotocoldev/teneo-agent-sdk/SKILL.md
来源类型：GitHub仓库