aquaman v0.14.1
🔱 L'unico proxy di credenziali indipendente per agenti AI: isolamento bring-your-own-vault e politiche di richiesta con privilegio minimo. Le tue chiavi rimangono dove già le conservi, mai nella memoria dell'agente. Compatibile con 1Password, keychain, keepassxc e molti altri.
🔱 Aquaman
🔱 L'unico proxy indipendente per le credenziali degli agenti AI: isolamento bring-your-own-vault e policy di richiesta a privilegio minimo. Le tue chiavi restano dove le conservi già, mai nella memoria dell'agente. Compatibile con 1Password, keychain, keepassxc e molti altri.
Hai configurato Claude Code, Codex, OpenClaw, Hermes o Docker Sandboxes, e ora stai fissando i file .env con le tue preziose chiavi API lì in chiaro. Hai letto gli articoli. Sai cosa succede quando un agente subisce un prompt injection. Ti capiamo.
Aquaman risolve il problema con tre livelli di difesa:
- Isolamento dei processi: le chiavi API risiedono in un processo proxy separato che le inietta in uscita. L'agente detiene un marcatore, mai una chiave, quindi anche un RCE nell'agente non può leggerne una. Gli agenti di coding ricevono solo i riferimenti che dichiari, un comando alla volta.
- Policy di richiesta: regole per singolo servizio controllano quali endpoint un agente può chiamare. Blocca le API di amministrazione, impedisci le cancellazioni, consenti le bozze ma nega gli invii. Le richieste negate non ricevono mai credenziali reali.
- Audit a prova di manomissione: ogni uso di credenziali viene registrato con catene di hash SHA-256. Puoi dimostrare cosa è stato consultato e rilevare manomissioni a posteriori.
Scegli il tuo percorso
Aquaman è distribuito come quattro pacchetti coordinati, che condividono un unico vault + un unico daemon. Installa solo ciò che ti serve:
| Pacchetto | Cosa fa | Quando installarlo |
|---|---|---|
aquaman-proxy | Nucleo: vault, daemon, audit, policy, CLI. Il pezzo di cui tutti hanno bisogno. | Sempre. |
aquaman-plugin | Adattatore per OpenClaw Gateway. Avvia il proxy all'avvio del Gateway; instrada il traffico del modello e di Telegram attraverso di esso; 25 servizi integrati in 5 modalità di autenticazione. | Se esegui un OpenClaw Gateway. Disponibile anche su https://clawhub.ai/plugins/aquaman-plugin |
aquaman-coder | Adattatore per agenti di coding AI. Riferimenti aquaman://service/key con ambito di progetto, risolti a ogni chiamata dello strumento Bash. | Se usi Claude Code o Codex. |
aquaman-hermes | Plugin agent-host per Hermes (Python, su PyPI). Indirizza Hermes verso un listener loopback opt-in, protetto da token, tramite le sue native ANTHROPIC_BASE_URL/OPENAI_BASE_URL; aggiunge un comando /aquaman-status in sessione, uno strumento e una sonda di stato. L'isolamento è lato proxy; il plugin non detiene credenziali. | Se esegui l'agent host Hermes. pip install aquaman-hermes |
| Docker Sandboxes | Non è un pacchetto: un percorso separato che richiede solo aquaman-proxy. Il proxy di Docker stesso inietta i segreti; aquaman get li fornisce dal tuo vault, con la allow-list e il registro di audit. | Se esegui agenti in Docker Sandboxes. Vedi Avvio rapido 5. |
| NVIDIA OpenShell | Non è un pacchetto: aquaman daemon diventa il driver delle credenziali del gateway OpenShell. OpenShell isola la chiave dalla sandbox; aquaman la fornisce dal tuo vault per riferimento, con la allow-list e il registro di audit. | Se esegui agenti in sandbox OpenShell. Vedi Avvio rapido 6. |
Un'unica CLI aquaman espone tutte e quattro le funzionalità: comandi di primo livello per vault e audit, aquaman openclaw ... per l'integrazione con OpenClaw, aquaman coder ... per l'integrazione con l'agente di coding (delega a aquaman-coder internamente) e aquaman hermes ... per il pacchetto Python Hermes.
Avvio rapido
aquaman help e aquaman doctor sono i tuoi amici.
1. Solo vault (solo il proxy + i tuoi segreti)
npm install -g aquaman-proxy
aquaman setup # backend wizard + store keys
aquaman daemon & # start the proxy
aquaman credentials list # verify
Il proxy è in ascolto su ~/.aquaman/proxy.sock (UDS, chmod 0o600). Punta qualsiasi strumento su http://aquaman.local/<service>/<path> e il proxy inietta le intestazioni di autenticazione per quel servizio dal backend vault scelto.
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
Risoluzione dei problemi: openclaw aquaman doctor.
Usi npm direttamente? npm install -g aquaman-proxy && aquaman openclaw setup fa la stessa cosa: installa la CLI del proxy, memorizza le tue chiavi, installa il plugin in ~/.openclaw/extensions/aquaman-plugin/ e collega le credenziali (riferimenti SecretRef su OpenClaw ≥ 2026.6.5, il segnaposto auth-profiles.json sulle versioni precedenti).
aquaman openclaw setup punta models.providers.<svc>.baseUrl e channels.telegram.apiRoot sul listener di loopback del proxy, perché il trasporto dei modelli di OpenClaw e i suoi canali costruiscono ciascuno il proprio client HTTP e aggirano l'intercettore fetch. I canali diversi da Telegram non espongono alcun override dell'endpoint, quindi i loro token vengono memorizzati e migrati ma non iniettati in uscita (vedi packages/plugin/README.md). Aggiungi i canali nella configurazione del plugin in openclaw.json; quelli supportati includono 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 altri (25 in totale).
3. Agenti di coding AI (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
Provalo tu stesso (l'effetto aha in 30 secondi): riavvia Claude Code (o Codex), apri una nuova sessione all'interno di ~/code/my-app e chiedi all'agente di eseguire:
printenv | grep ANTHROPIC_API_KEY
Lo vedrai nella trascrizione:
ANTHROPIC_API_KEY=[REDACTED:injected-value]
⏺ ANTHROPIC_API_KEY is set and available (injected via aquaman vault).