🔱 Aquaman

🔱 Le seul proxy d'identifiants indépendant pour agents IA : isolation bring-your-own-vault et politiques de requêtes à privilège minimal. Vos clés restent là où vous les conservez déjà, jamais dans la mémoire de l'agent. Compatible avec 1Password, keychain, keepassxc et bien d'autres.

Vous avez configuré Claude Code, Codex, OpenClaw, Hermes ou Docker Sandboxes, et vous voilà devant des fichiers .env contenant vos précieuses clés API en clair. Vous avez lu les articles. Vous savez ce qui se passe quand un agent subit une injection de prompt. On comprend.

Aquaman corrige cela avec trois couches de défense :

1. Isolation des processus : les clés API vivent dans un processus proxy séparé qui les injecte à la sortie. L'agent détient un marqueur, jamais une clé, donc même une RCE dans l'agent ne peut pas en lire une. Les agents de codage ne reçoivent que les références que vous déclarez, une commande à la fois.
2. Politiques de requêtes : des règles par service contrôlent quels endpoints un agent peut appeler. Bloquez les API d'administration, empêchez les suppressions, autorisez les brouillons mais refusez les envois. Les requêtes refusées ne reçoivent jamais de vrais identifiants.
3. Audit inviolable : chaque utilisation d'identifiant est journalisée avec des chaînes de hachage SHA-256. Vous pouvez prouver ce qui a été consulté et détecter toute altération après coup.

Choisissez votre voie

Aquaman est livré sous forme de quatre paquets coordonnés, partageant un seul vault + un seul daemon. Installez uniquement ce dont vous avez besoin :

Paquet	Ce qu'il fait	Quand l'installer
aquaman-proxy	Cœur : vault, daemon, audit, politique, CLI. La pièce dont tout le monde a besoin.	Toujours.
aquaman-plugin	Adaptateur OpenClaw Gateway. Lance le proxy au démarrage de la Gateway ; achemine le trafic des modèles et de Telegram à travers lui ; 25 services intégrés répartis sur 5 modes d'authentification.	Si vous exécutez une OpenClaw Gateway. Également disponible sur https://clawhub.ai/plugins/aquaman-plugin
aquaman-coder	Adaptateur pour agents de codage IA. Références aquaman://service/key limitées au projet, résolues à chaque appel de l'outil Bash.	Si vous utilisez Claude Code ou Codex.
aquaman-hermes	Plugin hôte d'agent Hermes (Python, sur PyPI). Pointe Hermes vers un listener loopback opt-in protégé par jeton via ses variables natives ANTHROPIC_BASE_URL/OPENAI_BASE_URL ; ajoute une commande /aquaman-status en session, un outil et une sonde de santé. L'isolation est côté proxy ; le plugin ne détient aucun identifiant.	Si vous exécutez l'hôte d'agent Hermes. pip install aquaman-hermes
Docker Sandboxes	Pas un paquet : une voie séparée qui ne nécessite que aquaman-proxy. Le proxy de Docker injecte lui-même les secrets ; aquaman get les fournit depuis votre vault, avec la liste d'autorisation et le journal d'audit.	Si vous exécutez des agents dans Docker Sandboxes. Voir Démarrage rapide 5.
NVIDIA OpenShell	Pas un paquet : aquaman daemon devient le pilote d'identifiants de la gateway OpenShell. OpenShell isole la clé du sandbox ; aquaman la fournit depuis votre vault par référence, avec la liste d'autorisation et le journal d'audit.	Si vous exécutez des agents dans des sandboxes OpenShell. Voir Démarrage rapide 6.

Une seule CLI aquaman expose les quatre : des commandes de premier niveau pour le vault et l'audit, aquaman openclaw ... pour l'intégration OpenClaw, aquaman coder ... pour l'intégration de l'agent de codage (délègue à aquaman-coder en interne) ainsi que aquaman hermes ... pour le package Python Hermes.

Démarrage rapide

aquaman help, aquaman doctor sont vos amis.

1. Vault uniquement (juste le proxy + vos secrets)

npm install -g aquaman-proxy
aquaman setup                                # backend wizard + store keys
aquaman daemon &                             # start the proxy
aquaman credentials list                     # verify

Le proxy écoute sur ~/.aquaman/proxy.sock (UDS, chmod 0o600). Pointez n'importe quel outil vers http://aquaman.local/<service>/<path> et le proxy injecte les en-têtes d'authentification pour ce service depuis le backend de coffre-fort que vous avez choisi.

2. Passerelle OpenClaw

openclaw plugins install aquaman-plugin           # 1. install plugin + proxy
openclaw aquaman setup                            # 2. backend + keys + plugin wire-up
openclaw                                          # 3. done - proxy starts automatically

Dépannage : openclaw aquaman doctor.

Vous utilisez npm directement ? npm install -g aquaman-proxy && aquaman openclaw setup fait la même chose - installe le CLI du proxy, stocke vos clés, installe le plugin dans ~/.openclaw/extensions/aquaman-plugin/, et configure les identifiants (références SecretRef sur OpenClaw ≥ 2026.6.5, l'espace réservé auth-profiles.json sur les versions plus anciennes).

aquaman openclaw setup pointe models.providers.<svc>.baseUrl et channels.telegram.apiRoot vers l'écouteur loopback du proxy, car le transport de modèles d'OpenClaw et ses canaux construisent chacun leur propre client HTTP et contournent l'intercepteur fetch. Les canaux autres que Telegram n'exposent aucune substitution de point de terminaison, donc leurs jetons sont stockés et migrés mais non injectés à la sortie (voir packages/plugin/README.md). Ajoutez des canaux sous la configuration du plugin dans openclaw.json ; les canaux pris en charge incluent Slack, Discord, Telegram, MS Teams, Matrix, LINE, Twitch, Twilio, BlueBubbles, Mattermost, Nostr, Tlon, Feishu, Google Chat, ElevenLabs, xAI, Cloudflare AI Gateway, Mistral, Hugging Face, et plus encore (25 au total).

3. Agents de codage 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