🔱 Aquaman

🔱 Единственный независимый прокси для учётных данных AI-агентов: изоляция с собственным хранилищем секретов (bring-your-own-vault) и политики запросов по принципу наименьших привилегий. Ваши ключи остаются там, где вы их уже храните, и никогда не попадают в память агента. Совместим с 1Password, keychain, keepassxc и многими другими.

Вы настроили Claude Code, Codex, OpenClaw, Hermes или Docker Sandboxes, и теперь смотрите на файлы .env, где ваши драгоценные API-ключи лежат открытым текстом. Вы читали статьи. Вы знаете, что происходит, когда агент подвергается prompt injection. Мы понимаем.

Aquaman решает эту проблему с помощью трёх уровней защиты:

Изоляция процессов: API-ключи хранятся в отдельном процессе-прокси, который внедряет их на выходе. Агент держит только маркер, а не ключ, поэтому даже RCE в агенте не позволит прочитать ключ. Кодирующие агенты получают только те ссылки, которые вы объявили, по одной команде за раз.
Политики запросов: Правила для каждого сервиса определяют, к каким эндпоинтам агент может обращаться. Блокируйте административные API, запрещайте удаление, разрешайте черновики, но запрещайте отправку. Отклонённые запросы никогда не получают реальных учётных данных.
Аудит с защитой от подделки: Каждое использование учётных данных регистрируется в цепочках хешей SHA-256. Вы можете доказать, к чему был получен доступ, и обнаружить подделку постфактум.

Выберите свой путь

Aquaman поставляется в виде четырёх согласованных пакетов, использующих одно хранилище секретов и один демон. Устанавливайте только то, что вам нужно:

Пакет	Что делает	Когда устанавливать
`aquaman-proxy`	Ядро: хранилище секретов, демон, аудит, политики, CLI. Компонент, который нужен всем.	Всегда.
`aquaman-plugin`	Адаптер для OpenClaw Gateway. Запускает прокси при старте Gateway; маршрутизирует трафик моделей и Telegram через него; 25 встроенных сервисов с 5 режимами аутентификации.	Если вы используете OpenClaw Gateway. Также доступен по адресу https://clawhub.ai/plugins/aquaman-plugin
`aquaman-coder`	Адаптер для AI-агентов, пишущих код. Ссылки `aquaman://service/key` в области проекта разрешаются при каждом вызове инструмента Bash.	Если вы используете Claude Code или Codex.
`aquaman-hermes`	Плагин для хоста агента Hermes (Python, на PyPI). Направляет Hermes на опциональный loopback-слушатель с токен-доступом через его нативные `ANTHROPIC_BASE_URL`/`OPENAI_BASE_URL`; добавляет команду `/aquaman-status` в сессии, инструмент и проверку работоспособности. Изоляция обеспечивается на стороне прокси; плагин не хранит учётных данных.	Если вы используете хост агента Hermes. `pip install aquaman-hermes`
Docker Sandboxes	Не пакет: отдельный путь, требующий только `aquaman-proxy`. Собственный прокси Docker внедряет секреты; `aquaman get` предоставляет их из вашего хранилища с учётом списка разрешений и журнала аудита.	Если вы запускаете агентов в Docker Sandboxes. См. Быстрый старт 5.
NVIDIA OpenShell	Не пакет: `aquaman daemon` становится драйвером учётных данных для шлюза OpenShell. OpenShell изолирует ключ от песочницы; aquaman предоставляет его из вашего хранилища по ссылке, с учётом списка разрешений и журнала аудита.	Если вы запускаете агентов в песочницах OpenShell. См. Быстрый старт 6.

Единый CLI aquaman объединяет все четыре компонента: команды верхнего уровня для vault и audit, aquaman openclaw ... для интеграции с OpenClaw, aquaman coder ... для интеграции с coding-agent (под капотом делегирует в aquaman-coder), а также aquaman hermes ... для Python-пакета 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

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/ и подключает учётные данные (SecretRef-ссылки на OpenClaw ≥ 2026.6.5, заглушка auth-profiles.json на более старых версиях).

aquaman openclaw setup направляет models.providers.<svc>.baseUrl и channels.telegram.apiRoot на loopback-слушатель прокси, поскольку транспорт моделей OpenClaw и его каналы каждый создают собственный HTTP-клиент и обходят перехватчик fetch. Каналы, отличные от Telegram, не предоставляют переопределения эндпоинта, поэтому их токены сохраняются и мигрируются, но не внедряются на исходящем трафике (см. 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]

aquaman v0.14.0