aquaman v0.14.0
🔱 Le seul proxy d'identification indépendant pour les agents IA : isolement de type « apportez votre propre coffre » et politiques de requêtes de moindre privilège. 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.
đź”± Aquaman
🔱 Le seul proxy d'identifiants indépendant pour agents IA : isolation bring-your-own-vault et politiques de requêtes à moindre privilège. 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, OpenClaw ou Hermes, et vous fixez maintenant vos fichiers .env avec vos précieuses clés API qui traînent en clair. Vous avez lu les articles. Vous savez ce qui se passe quand un agent subit une injection de prompt. On comprend.
Aquaman résout ce problème avec trois couches de défense :
- 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.
- 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.
- Audit à l'épreuve de la falsification : chaque utilisation d'identifiant est journalisée avec des chaînes de hachage SHA-256. Vous pouvez prouver ce qui a été accédé et détecter toute falsification après coup.
Choisissez votre parcours
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 modèle et 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 d'agent de codage IA. Références aquaman://service/key à portée de projet résolues à chaque appel d'outil Bash. | Si vous utilisez Claude Code (aujourd'hui) - Codex / OpenCode / Cursor prévus. |
aquaman-hermes | Plugin d'hôte d'agent Hermes (Python, sur PyPI). Pointe Hermes vers un listener loopback opt-in protégé par jeton via ses ANTHROPIC_BASE_URL/OPENAI_BASE_URL natifs ; ajoute une commande en session /aquaman-status, 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 |
Une seule CLI aquaman expose les quatre : commandes de premier niveau pour le vault et l'audit, aquaman openclaw ... pour l'intégration OpenClaw, aquaman coder ... pour l'intégration d'agent de codage (délègue à aquaman-coder en interne) ainsi que aquaman hermes ... pour le paquet Python Hermes.
DĂ©marrage rapide
aquaman help, aquaman doctor sont vos amis.
1. Vault uniquement (juste le proxy + vos secrets)```bash
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. OpenClaw Gateway```bash
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.
Utiliser npm directement ? npm install -g aquaman-proxy && aquaman openclaw setup fait la même chose - installe le CLI 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èle 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 aujourd'hui)```bash
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
aquaman doctor # 6. verify - should show both vault + coder green
**Voyez-le par vous-même (le déclic en 30 secondes) :** redémarrez Claude Code, ouvrez une nouvelle session dans `~/code/my-app`, et demandez à l'agent d'exécuter :```
printenv | grep ANTHROPIC_API_KEY
Vous verrez ceci dans la transcription :``` ANTHROPIC_API_KEY=[REDACTED:injected-value]
⏺ ANTHROPIC_API_KEY is set and available (injected via aquaman vault).
Le processus *enfant* voyait la vraie clé (vos tests, builds, serveurs MCP, scripts d'import - tout ce qui en a réellement besoin fonctionne). L'*agent* - la chose qui décide quel code exécuter sur votre machine - ne voit jamais la valeur, et donc l'historique de conversation ne la voit pas non plus, les logs du fournisseur du modèle non plus, et personne qui prendra plus tard une capture d'écran de votre terminal non plus.