aquaman v0.14.0
🔱 O único proxy de credenciais independente para agentes de IA: isolamento bring-your-own-vault e políticas de requisição com privilégios mínimos. Suas chaves permanecem onde você já as mantém, nunca na memória do agente. Compatível com 1Password, keychain, keepassxc e muitos outros.
🔱 Aquaman
🔱 O único proxy de credenciais independente para agentes de IA: isolamento bring-your-own-vault e políticas de requisição com privilégio mínimo. Suas chaves ficam onde você já as guarda, nunca na memória do agente. Compatível com 1Password, keychain, keepassxc e muitos outros.
Você configura o Claude Code, Codex, OpenClaw, Hermes ou Docker Sandboxes, e agora está encarando arquivos .env com suas preciosas chaves de API ali, em texto puro. Você leu os artigos. Você sabe o que acontece quando um agente sofre prompt injection. Entendemos.
O Aquaman resolve isso com três camadas de defesa:
- Isolamento de processo: as chaves de API vivem em um processo proxy separado que as injeta na saída. O agente carrega um marcador, nunca uma chave, então mesmo um RCE no agente não consegue ler uma. Agentes de codificação recebem apenas as referências que você declara, um comando por vez.
- Políticas de requisição: regras por serviço controlam quais endpoints um agente pode chamar. Bloqueie APIs de administração, impeça exclusões, permita rascunhos mas negue envios. Requisições negadas nunca recebem credenciais reais.
- Auditoria à prova de adulteração: cada uso de credencial é registrado com cadeias de hash SHA-256. Você pode provar o que foi acessado e detectar adulterações posteriormente.
Escolha seu caminho
O Aquaman é distribuído como quatro pacotes coordenados, compartilhando um vault + um daemon. Instale apenas o que você precisa:
| Pacote | O que faz | Quando instalar |
|---|---|---|
aquaman-proxy | Núcleo: vault, daemon, auditoria, política, CLI. A peça que todo mundo precisa. | Sempre. |
aquaman-plugin | Adaptador do OpenClaw Gateway. Inicia o proxy na inicialização do Gateway; roteia tráfego de modelo e Telegram através dele; 25 serviços embutidos em 5 modos de autenticação. | Se você executa um OpenClaw Gateway. Também disponível em https://clawhub.ai/plugins/aquaman-plugin |
aquaman-coder | Adaptador para agentes de codificação de IA. Referências aquaman://service/key com escopo de projeto, resolvidas a cada chamada da ferramenta Bash. | Se você usa Claude Code ou Codex. |
aquaman-hermes | Plugin de host de agente Hermes (Python, no PyPI). Aponta o Hermes para um listener de loopback opt-in, protegido por token, via seus ANTHROPIC_BASE_URL/OPENAI_BASE_URL nativos; adiciona um comando /aquaman-status em sessão, uma ferramenta e uma sonda de saúde. O isolamento fica no lado do proxy; o plugin não guarda credenciais. | Se você executa o host de agente Hermes. pip install aquaman-hermes |
| Docker Sandboxes | Não é um pacote: um caminho separado que precisa apenas do aquaman-proxy. O proxy do próprio Docker injeta os segredos; o aquaman get os fornece a partir do seu vault, com a allow-list e o log de auditoria. | Se você executa agentes em Docker Sandboxes. Veja Início Rápido 5. |
| NVIDIA OpenShell | Não é um pacote: o aquaman daemon se torna o driver de credenciais do gateway do OpenShell. O OpenShell isola a chave do sandbox; o aquaman a fornece a partir do seu vault por referência, com a allow-list e o log de auditoria. | Se você executa agentes em sandboxes do OpenShell. Veja Início Rápido 6. |
Uma única CLI aquaman expõe todos os quatro: comandos de nível superior para vault e audit, aquaman openclaw ... para a integração com o OpenClaw, aquaman coder ... para a integração com o agente de codificação (delega ao aquaman-coder nos bastidores), bem como aquaman hermes ... para o pacote Python Hermes.
Início Rápido
aquaman help, aquaman doctor são seus amigos.
1. Apenas o vault (somente o proxy + seus segredos)
npm install -g aquaman-proxy
aquaman setup # backend wizard + store keys
aquaman daemon & # start the proxy
aquaman credentials list # verify
O proxy escuta em ~/.aquaman/proxy.sock (UDS, chmod 0o600). Aponte qualquer ferramenta para http://aquaman.local/<service>/<path> e o proxy injeta os cabeçalhos de autenticação para esse serviço a partir do backend de cofre escolhido.
2. OpenClaw Gateway
openclaw plugins install aquaman-plugin # 1. install plugin + proxy
openclaw aquaman setup # 2. backend + keys + plugin wire-up
openclaw # 3. done - proxy starts automatically
Solução de problemas: openclaw aquaman doctor.
Usando npm diretamente? npm install -g aquaman-proxy && aquaman openclaw setup faz o mesmo - instala a CLI do proxy, armazena suas chaves, instala o plugin em ~/.openclaw/extensions/aquaman-plugin/ e configura as credenciais (refs SecretRef no OpenClaw ≥ 2026.6.5, o placeholder auth-profiles.json em versões mais antigas).
aquaman openclaw setup aponta models.providers.<svc>.baseUrl e channels.telegram.apiRoot para o listener de loopback do proxy, porque o transporte de modelos do OpenClaw e seus canais constroem cada um seu próprio cliente HTTP e ignoram o interceptor de fetch. Canais diferentes do Telegram não expõem substituição de endpoint, então seus tokens são armazenados e migrados, mas não injetados na saída (veja packages/plugin/README.md). Adicione canais na configuração do plugin em openclaw.json; os suportados incluem Slack, Discord, Telegram, MS Teams, Matrix, LINE, Twitch, Twilio, BlueBubbles, Mattermost, Nostr, Tlon, Feishu, Google Chat, ElevenLabs, xAI, Cloudflare AI Gateway, Mistral, Hugging Face e mais (25 no total).
3. Agentes de codificação com IA (Claude Code, Codex)
npm install -g aquaman-proxy aquaman-coder # 1. install daemon + adapter
aquaman setup # 2. vault wizard
aquaman daemon & # 3. start the proxy
aquaman coder project add my-app --path ~/code/my-app \
--env ANTHROPIC_API_KEY=aquaman://anthropic/api_key \
--env GITHUB_TOKEN=aquaman://github/token # 4. declare a project
aquaman coder setup claude-code # 5. wire Claude Code hooks
# (or: aquaman coder setup codex)
aquaman doctor # 6. verify - should show both vault + coder green
Veja você mesmo (o momento de clareza em 30 segundos): reinicie o Claude Code (ou o Codex), abra uma nova sessão dentro de ~/code/my-app e peça ao agente para executar:
printenv | grep ANTHROPIC_API_KEY
Você verá isto na transcrição:
ANTHROPIC_API_KEY=[REDACTED:injected-value]
⏺ ANTHROPIC_API_KEY is set and available (injected via aquaman vault).