Varlock
AI Skill Hub 强烈推荐：Varlock 是一款优质的Agent工作流。已获得 3.5k 颗 GitHub Star，AI 综合评分 8.0 分，在同类工具中表现稳健。如果你正在寻找可靠的Agent工作流解决方案，这是一个值得深入了解的选择。
📚 深度解析
Varlock 工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。
在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 8.0 分，是同类 Agent 工作流中的精选推荐。
📋 工具概览
Varlock 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
📖 中文文档
Varlock 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
# 方式一：npm 全局安装 npm install -g varlock # 方式二：npx 直接运行（无需安装） npx varlock --help # 方式三：项目依赖安装 npm install varlock # 方式四：从源码运行 git clone https://github.com/dmno-dev/varlock cd varlock npm install npm start
- 访问 GitHub 仓库获取工作流文件
- 在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
- 上传工作流文件
- 按照提示配置必要的环境变量和 API Key
- 运行测试确认流程正常后投入使用
# 命令行使用
varlock --help
# 基本用法
varlock [options] <input>
# Node.js 代码中使用
const varlock = require('varlock');
const result = await varlock.run(options);
console.log(result);
# varlock 配置说明 # 查看配置选项 varlock --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export VARLOCK_CONFIG="/path/to/config.yml"
简介
<p align="center"> <a href="https://varlock.dev" target="_blank" rel="noopener noreferrer"> <img src="/packages/varlock-website/src/assets/logos/wordmark.png" alt="Varlock banner"> </a> </p> <br/> <p align="center"> <a href="https://npmjs.com/package/varlock"><img src="https://img.shields.io/npm/v/varlock.svg" alt="npm package"></a> <a href="/LICENSE.md"><img src="https://img.shields.io/npm/l/varlock.svg" alt="license"></a> <a href="https://nodejs.org/en/about/previous-releases"><img src="https://img.shields.io/node/v/varlock.svg" alt="node compatibility"></a> <a href="https://github.com/dmno-dev/varlock/actions/workflows/test.yaml"><img src="https://img.shields.io/github/actions/workflow/status/dmno-dev/varlock/test.yaml?style=flat&logo=github&label=CI" alt="build status"></a> <a href="https://chat.dmno.dev"><img src="https://img.shields.io/badge/chat-discord-5865F2?style=flat&logo=discord" alt="discord chat"></a> </p> <br/>
@required @sensitive @type=string(startsWith=sk-)
OPENAI_API_KEY=
**Flexible plugin system**: adds new decorators, functions, types - enables secure declarative secret loading.
Run the installation wizard, which will install as a dependency in a JavaScript project
npx varlock init
Installation
You can get started with varlock by installing the CLI:
```bash
Or install as standalone binary
brew install dmno-dev/tap/varlock # via homebrew curl -sSfL https://varlock.dev/install.sh | sh -s # via cURL
Or use the official Docker image
docker pull ghcr.io/dmno-dev/varlock:latest ``` See the full installation docs or the Docker guide for more information.
Examples
Examples of integrating varlock in various frameworks and situations can be found in the Varlock examples repo
@defaultSensitive=false @defaultRequired=infer @currentEnv=$APP_ENV
our environment flag, will control automatic loading of `.env.xxx` files
API url including _expansion_ referencing another env var
@initOp(token=$OP_TOKEN, allowAppAuth=forEnv(dev), account=acmeco)
AI-Safe Config
Your .env.schema gives AI agents full context on your config — variable names, types, validation rules, descriptions — without ever exposing secret values. Combined with varlock scan to catch leaked secrets in AI-generated code, varlock is purpose-built for the AI era. Learn more in the AI-safe config guide.
@env-spec
Varlock is built on top of @env-spec, a new DSL for attaching a schema and additional functionality to .env files using JSDoc style comments. The @env-spec package contains a parser and info about the spec itself.
sensitive api key, with extra validation
Fetch secrets using 1Password secret references
DB_PASS=op(op://my-vault/database-password/password) API_KEY=op(op://api-vault/stripe/api-key) ```
@plugin(@varlock/1password-plugin)
Workflow
Validate your .env.schema and pretty print your environment variables with:
varlock loadIf you need to pass resolved env vars into another process, you can run:
varlock run -- python script.pyIn many cases you can use our drop-in integrations for seamless experience - with additional security guardrails, like log redaction and leak prevention.
Published Packages
Plugins
| Package | Published listing page |
|---|---|
| [@varlock/1password-plugin](packages/plugins/1password) | [](https://npmjs.com/package/@varlock/1password-plugin) |
| [@varlock/aws-secrets-plugin](packages/plugins/aws-secrets) | [](https://npmjs.com/package/@varlock/aws-secrets-plugin) |
| [@varlock/azure-key-vault-plugin](packages/plugins/azure-key-vault) | [](https://npmjs.com/package/@varlock/azure-key-vault-plugin) |
| [@varlock/bitwarden-plugin](packages/plugins/bitwarden) | [](https://npmjs.com/package/@varlock/bitwarden-plugin) |
| [@varlock/google-secret-manager-plugin](packages/plugins/google-secret-manager) | [](https://npmjs.com/package/@varlock/google-secret-manager-plugin) |
| [@varlock/hashicorp-vault-plugin](packages/plugins/hashicorp-vault) | [](https://npmjs.com/package/@varlock/hashicorp-vault-plugin) |
| [@varlock/infisical-plugin](packages/plugins/infisical) | [](https://npmjs.com/package/@varlock/infisical-plugin) |
| [@varlock/keepass-plugin](packages/plugins/keepass) | [](https://npmjs.com/package/@varlock/keepass-plugin) |
| [@varlock/kubernetes-plugin](packages/plugins/kubernetes) | [](https://npmjs.com/package/@varlock/kubernetes-plugin) |
| [@varlock/pass-plugin](packages/plugins/pass) | [](https://npmjs.com/package/@varlock/pass-plugin) |
| [@varlock/passbolt-plugin](packages/plugins/passbolt) | [](https://npmjs.com/package/@varlock/passbolt-plugin) |
| [@varlock/proton-pass-plugin](packages/plugins/proton-pass) | [](https://npmjs.com/package/@varlock/proton-pass-plugin) |
Framework Integrations
| Package | Published listing page |
|---|---|
| [@varlock/astro-integration](packages/integrations/astro) | [](https://npmjs.com/package/@varlock/astro-integration) |
| [@varlock/nextjs-integration](packages/integrations/nextjs) | [](https://npmjs.com/package/@varlock/nextjs-integration) |
| [@varlock/vite-integration](packages/integrations/vite) | [](https://npmjs.com/package/@varlock/vite-integration) |
Varlock 是一个专为开发者设计的环境变量管理工具，旨在通过灵活的插件系统实现安全、声明式的密钥加载。它支持自定义装饰器、函数和类型，能够帮助开发者在复杂的开发环境中更优雅地处理敏感信息，确保配置管理既高效又安全。
在使用 Varlock 之前，请确保已配置必要的环境变量。例如，若需调用相关服务，需提供以 `sk-` 开头的 `OPENAI_API_KEY`。系统支持通过安装向导进行初始化配置，确保所有敏感参数符合预设的校验规则。
您可以通过多种方式安装 Varlock：使用 CLI 工具运行 `npx varlock init` 进行快速初始化；通过 Homebrew (`brew install dmno-dev/tap/varlock`) 或 cURL 脚本安装独立二进制文件；此外，也支持直接使用官方提供的 Docker 镜像 (`docker pull ghcr.io/dmno-dev/varlock:latest`) 进行容器化部署。
为了帮助您快速上手，我们提供了丰富的集成示例。您可以访问 Varlock examples 仓库，查看如何在不同的框架和实际应用场景中集成 Varlock，从而实现无缝的环境变量管理。
Varlock 提供了强大的配置能力，支持根据当前环境标识自动加载 `.env` 文件。它允许通过环境变量引用实现 API URL 的动态扩展，并能通过特定的语法进行复杂的配置管理，确保配置逻辑的灵活性与安全性。
Varlock 支持高度安全的 API 密钥管理，内置了额外的校验机制。特别地，它支持通过 1Password 引用来获取机密信息（例如使用 `op(op://...)` 语法），实现从 1Password 秘钥库中直接提取 DB_PASS 或 API_KEY，极大提升了敏感数据的安全性。
Varlock 提供了直观的工作流体验。您可以使用 `varlock load` 命令来校验 `.env.schema` 文件并以美观的格式打印环境变量。如果需要将解析后的环境变量传递给其他进程，可以使用 `varlock run -- <command>` 模式。此外，通过引入插件系统（如 `@varlock/1password-plugin`），您可以轻松扩展其功能边界。
Varlock是一个高质量的AI工作流环境变量管理工具
- 需要让 Claude / Cursor 操作本地工具的 AI 工程师
- 构建多智能体协作系统的 Agent 开发者
- 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
- 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
- 容器内无法访问宿主机 localhost — 使用 host.docker.internal
- Docker：varlock 提供官方镜像，docker compose up 一键启动
- CLI：直接 npm install -g / pip install，命令行调用
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 需要让 Claude / Cursor 操作本地工具的 AI 工程师
- 构建多智能体协作系统的 Agent 开发者
- 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
- 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
- 容器内无法访问宿主机 localhost — 使用 host.docker.internal
👥 适合人群
🎯 使用场景
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
⚖️ 优点与不足
- +MIT 协议，可免费商用
- +大幅减少重复性人工操作
- +可视化流程，清晰直观
- +可扩展性强，支持复杂场景
- −初始配置和调试需投入一定时间
- −强依赖外部服务的稳定性
- −复杂场景需具备一定技术基础
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。
🔗 相关工具推荐
❓ 常见问题 FAQ
总体来看，Varlock 是一款质量优秀的Agent工作流，在同类工具中具备一定竞争力。AI Skill Hub 将持续追踪其更新动态，建议收藏备用，结合自身场景选择合适时机引入使用。
| 原始名称 | varlock |
| 原始描述 | 开源AI工作流：AI-safe .env files: Schemas for agents, Secrets for humans.。⭐3.5k · TypeScript |
| Topics | AI工作流环境变量TypeScript |
| GitHub | https://github.com/dmno-dev/varlock |
| License | MIT |
| 语言 | TypeScript |
收录时间：2026-05-28 · 更新时间：2026-05-30 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。