🔱 Aquaman

🔱 الوكيل المستقل الوحيد لبيانات الاعتماد لوكلاء الذكاء الاصطناعي: عزل الخزنة الخاصة بك وسياسات الطلبات بأقل صلاحية ممكنة. تبقى مفاتيحك حيث تحتفظ بها بالفعل، ولا تدخل أبدًا إلى ذاكرة الوكيل. متوافق مع 1Password وkeychain وkeepassxc وغيرها الكثير.

قمت بإعداد Claude Code أو Codex أو OpenClaw أو Hermes أو Docker Sandboxes، والآن تجد نفسك تحدّق في ملفات .env التي تحتوي على مفاتيح API الثمينة الخاصة بك مكشوفة كنص صريح. لقد قرأت المقالات. أنت تعرف ما يحدث عندما يتعرض الوكيل لهجوم حقن التعليمات (prompt injection). نحن نتفهم ذلك.

يعالج Aquaman هذه المشكلة بثلاث طبقات من الحماية:

عزل العمليات: تعيش مفاتيح API في عملية وكيل منفصلة تحقنها عند نقطة الخروج. يحمل الوكيل علامة مرجعية فقط، وليس مفتاحًا أبدًا، لذا حتى تنفيذ التعليمات البرمجية عن بُعد (RCE) في الوكيل لا يمكنه قراءة أي مفتاح. لا يحصل وكلاء البرمجة إلا على المراجع التي تعلنها، أمرًا واحدًا في كل مرة.
سياسات الطلبات: تتحكم قواعد لكل خدمة في نقاط النهاية التي يمكن للوكيل استدعاؤها. احظر واجهات API الإدارية، وامنع عمليات الحذف، واسمح بالمسودات مع رفض الإرسال. الطلبات المرفوضة لا تحصل أبدًا على بيانات اعتماد حقيقية.
تدقيق مقاوم للتلاعب: يُسجَّل كل استخدام لبيانات الاعتماد باستخدام سلاسل تجزئة SHA-256. يمكنك إثبات ما تم الوصول إليه واكتشاف أي تلاعب بعد وقوعه.

اختر مسارك

يُوزَّع Aquaman كأربع حزم منسّقة، تشترك في خزنة واحدة + خادم خفي (daemon) واحد. ثبّت فقط ما تحتاجه:

الحزمة	ما تفعله	متى تُثبّتها
`aquaman-proxy`	النواة: الخزنة، والخادم الخفي، والتدقيق، والسياسة، وواجهة سطر الأوامر (CLI). الجزء الذي يحتاجه الجميع.	دائمًا.
`aquaman-plugin`	محوّل OpenClaw Gateway. يشغّل الوكيل عند بدء Gateway؛ ويوجّه حركة النماذج وTelegram عبره؛ و25 خدمة مدمجة عبر 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. راجع البدء السريع 5.
NVIDIA OpenShell	ليست حزمة: يصبح `aquaman daemon` مشغّل بيانات الاعتماد لبوابة OpenShell. يعزل OpenShell المفتاح عن الصندوق الرملي؛ ويوفّره aquaman من خزنتك بالمرجع، مع قائمة السماح وسجل التدقيق.	إذا كنت تشغّل الوكلاء في صناديق OpenShell الرملية. راجع البدء السريع 6.

تُتيح واجهة سطر أوامر aquaman واحدة الوصول إلى المكوّنات الأربعة جميعها: أوامر عليا للخزنة والتدقيق، وaquaman openclaw ... لتكامل OpenClaw، وaquaman coder ... لتكامل وكيل البرمجة (الذي يفوّض العمل إلى aquaman-coder في الخلفية)، إضافةً إلى aquaman hermes ... لحزمة Hermes بلغة Python.

البدء السريع

aquaman help وaquaman doctor هما صديقاك.

1. الخزنة فقط (الوكيل + أسرارك فحسب)

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) التي اخترتها.

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 يفعل الشيء نفسه - يثبّت واجهة سطر أوامر الوكيل (proxy 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. وكلاء البرمجة بالذكاء الاصطناعي (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).

عملية الطفل رأت المفتاح الحقيقي (اختباراتك، عمليات البناء، خوادم MCP، سكربتات الاستيراد - أي شيء يحتاج إليه فعليًا يعمل). أما الوكيل - وهو الشيء الذي يقرر أي كود يُشغَّل على جهازك - فلا يرى القيمة أبدًا، وبالتالي لا يراها سجل المحادثة، ولا سجلات مزوّد النموذج، ولا أي شخص يلتقط لقطة شاشة لطرفيتك لاحقًا.

استخدمه من طرفيتك الخاصة أيضًا. يعمل الغلاف نفسه دون الوكيل. ما عليك سوى تنفيذ cd إلى مشروع مشمول ووضع البادئة على أمرك:

cd ~/code/
aquaman-coder exec -- python app/scripts/import.py

aquaman v0.14.0