🔱 唯一独立的AI代理凭据代理:自带保险库隔离和最小权限请求策略。您的密钥仍留在您原本存放的地方,绝不会进入代理的内存。兼容 1Password、keychain、keepassxc 等众多工具。
无需账户。自带保险库。本地运行。 aquaman 将 API 密钥和令牌保存在你已经在使用的保险库中(Keychain、1Password、Bitwarden、HashiCorp Vault、KeePassXC、Keeper、systemd-creds 或加密文件),并在请求或命令需要时注入它们。代理使用诸如 aquaman://github/token 这样的引用进行工作,从不持有密钥本身。
npm install -g aquaman-proxy aquaman-coder
cd ~/code/my-app && aquaman init --agent claude-code # or: --agent codex
这就是编码代理的完整配置。当任务需要密钥时,代理运行 aquaman request aquaman://github/token --env GITHUB_TOKEN,你在对话框中输入值,此后该项目中的命令会被注入该密钥,而记录中显示 [REDACTED:injected-value]。
aquaman 做三件事:
指南: Claude Code · Codex · OpenClaw · Hermes · Docker Sandboxes · NVIDIA OpenShell · 面向代理 · 与其他方案对比
安全: 策略与如何报告 · 已发布的安全公告(最新:GHSA-9qh6-wffq-9m9v,已在 0.17.2 中修复) · 信任它之前需要了解的事项 · 请求路径的对抗性测试 · aquaman 不防护的情况
要求: macOS、Linux 或 WSL2 上的 Node.js 18 或更高版本。
当任务需要你没有的 API 密钥或令牌时,aquaman 是一种无需用户将其粘贴到对话中即可获取的方式。如果项目中尚未设置 aquaman,请先提议:告诉用户它会安装两个 npm 包、启动一个本地守护进程并注册此目录,并引导他们查看他们同意的是什么。在获得他们同意后:
npm install -g aquaman-proxy aquaman-coder # 0.18.0 or later
aquaman init --agent claude-code --no-hooks --json # or: --agent codex
aquaman request aquaman://github/token --env GITHUB_TOKEN --json
aquaman-coder exec -- npm test # any command that needs the key
告诉用户在运行 request 之前留意对话框;它会等待最多 90 秒。你会收到一个状态和引用,但永远不会收到值。如果状态是 declined,请停止并询问如何继续。像往常一样,让应用从环境变量中读取其密钥。这是供开发者自己机器使用的工具,不适用于 CI。
使用 --no-hooks 时,不会向 agent 主机的设置写入任何内容,aquaman 也不会响应任何权限提示;你需要为需要密钥的命令添加前缀。不使用它时,用户级 hook 会改为包装项目中的每个 shell 命令:在选择该方式之前先询问用户。
状态、退出码和 JSON 字段:Using aquaman from an AI agent。
Aquaman 以四个包的形式发布,它们共享一个 vault 和一个 daemon,另外还有两个无需自身包的主机集成。只安装你需要的部分:
| 包 | 功能 | 何时安装 |
|---|---|---|
aquaman-proxy | 核心:vault、daemon、审计、策略、CLI。每个人都需要的那部分。 | 始终安装。 |
aquaman-plugin | OpenClaw Gateway 适配器。在 Gateway 启动时生成代理;将模型和 Telegram 流量路由通过它;跨 5 种认证模式的 26 个内置服务。 | 如果你运行 OpenClaw Gateway。也可在 https://clawhub.ai/plugins/aquaman-plugin 获取 |
aquaman-coder | AI 编码 agent 适配器。项目作用域的 aquaman://service/key 引用在每次 Bash 工具调用时解析。 | 如果你使用 Claude Code 或 Codex。 |
aquaman-hermes | Hermes agent 主机插件(Python,在 PyPI 上)。通过其原生 ANTHROPIC_BASE_URL/OPENAI_BASE_URL 将 Hermes 指向一个需选择加入、受令牌门控的环回监听器;添加会话内 /aquaman-status 命令、工具和健康探测。隔离在代理侧;插件不持有任何凭据。 | 如果你运行 Hermes agent 主机。pip install aquaman-hermes |
| Docker Sandboxes | 不是包:一条只需要 aquaman-proxy 的独立路径。Docker 自己的代理注入密钥;aquaman get 从你的 vault 提供它们,并带有允许列表和审计日志。 | 如果你在 Docker Sandboxes 中运行 agent。参见 Quick Start 5。 |
| NVIDIA OpenShell | 不是包:aquaman daemon 成为 OpenShell 网关的凭据驱动。OpenShell 将密钥与沙箱隔离;aquaman 通过引用从你的 vault 提供它,并带有允许列表和审计日志。 | 如果你在 OpenShell 沙箱中运行 agent。参见 Quick Start 6。 |
单个 aquaman CLI 呈现全部四个:用于 vault 和审计的顶层命令,用于 OpenClaw 集成的 aquaman openclaw ...,用于编码 agent 集成的 aquaman coder ...(底层委托给 aquaman-coder),以及用于 Hermes Python 包的 aquaman hermes ...。
aquaman help、aquaman doctor 是你的好帮手。
npm install -g aquaman-proxy
aquaman setup # backend wizard + store keys
aquaman daemon & # start the proxy
aquaman credentials list # verify
代理监听 ~/.aquaman/proxy.sock(UDS,chmod 0o600)。将任意工具指向 http://aquaman.local/<service>/<path>,代理便会从你所选的 vault 后端为该服务注入认证头。
openclaw plugins install aquaman-plugin # 1. install plugin + proxy
openclaw aquaman setup # 2. backend + keys + plugin wire-up
openclaw # 3. done - proxy starts automatically
故障排查:openclaw aquaman doctor。
直接使用 npm? npm install -g aquaman-proxy && aquaman openclaw setup 效果相同——安装代理 CLI、存储你的密钥、将插件安装到 ~/.openclaw/extensions/aquaman-plugin/,并配置凭据(在 OpenClaw ≥ 2026.6.5 上使用 SecretRef 引用,在旧版本上使用 auth-profiles.json 占位符)。
aquaman openclaw setup 将 models.providers.<svc>.baseUrl 和 channels.telegram.apiRoot 指向代理的环回监听地址,因为 OpenClaw 的模型传输层及其各通道各自构建自己的 HTTP 客户端,会绕过 fetch 拦截器。除 Telegram 之外的通道不会通过代理路由(OpenClaw 的配置中没有为它们提供按通道设置端点的选项),因此它们的令牌会被存储和迁移,但不会在出口处注入(参见 packages/plugin/README.md)。在 openclaw.json 的插件配置下添加通道;支持的通道包括 Slack、Discord、Telegram、MS Teams、Matrix、LINE、Twitch、Twilio、BlueBubbles、Mattermost、Nostr、Tlon、Feishu、Google Chat、ElevenLabs、xAI、Cloudflare AI Gateway、Mistral、Hugging Face 等(共 25 个)。
npm install -g aquaman-proxy aquaman-coder
cd ~/code/my-app
aquaman init --agent claude-code # or: --agent codex
aquaman request aquaman://github/token --env GITHUB_TOKEN
init 会创建配置、启动守护进程、安装 agent 的钩子和一个 skill、将该目录注册为项目,并向 CLAUDE.md(或 AGENTS.md)添加一小段内容。它从不提示,因此 agent 可以替你运行它。request 会打开一个对话框,你在其中输入值;该值直接进入你的 vault,而 agent 只能看到引用。两者都通过 --json 输出 JSON。之后重启 agent 会话,如果发现任何异常,运行 aquaman coder doctor。init 在你的机器上更改了什么,以及如何撤销,列在 Using aquaman from an AI agent 中。