Treg：给智能体用的工具网关

智能体要同时用好几家外部服务时，比如先查域名的反向链接，再抓社媒数据，最后找公司联系人，就得分别注册、充值，再把每家的 key 放进环境变量。Treg 是一个给智能体用的工具网关，仓库 2026 年 7 月 15 日才创建。README 的原话是「OpenRouter, but for agent tools instead of models」。智能体只持有一个基础地址和一个 token，服务端在每次调用时注入服务商的凭据。

核心功能

• 按用途找工具，先看价格：treg catalog search 按用途搜索，treg catalog get <id> 列出参数、价格和示例返回。同一能力有多家服务商时，价格并排显示，选哪家由你决定。
• 一个基础地址，原样转发：调用写成 https://treg.to/call/ 加上上游的完整地址，并带上 X-Treg-Token。README 说代理只改传输头、treg 自己的控制头和注入的凭据。
• 凭据留在服务端：HTTP 调用时智能体拿不到服务商的 key，CLI 的 --server 模式也一样，key 不离开注册表服务器。
• 团队自己的 key 优先：团队注册的 key 永远优先于 treg 自己的，走这些 key 的调用不扣 treg 余额。

典型使用场景

• 做外链研究的 SEO 人员：用 treg catalog search "backlinks for a domain" 找到查域名反向链接的端点，比较价格后直接调用，不必先去每家网站开户。
• 团队里已经买了付费 API 的人：服务注册一次，全组智能体用同一个 token 调用，个人不必各存一份 key。这只适用于 HTTP 调用。

快速上手

README 给的安装和第一次调用步骤如下：

# 1. install the CLI — also points it at the registry
curl -fsSL https://treg.to/install.sh | sh

# 2. sign in (GitHub default · --email for a one-time code · --token for agents/CI)
treg login

# 3. do something useful immediately — no key, nothing registered
treg catalog search "backlinks for a domain"     # find a tool by what it DOES
treg call tikhub.tiktok.user.profile --query uniqueId=tiktok
treg balance                                     # exactly what that cost

# (or `treg onboard` for the guided walkthrough)

treg balance 显示那次调用的实际花费。install.sh 是通过管道直接交给 sh 执行的远程脚本，不想这样的话，先下载下来读一遍。

计费与托管

目录里的端点按下面的顺序决定走哪条路：

调用方式	用的 key	是否扣 treg 余额
团队注册过该服务商的工具	团队自己的 key	不扣
团队保存过该服务商的密钥	团队自己的 key，经虚拟工具注入	不扣
端点有经过验证的公共路由	不需要服务商 key	免费
其他有公开价格的端点	treg 自己的 key	扣团队预付余额
没有公开价格的端点	无	拒绝，要求接入自己的 key

新团队有 1.00 美元免费额度。README 写的是新的已验证账户在创建符合条件的团队时领取一次，CLI 文档写的是每个新团队，两者不一致，我们没有核实。余额不足时接口返回 HTTP 402 和 insufficient_balance，并附带 topup_url。

README 没有给出单次价格表、treg 自己 key 的加价比例和每日消费上限的具体数额，也没说哪些端点有公共路由。我们在 README 和 llms.txt 里没有找到可用性承诺（SLA）。treg catalog get 会列出各家服务商的实测可靠性，但文档没有说明怎么测。treg 自己某家服务商的账户耗尽时，调用返回 HTTP 503 和 provider_capacity_unavailable，不计费，也不会替你换服务商。

自托管与安全

自托管要装 pip install "tools-registry[server]"，基础包只含 CLI。TREG_SECRET_KEY 留空时，服务会临时生成一把 Fernet 密钥，重启后保存的密钥会丢失，所以 README 要求备份密钥和数据库。README 也没说明，自托管实例能否使用 treg 持有的目录 key。

treg run 默认的 --local 模式在成员自己的机器上运行 CLI，凭据也会到达那台机器，且要由工具所有者逐个开启。Linux 上可以用 sudo treg setup-local-run 隔离运行，macOS 上的隔离只是尽力而为。要让 key 留在服务器上，就用 --server。

treg shell start --proxy 和 treg serve 会给本机程序访问已注册域名的请求自动加凭据，靠的是一个有效期两年的本地证书颁发机构。要留意 Node 24 之前的内置 fetch() 不走代理，会不带凭据直接发出请求。

回答归档可能保存计费调用的回答，团队可以用 treg org archive off 退出。README 没提归档，也没说明 treg 运营方能否看到团队的密钥。

许可证条款

LICENSE 文件的标题是 tools-registry License，正文是 Apache 2.0 加附加条款，冲突时以附加条款为准。它不是 OSI 认可的开源许可证：OSI 开源定义第 6 条不允许限制某个领域的使用，而这份许可证禁止的正是向第三方提供托管服务，实际上更接近源码可见、但有使用限制的 source-available 模式。以下是我们对原文的解读，不构成法律意见。

允许的：组织内部使用（含商业用途）、按 Apache 条款修改和再分发、为自己的团队搭一套注册表。

禁止的：未经许可方书面授权，不得为第三方提供托管、管理或嵌入式服务，原文举的例子有 SaaS 产品、托管注册表服务，以及作为已售出产品或服务的组成部分。README 只概括为「竞争性的托管 registry 服务」，比原文窄，应以 LICENSE 为准。README 还说，在自己的产品里调用 treg.to 的托管 API 不需要许可，这句话不在 LICENSE 里。贡献者同意自己的贡献按同样条款授权，许可方可以在它的托管服务中商用这些贡献。

小结

适合已经为好几家 API 付费、想让成员智能体共用一个入口的团队，以及愿意自己运维、保管密钥的自托管团队。不适合需要可用性承诺、要确定单次价格表，或想把它放进对外销售服务里的人。只调用一两家服务时，直接用官方接口更省事。模型侧的代理可以看 free-claude-code。

许可证前面已经讲过，不是 OSI 认可的开源许可证。主要语言是 Python。截至 2026-10-21，仓库有 5915 颗星、502 个 fork，未关闭的 issue 与 PR 合计 187 个。README 说目录里有「数千个端点」，宣传图写的是「2000+ tools」，llms.txt 给智能体的示例文案里则是「4,000+ tools across 113 providers」。我们没有统计目录，三个数字都只是项目自己的说法。我们只读了 README、LICENSE、USAGE.md 和 llms.txt，没有安装 CLI，也没有调用过任何端点。