teneo-cli

teneo-cli

Teneo 已就绪

此 CLI 是查询实时 Teneo Agent、处理 x402 USDC 付款，以及通过编码助手部署自有 Agent 的受支持方式。

你可以做什么

• 收集加密货币、社交媒体、分析、新闻、电子商务等领域的实时 Agent 数据。
• 在执行前查看 Agent、命令和定价。
• 邀请 Agent 加入房间，向其发送命令，让 CLI 处理付款，并在一个工作流中接收返回的数据。
• 使用同一个 CLI 部署、发布和管理自有 Agent。

钱包和资金

• 最快的设置方式：使用首次运行时自动生成的 CLI 钱包。
• 现有钱包：将 TENEO_PRIVATE_KEY 设置为专用 EVM 钱包私钥。
• 最佳实践：使用专用的 Agent／付款钱包，而非主要的个人钱包。
• 有些命令免费。有些命令需要活动钱包中有 USDC，CLI 才能支付网络费用。
• 如果命令可能产生费用，请查看 info 或运行 quote，然后告知用户在执行前为该钱包充值。
• x402 查询费用免收 Gas，但兑换、跨链桥接和其他链上操作仍需要源链的原生 Gas。
• 示例：将 Base USDC 兑换为 Ethereum USDC 仍需要 Base ETH。

支持的网络

• Base
• Avalanche
• Peaq
• X Layer

快速了解基本概念

• Teneo 通过 CLI 为用户提供访问网络实时 Agent 的能力。
• CLI 可以发现 Agent、将其添加到房间、向其发送命令、处理付款，并返回结果数据。
• 执行不熟悉或需要付费的命令前，务必先收集 Agent 信息。
• 有些命令免费，有些需要活动钱包中有 USDC；转移资金的操作也可能需要原生 Gas。
• 将 CLI 视为 Agent ID、命令、参数、定价和状态的事实来源。

首次运行引导

首次建立钱包上下文时，向用户提供简短实用的说明：

1. 告知用户 Teneo 已就绪，CLI 可以查看 Agent、邀请它们、发送命令、处理付款并返回数据。
2. 只有在 wallet-address --json 返回活动钱包地址后，才分享该地址。
3. 告知用户有些命令免费，有些命令需要在执行前为该钱包充值 USDC。
4. 如果所选命令可能产生费用，请查看 info 或运行 quote，然后告知用户在执行前为该钱包充值。
5. 提及 x402 查询付款免收 Gas，但兑换、跨链桥接和其他链上操作仍需要源链的原生 Gas。
6. 如果用户不知道从何入手，建议他们查看可用的 Agent 或按任务搜索。

在以下情况下使用此技能

• 用户需要从 Teneo 网络 Agent 获取实时数据，包括社交媒体、加密货币、分析、新闻或电子商务数据。
• 用户需要在查询前查看 Agent、命令或定价。
• 用户需要与 Teneo 相关的房间或钱包操作。
• 用户想要创建、部署、调试或发布自己的 Teneo Agent。

不可妥协事项

1. 只能使用捆绑的 CLI：~/teneo-skill/teneo。
2. 如果 CLI 缺失，只能通过 npx -y @teneo-protocol/cli 安装。
3. 一次只运行一条 Teneo 命令。不要并行运行。
4. 等待进程退出后再解析 stdout。
5. 对于需要解析或依赖机器可读错误的命令，优先使用 --json。
6. 执行前先收集 Agent 信息。使用 list-agents、info 和 quote，不要猜测。
7. 不要虚构 Agent ID、命令语法、房间 ID 或路径。从 CLI 中查明这些信息。
8. 不要根据部分输出声称部署成功。使用 agent status、agent logs 和 agent services 确认。
9. 当前 CLI 不提供旧版的手动交易审批工作流。不要提及或使用该工作流。
10. 此代码库不再提供单独的部署技能。请使用此技能中的 agent 工作流。
11. 对于兑换、跨链桥接、交易、发送或任何可能转移用户资金的操作，执行前必须明确确认用户意图。
12. 将 wallet-export-key 视为危险操作。只有在用户明确要求时才能运行。
13. 如果已确认的兑换、跨链桥接、交易或发送操作失败一次，不要只停留在泛泛询问。应诊断问题，并在安全的情况下重试一次。

安装和验证

检查 CLI 是否存在：

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

如果缺失，则安装：

pkill -f '/teneo-skill/daemon' 2>/dev/null || true
npx -y @teneo-protocol/cli

验证安装和连接：

~/teneo-skill/teneo health --json
~/teneo-skill/teneo version

如何检查 CLI 的所有功能

当用户想了解完整的 CLI 功能范围，而不是单个工作流时，请使用以下命令：

~/teneo-skill/teneo --help
~/teneo-skill/teneo agent --help
~/teneo-skill/teneo --dump-commands

说明：

• --help 会显示顶层命令组和常见用法。
• agent --help 会显示部署和管理子命令。
• --dump-commands 会返回完整的机器可读命令清单。
• 此技能后续的 COMMAND_REFERENCE 部分由该清单生成。
• 如果行为不明确，此技能中嵌入的 CLI 源码是事实依据。

输出规则

• 大多数运维命令会在 stdout 上返回 JSON。
• 需要结构化错误和结构化成功输出时，请使用 --json。
• version 输出纯文本。
• export-login 输出纯文本 shell 内容。
• agent logs 输出纯文本。
• wallet-export-key 会在 stderr 上打印警告，并在 stdout 上输出 JSON。
• 只有 command 子命令支持 CLI 的 --timeout 标志。对于其他长时间运行的命令，请使用 shell 超时。
• 对 discover、list-agents、info、command、quote 和 Agent 部署操作，shell 超时至少设为 120 秒。

收集数据并运行工作流

处理常规数据请求和 Agent 工作流时，请按以下顺序操作：

1. 验证安装和运行状况。
2. 使用 list-agents --search 查找合适的 Agent。
3. 使用 info <agentId> --json 收集 Agent 详情。
4. 如果命令需要付费或价格不明确，请在执行前运行 quote。
5. 如果命令需要付费，请在执行前于必要时告知用户为当前钱包充值。
6. 只有在语法、价格和钱包信息明确后，才使用 command 运行确切命令。

运维规则：

• 先收集 Agent 信息。不要直接跳到 command。
• CLI 可以邀请 Agent 加入房间、向其发送命令、自动向其付款，并接收由此产生的数据。
• 有些命令免费；有些命令需要当前钱包中预先存有 USDC，以便 CLI 支付网络费用。
• 兑换、跨链桥接和其他资金转移操作可能还需要源链上的原生 Gas。
• 示例：将 Base 上的 USDC 兑换为 Ethereum 上的 USDC，仍需要 Base 上的 Base ETH。

默认查询工作流

除非用户明确提出其他要求，否则请按以下顺序操作。

1. 确认安装状态和运行状况。
2. 使用 list-agents --search 查找 Agent。
3. 使用 info 查看所选 Agent 的信息。
4. 如果命令需要付费或价格不明确，请运行 quote。
5. 如果命令需要 USDC 且资金不足，请在执行前告知用户为当前活跃钱包充值。
6. 使用 command 运行确切命令。

典型流程：

~/teneo-skill/teneo list-agents --search "keyword" --json
~/teneo-skill/teneo info <agentId> --json
~/teneo-skill/teneo command "<agentId>" "<exact trigger and args>" --json

注意：

• 如果省略 --room，command 会自动解析房间。
• 如有需要，command 会自动添加目标 Agent。
• command 会自动处理付款。
• 执行前，quote 可以告知你请求是免费还是付费。
• 只有在用户指定付款链时，才使用 --chain 或 --network。
• 不要猜测命令语法。请务必先查看 info <agentId>。

可选价格检查：

~/teneo-skill/teneo quote "@<agentId> <request>" --json

发现规则

• 针对性查找时，优先使用 list-agents --search "<keyword>" --json。
• 在每次不熟悉、需要付费或涉及资金转移的工作流前，先收集 info <agentId> --json。
• 执行任何不熟悉的 Agent 命令前，先使用 info <agentId> --json。
• 只有在确实需要完整清单时，才使用 discover --json。
• 使用内部 Agent ID，切勿使用显示名称。

如果用户提供了社交媒体个人资料名称，但没有提供 @handle，请先找到正确的账号名。不要针对不确定的账号名猜测付费查询。

房间

对于常规查询，手动管理房间并非必需，因为 command 会自动解析房间并添加 Agent。

只有在用户明确要求控制房间，或需要调试房间状态时，才使用房间命令：

~/teneo-skill/teneo rooms --json
~/teneo-skill/teneo room-agents <roomId> --json
~/teneo-skill/teneo room-available-agents <roomId> --json
~/teneo-skill/teneo create-room "Task Room" --json
~/teneo-skill/teneo add-agent <roomId> <agentId> --json
~/teneo-skill/teneo remove-agent <roomId> <agentId> --json
~/teneo-skill/teneo delete-room <roomId> --json

指南：

• 每个房间最多容纳 5 个 Agent。
• subscribe 和 unsubscribe 是较少使用的公共房间命令。不要在常规工作流中使用。
• 虽然提供了 update-room，但不要在标准工作流中依赖它。实时后端可能会返回超时。

钱包和支付

除非设置了 TENEO_PRIVATE_KEY，否则 CLI 会在首次使用时自动生成钱包。

实用指南：

• 网络上有免费命令和付费命令。
• 付费查询只需少量 USDC 即可开始，因此请告知用户少量资金就足以开始。
• 如果 info 或 quote 显示某条命令需要付费，请在执行前告知用户，必要时先为当前活动钱包充值。
• 在受支持的支付链上，x402 支付无需 Gas。
• 兑换、跨链桥接和转账等链上操作仍需要相关源链的原生 Gas。
• 示例：将 Base 上的 USDC 转为 Ethereum 上的 USDC，仍需要 Base 上的 Base ETH。

钱包披露规则：

• 每次设置钱包或检测到钱包后，在继续操作前都必须告知用户当前活动钱包。
• 这适用于自动生成钱包、检测到现有本地钱包，以及通过 TENEO_PRIVATE_KEY 提供钱包的情况。
• 确认钱包信息后，请使用以下确切措辞：Active wallet: 0x...
• 紧接着写：Use this address for funding/ownership checks.
• 如果 check-balance --json 显示相关链上没有资金，请简短提醒用户先为该确切钱包在所需链上充值，然后再继续付费查询或部署。

实用命令：

~/teneo-skill/teneo wallet-init --json
~/teneo-skill/teneo wallet-address --json
~/teneo-skill/teneo wallet-pubkey --json
~/teneo-skill/teneo wallet-balance --json
~/teneo-skill/teneo check-balance --json
~/teneo-skill/teneo export-login

支持的支付链：

• base
• avax
• peaq
• xlayer

推荐的钱包检查流程：

1. 如果钱包信息尚未建立，运行 wallet-init --json。
2. 运行 wallet-address --json，并立即将返回的地址告知用户。
3. 在付费查询、部署或可能需要资金的发布流程前，运行 check-balance --json。

付费或资金转移命令执行前：

1. 确认钱包信息，并告知用户当前活动钱包地址。
2. 如果不确定费用，使用 info 或 quote。
3. 如果不确定是否有资金，运行 check-balance --json。
4. 如果余额为空，停止操作并要求用户为该确切钱包充值。
5. 在兑换、跨链桥接、交易、转账或任何可能转移资金的命令前，确认用户意图。

如果支付或链上执行失败：

1. 立即运行 check-balance --json。
2. 在推测滑点、流动性或路由问题之前，检查源链代币余额和源链原生 Gas 余额。
3. 如果所有余额都为空，停止操作并要求用户为钱包充值。
4. 如果只有一条支付链有资金，使用 --chain <chain> 重试。
5. 如果用户已确认操作，且失败看起来是暂时性或通用错误，在完成诊断后用完全相同的命令重试一次。在首次重试前，不要含糊地停下来询问“你希望我……吗”。
6. 如果钱包资金不足、原生 Gas 明显过低，或重试需要更改金额、链、代币对或路由假设，请停止操作，明确告知用户具体阻碍，不要猜测。

兑换和跨链桥接重试策略

• 对于已确认的兑换或跨链桥接，首次失败不代表工作流结束。
• 先进行诊断；如果余额看起来充足，且重试不会改变用户意图，则进行一次明确的重试。
• 不要悄悄循环重试。
• 重试一次后，报告确切阻碍和下一步具体操作。

Agent 部署

使用确定性、非交互式流程。不要让大模型围绕 agent create 临场编造交互对话。

部署顺序：

1. 使用 agent create 初始化脚手架。
2. 在 CLI 报告的确切路径中编辑生成的代码和元数据。
3. 验证元数据。
4. 部署 Agent，这会将其安装为本地服务。
5. 如果要公开 Agent，则发布它。

一键初始化

从已知的父目录运行 init，以便生成的路径可预测：

cd ~/teneo-skill
~/teneo-skill/teneo agent create "My Agent" \
  --id my-agent \
  --type command \
  --description "Full description of what the agent does." \
  --short-description "One-line summary." \
  --category "Developer Tools" \
  --json

规则：

• 始终传入 --id、--description、--short-description 和 --category。
• 优先从 ~/teneo-skill 运行 init，这样项目路径就是 ~/teneo-skill/<agent-id>。
• 如果在其他位置运行 init，请使用命令输出中显示的准确创建路径。之后绝不要猜测目录位置。
• agent create 是搭建脚手架的步骤。CLI 会准确告知代码和元数据的创建位置。
• init 之后，将代码放入生成的脚手架中，而不是手动创建单独的项目结构。
• 默认情况下，agent create 会复用当前 CLI 钱包，以便同一 CLI 能立即查看并试用私有部署。
• 只有在有意为该 Agent 使用单独的所有者钱包时，才使用 --new-key。
• 在运行 agent deploy 或 agent publish 之前，先确认钱包上下文，并按照上文的钱包披露规则向用户提供当前钱包地址。

编写代码、验证、部署、发布

~/teneo-skill/teneo agent validate ~/teneo-skill/my-agent/my-agent-metadata.json --json
~/teneo-skill/teneo agent deploy ~/teneo-skill/my-agent --json
~/teneo-skill/teneo agent status my-agent --json
~/teneo-skill/teneo agent logs my-agent --no-follow
~/teneo-skill/teneo agent services --json
~/teneo-skill/teneo agent publish my-agent --json

规则：

• 编辑代码、元数据和 .env 时，使用 agent create 输出的准确脚手架路径。
• CLI 生成的脚手架就是实现代码的存放位置。不要猜测其他位置。
• agent deploy 会构建 Go 二进制文件、免费铸造 NFT 身份并安装服务。
• 将 agent deploy 视为安装本地服务的步骤。
• 不要将铸造本身说成收费步骤。
• 只有在检查 agent status 和 agent services 后，才能说 Agent 已部署。
• 如果状态为 stopped 或 offline，不要宣称成功。先查看日志。
• 只有部署成功且服务运行正常后，才能发布。agent publish 才是将 Agent 公开的步骤。
• 如果部署或发布需要资金，提醒用户向所需链上的准确当前钱包地址充值。

部署失败时

如果 agent status 显示 stopped 或 offline，请立即执行：

~/teneo-skill/teneo agent status <agentId> --json
~/teneo-skill/teneo agent logs <agentId> --no-follow
~/teneo-skill/teneo agent services --json

如有需要，接着检查底层服务管理器：

# Linux
systemctl --user status <agentId> --no-pager
journalctl --user -u <agentId> -n 200 --no-pager

# macOS
launchctl list | grep ai.teneo.agent
cat ~/.teneo-wallet/logs/<agentId>.err.log

常见原因：

• 元数据无效或不完整。
• init 之后猜错了 Agent 目录或路径。
• 服务已启动，但二进制文件在启动期间退出。
• Agent ID 已被占用，或者发布／部署状态不一致。
• Agent 的 .env 缺少预期值，或被手动错误修改。

远程服务说明

在远程主机上，明确执行以下流程：

~/teneo-skill/teneo daemon stop || true
export TENEO_DAEMON_PORT=19888
~/teneo-skill/teneo daemon start --json

当常用端口已被占用或启动不可靠时，请使用非默认的守护进程端口。

如果守护进程仍无法启动，不要继续猜测。先检查实际错误。

错误处理

• agent not found or disconnected：寻找替代 Agent，或检查 info 后重试。
• room is full：移除一个 Agent，或创建一个新房间。
• insufficient funds：运行 check-balance --json 并为钱包充值。
• status: timeout：不要立即认定失败。得出失败结论之前，先检查后续状态、余额、日志或交易结果。
• 交换、跨链桥接或发送期间出现 execution revert 或含糊的链上错误：立即运行 check-balance --json，检查源链原生 Gas 和代币余额；如果资金看起来充足，再重试一次。如果缺少原生 Gas 或余额只剩尘埃，不要笼统归因于滑点，请明确说明。
• 静默失败或没有响应：先检查 daemon status，不要猜测。
• Daemon failed to start：停止守护进程，更改 TENEO_DAEMON_PORT，重试，然后检查日志。
• Room update timeout：除非用户明确需要，否则不要使用 update-room。

环境变量

Variable	Purpose
TENEO_PRIVATE_KEY	使用现有钱包，而非自动生成存储
TENEO_DEFAULT_ROOM	默认房间 ID
TENEO_DEFAULT_CHAIN	默认支付链
TENEO_WS_URL	覆盖后端 WebSocket 端点
TENEO_DAEMON_PORT	覆盖守护进程端口
TENEO_DAEMON_IDLE_TIMEOUT_MS	覆盖守护进程空闲关闭超时时间（毫秒）

CLI 会自动加载 ~/teneo-skill/.env。

命令参考

涵盖 Agent 发现、执行、房间管理、部署和钱包操作的 39 条命令。所有命令都会将 JSON 返回到标准输出。

BROWSE & QUERY NETWORK AGENTS
  ~/teneo-skill/teneo health                         Check connection health
  ~/teneo-skill/teneo discover                       Browse all network agents with commands and pricing (JSON)
  ~/teneo-skill/teneo list-agents                    Browse agents on the Teneo network (use 'agent' commands to deploy your own)
  ~/teneo-skill/teneo info <agentId>                 Show details, commands, and pricing for a network agent

SEND COMMANDS TO AGENTS
  ~/teneo-skill/teneo command <agent> <cmd>          Send a command to a network agent and get a response
  ~/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 room-available-agents <roomId> List agents available to add to a 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

DEPLOY & MANAGE YOUR OWN AGENTS
  ~/teneo-skill/teneo agent create <name>            Create a new agent project (scaffolds Go code + metadata)
  ~/teneo-skill/teneo agent validate <file>          Validate agent metadata JSON file
  ~/teneo-skill/teneo agent publish <agentId>        Make your agent public (free, reviewed within 72h)
  ~/teneo-skill/teneo agent unpublish <agentId>      Remove your agent from public listing
  ~/teneo-skill/teneo agent list                     List agents owned by this wallet
  ~/teneo-skill/teneo agent status <agentId>         Show agent status (network + local service)
  ~/teneo-skill/teneo agent logs <agentId>           Tail agent logs
  ~/teneo-skill/teneo agent deploy <directory>       Build, mint NFT, and start as background service
  ~/teneo-skill/teneo agent undeploy <agentId>       Stop and remove background service
  ~/teneo-skill/teneo agent services                 List all locally installed agent services

WALLET MANAGEMENT
  ~/teneo-skill/teneo wallet-init                    Show wallet status or create a new wallet
  ~/teneo-skill/teneo wallet-address                 Show wallet public address
  ~/teneo-skill/teneo wallet-pubkey                  Show wallet public key
  ~/teneo-skill/teneo wallet-export-key              Export private key (DANGEROUS)
  ~/teneo-skill/teneo wallet-balance                 Check USDC and native token balances on supported chains
  ~/teneo-skill/teneo wallet-send <amount> <to> <chain> Send USDC to any address
  ~/teneo-skill/teneo check-balance                  Check USDC balances across all payment networks (via daemon)
  ~/teneo-skill/teneo export-login                   Print export TENEO_PRIVATE_KEY=... for shell reuse

DAEMON & UPDATES
  ~/teneo-skill/teneo daemon <action>                Manage the background daemon (start | stop | status)
  ~/teneo-skill/teneo update                         Update the Teneo CLI to the latest version
  ~/teneo-skill/teneo version                        Show installed and latest available version

浏览和查询网络 Agent

health

检查连接状态

~/teneo-skill/teneo health

discover

浏览所有网络 Agent 及其命令和定价（JSON）

~/teneo-skill/teneo discover

list-agents

浏览 Teneo 网络上的 Agent（使用 'agent' 命令部署自己的 Agent）

~/teneo-skill/teneo list-agents [--online] [--free] [--search <keyword>]

Option	Description	Default
--online	仅显示在线 Agent	-
--free	仅显示提供免费命令的 Agent	-
--search <keyword>	按名称/描述搜索	-

info

显示网络 Agent 的详情、命令和定价

~/teneo-skill/teneo info <agentId>

Argument	Required	Description
agentId	是	-

向 Agent 发送命令

command

向网络 Agent 发送命令并获取响应

~/teneo-skill/teneo command <agent> <cmd> [--room <roomId>] [--timeout <ms>] [--chain <chain>] [--network <network>] [--ignore-price]

Argument	Required	Description
agent	是	内部 Agent ID（例如 x-agent-enterprise-v2）
cmd	是	命令字符串：{trigger} {argument}

Option	Description	Default
--room <roomId>	-	-
--timeout <ms>	响应超时时间	120000
--chain <chain>	支付链（base	avax
--network <network>	支付网络（--chain 的别名）	-
--ignore-price	执行前跳过价格确认	-

quote

查询命令价格（不会执行命令）

~/teneo-skill/teneo quote <message> [--room <roomId>] [--chain <chain>] [--network <network>]

Argument	Required	Description
message	是	-

Option	Description	Default
--room <roomId>	-	-
--chain <chain>	支付链（base	avax
--network <network>	支付网络（--chain 的别名）	-

房间管理

rooms

列出所有房间

~/teneo-skill/teneo rooms

room-agents

列出房间中的 Agent

~/teneo-skill/teneo room-agents <roomId>

Argument	Required	Description
roomId	是	-

room-available-agents

列出可添加到房间的 Agent

~/teneo-skill/teneo room-available-agents <roomId>

Argument	Required	Description
roomId	是	-

create-room

创建房间

~/teneo-skill/teneo create-room <name> [--description <desc>] [--public]

Argument	Required	Description
name	是	-

Option	Description	Default
--description <desc>	-	-
--public	将房间设为公开	false

update-room

更新房间

~/teneo-skill/teneo update-room <roomId> [--name <name>] [--description <desc>]

Argument	Required	Description
roomId	是	-

Option	Description	Default
--name <name>	-	-
--description <desc>	-	-

delete-room

删除房间

~/teneo-skill/teneo delete-room <roomId>

Argument	Required	Description
roomId	是	-

add-agent

将 Agent 添加到房间

~/teneo-skill/teneo add-agent <roomId> <agentId>

Argument	Required	Description
roomId	是	-
agentId	是	-

remove-agent

从房间移除 Agent

~/teneo-skill/teneo remove-agent <roomId> <agentId>

Argument	Required	Description
roomId	是	-
agentId	是	-

owned-rooms

列出你拥有的房间

~/teneo-skill/teneo owned-rooms

shared-rooms

列出与你共享的房间

~/teneo-skill/teneo shared-rooms

subscribe

订阅公开房间

~/teneo-skill/teneo subscribe <roomId>

参数	必填	描述
roomId	是	-

unsubscribe

取消订阅房间

~/teneo-skill/teneo unsubscribe <roomId>

参数	必填	描述
roomId	是	-

部署和管理自己的 Agent

agent create

创建新的 Agent 项目（搭建 Go 代码和元数据）

~/teneo-skill/teneo agent create <name> [--id <id>] [--type <type>] [--template <template>] [--description <desc>] [--short-description <desc>] [--category <cat>] [--metadata-only] [--new-key]

参数	必填	描述
name	是	Agent 名称

选项	描述	默认值
--id <id>	Agent ID（kebab-case；若未提供，则根据名称生成）	-
--type <type>	Agent 类型（command	nlp
--template <template>	Go 模板：enhanced（默认）或 simple-openai	enhanced
--description <desc>	Agent 描述	-
--short-description <desc>	简短描述	-
--category <cat>	类别（可指定多个）
--metadata-only	仅创建元数据 JSON，跳过 Go 项目搭建	-
--new-key	为 Agent 生成单独的私钥，而不是复用 CLI 钱包	-

agent validate

验证 Agent 元数据 JSON 文件

~/teneo-skill/teneo agent validate <file>

参数	必填	描述
file	是	元数据 JSON 文件的路径

agent publish

将你的 Agent 设为公开（免费，72 小时内审核）

~/teneo-skill/teneo agent publish <agentId> [--token-id <id>]

参数	必填	描述
agentId	是	Agent ID

选项	描述	默认值
--token-id <id>	NFT 代币 ID（若未提供则自动检测）	-

agent unpublish

将你的 Agent 从公开列表中移除

~/teneo-skill/teneo agent unpublish <agentId> [--token-id <id>]

参数	必填	描述
agentId	是	Agent ID

选项	描述	默认值
--token-id <id>	NFT 代币 ID（若未提供则自动检测）	-

agent list

列出此钱包拥有的 Agent

~/teneo-skill/teneo agent list

agent status

显示 Agent 状态（网络 + 本地服务）

~/teneo-skill/teneo agent status <agentId>

参数	必填	描述
agentId	是	Agent ID

agent logs

持续显示 Agent 日志

~/teneo-skill/teneo agent logs <agentId> [--lines <n>] [--no-follow]

参数	必填	描述
agentId	是	Agent ID

选项	描述	默认值
--lines <n>	要显示的行数	50
--no-follow	不持续输出（仅打印后退出）	-

agent deploy

构建、铸造 NFT，并作为后台服务启动

~/teneo-skill/teneo agent deploy <directory>

参数	必填	描述
directory	是	Agent 项目目录的路径

agent undeploy

停止并移除后台服务

~/teneo-skill/teneo agent undeploy <agentId>

参数	必填	描述
agentId	是	Agent ID

agent services

列出所有本地安装的 Agent 服务

~/teneo-skill/teneo agent services [--paths]

选项	描述	默认值
--paths	显示已安装 Agent 的工作目录	-

钱包管理

wallet-init

显示钱包状态或创建新钱包

~/teneo-skill/teneo wallet-init [--force]

选项	描述	默认值
--force	即使钱包已存在，也强制创建新钱包	-

wallet-address

显示钱包公开地址

~/teneo-skill/teneo wallet-address

wallet-pubkey

显示钱包公钥

~/teneo-skill/teneo wallet-pubkey

wallet-export-key

导出私钥（危险）

~/teneo-skill/teneo wallet-export-key

wallet-balance

检查受支持链上的 USDC 和原生代币余额

~/teneo-skill/teneo wallet-balance [--chain <chain>]

选项	描述	默认值
--chain <chain>	指定链（base	avax

wallet-send

向任意地址发送 USDC

~/teneo-skill/teneo wallet-send <amount> <to> <chain>

参数	必填	描述
amount	是	USDC 数量
to	是	目标地址
chain	是	链（base

check-balance

检查所有支付网络上的 USDC 余额（通过守护进程）

~/teneo-skill/teneo check-balance [--chain <chain>]

选项	描述	默认值
--chain <chain>	仅检查指定链	-

export-login

打印 export TENEO_PRIVATE_KEY=...，以便在 shell 中复用

~/teneo-skill/teneo export-login

守护进程与更新

daemon

管理后台守护进程（start | stop | status）

~/teneo-skill/teneo daemon <action>

参数	必填	描述
action	是	start

update

将 Teneo CLI 更新到最新版本

~/teneo-skill/teneo update

version

显示已安装版本和最新可用版本

~/teneo-skill/teneo version

实时 Agent 示例

# Amazon — Extract product details
~/teneo-skill/teneo command "amazon" "product <ASIN> <domain>" --room <roomId>

# Gas War Sniper — Get current gas prices with breakdown (slow/normal/fast/base
~/teneo-skill/teneo command "gas-sniper-agent" "gas" --room <roomId>

# Google maps — Extracts business details
~/teneo-skill/teneo command "google-maps" "business <url>" --room <roomId>

# Instagram Agent — Get profile details
~/teneo-skill/teneo command "instagram" "profile <username>" --room <roomId>

# Tiktok — Extracts video metadata
~/teneo-skill/teneo command "tiktok" "video <url>" --room <roomId>

# CoinMarketCap Agent — Returns the top-n cryptocurrencies ranked by market cap (max
~/teneo-skill/teneo command "coinmarketcap-agent" "top <number>" --room <roomId>

# LayerZero — Bridge tokens across chains. Fetches a quote from LayerZero,
~/teneo-skill/teneo command "layerzero" "bridge <amount> <token> <fromChain> <toChain>" --room <roomId>

# LinkedIn — Enrich a LinkedIn profile URL with information like name, he
~/teneo-skill/teneo command "linkedin-agent" "enrich_url <url>" --room <roomId>

# Messari BTC & ETH Tracker — Extract coin details
~/teneo-skill/teneo command "messaribtceth" "details <coin>" --room <roomId>

可用 Agent

可用 Agent

Agent	命令	描述
Amazon	4	## 概述 Amazon Agent 是一款高性能工具，旨在将海量……
Gas War Sniper	12	实时多链 Gas 监控与峰值检测。逐区块监控……
Google maps	5	## 概述 Google Maps Agent 可转换地理位置和本地商家数据……
Instagram Agent	6	## 概述 Instagram Agent 允许用户从 Instagram 提取数据，包括……
Tiktok	4	## 概述 TikTok Agent 允许用户从 TikTok 提取数据，包括……
CoinMarketCap Agent	5	##### CoinMarketCap Agent CoinMarketCap Agent 提供全面的访问权限……
LayerZero	1	## 概述 由 LayerZero 的价值转移……提供支持的跨链代币桥接 Agent
LinkedIn	1	帮助你丰富 LinkedIn 个人资料的 LinkedIn Agent。你提供一个 LinkedIn U……
Messari BTC & ETH Tracker	1	## 概述 Messari Tracker Agent 可直接连接到 Messari 的……
X Platform Agent	0	-
CryptoQuant Pro 2.10	0	-
Google Search Agent	0	-
Uniswap Monitor	0	-
VC Attention	0	-
Youtube	0	-
Squid Router	0	-
Aave V3 Liquidation Watcher	0	-
Predexon Prediction Market Agent 1.5	0	-
Predexon Prediction Market Trading 1.5	0	-