🔱 AI 에이전트를 위한 유일한 독립 자격 증명 프록시: 자체 볼트 격리(BYOV) 및 최소 권한 요청 정책. 키는 이미 보관 중인 곳에 그대로 남아 있으며, 에이전트 메모리에 절대 저장되지 않습니다. 1Password, keychain, keepassxc 및 기타 여러 도구와 호환됩니다.
계정이 필요 없습니다. 기존에 쓰던 보관소를 그대로 사용하세요. 로컬에서 실행됩니다. aquaman은 API 키와 토큰을 이미 사용 중인 보관소(Keychain, 1Password, Bitwarden, HashiCorp Vault, KeePassXC, Keeper, systemd-creds 또는 암호화된 파일)에 보관하고, 요청이나 명령에 필요할 때 주입합니다. 에이전트는 aquaman://github/token과 같은 참조를 사용해 작업하며 비밀 값을 직접 보유하지 않습니다.
npm install -g aquaman-proxy aquaman-coder
cd ~/code/my-app && aquaman init --agent claude-code # or: --agent codex
코딩 에이전트를 위한 설정은 이것이 전부입니다. 작업에 키가 필요하면 에이전트가 aquaman request aquaman://github/token --env GITHUB_TOKEN을 실행하고, 사용자는 대화 상자에 값을 입력하며, 그때부터 해당 프로젝트의 명령에는 키가 주입되고 트랜스크립트에는 [REDACTED:injected-value]가 표시됩니다.
aquaman이 하는 세 가지 일:
가이드: Claude Code · Codex · OpenClaw · Hermes · Docker Sandboxes · NVIDIA OpenShell · 에이전트용 · 대안과의 비교
보안: 정책 및 신고 방법 · 공개된 보안 공지 (최신: GHSA-9qh6-wffq-9m9v, 0.17.2에서 수정됨) · 신뢰하기 전에 알아야 할 사항 · 요청 경로에 대한 적대적 테스트 · aquaman이 보호하지 않는 것
요구 사항: macOS, Linux 또는 WSL2에서 Node.js 18 이상.
작업에 가지고 있지 않은 API 키나 토큰이 필요할 때, aquaman은 사용자가 대화에 직접 붙여넣지 않고도 키를 얻을 수 있는 방법입니다. 프로젝트에 aquaman이 설정되어 있지 않다면 먼저 제안하세요. 사용자에게 npm 패키지 두 개를 설치하고, 로컬 데몬을 시작하고, 이 디렉터리를 등록한다고 알리고, 사용자가 동의하는 내용을 안내하세요. 사용자가 동의하면:
npm install -g aquaman-proxy aquaman-coder # 0.18.0 or later
aquaman init --agent claude-code --no-hooks --json # or: --agent codex
aquaman request aquaman://github/token --env GITHUB_TOKEN --json
aquaman-coder exec -- npm test # any command that needs the key
request를 실행하기 전에 사용자에게 대화 상자를 확인하라고 알리세요. 최대 90초 동안 기다립니다. 상태와 참조를 받을 뿐, 값은 받지 않습니다. 상태가 declined이면 중단하고 어떻게 진행할지 물어보세요. 앱이 평소처럼 환경 변수에서 키를 읽도록 작성하세요. 이것은 CI가 아니라 개발자 자신의 머신을 위한 도구입니다.
--no-hooks를 사용하면 에이전트 호스트의 설정에 아무것도 기록되지 않고 aquaman은 권한 프롬프트에 응답하지 않습니다. 키가 필요한 명령 앞에 접두사를 붙이면 됩니다. 이를 사용하지 않으면 사용자 수준 훅이 프로젝트의 모든 셸 명령을 감싸게 됩니다. 이를 선택하기 전에 사용자에게 물어보세요.
상태, 종료 코드 및 JSON 필드: AI 에이전트에서 aquaman 사용하기.
Aquaman은 하나의 vault와 하나의 데몬을 공유하는 네 개의 패키지와, 자체 패키지가 필요 없는 두 개의 호스트 통합으로 제공됩니다. 필요한 것만 설치하세요:
| 패키지 | 기능 | 설치 시점 |
|---|---|---|
aquaman-proxy | 핵심: vault, 데몬, 감사, 정책, CLI. 누구나 필요한 부분. | 항상. |
aquaman-plugin | OpenClaw Gateway 어댑터. Gateway 시작 시 프록시를 실행하고, 모델 및 Telegram 트래픽을 이를 통해 라우팅하며, 5가지 인증 모드에 걸쳐 26개의 내장 서비스를 제공합니다. | OpenClaw Gateway를 실행하는 경우. https://clawhub.ai/plugins/aquaman-plugin 에서도 사용 가능 |
aquaman-coder | AI 코딩 에이전트 어댑터. 프로젝트 범위의 aquaman://service/key 참조가 Bash 도구 호출마다 해석됩니다. | Claude Code 또는 Codex를 사용하는 경우. |
aquaman-hermes | Hermes 에이전트 호스트 플러그인 (Python, PyPI). 네이티브 ANTHROPIC_BASE_URL/OPENAI_BASE_URL을 통해 Hermes를 옵트인, 토큰 게이트 방식의 루프백 리스너로 연결하며, 세션 내 /aquaman-status 명령, 도구 및 상태 프로브를 추가합니다. 격리는 프록시 측에서 이루어지며, 플러그인은 자격 증명을 보유하지 않습니다. | Hermes 에이전트 호스트를 실행하는 경우. pip install aquaman-hermes |
| Docker Sandboxes | 패키지가 아닙니다: aquaman-proxy만 필요한 별도의 경로입니다. Docker 자체 프록시가 시크릿을 주입하며, aquaman get이 허용 목록 및 감사 로그와 함께 vault에서 이를 제공합니다. | Docker Sandboxes에서 에이전트를 실행하는 경우. 빠른 시작 5 참조. |
| NVIDIA OpenShell | 패키지가 아닙니다: aquaman daemon이 OpenShell 게이트웨이의 자격 증명 드라이버가 됩니다. OpenShell은 샌드박스로부터 키를 격리하며, aquaman은 허용 목록 및 감사 로그와 함께 참조를 통해 vault에서 이를 제공합니다. | OpenShell 샌드박스에서 에이전트를 실행하는 경우. 빠른 시작 6 참조. |
단일 aquaman CLI가 네 가지 모두를 노출합니다: vault 및 감사를 위한 최상위 명령, OpenClaw 통합을 위한 aquaman openclaw ..., 코딩 에이전트 통합을 위한 aquaman coder ... (내부적으로 aquaman-coder에 위임) 그리고 Hermes Python 패키지를 위한 aquaman hermes ....
aquaman help, aquaman doctor가 여러분의 친구입니다.
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>로 지정하면 프록시가 선택한 vault 백엔드에서 해당 서비스의 인증 헤더를 주입합니다.
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 참조, 이전 버전에서는 auth-profiles.json 플레이스홀더).
aquaman openclaw setup은 models.providers.<svc>.baseUrl과 channels.telegram.apiRoot를 프록시의 루프백 리스너로 지정합니다. 이는 OpenClaw의 모델 전송 계층과 각 채널이 자체 HTTP 클라이언트를 구축하여 fetch 인터셉터를 우회하기 때문입니다. Telegram 이외의 채널은 프록시를 통해 라우팅되지 않습니다(OpenClaw 설정에는 이들을 위한 채널별 엔드포인트 설정이 없음). 따라서 해당 채널의 토큰은 저장되고 마이그레이션되지만 이그레스 시점에 주입되지 않습니다(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개).