Teneo CLI 是 Teneo 协议官方支持的命令行工具，用于查询实时 Teneo 智能体、处理 x402 USDC 支付，以及从编码助手中部署自己的智能体。
用途
Teneo CLI 让用户通过命令行访问 Teneo 网络中的实时智能体。它可以发现智能体、将智能体加入房间、向智能体发送指令、自动处理支付，并返回结果数据。同时，它也能用于部署、发布和管理用户自己的智能体。
主要能力
- 浏览和查询网络智能体，获取加密、社交、分析、新闻、电商等领域的实时数据。
- 在执行前检查智能体信息、可用命令和定价。
- 邀请智能体进入房间、发送指令，由 CLI 自动处理支付并返回数据。
- 通过同一 CLI 部署、发布和管理自己的智能体。
- 钱包管理，包括自动生成钱包、查看地址、余额检查等。
- 守护进程管理。
使用方式
安装与验证
检查 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
查看全部命令
~/teneo-skill/teneo --help ~/teneo-skill/teneo agent --help ~/teneo-skill/teneo --dump-commands
默认查询流程
- 验证安装与健康状态。
- 使用 list-agents --search 查找智能体。
- 使用 info 检查所选智能体。
- 若命令为付费或定价不明，运行 quote。
- 若命令需要 USDC 且余额不足，提示用户为当前钱包充值。
- 使用 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
可选价格检查：
~/teneo-skill/teneo quote "@<agentId> <request>" --json
房间管理
房间命令仅在用户明确需要房间控制或调试房间状态时使用：
~/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 个智能体。
钱包与支付
CLI 首次使用时自动生成钱包，除非设置了 TENEO_PRIVATE_KEY。
常用命令：
~/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。
x402 查询支付免 gas，但兑换、跨链桥等链上操作仍需源链原生 gas。例如将 Base USDC 兑换为 Ethereum USDC 仍需 Base ETH。
智能体部署
部署顺序：
- 使用 agent create 初始化脚手架。
- 在 CLI 报告的确切路径编辑生成的代码和元数据。
- 验证元数据。
- 部署智能体，将其安装为本地服务。
- 需要公开时发布。
一次性初始化示例：
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
代码、验证、部署、发布：
~/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
远程服务器
在远程主机上：
~/teneo-skill/teneo daemon stop || true export TENEO_DAEMON_PORT=19888 ~/teneo-skill/teneo daemon start --json
适用场景
- 需要从 Teneo 网络智能体获取实时数据，包括社交媒体、加密、分析、新闻或电商数据。
- 需要在查询前检查智能体、命令或定价。
- 需要与 Teneo 相关的房间或钱包操作。
- 想要创建、部署、调试或发布自己的 Teneo 智能体。
限制与注意事项
- 仅使用捆绑的 CLI：~/teneo-skill/teneo。若缺失，仅通过 npx -y @teneo-protocol/cli 安装。
- Teneo 命令需逐条运行，不可并行。
- 需等待进程退出后再解析 stdout。
- 对需要解析或依赖机器可读错误的命令，优先使用 --json。
- 执行前先收集智能体信息，使用 list-agents、info 和 quote，不要猜测。
- 不要编造智能体 ID、命令语法、房间 ID 或路径，应从 CLI 中发现。
- 不要根据部分输出声称部署成功，需通过 agent status、agent logs 和 agent services 确认。
- 当前 CLI 不暴露旧的手动交易审批工作流。
- 对于兑换、跨链桥、交易、转账或任何可能移动用户资金的操作，执行前需明确确认意图。
- wallet-export-key 视为危险操作，仅在用户明确要求时运行。
- 部分命令免费，部分命令需要活动钱包中有 USDC 才能支付网络费用。
- 若命令可能产生费用，先检查 info 或运行 quote，再提示用户在执行前为该确切钱包充值。
- 仅 command 子命令有 CLI --timeout 标志，其他长时间运行命令使用 shell 超时。
- discover、list-agents、info、command、quote 和智能体部署操作建议至少使用 120 秒 shell 超时。
- 房间上限为 5 个智能体。
- subscribe 和 unsubscribe 是特定公共房间命令，正常流程中不使用。
- update-room 存在，但标准流程中不依赖它，实时后端可能返回超时。
- 部署失败时需检查 agent status、agent logs、agent services，必要时检查底层服务管理器。
- 常见失败原因包括：元数据无效或不完整、初始化后智能体目录/路径猜测错误、服务启动但二进制在启动时退出、智能体 ID 已被占用或发布/部署状态不一致、智能体 .env 缺少预期值或被手动错误编辑。