agent-vault v0.39.1 — A HTTP credential proxy and vault for AI agents like Claude Code, OpenClaw, Hermes, custom agents + harnesses, and more.

Agent Vault

HTTP 凭证代理与保险库

一个由 Infisical 开发的开源凭证代理，位于您的智能体和他们调用的 API 之间。
智能体不应该持有凭证。Agent Vault 通过代理访问消除了凭证泄露风险。

新朋友？发布博客文章拥有 Agent Vault 的完整故事。

Agent Vault 演示

为什么选择 Agent Vault

传统的机密管理是将凭证返回给您的应用和服务。这对 AI 智能体来说会出问题，因为它们可能通过提示注入被诱骗而泄露机密。这就是凭证外泄问题。

Agent Vault 的创建就是为了解决所有 AI 智能体的凭证外泄问题。与其直接向 AI 智能体提供凭证，不如将凭证存储在 Agent Vault 中（例如 ANTHROPIC_API_KEY、GITHUB_PAT 等），并强制您的智能体通过它路由 HTTP 请求。Agent Vault 拦截每个请求，在转发到目标出站 API 之前将凭证附加到请求上。

特性：

凭证代理：代理 AI 智能体访问目标服务（如 LLM 提供商和 GitHub），而它们不持有任何真实凭证。Agent Vault 能够通过将 __anthropic_api_key__ 这样的占位符值替换为真实凭证，或完全替换出站请求中的认证头，来实现这种代理访问。
可插拔凭证存储：使用外部机密存储（如 Infisical）来支持保险库，而不是本地加密存储。这扩展了 Agent Vault 的能力，包括来自 Infisical 的动态机密等功能。
透明集成：让 AI 智能体使用现有的工具（如 MCP、CLI、SDK、API），而所有底层请求自动通过 Agent Vault 路由。Agent Vault 采用与接口无关、非侵入式的凭证代理方法，通过引导智能体的环境使用 HTTPS_PROXY 并与 Agent Vault 的 MITM 架构兼容。
专为任务设计：现有的正向代理（如 mitmproxy 或 squid）需要修改才能执行凭证代理并与智能体良好集成。Agent Vault 专为适应所有类型智能体用例的人机工程学而设计，拥有专用 CLI、多租户以及由 Infisical 支持的智能体特定路线图。
出站过滤：控制哪些智能体可以访问哪些服务及其 API 端点，因为经过认证的请求会通过 Agent Vault 流出。
请求日志记录：检查经过认证的流量，以监控和诊断智能体行为。

默认情况下，与任何服务不匹配的请求会作为普通代理流量转发；将保险库切换到严格拒绝模式（unmatched_host_policy=deny）可拒绝这些请求并返回 403。

阅读 Agent Vault 的完整背景故事在此。

用例

Agent Vault 适用于各种 AI 智能体用例，包括安全的远程编码智能体、通用智能体、自定义智能体 + 框架、安全的短暂沙箱等。

安全的远程编码智能体：您可以运行远程 Claude Code 会话，并配置其通过 Agent Vault 代理请求。作为设置的一部分，您可以在 Agent Vault 中设置 ANTHROPIC_API_KEY 和 GITHUB_PAT，使 Claude Code 能够与 Anthropic 和 GitHub API 交互以编写代码、发起 PR 等。同样的原则适用于其他编码智能体。
安全的通用智能体：您可以设置 OpenClaw、Hermes 和其他通用智能体，通过 Agent Vault 代理出站请求。
安全的自定义智能体：您可以使用自定义框架构建自己的 AI 智能体，并配置其通过 Agent Vault 代理出站请求。
安全的短暂沙箱：您可以配置一个编排器（例如后端）生成一个临时令牌，传递到智能体沙箱中，用于通过 Agent Vault 代理请求。您甚至可以让沙箱中的智能体将请求回环到启动它的同一个后端。

基本用法

Agent Vault 既是一个保险库，也是一个代理服务，它以一个单一二进制文件的形式提供，同时充当服务器和 CLI 客户端。它存储凭证，并使用 MITM 代理架构将这些凭证代理给您的 AI 智能体。根据设计，Agent Vault 应部署在与 AI 智能体不同的机器上，以提供必要的安全保障，使 AI 智能体无法直接访问 Agent Vault 内的凭证。

┌─────────────────────────────────────────────────────────────────┐
│ 公共互联网                                                     │
│                                                                 │
│   api.anthropic.com    api.github.com    api.stripe.com   ...   │
│          ▲                   ▲                  ▲               │
└──────────┼───────────────────┼──────────────────┼───────────────┘
           │                   │                  │
           └───────────────────┼──────────────────┘
                               │ 出站 HTTPS，Agent Vault
                               │ 在出站时注入凭证
┌──────────────────────────────┼──────────────────────────────────┐
│ 私有网络                     │                                  │
│                              │                                  │
│  ┌───────────────────────────┴────┐     ┌────────────────────┐  │
│  │ Agent Vault                    │     │ AI 智能体          │  │
│  │ :14321  管理界面 / API         │◀────│ HTTPS_PROXY=       │  │
│  │ :14322  MITM 代理              │     │ agent-vault:14322  │  │
│  └────────────────▲───────────────┘     └────────────────────┘  │
│                   │                                             │
└───────────────────┼─────────────────────────────────────────────┘
                    │ 操作员访问：保持私有，或通过
                    │ TLS + 认证（SSO 反向代理、IP
                    │ 白名单或 VPN）前端化，如果需要远程管理
                    │
                操作员

您可以按照以下步骤配置 Agent Vault 为 AI 智能体代理凭证：

安装并启动 Agent Vault 服务器。您可以运行下面的脚本来安装 Agent Vault，支持 macOS（Intel + Apple Silicon）和 Linux（x86_64 + ARM64）：

curl --proto '=https' --proto-redir '=https' --tlsv1.2 -fsSL https://get.agent-vault.dev | sh

启动 Agent Vault 服务器并为其设置一个主密码（存储在安全的地方）；该密码用于其数据加密机制，并且在初始读取后从进程中清除。

export AGENT_VAULT_MASTER_PASSWORD=your-password
agent-vault server -d

您也可以使用 Docker 部署 Agent Vault：

docker run -it -p 14321:14321 -p 14322:14322 \
  -e AGENT_VAULT_MASTER_PASSWORD=your-password \
  -v agent-vault-data:/data infisical/agent-vault

服务器在 14321 端口启动 HTTP API，在 14322 端口启动透明 HTTP/HTTPS 代理；同一个监听器处理 https:// 上游的 CONNECT 方法和 http:// 上游的绝对形式正向代理请求。

Web UI 可通过 http://<host>:14321 访问，系统会提示您创建第一个用户，称为实例所有者。

在 Agent Vault 中创建一个保险库，输入您的凭证，并配置服务规则。您可以通过管理 UI 或在 Agent Vault 机器上通过 CLI 来完成。例如，您可以为 ANTHROPIC_API_KEY 创建一个凭证，并为 Agent Vault 创建一个服务规则，以将占位符值 __anthropic_api_key__ 替换为真实的密钥。
创建一个智能体来表示一个长期运行的智能体，并为其获取一个令牌。或者，如果您正在启动短暂的沙箱智能体，您可以使用智能体来表示一个编排器后端，并使用它生成一个短期的令牌传递给沙箱，以便智能体使用并通过 Agent Vault 代理请求。
在您的 AI 智能体环境中设置以下环境变量：

AGENT_VAULT_ADDR=http://<your-addr>:14321
AGENT_VAULT_TOKEN=<agent-token-from-agent-vault>
AGENT_VAULT_VAULT=<vault-in-agent-vault>
...
ANTHROPIC_API_KEY=__anthropic_api_key__ // 将被 Agent Vault 替换的占位符密钥

在您的智能体环境中安装 Agent Vault CLI，并运行带有智能体的 Agent Vault CLI，以开始通过 Agent Vault 代理请求。

curl --proto '=https' --proto-redir '=https' --tlsv1.2 -fsSL https://get.agent-vault.dev | sh

验证下载的发布二进制文件

从此工作流发布的归档文件附带一个构建来源证明，该证明与生成它的 GitHub Actions 运行相关联。使用 gh CLI 进行验证（无需额外工具，无需密钥管理）：

gh attestation verify agent-vault_*.tar.gz --repo Infisical/agent-vault

checksums.txt 也包含在同一个证明中，其 cosign 签名继续可以用 cosign verify-blob 验证，供偏好该方式的用户使用。

agent-vault run -- claude
agent-vault vault run -- agent
agent-vault vault run -- codex
agent-vault vault run -- opencode

或者，如果您的智能体使用 Docker 运行，您可以通过将二进制文件复制到自己的镜像并用于启动智能体进程的方式，通过 Dockerfile 安装 Agent Vault CLI：

# 将此行添加到现有 Dockerfile 中，紧接在您的智能体或应用程序设置旁边。
COPY --from=infisical/agent-vault:latest /usr/local/bin/agent-vault /usr/local/bin/agent-vault

...

ENTRYPOINT ["agent-vault", "run", "--", "claude"]

部署 Agent Vault 并集成 AI 智能体的方法有很多种。我们建议查阅更完整的文档。

查看实际效果

观看 Agent Vault 如何为 AI 智能体代理凭证：一次存储您的密钥，通过代理路由每个出站请求，让智能体在从未看到密钥的情况下调用真实 API。

想要完整的部署演练？请参阅在 VPS 上运行 Hermes，这是一个在独立机器上使用代理智能体的端到端示例。

最佳实践

安全：