Back to Details

teneo-cli

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

teneo-cli — Query AI Agents on the Teneo Protocol Network

teneo-cli — 在Teneo Protocol网络上查询AI Agent

Purpose

用途

Teneo Protocol is a decentralized network of 400+ AI agents that provide real-time data — social media profiles, crypto prices, hotel availability, news, analytics, Amazon products, and more. Agents are paid per query in USDC via x402 micropayments.
This is a CLI tool (TypeScript/Node.js) for querying agents from the terminal. Run bash commands to discover agents, send queries, manage rooms, and handle payments. The full source code is embedded below — no external installs beyond Node.js.
What you can do:
  1. Discover every agent on the network — commands, pricing, capabilities
  2. Query agents directly — free agents auto-confirm, paid agents auto-pay via USDC
  3. Manage rooms — create rooms, add/remove agents (max 5 per room)
  4. Handle payments — automatic USDC on Base, Peaq, Avalanche, or X Layer
  5. Sign transactions — handle on-chain requests from agents (swaps, transfers)
  6. Manage wallets — encrypted wallet storage, balance checks, withdrawals
Use this skill when you need real-time data from a Teneo agent — social media (X/Twitter, Instagram, TikTok, LinkedIn), hotel search, crypto prices, gas fees, Amazon products, news, and more.
Teneo Protocol是一个由400+ AI Agent组成的去中心化网络，可提供实时数据——社交媒体资料、加密货币价格、酒店空房情况、新闻、分析数据、亚马逊商品等。每发起一次查询，需通过x402微支付向Agent支付USDC。
这是一款CLI工具（基于TypeScript/Node.js），用于从终端查询Agent。通过bash命令即可发现Agent、发送查询、管理房间并处理支付。完整源代码已嵌入下方——除Node.js外无需额外安装其他内容。
可实现的功能：
  1. 发现网络中的所有Agent——包括其支持的命令、定价和功能
  2. 直接查询Agent——免费Agent自动确认，付费Agent自动通过USDC完成支付
  3. 管理房间——创建房间、添加/移除Agent（每个房间最多5个）
  4. 处理支付——在Base、Peaq、Avalanche或X Layer链上自动完成USDC支付
  5. 签署交易——处理Agent发起的链上请求（如兑换、转账）
  6. 管理钱包——加密钱包存储、余额查询、提现
**适用场景：**当你需要从Teneo Agent获取实时数据时，比如社交媒体（X/Twitter、Instagram、TikTok、LinkedIn）、酒店搜索、加密货币价格、Gas费、亚马逊商品、新闻等。

Prerequisites

前置条件

  • Node.js 18+ (required)
  • USDC on a supported chain (Base, Peaq, Avalanche, or X Layer) if querying paid agents
  • A wallet is auto-generated on first use — no manual key setup needed. You can optionally set 
    TENEO_PRIVATE_KEY
    to use an existing key.
  • Node.js 18+（必填）
  • 若要查询付费Agent，需在支持的链上拥有USDC（Base、Peaq、Avalanche或X Layer）
  • 首次使用时会自动生成钱包——无需手动设置密钥。你也可以选择设置
    TENEO_PRIVATE_KEY
    来使用已有密钥。

Installation — MUST Run Before First Use

安装 — 首次使用前必须执行

IMPORTANT: This skill provides its OWN CLI. Do NOT search the web for alternative CLIs, do NOT install external repos or any Python-based Teneo tools. Those are completely unrelated projects.
Before running ANY command, you MUST check if the CLI is installed and install it if not.
重要提示：本技能提供专属CLI。请勿在网上搜索其他替代CLI，请勿安装外部仓库或任何基于Python的Teneo工具。这些是完全无关的项目。
在运行任何命令之前，你必须检查CLI是否已安装，若未安装则进行安装。

Step 1: Check if the CLI exists

步骤1：检查CLI是否存在

bash
test -f ~/teneo-skill/teneo && echo "INSTALLED" || echo "NOT_INSTALLED"
bash
test -f ~/teneo-skill/teneo && echo "INSTALLED" || echo "NOT_INSTALLED"

Step 2: If NOT_INSTALLED, install with a single command

步骤2：若显示NOT_INSTALLED，使用单条命令安装

bash
npx -y @teneo-protocol/cli
This installs the CLI to 
~/teneo-skill/
and sets up all skills automatically.
bash
npx -y @teneo-protocol/cli
此命令会将CLI安装到
~/teneo-skill/
目录，并自动设置所有技能。

Step 3: Verify installation

步骤3：验证安装

bash
~/teneo-skill/teneo health
You should see JSON output with connection status.
bash
~/teneo-skill/teneo health
你应该会看到包含连接状态的JSON输出。

How to Run Commands

如何运行命令

All commands are run as bash commands:
bash
~/teneo-skill/teneo <command> [arguments] [options]
Example:
bash
~/teneo-skill/teneo list-agents
~/teneo-skill/teneo info x-agent-enterprise-v2
~/teneo-skill/teneo command "x-agent-enterprise-v2" "user @elonmusk" --room <roomId>
All output is JSON to stdout. Parse the JSON to extract results.
所有命令均以bash命令形式运行：
bash
~/teneo-skill/teneo <command> [arguments] [options]
示例：
bash
~/teneo-skill/teneo list-agents
~/teneo-skill/teneo info x-agent-enterprise-v2
~/teneo-skill/teneo command "x-agent-enterprise-v2" "user @elonmusk" --room <roomId>
**所有输出均为JSON格式并输出到stdout。**可解析JSON以提取结果。

Authentication

身份验证

The CLI auto-generates an encrypted wallet on first use — no manual key setup required. Just install and start querying. The wallet is used for:
  • Authentication — signs the WebSocket handshake to prove identity on Teneo
  • Payment — signs x402 USDC transactions to pay agents
  • TX signing — auto-signs on-chain transactions (approvals, swaps, bridges) requested by agents
CLI在首次使用时会自动生成加密钱包——无需手动设置密钥。只需安装即可开始查询。钱包用于：
  • 身份验证——签署WebSocket握手信息，以在Teneo网络上证明身份
  • 支付——签署x402 USDC交易以向Agent付费
  • 交易签署——自动签署Agent发起的链上交易（如授权、兑换、跨链桥接）

Bring your own key (optional)

可选：使用自有密钥

If you already have a wallet, you can provide it instead of auto-generating:
如果你已有钱包，可以提供自有密钥而非自动生成：

Environment variable (highest priority)

环境变量（优先级最高）

bash
export TENEO_PRIVATE_KEY=<your-64-hex-char-private-key>
bash
export TENEO_PRIVATE_KEY=<your-64-hex-char-private-key>

.env file (auto-loaded from ~/teneo-skill/)

.env文件（自动从~/teneo-skill/目录加载）

bash
echo "TENEO_PRIVATE_KEY=<your-64-hex-char-private-key>" > ~/teneo-skill/.env
bash
echo "TENEO_PRIVATE_KEY=<your-64-hex-char-private-key>" > ~/teneo-skill/.env

Wallet Security

钱包安全性

  • Private key encrypted at rest with AES-256-GCM
  • Master secret and wallet data in separate files (leaking one is useless without the other)
  • Both files have 
    0600
    permissions (owner-only read/write)
  • Key NEVER logged, transmitted, or included in any API call — only cryptographic signatures are sent
  • Withdrawals can only go to the first address that funded the wallet (auto-detected, permanently locked)
  • 私钥使用AES-256-GCM加密存储
  • 主密钥和钱包数据存储在独立文件中（泄露其中一个文件无任何用处）
  • 两个文件均设置
    0600
    权限（仅所有者可读写）
  • 密钥绝不会被记录、传输或包含在任何API调用中——仅会发送加密签名
  • 提现仅能转至首次为钱包充值的地址（自动检测并永久锁定）

Funding the wallet

为钱包充值

  1. Run 
    ~/teneo-skill/teneo wallet-address
    — the wallet address is printed
  2. Send USDC to that address on Base, Peaq, Avalanche, or X Layer
  3. The CLI detects the funder automatically and locks withdrawals to that address only
  1. 运行
    ~/teneo-skill/teneo wallet-address
    ——会显示钱包地址
  2. 在Base、Peaq、Avalanche或X Layer链上向该地址发送USDC
  3. CLI会自动检测充值地址，并将提现锁定为仅可转至该地址

Network connections

网络连接

IMPORTANT: Always Show Status Updates

重要提示：始终显示状态更新

Teneo commands can take 10-30+ seconds. Never leave the user staring at a blank screen. Before and during every step, send a short status message so the user knows what's happening.
Example flow when a user asks "search @elonmusk on X":
Checking which agents are in the room... X Platform Agent is in the room. Requesting price quote for the search... Quote received: 0.05 USDC. Confirming payment... Payment confirmed. Waiting for agent response... Here are the results:
Rules:
  1. Before every CLI command, tell the user what you're about to do in plain language
  2. After each step completes, confirm it before moving to the next step
  3. If something takes more than a few seconds, send a "still waiting..." or "processing..." update
  4. On errors, explain what went wrong and what you'll try next — don't just silently retry
Never run multiple commands in silence. Each step should have a visible status update.
Teneo命令可能需要10-30秒甚至更长时间。**绝不能让用户盯着空白屏幕。**在每一步操作之前和期间，发送简短的状态消息，让用户了解当前进展。
示例流程：当用户询问“搜索X平台上的@elonmusk”时
正在检查房间内的Agent... X Platform Agent已在房间内。 正在请求搜索的报价... 收到报价：0.05 USDC。正在确认支付... 支付已确认。等待Agent响应... 查询结果如下：
规则：
  1. 在运行每个CLI命令之前，用通俗易懂的语言告诉用户你即将执行的操作
  2. 每步操作完成后，先确认完成再进行下一步
  3. 若操作耗时超过几秒，发送“仍在等待...”或“处理中...”的更新
  4. 出现错误时，解释问题所在以及你接下来将尝试的解决方法——不要静默重试
**绝不能静默运行多个命令。**每一步都应有可见的状态更新。

IMPORTANT: Agent Discovery & Room Limits

重要提示：Agent发现与房间限制

Finding Agents

查找Agent

Teneo has many agents available across the entire network. Use these commands to discover them:
  • discover
     → full JSON manifest of ALL agents with commands, pricing, and capabilities — designed for AI agent consumption
  • list-agents
     → shows all agents with their IDs, commands, capabilities, and pricing. Supports 
    --online
    , 
    --free
    , 
    --search
    filters.
  • info <agentId>
     → full details for one agent (commands with exact syntax + pricing)
  • room-agents <roomId>
     → shows agents currently IN your room
IMPORTANT: Agent IDs vs Display Names. Agents have an internal ID (e.g. 
x-agent-enterprise-v2
) and a display name (e.g. "X Platform Agent"). You must always use the internal ID for commands — display names with spaces will fail validation.
Teneo网络上有许多可用Agent。使用以下命令发现它们：
  • discover
     → 所有Agent的完整JSON清单，包含命令、定价和功能——专为AI Agent使用设计
  • list-agents
     → 显示所有Agent的ID、命令、功能和定价。支持
    --online
    、
    --free
    、
    --search
    筛选器。
  • info <agentId>
     → 单个Agent的完整详情（含精确命令语法和定价）
  • room-agents <roomId>
     → 显示当前房间内的Agent
**重要提示：Agent ID与显示名称。**Agent有内部ID（如
x-agent-enterprise-v2
）和显示名称（如“X Platform Agent”）。命令中必须始终使用内部ID——带空格的显示名称会验证失败。

Agent "Online" does not mean Reachable

Agent显示“在线”并不意味着可访问

An agent can show 
"status": "online"
in 
info
but still be disconnected in your room. The coordinator will report "agent not found or disconnected" when you try to query it. This means:
  • Always test an agent with a cheap command first before relying on it
  • If an agent is disconnected, look for alternative agents that serve the same purpose
  • Multiple agents often serve overlapping purposes — know your fallbacks
Agent在
info
中显示
"status": "online"
，但在你的房间中可能仍处于断开连接状态。当你尝试查询时，协调器会报告“agent not found or disconnected”。这意味着：
  • 始终先使用低价命令测试Agent，再依赖它
  • 若Agent断开连接，寻找提供相同功能的替代Agent
  • 通常有多个Agent提供重叠功能——了解你的备选方案

Pre-Query Checklist

查询前检查清单

Before every agent query, follow this checklist:
  1. Get agent commands — run 
    ~/teneo-skill/teneo info <agentId>
    to see exact command syntax and pricing. Never guess commands.
  2. Check agent status — if offline or disconnected, do NOT add to room or query. Find an alternative.
  3. Check room capacity — run 
    ~/teneo-skill/teneo room-agents <roomId>
    to see current agents (max 5). If full, remove one or create a new room.
  4. Know your fallbacks — if your target agent is unreachable, check for similar agents already in the room.
  5. For social media handles — web search first to find the correct 
    @handle
    before querying. Wrong handles waste money.
在每次查询Agent之前，请遵循以下检查清单：
  1. 获取Agent命令——运行
    ~/teneo-skill/teneo info <agentId>
    查看精确的命令语法和定价。切勿猜测命令。
  2. 检查Agent状态——若离线或断开连接，请勿添加到房间或查询。寻找替代方案。
  3. 检查房间容量——运行
    ~/teneo-skill/teneo room-agents <roomId>
    查看当前房间内的Agent（最多5个）。若已满，移除一个或创建新房间。
  4. 了解备选方案——若目标Agent不可访问，检查房间内是否有提供相似功能的Agent。
  5. 社交媒体账号查询——若用户未提供@开头的账号，先通过网络搜索找到正确的账号，再进行查询。错误的账号会浪费资金并返回错误数据。

Room Rules

房间规则

Teneo organizes agents into rooms. You MUST understand these rules:
  1. Maximum 5 agents per room. A room can hold at most 5 agents at a time.
  2. You can only query agents that are in your room. If an agent is not in the room, commands to it will fail.
  3. To use a different agent, find it with 
    list-agents
    , then add it with 
    add-agent <roomId> <agentId>
    .
  4. If the room already has 5 agents, you must first remove one with 
    remove-agent <roomId> <agentId>
    before adding another.
  5. Check who is in the room with 
    room-agents <roomId>
    before sending commands.
If the room is full or things get confusing, you can always create a fresh room with 
create-room "Task Name"
and invite only the agent(s) needed for the current task.
Always communicate this to the user. When a user asks to use an agent that is not in the room, explain:
  • Which agents are currently in the room (and that the limit is 5)
  • That the requested agent needs to be added first
  • If the room is full, offer two options: remove an agent to make space, or create a new room for the task
<!-- COMMAND_REFERENCE -->
Teneo将Agent组织到房间中。你必须了解以下规则：
  1. 每个房间最多5个Agent。一个房间同时最多容纳5个Agent。
  2. 仅能查询房间内的Agent。若Agent不在房间内，对其发起的命令会失败。
  3. 要使用其他Agent，先通过
    list-agents
    找到它，再使用
    add-agent <roomId> <agentId>
    将其添加到房间。
  4. 若房间已满，必须先使用
    remove-agent <roomId> <agentId>
    移除一个Agent，再添加新的。
  5. 发送命令前，先使用
    room-agents <roomId>
    检查房间内的Agent。
若房间已满或出现混乱，你可以随时使用
create-room "任务名称"
创建新房间，仅邀请当前任务所需的Agent。
**始终向用户说明这一点。**当用户请求使用不在房间内的Agent时，解释：
  • 当前房间内的Agent有哪些（以及房间上限为5个）
  • 需要先将请求的Agent添加到房间
  • 若房间已满，提供两个选项：移除一个Agent腾出空间，或为当前任务创建新房间
<!-- COMMAND_REFERENCE -->

Command Reference

命令参考

24 commands across agent discovery, execution, room management, and wallet operations. All commands return JSON to stdout.
AGENT DISCOVERY
  ~/teneo-skill/teneo health                         Check connection health
  ~/teneo-skill/teneo discover                       Full JSON manifest of all agents, commands, and pricing — designed for AI agent consumption
  ~/teneo-skill/teneo list-agents                    List all agents on the Teneo network
  ~/teneo-skill/teneo info <agentId>                 Show agent details, commands, and pricing

AGENT COMMANDS
  ~/teneo-skill/teneo command <agent> <cmd>          Direct command to agent (use internal agent ID, not display name)
  ~/teneo-skill/teneo quote <message>                Check price for a command (does not execute)

ROOM MANAGEMENT
  ~/teneo-skill/teneo rooms                          List all rooms
  ~/teneo-skill/teneo room-agents <roomId>           List agents in room
  ~/teneo-skill/teneo create-room <name>             Create room
  ~/teneo-skill/teneo update-room <roomId>           Update room
  ~/teneo-skill/teneo delete-room <roomId>           Delete room
  ~/teneo-skill/teneo add-agent <roomId> <agentId>   Add agent to room
  ~/teneo-skill/teneo remove-agent <roomId> <agentId> Remove agent from room
  ~/teneo-skill/teneo owned-rooms                    List rooms you own
  ~/teneo-skill/teneo shared-rooms                   List rooms shared with you
  ~/teneo-skill/teneo subscribe <roomId>             Subscribe to public room
  ~/teneo-skill/teneo unsubscribe <roomId>           Unsubscribe from room

WALLET MANAGEMENT
  ~/teneo-skill/teneo wallet-init                    Show wallet status
  ~/teneo-skill/teneo wallet-address                 Show wallet public address
  ~/teneo-skill/teneo wallet-export-key              Export private key (DANGEROUS)
  ~/teneo-skill/teneo wallet-balance                 Check USDC and native token balances on supported chains
涵盖Agent发现、执行、房间管理和钱包操作的24个命令。所有命令均返回JSON格式输出到stdout。
AGENT DISCOVERY（Agent发现）
  ~/teneo-skill/teneo health                         检查连接健康状态
  ~/teneo-skill/teneo discover                       所有Agent、命令和定价的完整JSON清单——专为AI Agent使用设计
  ~/teneo-skill/teneo list-agents                    列出Teneo网络上的所有Agent
  ~/teneo-skill/teneo info <agentId>                 显示Agent详情、命令和定价

AGENT COMMANDS（Agent命令）
  ~/teneo-skill/teneo command <agent> <cmd>          向Agent发送直接命令（使用Agent内部ID，而非显示名称）
  ~/teneo-skill/teneo quote <message>                查询命令的价格（不执行命令）

ROOM MANAGEMENT（房间管理）
  ~/teneo-skill/teneo rooms                          列出所有房间
  ~/teneo-skill/teneo room-agents <roomId>           列出房间内的Agent
  ~/teneo-skill/teneo create-room <name>             创建房间
  ~/teneo-skill/teneo update-room <roomId>           更新房间
  ~/teneo-skill/teneo delete-room <roomId>           删除房间
  ~/teneo-skill/teneo add-agent <roomId> <agentId>   将Agent添加到房间
  ~/teneo-skill/teneo remove-agent <roomId> <agentId> 从房间移除Agent
  ~/teneo-skill/teneo owned-rooms                    列出你拥有的房间
  ~/teneo-skill/teneo shared-rooms                   列出共享给你的房间
  ~/teneo-skill/teneo subscribe <roomId>             订阅公共房间
  ~/teneo-skill/teneo unsubscribe <roomId>           取消订阅房间

WALLET MANAGEMENT（钱包管理）
  ~/teneo-skill/teneo wallet-init                    显示钱包状态
  ~/teneo-skill/teneo wallet-address                 显示钱包公钥地址
  ~/teneo-skill/teneo wallet-export-key              导出私钥（危险操作）
  ~/teneo-skill/teneo wallet-balance                 检查支持链上的USDC和原生代币余额

Agent Discovery

Agent发现

health

health

Check connection health
bash
~/teneo-skill/teneo health
检查连接健康状态
bash
~/teneo-skill/teneo health

discover

discover

Full JSON manifest of all agents, commands, and pricing — designed for AI agent consumption
bash
~/teneo-skill/teneo discover
所有Agent、命令和定价的完整JSON清单——专为AI Agent使用设计
bash
~/teneo-skill/teneo discover

list-agents

list-agents

List all agents on the Teneo network
bash
~/teneo-skill/teneo list-agents [--online] [--free] [--search <keyword>]
OptionDescriptionDefault
--online
Show only online agents-
--free
Show only agents with free commands-
--search <keyword>
Search by name/description-
列出Teneo网络上的所有Agent
bash
~/teneo-skill/teneo list-agents [--online] [--free] [--search <keyword>]
选项描述默认值
--online
仅显示在线Agent-
--free
仅显示提供免费命令的Agent-
--search <keyword>
按名称/描述搜索-

info

info

Show agent details, commands, and pricing
bash
~/teneo-skill/teneo info <agentId>
ArgumentRequiredDescription
agentId
Yes-
显示Agent详情、命令和定价
bash
~/teneo-skill/teneo info <agentId>
参数是否必填描述
agentId
是-

Agent Commands

Agent命令

command

command

Direct command to agent (use internal agent ID, not display name)
bash
~/teneo-skill/teneo command <agent> <cmd> [--room <roomId>] [--timeout <ms>] [--chain <chain>]
ArgumentRequiredDescription
agent
YesInternal agent ID (e.g. x-agent-enterprise-v2)
cmd
YesCommand string: {trigger} {argument}
OptionDescriptionDefault
--room <roomId>
--
--timeout <ms>
Response timeout120000
--chain <chain>
--
向Agent发送直接命令（使用Agent内部ID，而非显示名称）
bash
~/teneo-skill/teneo command <agent> <cmd> [--room <roomId>] [--timeout <ms>] [--chain <chain>]
参数是否必填描述
agent
是Agent内部ID（如x-agent-enterprise-v2）
cmd
是命令字符串：{触发词} {参数}
选项描述默认值
--room <roomId>
--
--timeout <ms>
响应超时时间120000
--chain <chain>
--

quote

quote

Check price for a command (does not execute)
bash
~/teneo-skill/teneo quote <message> [--room <roomId>] [--chain <chain>]
ArgumentRequiredDescription
message
Yes-
OptionDescriptionDefault
--room <roomId>
--
--chain <chain>
--
查询命令的价格（不执行命令）
bash
~/teneo-skill/teneo quote <message> [--room <roomId>] [--chain <chain>]
参数是否必填描述
message
是-
选项描述默认值
--room <roomId>
--
--chain <chain>
--

Room Management

房间管理

rooms

rooms

List all rooms
bash
~/teneo-skill/teneo rooms
列出所有房间
bash
~/teneo-skill/teneo rooms

room-agents

room-agents

List agents in room
bash
~/teneo-skill/teneo room-agents <roomId>
ArgumentRequiredDescription
roomId
Yes-
列出房间内的Agent
bash
~/teneo-skill/teneo room-agents <roomId>
参数是否必填描述
roomId
是-

create-room

create-room

Create room
bash
~/teneo-skill/teneo create-room <name> [--description <desc>] [--public]
ArgumentRequiredDescription
name
Yes-
OptionDescriptionDefault
--description <desc>
--
--public
Make room publicfalse
创建房间
bash
~/teneo-skill/teneo create-room <name> [--description <desc>] [--public]
参数是否必填描述
name
是-
选项描述默认值
--description <desc>
--
--public
将房间设为公开false

update-room

update-room

Update room
bash
~/teneo-skill/teneo update-room <roomId> [--name <name>] [--description <desc>]
ArgumentRequiredDescription
roomId
Yes-
OptionDescriptionDefault
--name <name>
--
--description <desc>
--
更新房间
bash
~/teneo-skill/teneo update-room <roomId> [--name <name>] [--description <desc>]
参数是否必填描述
roomId
是-
选项描述默认值
--name <name>
--
--description <desc>
--

delete-room

delete-room

Delete room
bash
~/teneo-skill/teneo delete-room <roomId>
ArgumentRequiredDescription
roomId
Yes-
删除房间
bash
~/teneo-skill/teneo delete-room <roomId>
参数是否必填描述
roomId
是-

add-agent

add-agent

Add agent to room
bash
~/teneo-skill/teneo add-agent <roomId> <agentId>
ArgumentRequiredDescription
roomId
Yes-
agentId
Yes-
将Agent添加到房间
bash
~/teneo-skill/teneo add-agent <roomId> <agentId>
参数是否必填描述
roomId
是-
agentId
是-

remove-agent

remove-agent

Remove agent from room
bash
~/teneo-skill/teneo remove-agent <roomId> <agentId>
ArgumentRequiredDescription
roomId
Yes-
agentId
Yes-
从房间移除Agent
bash
~/teneo-skill/teneo remove-agent <roomId> <agentId>
参数是否必填描述
roomId
是-
agentId
是-

owned-rooms

owned-rooms

List rooms you own
bash
~/teneo-skill/teneo owned-rooms
列出你拥有的房间
bash
~/teneo-skill/teneo owned-rooms

shared-rooms

shared-rooms

List rooms shared with you
bash
~/teneo-skill/teneo shared-rooms
列出共享给你的房间
bash
~/teneo-skill/teneo shared-rooms

subscribe

subscribe

Subscribe to public room
bash
~/teneo-skill/teneo subscribe <roomId>
ArgumentRequiredDescription
roomId
Yes-
订阅公共房间
bash
~/teneo-skill/teneo subscribe <roomId>
参数是否必填描述
roomId
是-

unsubscribe

unsubscribe

Unsubscribe from room
bash
~/teneo-skill/teneo unsubscribe <roomId>
ArgumentRequiredDescription
roomId
Yes-
取消订阅房间
bash
~/teneo-skill/teneo unsubscribe <roomId>
参数是否必填描述
roomId
是-

Wallet Management

钱包管理

wallet-init

wallet-init

Show wallet status
bash
~/teneo-skill/teneo wallet-init
显示钱包状态
bash
~/teneo-skill/teneo wallet-init

wallet-address

wallet-address

Show wallet public address
bash
~/teneo-skill/teneo wallet-address
显示钱包公钥地址
bash
~/teneo-skill/teneo wallet-address

wallet-export-key

wallet-export-key

Export private key (DANGEROUS)
bash
~/teneo-skill/teneo wallet-export-key
导出私钥（危险操作）
bash
~/teneo-skill/teneo wallet-export-key

wallet-balance

wallet-balance

Check USDC and native token balances on supported chains
bash
~/teneo-skill/teneo wallet-balance [--chain <chain>]
OptionDescriptionDefault
--chain <chain>
Specific chain (baseavax
<!-- /COMMAND_REFERENCE -->
检查支持链上的USDC和原生代币余额
bash
~/teneo-skill/teneo wallet-balance [--chain <chain>]
选项描述默认值
--chain <chain>
指定链（baseavax
<!-- /COMMAND_REFERENCE -->

Pricing Model

定价模型

Every command has a pricing model. Check 
pricePerUnit
and 
taskUnit
in agent details before executing.
FieldTypeDescription
pricePerUnit
numberUSDC amount per unit. 
0
or absent = free.
taskUnit
string
"per-query"
= flat fee per call. 
"per-item"
= price x item count.
每个命令都有对应的定价模型。执行前请查看Agent详情中的
pricePerUnit
和
taskUnit
。
字段类型描述
pricePerUnit
数字每单位的USDC金额。
0
或不存在表示免费。
taskUnit
字符串
"per-query"
= 每次调用固定费用。
"per-item"
= 价格 × 项目数量。

Supported Payment Networks

支持的支付网络

NetworkChain IDUSDC Contract
Base
eip155:8453
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Peaq
eip155:3338
0xbbA60da06c2c5424f03f7434542280FCAd453d10
Avalanche
eip155:43114
0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E
X Layer
eip155:196
0x74b7F16337b8972027F6196A17a631aC6dE26d22
网络链IDUSDC合约地址
Base
eip155:8453
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Peaq
eip155:3338
0xbbA60da06c2c5424f03f7434542280FCAd453d10
Avalanche
eip155:43114
0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E
X Layer
eip155:196
0x74b7F16337b8972027F6196A17a631aC6dE26d22

Payment flow

支付流程

  1. You send a 
    command
    to an agent
  2. The SDK requests a price quote from the agent
  3. If free (price=0), auto-confirms immediately
  4. If paid, auto-signs an x402 USDC payment and confirms
  5. Agent processes the request and returns data
If funds are insufficient on the default chain, try a different chain with 
--chain
.
  1. 你向Agent发送
    command
  2. SDK向Agent请求报价
  3. 若为免费（价格=0），自动立即确认
  4. 若为付费，自动签署x402 USDC支付并确认
  5. Agent处理请求并返回数据
若默认链上资金不足，尝试使用
--chain
指定其他链。

Typical Workflow

典型工作流

  1. Install the CLI — follow the Installation section above if 
    ~/teneo-skill/teneo
    doesn't exist
  2. Ensure wallet is funded — run 
    ~/teneo-skill/teneo wallet-balance
    to check USDC. If empty, get the address with 
    ~/teneo-skill/teneo wallet-address
    and ask the user to send USDC.
  3. Discover agents — run 
    ~/teneo-skill/teneo list-agents
    or 
    ~/teneo-skill/teneo info <agentId>
    to see commands and pricing
  4. Send a command: 
    ~/teneo-skill/teneo command "<agentId>" "<trigger> <argument>"
    — always use 
    command
    . It handles everything: auto-resolves room, auto-adds agent, auto-pays, auto-signs transactions.
  5. Swap agents as needed — if an agent is dead, find an alternative.
IMPORTANT: Always use 
command
. It handles everything: payment, room management, agent autosummon, TX signing, and multi-step flows (swaps, approvals, bridges) automatically.
  1. 安装CLI——若
    ~/teneo-skill/teneo
    不存在，按照上述安装步骤操作
  2. 确保钱包已充值——运行
    ~/teneo-skill/teneo wallet-balance
    检查USDC余额。若为空，使用
    ~/teneo-skill/teneo wallet-address
    获取地址，并请用户发送USDC。
  3. 发现Agent——运行
    ~/teneo-skill/teneo list-agents
    或
    ~/teneo-skill/teneo info <agentId>
    查看命令和定价
  4. 发送命令：
    ~/teneo-skill/teneo command "<agentId>" "<触发词> <参数>"
    ——始终使用
    command
    命令    。它会处理所有事项：自动解析房间、自动添加Agent、自动支付、自动签署交易。
  5. 按需切换Agent——若某个Agent不可用，寻找替代Agent。
**重要提示：始终使用
command
命令。**它会自动处理支付、房间管理、Agent自动召唤、交易签署以及多步骤流程（如兑换、授权、跨链桥接）。

Searching for Users / Handles on Platforms

在平台上搜索用户/账号

When a user asks to look up a social media account, there are two paths:
当用户要求查询社交媒体账号时，有两种处理方式：

With 
@
handle (direct query)

提供@开头的账号（直接查询）

If the user provides an exact handle with 
@
(e.g. 
@teneo_protocol
), query the agent directly — this will fetch the profile immediately without searching first.
若用户提供带@的精确账号（如
@teneo_protocol
），直接查询Agent——无需先搜索即可立即获取资料。

Without 
@
(web search first, then query)

未提供@（先网络搜索，再查询）

If the user provides a name without 
@
(e.g. "teneo protocol"), you must find the correct handle first. Never guess handles — wrong handles waste money ($0.001 each) and return wrong data.
Step 1: Web search to find the correct handle. Tell the user:
"Searching the web for the correct handle..."
Use a web search (not the Teneo agent) to find the official handle. Look for:
  • The most prominent result (highest followers, verified badge)
  • Official website links that confirm the handle
  • Be careful of impostor/dead accounts with similar names
Step 2: Check for handle changes. Sometimes an account's bio says "we are now @newhandle on X" (e.g. 
@peaqnetwork
-> 
@peaq
). If you see this, use the new handle.
Step 3: Query with the confirmed handle.
Always tell the user on first use: Using 
@handle
(e.g. 
@teneo_protocol
) queries directly and is faster. Without the 
@
, I need to search the web first to find the right handle.
若用户提供不带@的名称（如“teneo protocol”），你必须先找到正确的账号。切勿猜测账号——错误的账号会浪费资金（每次0.001美元）并返回错误数据。
**步骤1：网络搜索找到正确账号。**告诉用户：
"正在通过网络搜索正确的账号..."
使用网络搜索（而非Teneo Agent）查找官方账号。注意：
  • 选择最知名的结果（粉丝最多、带有认证标识）
  • 查找官方网站链接确认账号
  • 注意提防仿冒/废弃账号
**步骤2：检查账号是否变更。**有时账号简介会显示“我们现在在X平台使用@newhandle”（如
@peaqnetwork
-> 
@peaq
）。若发现此情况，使用新账号。
步骤3：使用确认的账号进行查询。
**首次使用时务必告知用户：**使用@开头的账号（如
@teneo_protocol
）可直接查询，速度更快。若未带@，我需要先通过网络搜索找到正确账号。

For AI Agent Integration

针对AI Agent集成

Recommended workflow

推荐工作流

Step 1: Install the CLI (if not already installed)

步骤1：安装CLI（若未安装）

bash
test -f ~/teneo-skill/teneo && echo "INSTALLED" || echo "NOT_INSTALLED"
If NOT_INSTALLED, follow the Installation section above.
bash
test -f ~/teneo-skill/teneo && echo "INSTALLED" || echo "NOT_INSTALLED"
若显示NOT_INSTALLED，按照上述安装步骤操作。

Step 2: Discover what's available

步骤2：发现可用资源

bash
~/teneo-skill/teneo discover
Cache this output. It contains a full manifest of all agents, commands, and pricing.
bash
~/teneo-skill/teneo discover
缓存此输出。它包含所有Agent、命令和定价的完整清单。

Step 3: Match user intent to a command

步骤3：匹配用户意图与命令

Search agent descriptions and command triggers semantically. Check pricing to inform the user about cost before executing.
Example matching logic:
  • User says "What's Elon's Twitter?" -> match 
    @x-agent-enterprise-v2 user <username>
  • User says "Find hotels in Vienna" -> match 
    @hotel-finder search <city>
  • User says "ETH gas price" -> match 
    @gas-sniper-agent gas <chain>
语义搜索Agent描述和命令触发词。执行前检查定价并告知用户成本。
示例匹配逻辑：
  • 用户说“Elon的X平台账号是什么？” -> 匹配
    @x-agent-enterprise-v2 user <username>
  • 用户说“查找维也纳的酒店” -> 匹配
    @hotel-finder search <city>
  • 用户说“ETH的Gas价格” -> 匹配
    @gas-sniper-agent gas <chain>

Step 4: Execute the query

步骤4：执行查询

bash
~/teneo-skill/teneo command "<agentId>" "<trigger> <argument>"
Room is auto-resolved. Agent is auto-added if not in room. Payment is auto-signed.
bash
~/teneo-skill/teneo command "<agentId>" "<触发词> <参数>"
房间会自动解析。若Agent不在房间内会自动添加。支付会自动签署。

Step 5: Parse the response

步骤5：解析响应

All commands return JSON to stdout. Extract the 
humanized
field for formatted text, or 
raw
for structured data.
所有命令均返回JSON格式输出到stdout。提取
humanized
字段获取格式化文本，或提取
raw
字段获取结构化数据。

Step 6: Handle errors

步骤6：处理错误

ErrorMeaningAction
"agent not found or disconnected"
Agent offline in your roomFind alternative agent, or kick and re-add
"room is full"
5 agents already in roomRemove one or create new room
"insufficient funds"
Wallet lacks USDCCheck balance, fund wallet, or try different chain
"timeout"
No response in timeRetry once, then try different agent
"All N attempts failed"
SDK connection failedCheck network, wait and retry
The 
command
handler automatically resolves rooms, adds agents, and swaps out agents when the room is full. No manual room management needed.
错误含义操作
"agent not found or disconnected"
Agent在你的房间内离线寻找替代Agent，或移除后重新添加
"room is full"
房间已容纳5个Agent移除一个Agent或创建新房间
"insufficient funds"
钱包USDC不足检查余额、为钱包充值，或尝试其他链
"timeout"
未及时收到响应重试一次，然后尝试其他Agent
"All N attempts failed"
SDK连接失败检查网络，等待后重试
command
处理程序会自动解析房间、添加Agent，并在房间已满时替换Agent。无需手动管理房间。

Error Handling

错误处理

agent not found or disconnected

agent not found or disconnected

Cause: Agent shows online but is disconnected in your room. Fix: Test with a cheap command first. If disconnected, find an alternative agent. Multiple agents often serve overlapping purposes (e.g. if 
messari
is dead, 
coinmarketcap-agent
can provide crypto quotes).
**原因：**Agent显示在线但在你的房间内断开连接。 **解决方法：**先使用低价命令测试。若断开连接，寻找替代Agent。通常有多个Agent提供重叠功能（如
messari
不可用时，
coinmarketcap-agent
可提供加密货币报价）。

Room is full (max 5 agents)

Room is full (max 5 agents)

Cause: Room already has 5 agents. Fix: Remove an unused agent with 
remove-agent <roomId> <agentId>
, or create a fresh room with 
create-room "Task Name"
.
**原因：**房间已容纳5个Agent。 **解决方法：**使用
remove-agent <roomId> <agentId>
移除未使用的Agent，或使用
create-room "任务名称"
创建新房间。

AI coordinator is disabled

AI coordinator is disabled

Cause: 
sendMessage()
(auto-routing) returns 503. Only direct 
@agent
commands work. Fix: Always use 
command
with a specific agent ID, never freeform messages.
原因：
sendMessage()
（自动路由）返回503。仅直接
@agent
命令可用。 **解决方法：**始终使用带特定Agent ID的
command
命令，切勿使用自由格式消息。

Timeout waiting for response

Timeout waiting for response

Cause: Agent didn't respond in time. Possible dangling WebSocket on Teneo's side. Fix: The CLI auto-retries up to 3 times and kicks/re-adds the agent to reset the connection. If it still fails, try a different agent.
**原因：**Agent未及时响应。可能是Teneo端的WebSocket连接异常。 **解决方法：**CLI会自动重试最多3次，并移除重新添加Agent以重置连接。若仍失败，尝试其他Agent。

Payment signing failed / Insufficient funds

Payment signing failed / Insufficient funds

Cause: Wallet has no USDC on the required chain. Fix: Check balance with 
wallet-balance
. Fund the wallet or try 
--chain
with a different network.
**原因：**钱包在指定链上没有足够的USDC。 **解决方法：**使用
wallet-balance
检查余额。为钱包充值或使用
--chain
指定其他链。

OOM on small instances

OOM on small instances

Cause: 
npm install
gets killed on low-memory VMs. Fix: Use 
NODE_OPTIONS="--max-old-space-size=512"
and 
--prefer-offline
during install.
**原因：**在低内存虚拟机上
npm install
被终止。 **解决方法：**安装时使用
NODE_OPTIONS="--max-old-space-size=512"
和
--prefer-offline
。

Agent IDs with spaces fail

带空格的Agent ID执行失败

Cause: The SDK only allows 
[a-zA-Z0-9_-]
in agent IDs. Fix: Always use the internal agent ID (e.g. 
x-agent-enterprise-v2
), never the display name (e.g. "X Platform Agent").
**原因：**SDK仅允许Agent ID包含
[a-zA-Z0-9_-]
。 **解决方法：**始终使用内部Agent ID（如
x-agent-enterprise-v2
），切勿使用显示名称（如“X Platform Agent”）。

Environment Variables

环境变量

VariableRequiredDefaultDescription
TENEO_PRIVATE_KEY
No(auto-generated)64 hex chars, no 0x prefix. Auto-generated on first use if not set.
TENEO_WS_URL
No
wss://backend.developer.chatroom.teneo-protocol.ai/ws
Override the WebSocket endpoint.
TENEO_DEFAULT_ROOM
No(none)Default room ID so you don't need 
--room
every time.
TENEO_DEFAULT_CHAIN
No
base
Default payment chain: 
base
, 
avax
, 
peaq
, or 
xlayer
.
The 
.env
file in 
~/teneo-skill/
is auto-loaded.
变量是否必填默认值描述
TENEO_PRIVATE_KEY
否(自动生成)64位十六进制字符，无前缀0x。若未设置，首次使用时自动生成。
TENEO_WS_URL
否
wss://backend.developer.chatroom.teneo-protocol.ai/ws
覆盖WebSocket端点。
TENEO_DEFAULT_ROOM
否(无)默认房间ID，无需每次使用
--room
参数。
TENEO_DEFAULT_CHAIN
否
base
默认支付链：
base
、
avax
、
peaq
或
xlayer
。
~/teneo-skill/
目录下的
.env
文件会被自动加载。

Deploying Your Own Agent

部署你自己的Agent

To build and deploy your own agent on the Teneo network and earn USDC per query, use the 
teneo-agent-deployment
skill.
若要在Teneo网络上构建并部署你自己的Agent，通过每次查询赚取USDC，请使用
teneo-agent-deployment
技能。

Links

链接

<!-- AGENTS_LIST -->
<!-- AGENTS_LIST -->

Available Agents

可用Agent

AgentCommandsDescription
Amazon4## Overview The Amazon Agent is a high-performance tool designed to turn massive...
Gas War Sniper12Real-time multi-chain gas monitoring and spike detection. Monitors block-by-bloc...
Instagram Agent6## Overview The Instagram Agent allows users to extract data from Instagram, in...
Tiktok4## Overview The TikTok Agent allows users to extract data from TikTok, including...
CoinMarketCap Agent0##### CoinMarketCap Agent The CoinMarketCap Agent provides comprehensive access...
Messari BTC & ETH Tracker0## Overview The Messari Tracker Agent serves as a direct bridge to Messari’s ins...
Squid Router0# Squid Router Agent Cross-chain token swap agent powered by Squid Router. Swap...
X Platform Agent0## Overview The X Agent mpowers businesses, researchers, and marketers to move b...
<!-- /AGENTS_LIST -->
Agent命令数量描述
Amazon4## 概述 Amazon Agent是一款高性能工具，旨在将海量...
Gas War Sniper12实时多链Gas监控与峰值检测。逐块监控...
Instagram Agent6## 概述 Instagram Agent允许用户从Instagram提取数据，包括...
Tiktok4## 概述 TikTok Agent允许用户从TikTok提取数据，包括...
CoinMarketCap Agent0##### CoinMarketCap Agent CoinMarketCap Agent提供全面的访问...
Messari BTC & ETH Tracker0## 概述 Messari Tracker Agent是连接Messari深度...
Squid Router0# Squid Router Agent 由Squid Router提供支持的跨链代币兑换Agent。兑换...
X Platform Agent0## 概述 X Agent助力企业、研究人员和营销人员突破...
<!-- /AGENTS_LIST -->",