🔱 البروكسي الوحيد المستقل للاعتمادات لوكلاء الذكاء الاصطناعي: عزل بخزاناتك الخاصة وسياسات طلب بأقل الامتيازات. تبقى مفاتيحك حيث تخزنها بالفعل، ولا تصل أبدًا إلى ذاكرة الوكيل. متوافق مع 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
يتطلب: Node.js 18 أو أحدث على macOS أو Linux أو WSL2.
عندما تحتاج مهمة إلى مفتاح API أو رمز مميز لا تملكه، فإن aquaman طريقة للحصول عليه دون أن يلصقه المستخدم في المحادثة. إذا لم يكن aquaman مُعدًّا في المشروع، اقترحه أولًا: أخبر المستخدم أنه يثبّت حزمتي npm، ويشغّل خادمًا محليًا (daemon)، ويسجّل هذا الدليل، ووجّهه إلى ما يوافق عليه. بموافقته:
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 على أي مطالبة إذن؛ بل تُسبق الأوامر التي تحتاج مفتاحًا ببادئة. وبدون ذلك، يلتف خطاف على مستوى المستخدم حول كل أمر shell في المشروع بدلًا من ذلك: اسأل المستخدم قبل اختيار ذلك.
الحالات وأكواد الخروج وحقول JSON: Using aquaman from an AI agent.
يُشحن Aquaman على هيئة أربع حزم تتشارك خزنة واحدة وخادمًا خفيًا واحدًا (daemon)، إضافةً إلى تكاملين مع المضيف لا يحتاجان إلى حزمة خاصة بهما. ثبّت فقط ما تحتاج إليه:
| الحزمة | ما تفعله | متى تُثبّتها |
|---|---|---|
aquaman-proxy | النواة: الخزنة، والخادم الخفي، والتدقيق، والسياسة، وواجهة سطر الأوامر. الجزء الذي يحتاجه الجميع. | دائمًا. |
aquaman-plugin | محوّل OpenClaw Gateway. يُشغّل الوكيل عند بدء Gateway؛ ويوجّه حركة النماذج وTelegram عبره؛ و26 خدمة مدمجة عبر 5 أنماط مصادقة. | إذا كنت تشغّل OpenClaw Gateway. متاح أيضًا على https://clawhub.ai/plugins/aquaman-plugin |
aquaman-coder | محوّل وكيل البرمجة بالذكاء الاصطناعي. مراجع 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. راجع Quick Start 5. |
| NVIDIA OpenShell | ليست حزمة: يصبح aquaman daemon مشغّل بيانات الاعتماد لبوابة OpenShell. يعزل OpenShell المفتاح عن الصندوق الرملي؛ ويوفّره aquaman من خزنتك بالمرجع، مع قائمة السماح وسجل التدقيق. | إذا كنت تشغّل الوكلاء في صناديق OpenShell الرملية. راجع Quick Start 6. |
تُظهر واجهة aquaman CLI واحدة الحزم الأربع جميعها: أوامر عليا للخزنة والتدقيق، وaquaman openclaw ... لتكامل OpenClaw، وaquaman coder ... لتكامل وكيل البرمجة (تفوّض إلى aquaman-coder في الخلفية) وكذلك aquaman hermes ... لحزمة Hermes بلغة Python.
aquaman help وaquaman doctor صديقانك.
npm install -g aquaman-proxy
aquaman setup # backend wizard + store keys
aquaman daemon & # start the proxy
aquaman credentials list # verify
يستمع الوكيل (proxy) على ~/.aquaman/proxy.sock (UDS، chmod 0o600). وجّه أي أداة إلى http://aquaman.local/<service>/<path> وسيقوم الوكيل بحقن ترويسات المصادقة (auth headers) الخاصة بتلك الخدمة من خلفية الخزنة (vault backend) التي اخترتها.