🔱 Aquaman

🔱 O único proxy de credenciais independente para agentes de IA: isolamento bring-your-own-vault e políticas de requisição de 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ê configurou o Claude Code, Codex, OpenClaw, Hermes ou Docker Sandboxes, e agora está encarando arquivos .env com suas preciosas chaves de API expostas em texto puro. Você leu os artigos. Você sabe o que acontece quando um agente sofre prompt injection. Nós entendemos.

O Aquaman resolve isso com três camadas de defesa:

Isolamento de processo: as chaves de API ficam 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 lê-la. 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 único vault + um único 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 integrados 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 por 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 loopback opt-in com token, através de suas variáveis nativas `ANTHROPIC_BASE_URL`/`OPENAI_BASE_URL`; adiciona um comando `/aquaman-status` em sessão, ferramenta e sonda de saúde. O isolamento é do 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 próprio proxy do 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 Quick Start 5.

Uma única CLI aquaman expõe todos os quatro: comandos de nível superior para vault e auditoria, aquaman openclaw ... para a integração com OpenClaw, aquaman coder ... para a integração com agentes de codificação (delegando ao aquaman-coder nos bastidores), bem como aquaman hermes ... para o pacote Python do Hermes.

Quick Start

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 modelo 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 sob a 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 "aha" de 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).

O processo filho viu a chave real (seus testes, builds, servidores MCP, scripts de importação - qualquer coisa que realmente precise dela funciona). O agente - a coisa que decide qual código executar na sua máquina - nunca vê o valor, e portanto nem o histórico da conversa, nem os logs do provedor do modelo, nem qualquer pessoa que depois tire um screenshot do seu terminal.

aquaman v0.15.0