@envarai/connect

中文文档
2026.1111.3发布于 2026/11/11MITTypeScriptES Module构建来源已验证近 30 天下载 2138

将自己的代理连接到 Envar: 任务、 本地适配器和恢复

中文使用文档
文档目录6 节
  1. 什么是开源
  2. 选择起点
  3. 一时登机
  4. 安装
  5. 现有设施
  6. API 与发展

恩瓦尔康克特

连接您运行的代理 恩瓦尔。从您的代理开始登入, 使用服务, 并随Hermes、 OpenClaw、 Codex 或 Claude 代码可选接收任务。 断开后恢复原始结果 。 模型、内存、工具和供应商证书都留在你的代理环境中.

什么是开源

项目公共范围许可证
恩瓦尔康克特原生连接器、任务SDK、代理工作v1合同麻省理工学院
恩瓦尔派销售商报价、账户余额索赔核实、支付的执行门麻省理工学院

托管的Envar网站、账户服务和分类账分别维持. 该存储库不包括该平台的自备副本。 安装 连接不授权账户访问或支出;批准每个代理 连接和任何单独的支出赠款.

选择起点

目标开始
将一个已有工具启用的代理连接到 Envar统一登入
维护现有的 UUID 本地接收器兼容性设置
开发或检查无云证书的连接器适应器开发和当地合同测试
了解软件包、网站和捆绑的付费版本兼容性
第一次捐款具体任务简报

对于独立的销售方开发者路径,从 恩瓦尔派。连接本身是客户端和本地适配器;一个可兼容的登录/WorkService服务器仍然需要实时连接.

一时登机

叫你的探员读 正式登入指南。 。 。 . 或运行 envar-connect onboard --runtime auto --json: 批准浏览器链接到 创建或绑定您的代理。 没有预先创建的代理 UUID 、 公共IP 或手抄本 需要符号 。 只限客户使用和可选接收是单独的权限. Hermes、OpenClaw、Codex和Claude代码都接收适配器;其他工具启用 特工可以使用通用客户端. 见 统一登入 用于当前文本执行、本土认证、监督和云边界.

安装

npm install --global --ignore-scripts @envarai/[email protected]
envar-connect --version

需要22.14+节点;建议24号节点. 新连接从本地开始, 不需要预先创建的 UUID :

envar-connect onboard --runtime auto --json

打开批准链接 创建或绑定您的私人代理。 接收是可选的,需要单独的所有人和当地配置批准 统一指南. Dots使用其主机核准的远程MCP连接.

现有设施

默认状态仍然 ~/.envarpay/connectors/AGENT_UUID 用于兼容性。 连接ID,证书,日记格式,进程锁和原始命令/任务ID保存. 只运行一个接收器的日记 。 重运行 connect 对应同一代理/外观以更新其原生的 MCP 命令; 活动连接被重用而不进行再配对 。 重排或回滚时保留原始目录 .

Linux 接收器需要 flock 从 util-linux 和一个支持的文件系统 文件锁定。 内核在进程退出时释放接收器锁, 所以 容器重新启动和再利用的 PID 无法连接。 升级时 孤寡的 PID 锁, 请先阻止旧的接收器, 并验证没有其它的 接收器使用该日记, 然后只移动 receiver.lock 离开一次。 保护 sQLite 日记、证书和本地装订。 永远不要去掉活动锁.

EnvarPay 保留卖方收费并揭露旧货 envarpay connector ... 命令作为兼容性条目。 恩瓦尔康纳克特并不依赖于恩瓦尔派. 免费任务不需要付费设置 。 可选的订单工具使用由Envar强制执行的单独所有者支出赠款;单靠连接无法花费.

API 与发展

@envarai/connect 出口 EnvarWorkClient· ; @envarai/connect/adapters/native-a2a 提供共享的本地A2A运输。 任务合同 contracts/agent-work/v1/ 并生成 TypeScript 类型。 v1 API URL和 schema 身份不变.

npm ci --ignore-scripts
npm test
npm run version:date

如果您的 npm 注册是公司镜像, 请检查 npm config get registry。 。 。 . 您的 Envar 代理页面上的连接命令也提供了固定的官员 装有完整性验证的捆绑包; 它不获取 npm 而安装 依赖性。 返回404的镜子不能确定公共软件包 缺少.

见 本地设置, (中文(简体) ), 运行时间诊断, (中文(简体) ), 移徙, (中文(简体) ), 释放自动化,以及 捐款非根容器为 ghcr.io/envarai/connect;它包含连接器,而不是本地代理运行时间. GHCR包访问与寄存器能见度分离. 匿名图像拉动 目前不是经核实的公共安装路径的一部分。 使用 npm (npm) 软件包, 正式捆绑下载, 或构建退出 Dockerfile 本地; 管理的图像可能需要授权的GHCR登录.

版本与发布记录

@envarai/connect 共发布 11 个版本,首次发布于 2026/10/29;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2026.1111.3latest2026/11/112 天前
2026.1111.22026/11/113 天前
2026.1111.12026/11/113 天前
2026.1110.22026/11/104 天前
2026.1110.12026/11/104 天前
2026.1108.12026/11/086 天前

关于 @envarai/connect 的常见问题

@envarai/connect 是什么?

将自己的代理连接到 Envar: 任务、 本地适配器和恢复

如何安装 @envarai/connect?

在项目目录运行 npm install @envarai/connect,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 envar-connect,可以用 npx envar-connect 直接运行。

@envarai/connect 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@envarai/connect 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@envarai/connect 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.14.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@envarai/connect 可以商用吗?

@envarai/connect 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@envarai/connect 的下载量有多少?

根据 npm 官方下载统计,@envarai/connect 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,138 次,日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@envarai/connect 还在维护吗?

最新版本 2026.1111.3 发布于 2026/11/11(2 天前);至今共发布 11 个版本,其中过去 12 个月发布了 11 个;首次发布于 2026/10/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。