
aquaman v0.14.0
🔱 AI एजेंटों के लिए एकमात्र स्वतंत्र क्रेडेंशियल प्रॉक्सी: अपना स्वयं का वॉल्ट पृथक्करण और न्यूनतम विशेषाधिकार अनुरोध नीतियां। आपकी चाबियाँ वहीं रहती हैं जहाँ आप पहले से रखते हैं, एजेंट की मेमोरी में कभी नहीं। 1Password, keychain, keepassxc और कई अन्य के साथ संगत।
🔱 Aquaman
🔱 AI एजेंट्स के लिए एकमात्र स्वतंत्र क्रेडेंशियल प्रॉक्सी: bring-your-own-vault आइसोलेशन और न्यूनतम-विशेषाधिकार अनुरोध नीतियाँ। आपकी कुंजियाँ वहीं रहती हैं जहाँ आप उन्हें पहले से रखते हैं, कभी भी एजेंट की मेमोरी में नहीं। 1Password, keychain, keepassxc और कई अन्य के साथ संगत।
आपने Claude Code, Codex, OpenClaw, Hermes, या Docker Sandboxes सेट अप किया है, और अब आप .env फ़ाइलों को देख रहे हैं जिनमें आपकी कीमती API कुंजियाँ सादे टेक्स्ट में पड़ी हैं। आपने लेख पढ़े हैं। आप जानते हैं कि जब किसी एजेंट को prompt-injection होता है तो क्या होता है। हम समझते हैं।
Aquaman इसे तीन सुरक्षा परतों से ठीक करता है:
- प्रोसेस आइसोलेशन: API कुंजियाँ एक अलग प्रॉक्सी प्रोसेस में रहती हैं जो उन्हें egress पर इंजेक्ट करती है। एजेंट के पास एक मार्कर होता है, कभी कुंजी नहीं, इसलिए एजेंट में RCE होने पर भी कोई कुंजी नहीं पढ़ सकता। कोडिंग एजेंट्स को केवल वही refs मिलते हैं जो आप घोषित करते हैं, एक बार में एक कमांड।
- अनुरोध नीतियाँ: प्रति-सेवा नियम नियंत्रित करते हैं कि एजेंट कौन से एंडपॉइंट कॉल कर सकता है। एडमिन API ब्लॉक करें, डिलीशन रोकें, ड्राफ़्ट की अनुमति दें लेकिन भेजना अस्वीकार करें। अस्वीकृत अनुरोधों को कभी वास्तविक क्रेडेंशियल नहीं मिलते।
- छेड़छाड़-स्पष्ट ऑडिट: प्रत्येक क्रेडेंशियल उपयोग SHA-256 हैश चेन के साथ लॉग किया जाता है। आप साबित कर सकते हैं कि क्या एक्सेस किया गया और बाद में छेड़छाड़ का पता लगा सकते हैं।
अपना रास्ता चुनें
Aquaman चार समन्वित पैकेजों के रूप में आता है, जो एक vault + एक daemon साझा करते हैं। केवल वही इंस्टॉल करें जो आपको चाहिए:
| पैकेज | यह क्या करता है | कब इंस्टॉल करें |
|---|---|---|
aquaman-proxy | कोर: vault, daemon, ऑडिट, नीति, CLI। वह हिस्सा जो सभी को चाहिए। | हमेशा। |
aquaman-plugin | OpenClaw Gateway एडाप्टर। Gateway स्टार्टअप पर प्रॉक्सी स्पॉन करता है; मॉडल और Telegram ट्रैफ़िक को इसके माध्यम से रूट करता है; 5 auth मोड्स में 25 बिल्टइन सेवाएँ। | यदि आप OpenClaw Gateway चलाते हैं। https://clawhub.ai/plugins/aquaman-plugin पर भी उपलब्ध। |
aquaman-coder | AI कोडिंग-एजेंट एडाप्टर। प्रोजेक्ट-स्कोप्ड aquaman://service/key संदर्भ प्रति Bash टूल कॉल हल किए जाते हैं। | यदि आप Claude Code या Codex उपयोग करते हैं। |
aquaman-hermes | Hermes एजेंट-होस्ट प्लगइन (Python, PyPI पर)। Hermes को उसके मूल ANTHROPIC_BASE_URL/OPENAI_BASE_URL के माध्यम से एक opt-in, token-gated loopback listener की ओर इंगित करता है; एक इन-सेशन /aquaman-status कमांड, टूल, और हेल्थ प्रोब जोड़ता है। आइसोलेशन प्रॉक्सी-साइड है; प्लगइन कोई क्रेडेंशियल नहीं रखता। | यदि आप Hermes एजेंट होस्ट चलाते हैं। pip install aquaman-hermes |
| Docker Sandboxes | पैकेज नहीं: एक अलग रास्ता जिसे केवल aquaman-proxy चाहिए। Docker की अपनी प्रॉक्सी सीक्रेट्स इंजेक्ट करती है; aquaman get उन्हें आपके vault से प्रदान करता है, allow-list और ऑडिट लॉग के साथ। | यदि आप Docker Sandboxes में एजेंट्स चलाते हैं। देखें Quick Start 5। |
| NVIDIA OpenShell | पैकेज नहीं: aquaman daemon OpenShell गेटवे का क्रेडेंशियल ड्राइवर बन जाता है। OpenShell कुंजी को सैंडबॉक्स से अलग करता है; aquaman इसे संदर्भ द्वारा आपके vault से प्रदान करता है, allow-list और ऑडिट लॉग के साथ। | यदि आप OpenShell सैंडबॉक्स में एजेंट्स चलाते हैं। देखें Quick Start 6। |
एक ही aquaman CLI चारों को सामने लाता है: vault और audit के लिए top-level कमांड, OpenClaw इंटीग्रेशन के लिए aquaman openclaw ..., coding-agent इंटीग्रेशन के लिए aquaman coder ... (जो अंदर ही अंदर aquaman-coder को सौंपता है) तथा Hermes Python पैकेज के लिए aquaman hermes ...।
त्वरित शुरुआत
aquaman help, aquaman doctor आपके मित्र हैं।
1. केवल Vault (बस प्रॉक्सी + आपके रहस्य)
npm install -g aquaman-proxy
aquaman setup # backend wizard + store keys
aquaman daemon & # start the proxy
aquaman credentials list # verify
प्रॉक्सी ~/.aquaman/proxy.sock (UDS, chmod 0o600) पर सुनता है। किसी भी टूल को http://aquaman.local/<service>/<path> पर इंगित करें और प्रॉक्सी आपके चुने हुए वॉल्ट बैकएंड से उस सेवा के लिए प्रमाणीकरण हेडर इंजेक्ट करता है।
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
समस्या निवारण: openclaw aquaman doctor।
सीधे npm का उपयोग कर रहे हैं? npm install -g aquaman-proxy && aquaman openclaw setup वही काम करता है - प्रॉक्सी CLI इंस्टॉल करता है, आपकी कुंजियाँ संग्रहीत करता है, प्लगइन को ~/.openclaw/extensions/aquaman-plugin/ में इंस्टॉल करता है, और क्रेडेंशियल्स को वायर करता है (OpenClaw ≥ 2026.6.5 पर SecretRef refs, पुराने संस्करणों पर auth-profiles.json प्लेसहोल्डर)।
aquaman openclaw setup models.providers.<svc>.baseUrl और channels.telegram.apiRoot को प्रॉक्सी के लूपबैक लिसनर की ओर इंगित करता है, क्योंकि OpenClaw का मॉडल ट्रांसपोर्ट और उसके चैनल प्रत्येक अपना HTTP क्लाइंट बनाते हैं और fetch इंटरसेप्टर को बायपास करते हैं। Telegram के अलावा अन्य चैनल कोई एंडपॉइंट ओवरराइड प्रदान नहीं करते, इसलिए उनके टोकन संग्रहीत और माइग्रेट किए जाते हैं लेकिन egress पर इंजेक्ट नहीं किए जाते (देखें packages/plugin/README.md)। openclaw.json में प्लगइन कॉन्फ़िग के अंतर्गत चैनल जोड़ें; समर्थित चैनलों में Slack, Discord, Telegram, MS Teams, Matrix, LINE, Twitch, Twilio, BlueBubbles, Mattermost, Nostr, Tlon, Feishu, Google Chat, ElevenLabs, xAI, Cloudflare AI Gateway, Mistral, Hugging Face, और अन्य शामिल हैं (कुल 25)।
3. 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
इसे स्वयं देखें (30-सेकंड का अहा): Claude Code (या Codex) को पुनः आरंभ करें, ~/code/my-app के अंदर एक नया सत्र खोलें, और एजेंट से चलाने के लिए कहें:
printenv | grep ANTHROPIC_API_KEY
आपको ट्रांस्क्रिप्ट में यह दिखाई देगा:
ANTHROPIC_API_KEY=[REDACTED:injected-value]
⏺ ANTHROPIC_API_KEY is set and available (injected via aquaman vault).