aquaman v0.15.0
🔱 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 dedicato agli 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 ti ritrovi davanti a file .env con le tue preziose chiavi API 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 possiede un marker, mai una chiave, quindi nemmeno un RCE nell'agente può leggerne una. Gli agenti di coding ricevono solo i riferimenti che dichiari, una richiesta 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 utilizzo di credenziali viene registrato con catene di hash SHA-256. Puoi dimostrare cosa è stato accesso e rilevare manomissioni a posteriori.
Scegli il tuo percorso
Aquaman viene 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 | Core: vault, daemon, audit, policy, CLI. Il pezzo che serve a tutti. | 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 su 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 per l'agent-host Hermes (Python, su PyPI). Punta Hermes verso un listener loopback opt-in, protetto da token, tramite le sue native ANTHROPIC_BASE_URL/OPENAI_BASE_URL; aggiunge un comando in-sessione /aquaman-status, uno strumento e una sonda di salute. 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 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 Quick Start 5. |
Un'unica CLI aquaman espone tutti e quattro: comandi di primo livello per vault e audit, aquaman openclaw ... per l'integrazione OpenClaw, aquaman coder ... per l'integrazione con gli agenti di coding (che delega a aquaman-coder dietro le quinte) e aquaman hermes ... per il pacchetto Python Hermes.
Quick Start
aquaman help, aquaman doctor sono 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 ascolta su ~/.aquaman/proxy.sock (UDS, chmod 0o600). Punta qualsiasi strumento su http://aquaman.local/<service>/<path> e il proxy inietta gli header 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
Troubleshooting: 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 verso il listener di loopback del proxy, perché il trasporto dei modelli di OpenClaw e i suoi canali costruiscono ciascuno il proprio client HTTP e bypassano 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; tra quelli supportati ci sono 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).