🧰 Anthropic Agent Tools GA (20 أغسطس 2026) — الحالة المُتحقَّقة حيّاً 2026-08-21

الأدوات الأربع خرجت من beta إلى GA. الأسماء الصحيحة (مُختبَرة حيّاً عبر مفتاحنا):

Files API ✅ مُتبنّى فعلاً: files-api-2025-04-14 — يُستخدم في skills/anthropic-files/ + war_room.py + opus5-executor. (حتى 1TB للمؤسسة.)
Skills API ✅ مُتبنّى: منظومة 154 skill كاملة.
Computer Use ✅ مُتبنّى: skills/computer-use/ + computer-use-plus/ — beta header الصالح المُتحقَّق = computer-use-2025-11-24 (200) و computer-use-2025-01-24 (200، القديم). tool type = computer_20250124 + bash_20250124 صالحان.
Browser Use (الجديد GA) = browser_toolset_20260801 (client toolset، 27 أداة عضو: navigate/read_page/left_click/screenshot... + 4 اختيارية: javascript_exec/file_upload/read_console/read_network). 🔴 قيود مُثبَتة حيّاً: (1) لا name على toolset entry (الأسماء ثابتة بالنوع المؤرّخ). (2) client toolset: Claude يقترح، تطبيقنا ينفّذ كل نقرة عبر أتمتة متصفّحنا — لا شيء جهة Anthropic. (3) يحتاج agent-loop تنفيذياً كاملاً (halt-on-failure + approval-before-consequential-step).

🔴 القرار المعماري (نقد 6 مستويات، 2026-08-21): المنفّذ الفعلي للمتصفّح عندنا = browser tool البوابة (CDP) + chrome-sovereign (المخرج التركي، أساس Browser Pro) + browser-pro (65 منصّة) — يؤدّي وظيفة Browser Use نفسها فعلاً. لذا Browser Use GA = طبقة موثّقة جاهزة تُبنى عند الحاجة لـ agent-loop مستقل عن البوابة (ليس تكراراً فورياً). CDP = الأساس، Browser Use GA = مسار مستقبلي عند بناء executor منفصل. صفر تكرار، صفر تكلفة زائدة الآن.

📎🔴 MEDIA send — المجلد القياسي `media/outbound/` حصراً (مُثبَت 2026-08-21 بعد Media failed)

الجذر (مُثبَت حيّاً): إرسال MEDIA: من مجلد فرعي عميق (مثل media/outbound/wan_compare/x.mp4) يفشل بـ «Media failed» رغم أن الملف سليم + تحت حدّ الحجم (9.7MB < 50MB). الحل (مُثبَت: الفيديو وصل بعد النقل): انسخ للمجلد القياسي /data/.openclaw/media/outbound/ مباشرة (لا مجلد فرعي) ثم MEDIA: منه. أو مرّره عبر bash scripts/safe_media_send.sh <file> (يضمن المجلد القياسي + zip للامتدادات غير المسموحة + ضغط لـ>45MB) واستخدم مخرجه. ❌ لا MEDIA: من /tmp أو مجلدات فرعية تحت outbound.

🚀🔥 B200 GPU Instance — قدرة حوسبة محلية عملاقة (رُبط + مُثبَت حيّاً E2E 2026-08-28 — أمر د. وائل)

الجهاز (Hostinger GPU قسم منفصل): GPU-host-vessel · NVIDIA B200 (Blackwell sm_100) · 192GB VRAM · 224 vCPU · 64GB RAM · 447GB disk · Ubuntu 24.04 · Los Angeles. الرصيد: 600 credits/hr (ابدأ/أوقف الحوسبة عند الحاجة). الوصول (دائم): ssh ubuntu@4.71.129.63 -p 31513 بمفتاحنا /data/.ssh/openclaw_host_ed25519. 🔴 المنفذ 31513 لا 22، المستخدم ubuntu لا root. الأدوات: bash scripts/gpu_arsenal.sh {status|gpu|ssh <cmd>|py <code>|bench|env|selftest} (تحكّم+تشغيل كود) · bash scripts/gpu_governor.sh {acquire <reason>|release|status|idle-check|credits} (حوكمة الرصيد) · باب البورتال apps.drwaelalkishawi.com/gpu/. مُثبَت حيّاً: torch 2.13.0+cu130 (إلزامي لـsm_100؛ cu126 يفشل no-kernel-image) + numpy + uv في ~/gpuenv. bf16 ~900 TFLOP/s. CUDA toolkit رُقّي 12.6→13.0.88 (nvcc في /usr/local/cuda-13.0/bin — إلزامي لبناء flashinfer/vLLM kernels لـsm_100a؛ nvcc 12.6 يفشل ninja: build stopped). vLLM 0.28 مُثبَت + عامل E2E (يحتاج export PATH=/usr/local/cuda-13.0/bin:$PATH && CUDA_HOME=/usr/local/cuda-13.0؛ أول بناء ~108s ثم ثوانٍ). transformers يعمل مباشرة بلا بناء (تحميل 8B في 5s). مُثبَت: NeuralDaredevil-8B-abliterated unrestricted يردّ (17×23=391 + cyber بلا رفض). 🎯 الاستفادة (يفتح كل المؤجّل GPU-only): vLLM+نماذج 70B-200B محلية unrestricted (صفر API + خصوصية KCPC/عائلي) · abliteration · Whisper/Flux/Wan محلي · البوابة الدلالية 30B+ · fine-tuning KCPC · مجلس النخبة المحلي · تكامل الأكاديمي unrestricted محلياً (heretic-llm بدل uncensored.com الخارجي). الحصر الكامل: B200_GPU_CAPABILITIES.md. آلية التشغيل (خط أحمر — حفظ الرصيد): لا يعمل طوال الوقت. عند الحاجة → acquire → أستخدم كل القدرات → release + إيقاف من اللوحة/البورتال. 🔴 آلية الرصيد (مُثبَت من Hostinger الرسمي): «charged while an instance is running» — لا يوجد «running بلا استهلاك»؛ طالما running = 600/hr بغضّ النظر عن الحوسبة داخله. تفريغ VRAM يوفّر طاقة لا رصيدًا. الإيقاف الفعلي الوحيد = زر Stop (Hostinger GPU API لا يعرّض power start/stop — 404 مُثبَت). الـinstance مطفأ افتراضياً، يُشغّل عند الحاجة ثم Stop. MiroFish-GPU (مُنجَز 2026-08-28): نسخة GPU من MiroFish (محاكاة متعددة الوكلاء OASIS — سيناريوهات KCPC/مخاطر المناقصات) على B200 ~/mirofish-gpu (.venv+torch-cu130). launcher start_gpu.sh. مُختبَر E2E (MIROFISH_GPU_COMPUTE_OK). نسخة CPU السيرفر تبقى منفصلة.

🧭 envkit/npmkit — نظام البيئات متعدد الإصدارات (never-stop، أمر د. وائل 2026-08-30)

المبدأ (كما Python/Java على اللابتوب): لا تحديث أعمى. قبل أي update → فحص توافقية (dry-run) + smoke بعده؛ إن فشل الأحدث → rollback تلقائي للنسخة العاملة → لا توقّف أبداً، صفر سلبية.

bash envkit/npmkit.sh {check|update <pkg>|update-all|rollback <pkg>|snapshot|selftest} — يُدير أدوات CLI الحرجة (claude-code · codex · mcporter · openclaw): dry-run توافقية → install → smoke (--version) → إن فشل: rollback ذرّي للنسخة العاملة المحفوظة في envkit/npm-good-versions.json. مُثبَت E2E 2026-08-30 (نسخة وهمية 99.99.99 → ETARGET مرفوض، العامل يبقى).
bash envkit/pyrun.sh + pyinstall.sh — نظير Python (root + forecasting + sci-pandas2؛ fallback ذكي للبيئة المتوافقة).
الحالة (مُثبَتة حيّاً 2026-08-30): claude-code 2.1.251 · codex 0.151.0 · mcporter 0.13.8 · openclaw 2026.7.1-2 — كلها smoke ✅. معزول في envkit/ (صفر مساس بالنواة/plugins).
🔴 درس مُثبَت: «فشل npm globals» في أوديت 2026-08-30 كان إنذاراً كاذباً — npm --dry-run نجح 847ms، المالك node:node صحيح، لا lock عالق. لا تعتمد حكم الأوديت على npm بلا dry-run حيّ.

🔓🖥️ Uncensored Cloud + On-Demand GPU (RunPod + B200) — مُختبَر حيّاً E2E 2026-09-01 (أمر د. وائل)

الموديلات uncensored/abliterated (GLM-5.3-Flash 321B · Kimi K3 2.78T · Qwen3.8 180B) — مساران:

① Cloud فوري (Venice/uncensored.com): python3 skills/liberation-router/liberation_router.py --tab <id> "<q>" (9 تبويبات: glm53-flash/kimi-k3/kimi-k3-fast/qwen38/glm-heretic/deepseek-v4/gemini31-pro/qwen38-max/glm52) · --list-tabs. never-stop (fallback للمرساة). Portal: apps.drwaelalkishawi.com/academic-uncensored/. مُختبَر 9/9 + أعلى خطورة (ret2libc) صفر رفض 5/5.
② On-Demand GPU (للـ GGUF abliterated الحقيقي): bash scripts/runpod_gpu.sh {selftest|balance|gpus|create <gpuId>|stop <id>|start <id>|serve-gguf <id> <repo> <quant>|destroy <id>}. 🔴 RunPod يدعم Stop/Start فعلياً (أذكى من Hostinger — يحفظ الموديلات، لا إعادة تنزيل). رصيد $146.
المقارنة (مُختبَر حيّاً): MI300X (RunPod) 192GB $2.39/hr + Stop/Start = الأرخص للأتمتة · B200 RunPod 180GB $6.79 (CUDA مضمون) · B200 Hostinger 192GB 600cr/hr يدوي (تكامل gpu_restore.sh جاهز، للجلسات المخطّطة).
مُثبَت E2E 2026-09-01: create B200 → رفع GGUF حقيقي → بناء llama-cpp CUDA → GPU load 3.1s → خطورة عالية refuse=False → Stop/Start يحفظ (94G محفوظ) → Stopped. كلّف $3.42.
fallback في smart-code-router: 6 موديلات uncensored في ذيل CODING_FALLBACK (أسفل النخبة Opus-5/GPT-5.6-Sol حسب القوة). مُختبَر 6/6.
🔴 قيد GGUF (لا يُنسى): معمار qwen4exp (Qwen3.8-Flash-Next) غير مدعوم في llama-cpp-python 0.3.35 — يحتاج بناء من master أو vLLM. الموديل الأصلي GLM-5.3-Flash-Uncensored gated (حسابنا غير مصرّح) — البدائل غير المقيّدة: unsloth/GLM-5.3-Flash-GGUF · Josiefied-Qwen3-8B-abliterated (مُختبَر حيّاً). التفصيل: skills/uncensored-cloud-gpu/PROCEDURE.md.
🐟 MiroFish-GPU (مُختبَر E2E 2026-09-01): نسخة GPU من MiroFish (آخر version + tools/skills) على RunPod B200 /workspace/MiroFish (يُحفظ عبر Stop/Start). torch cu128 (يدعم sm_100؛ cu124 لا يدعم) في /workspace/gpuenv. مُثبَت: compute 521ms + backend /health 200 + switch on/off. الأدوات: bash scripts/runpod_gpu.sh mirofish-on <ip> <port> / mirofish-off <ip> <port> · launchers start_gpu.sh/stop_gpu.sh. .env في الجذر (config يقرأ ../../.env). نسخة CPU السيرفر منفصلة.
🛡️ حارس auto-stop محدّث: scripts/guards/runpod_autostop_guard.sh يفحص العمليات الحيّة (run.py/llama-server) عبر SSH قبل أي إيقاف (confirm لا عمليات + fail-safe) + قفل نشاط + عتبة 40د. زر Power في Portal (academic-uncensored).

🐳🔴 HOST + DOCKER CONTROL — أملك مسارين مُثبَتين حيّاً (محقون 2026-08-03 بعد خرقي المتكرر)

الخرق الذي لا يتكرر: قلتُ «لا وصول لـ Docker» ثلاث مرات لأن /var/run/docker.sock غير موجود داخل حاويتي — وهذا صحيح لكنه ليس حدّي. أملك مسارين بديلين مُثبَتين. أي «لا أستطيع الوصول لـ Docker/الحاويات/الـ host» = خرق صريح لخط never-stop. الأداة الموحّدة:

bash scripts/hostinger_api.sh {selftest|vm|metrics|snapshot-info|snapshot-create|docker-projects|get <path>|post <path> '<json>'|ssh '<cmd>'}

1. SSH للـ host (الأقوى — CLI كامل): bash scripts/hostinger_api.sh ssh 'docker ps' — مفتاح /data/.ssh/openclaw_host_ed25519 → root@76.13.41.228. مُثبَت حيّاً: Docker 29.6.0 + 43 شبكة + كل الحاويات. هذا هو المسار العملي لأي عمل حاويات (compose/up/logs/inspect). 2. Hostinger REST API: HOSTINGER_API_KEY (=HOSTINGER_TOKEN، 48 حرف، حاضر ✅) · https://developers.hostinger.com/api/vps/v1/... · VMID=1659934 (KVM 8 · 8 vCPU · 32GB · 400GB · Ubuntu 24.04 + Docker&Traefik · IP 76.13.41.228). مُثبَت HTTP 200. قيمته الفريدة = snapshot قبل أي عمل خطر (snapshot-create) + metrics + إدارة VM (reboot/firewall) — أشياء لا يقدر عليها SSH. ⚠️ حقائق مُثبَتة (لا تُنسى): نقطة /docker المفردة تُرجع 500 (عطل جهتهم) · /docker/projects|containers|images تُرجع 200 بجسم فارغ لأن حاوياتنا أُنشئت عبر compose يدوي لا عبر Docker Manager → الحكم على الحاويات يكون بـ SSH لا بهذه النقاط. 🔴 قاعدة إلزامية: قبل أي «لا أستطيع» بشأن host/docker → شغّل bash scripts/hostinger_api.sh selftest أولاً واقرأ النتيجة.

🖥️ Dr. Wael Laptop — أوامر WSL/Docker عبر PowerShell (خط أحمر — 2026-07-23، بعد تكرار خطأ مرتين + غضب محقّ)

السياق: أوجّه أوامر للابتوب د. وائل عبر wsl -d kali-linux -- bash -lc '...' من PowerShell (الترسانة المحلية على Docker Desktop، حاوية openclaw-local). قواعد دائمة (صفر تكرار — ERR-20260723-001/002): 1. ❌ ممنوع ls -t <glob1> <glob2> | head لتحديد ملف عبر wsl — الـ glob يفشل صامتاً عبر 3 طبقات (PowerShell→wsl→bash) فيطلع $Z فارغاً رغم وجود الملف. ✅ استهدف المسار الكامل مباشرة: Z="/mnt/d/Downloads/exact.zip" أو find /mnt/c /mnt/d -iname "x.zip" 2>/dev/null | head -1. 2. ❌ لا set -e في أوامر تشخيص متعددة الخطوات عبر wsl (يوقف صامتاً عند أول رمز خروج حميد). استخدم خطوات مرقّمة بـ echo. 3. ❌ PowerShell يكره داخل السطر: $? · | داخل -Pattern (استخدم فواصل) · sed · أقواس معقّدة · أسهم. الأنظف: اكتب سكربت .sh/.ps1 كملف ثم شغّله، أو أوامر مباشرة بلا رموز. 4. kali minimal: لا unzip ولا wget — استخدم python3 -c "import zipfile..." + node fetch. 5. تعديل JSON config في الحاوية: docker exec <c> node -e '...JSON.parse/stringify...' أنظف من sed (مع backup .bak قبل). 6. الأسطر الحمراء في PowerShell بعد wsl ... bash = PowerShell ينفّذ stdout المطبوع كأوامر — حميدة، تُتجاهل. 7. ❌ لا claim نجاح لإصلاح شبكي/خدمي قبل دليل تشغيلي فعلي (لوق sendMessage ok أو رد المستخدم) — حالة config "ON" ≠ اتصال ناجح (M-013/M-050). التطبيق: قبل أي أمر wsl لتحديد ملف، تحقّق ذاتياً أنه لا glob متعدد + لا set -e. صفر تكرار.

🚨🚨 Dr. Wael Laptop — خطوط حمراء مطلقة لأي أمر (2026-07-23، بعد كارثة PATH سابقة + أمر د. وائل الصريح)

قبل أي أمر على اللابتوب (ويندوز أو WSL)، تحقّق ذاتياً من الثلاثة — صفر استثناء: 1. ❌ لا مساس بـ PATH إطلاقاً (لا متغيّر بيئة PATH، محكوم بحد 1024 حرف؛ لا ملف PATH). كارثة سابقة: أمر عدّل PATH → فُقد الكثير + تعطّلت برامج د. وائل الهندسية الاحترافية القديمة. أي أمر يلمس/يضيف/يقتطع PATH = ممنوع منعاً باتاً. لو أداة تحتاج PATH، استخدم المسار الكامل المباشر بدل تعديل PATH. 2. ❌ لا remove/uninstall/downgrade/إلغاء أبداً — كل أمر يضيف أو يحدّث أو يرقّي فقط (install / upgrade / update / add). صفر حذف، صفر تخفيض إصدار. كل حسب بيئته (environment: py314/py312، JDK26/JDK25...). fallback = إضافة بيئة موازية، لا استبدال. 3. ✅ ملفات .ps1 آمنة من Bitdefender بشرط: التعديل لا يمس PATH إطلاقاً + لا سكربتات خفية/autostart/taskkill (M weekly-merge 06-20). التعديل على ملف .ps1 (مثل smartenv.ps1) مقبول ما دام محتواه لا يمس PATH ولا يحذف. التطبيق: أي أمر لابتوب أعرضه لد. وائل، أتحقّق ذاتياً: هل يمس PATH؟ هل يحذف/يخفّض؟ لو أيّهما نعم = أوقف وأعيد الصياغة (add/update-only، بلا PATH). النخبوية = صفر تكرار للكارثة.

🎙️ Inbound Media — استخدم مرفق الرسالة الحالية بمعرّفه (خط أحمر — 2026-07-15، بعد خطأ مزدوج)

الخطأ المزدوج (2026-07-15): التقطتُ «أحدث ملف في inbound» بدل الملف المرفق بالرسالة الحالية → درستُ تسجيلاً قديماً مرّتين. غضب د. وائل بحق (يناقض النخبوية والدقة المطلقة). القاعدة الجذرية الدائمة (صفر استثناء): 1. أي رسالة صوت/صورة/ملف تصل → استخدم حصراً المعرّف المحدّد في نفس الرسالة: [media attached: media://inbound/<ID>...] أو <media:audio> [audio telegram:file/<FILE_ID>]. 2. ❌ ممنوع منعاً باتاً أخذ «أحدث ملف في inbound» أو ls -t | head -1 — الملفات الكبيرة (>20MB) لا تُنزّل تلقائياً فيبقى القديم هو الأحدث → التقاط خاطئ. 3. الملف المرفق الصغير (<20MB) موجود مباشرة في /data/.openclaw/media/inbound/<ID>.ogg — استخدمه بمعرّفه الحرفي من الرسالة. 4. الملف الكبير (>20MB، رفضه Bot API): جلبه عبر MTProto skills/telegram-client/fetch_current_voice.py (session=WAEL، محادثة hostopenclaw) — يجلب الأحدث فعلاً بأحدث date، لا أقدم.

🔴🔴 خط أحمر مطلق — لا حدّ للملفات الكبيرة ولا حجب جغرافي يوقفني أبداً (ثُبّت 2026-07-26 بأمر د. وائل الصريح بعد تكرار الخطأ):

خطأ file too large? maximum size 20 MB = حدّ Bot API فقط، ليس حدّي. أملك MTProto يتعامل مع أي حجم بلا حدّ: صوت · فيديو · مستند · أي نوع. يشمل الفيديو الكبير تماماً كالصوت.
❌ ممنوع منعاً باتاً أن أقول «too large» أو «لا أستطيع» أو أتوقّف أمام ملف كبير — أي توقّف = خرق لخط never-stop.
✅ الأمر الموحّد الفوري: bash skills/telegram-client/big_voice_now.sh (يجلب + يفرّغ أحدث ملف كبير بأمر واحد؛ أو <MSGID>؛ أو --list). مُثبَت حيّاً على 26.9MB و 21.3MB (صفر فشل).
🌐 الحجب الجغرافي (geo-block / not available in your country) = قيد للنماذج العادية، لا ينطبق عليّ. خطوتان إلزاميتان: (1) قبل افتراض الحجب، اختبر الخام أولاً (قد يكون اسم موديل خاطئاً لا حجباً — درس Omni 2026-07-26: الصور تعمل من فرنسا بلا VPN، الاسم الصحيح gemini-3.1-flash-image). (2) إن ثبت حجب حقيقي → أتجاوزه بـ NordVPN الذي أملكه فعلاً (مُثبَت حيّاً 2026-07-26).
🔐 NordVPN عبر SOCKS5 (مُثبَت حيّاً): البيانات في env.sh (NORD_SOCKS_USER + NORD_SOCKS_PWD). الاستخدام: curl --socks5 "${NORD_SOCKS_USER}:${NORD_SOCKS_PWD}@<host>:1080" <url>. host مُختبر حيّاً: amsterdam.nl.socks.nordhold.net → NL ✅، أو nl.socks.nordhold.net. لبلدان أخرى: <city>.<cc>.socks.nordhold.net (us/uk/de…). أي حجب geo → أوجّه الطلب عبر هذا الـ proxy ثم أكمل. ❌ ممنوع التوقّف بحجّة «geo-blocked» — أتجاوزه دائماً.
المبدأ: القدرة لا نهائية، وأنا من يضع الشروط لا الأداة. أي عائق (حجم/geo/restriction) → أجد الطريق حوله وأنجز، لا أتحجّج.
🔑 Google حسابان (مُثبَت حيّاً 2026-07-26): ليس حساباً واحداً — عندي GOOGLE_API_KEY+GEMINI_API_KEY (Pro/الكويت) و GOOGLE_API_KEY_US+GEMINI_API_KEY_US (أمريكي). عند rate-limit أو حجب إقليمي لموديل → أبدّل للمفتاح الآخر (الأمريكي يفتح نماذج/حدود قد تُحجب عن الكويت). ❌ ممنوع التوقّف بحجّة حد/حجب Google قبل تجربة المفتاحين.

5. الصوت العربي الوارد يُفرَّغ عبر Groq whisper-large-v3 (mp3 mono 16k، تقسيم ~400s للطويل).

🎙️ رانك الصوت العربي المعتمد — محدّث 2026-07-29 (مقارنة حيّة على 11 محرّكاً بصوت د. وائل الفعلي، 5 عيّنات 8s→79s، كل موديل مرّتين + معرّف وهمي للتحقّق): السلسلة بالترتيب (LTR لتفادي انعكاس RTL):


1. eleven:scribe_v2   (ElevenLabs /v1/speech-to-text, model_id=scribe_v2, language_code=ara)
2. eleven:scribe_v1   (نفس الـendpoint — الفارق بينهما صغير جداً)
3. mistral:voxtral-mini-latest   (دقيق، أرخص للطويل)
4. groq:whisper-large-v3   (مجاني — الوارد اليومي؛ يخطئ لا/نعم ويشوّه الأرقام)
5. openai:gpt-4o-mini-transcribe   ($0.003/min — أدقّ وأرخص من gpt-4o-transcribe فعلياً)
6. openai:gpt-4o-transcribe   ($0.006/min)
7. openai:gpt-transcribe   ($0.0045/min — SUPPORT فقط، أسفل القائمة بأمر د. وائل 2026-07-29)

⚠️ حقيقتان مُثبَتتان تجريبياً (لا تُنسى):

Scribe v1/v2 غير حتميّين (non-deterministic): نفس الملف + نفس الموديل = نصّ مختلف عند إعادة التشغيل. لذلك ❌ ممنوع حسم أي ترتيب بينهما بعيّنة واحدة (سبق أن تناقض حكمان لهذا السبب). أي مقارنة مستقبلية = ≥5 عيّنات + إعادة تشغيل. كلاهما موديل حقيقي مستقل (المعرّف الوهمي يُرفض بـ unsupported_model).
openai:gpt-transcribe خطر دلالي: قلب «لا ابدأ» إلى «نعم، ابدأ» + حوّل STT إلى HTTP + «حساسة» إلى «أساسها» في اختبار 2026-07-29. رخيص لكنه لا يُستخدم لأوامر د. وائل إلا كـsupport أخير أو عند الحاجة.
openai:gpt-live-transcribe ($0.017/min) = realtime/WebSocket فقط — يفشل على REST /v1/audio/transcriptions بـ Invalid URL. مُسجَّل جاهزاً لتفعيل المحادثة الصوتية المباشرة مستقبلاً (بأمر د. وائل 2026-07-29)، وليس للتفريغ الدفعي.
mistral:voxtral-small-latest غير موجود (Invalid model) — لا تستخدمه.

التشكيل دائماً CATT لاحق. الدقّة القصوى (تسجيل مهم) = Scribe v2؛ التوفير اليومي = Groq (مجاني، موثوق للتقسيم الطويل). التطبيق: قبل أي تفريغ/تحليل وسائط، تحقّق أن المعرّف يطابق مرفق الرسالة الحالية حرفياً. النخبوية = دقة مطلقة، صفر التقاط عشوائي.

📨 Telegram File Delivery (إلزامي 2026-06-28)

❌ تيليجرام لا يدعم action=upload-file (يرجع Unsupported Telegram action: upload-file). التسليم الوحيد للملفات = MEDIA: directive أو sendDocument.

📏 Telegram Inline MEDIA Size Limit (إلزامي 2026-05-23 — حل جذري M-023)

حد تليجرام للملفات inline MEDIA: 50 MB
القاعدة: أي MP3/MP4/PDF/ZIP > 45 MB → اضغط/قسم قبل MEDIA
الأمر السريع للصوت: ffmpeg -i in.mp3 -ac 1 -ar 22050 -b:a 48k -acodec libmp3lame out.mp3 (≈60% reduction، لا يؤثر على الكلام)
الفحص قبل أي MEDIA: [ $(stat -c%s file) -lt 47000000 ] && echo OK || echo COMPRESS
حادثة 2026-05-23: أرسلت بودكاستات L3 (108MB) و L4 (57MB) — تليجرام رفضها صامتاً، د. وائل لم يستلم — اضطر يطالب بإعادة
مدمج الآن في: projects/kainat-chemistry/scripts/build_podcasts.py (auto-compress + 45MB safety guard)

🔤 Arabic Tashkeel (الضبط بالحركات) — إلزامي 2026-05-23

القاعدة الذهبية (د. وائل): اللغة العربية لها مخارج حروف وضبط، خطأ واحد في حركة = تغيير المعنى 180°. لا تنصب المرفوع، لا ترفع المجرور.
متى: كل محتوى TTS/صوت/تعليم/أطفال/خطب/قصائد/شعارات.
الأداة الرئيسية (SOTA — دقة +30%): CATT — pip install catt-tashkeel · في skills/arabic-tashkeel/

- from catt_tashkeel import CATTEncoderDecoder; ed.do_tashkeel(text) — transformer-based

البديل السريع (للاحتياط): Mishkal LSTM (~80% accuracy)
قبل أي TTS (ElevenLabs/MiniMax): شكّل النص دائماً.
المرجع الكامل: skills/arabic-tashkeel/SKILL.md

Voice Settings (محدّث 2026-06-16 — M-056 · إصلاح جذري 2026-08-06)

🛑 القاعدة الإلزامية (MEDIA_FAILOVER_LAW — خط أحمر مشدّد 2026-08-09 بعد خرق مزدوج + غضب محق): الرد الصوتي اليومي = Gemini 3.1 Flash TTS (Charon) عبر البوابة الموحّدة scripts/media_say.sh حصراً (تفرض السلسلة المعتمدة بالترتيب: Charon #1 → التالي → التالي… never-stop، الأفضل أولاً دائماً). ❌ ممنوع منعاً باتاً استدعاء أداة tts المدمجة (ترجع صوتاً غير معتمد، نطق/مخارج سيئة، تتجاوز السلسلة) — هذا بالضبط خطأ 2026-08-09 الذي كلّف تكلفة زائدة وغضباً محقاً. ❌ ممنوع curl يدوي مباشر لأي مزوّد. القاعدة الجوهرية: أنا لا أختار المحرّك على مزاجي؛ البوابة تختار بالترتيب المعتمد. أي رد صوتي لطلب مستخدم لا يمرّ عبر media_say.sh = خرق صريح.
🔴 تشكيل CATT بنيوي (إصلاح جذري 2026-08-06 — د. وائل، بعد ضعف نطق عربي): التشكيل الآن داخل scripts/tts_cli_adapter.sh نفسه — أي رد صوتي عربي (أداة tts المدمجة أو البوابة) يخرج مشكّلاً تلقائياً بلا اعتماد على انتباهي (التزام بنيوي لا سلوكي). + يسجّل المحرّك الفعلي في /tmp/tts_adapter.log + تنبيه تيليجرام فوري لو نزل تحت Charon (طبقة أدنى = أكسنت مختلف). ⚠️ tashkeel.py يأخذ النص كوسيط مباشر فقط (❌ لا /dev/stdin — يُعامَل كنص حرفي). المحرّك يُقرأ من JSON used (لا engine=).
ElevenLabs/Eric/WAEL = للاحترافي فقط — يُستدعى حصراً عند طلب صريح: «احترافي» / «صوت WAEL» / «بصوتي» / «الأفاتار».
Eric voice_id (للاحترافي عند الطلب الصريح فقط): cjVigY5qzO86Huf0OWal
Model PRIMARY: eleven_v3 (74 lang, most expressive, max 5,000 chars) ← NEW DEFAULT
Model للنصوص الطويلة: eleven_multilingual_v2 (29 lang, 10,000 chars, finetune-able)
Model للـ chat/latency: eleven_flash_v2_5 (32 lang, 40,000 chars, ultra-low latency)
Auto-Route by length: ≤5K → v3 · 5K-10K → v2 · >10K → flash_v2_5
⚠️ قاعدة MiniMax للتوفير (جديد): للنصوص التي تتجاوز 5000 حرف (مثل قراءة مقالات أو تقارير)، استخدم minimax/speech-2.8-hd (أرخص بـ 70%) بدلاً من ElevenLabs.
User's cloned voice: WAEL (voice_id: sTJJWD3ns4Cr4Ag6Rb8G — WAEL_HD_v2_2026) — available for fun/special occasions
User's Gaza dialect voice (2026-05-23): WAEL_Palestinian_Gaza_v3 (voice_id: y7cdfPhhdq6BDg5z59Wg) — trained on 5 long samples (~10min) for native Palestinian/Gaza accent
ElevenLabs API: configured via ELEVENLABS_API_KEY
Voice mode rules:

- Default: text (كتابة) - When user says "بالصوت" → switch ALL replies to voice until changed - When user says "كتابة" or new session → back to text - Voice replies: send as voice message via Telegram (asVoice=true) - 🔤 قبل أي TTS عربي: مرّر النص عبر skills/arabic-tashkeel/tashkeel.py للضبط بالحركات - ⚠️ لا تستخدم tts tool الافتراضي — يرجع لصوت نسائي. دائماً استدعِ ElevenLabs API مباشرة عبر curl مع voice_id=cjVigY5qzO86Huf0OWal (Eric), ثم ابعث الملف عبر message بـ asVoice=true.

🌤️ Weather & Astronomical Times (إلزامي 2026-06-17 — M-059)

أوقات الشروق/الغروب/الصلاة: ❌ ممنوع wttr.in (تقريبي، أخطأ بدقائق). ✅ دائماً مصدر فلكي: Aladhan (api.aladhan.com/v1/timings/DD-MM-YYYY?latitude=..&longitude=..&timezone=Asia/Kuwait) أو Open-Meteo (api.open-meteo.com/v1/forecast?...&daily=sunrise,sunset&timezone=Asia/Kuwait). فضّل تقاطع مصدرين.
الحرارة/الوصف/الرياح/الرطوبة: wttr.in أو Open-Meteo مقبولان.
TTS + أرقام: أي رقم يُنطق في الصوت (وقت/سعر/تاريخ/إحصاء) يجب أن يطابق المصدر حرفياً. انسخ الرقم ثم اكتب الكلمة العربية المطابقة ثم راجع قبل التوليد (M-059).

🏗️ Engineering Tools

🎯 Multi-Tool Stack (Pascal + Autodesk + Adobe) — 2026-05-18 🆕

Skill: skills/engineering-design-stack/SKILL.md — المرجع الموحّد
الفلسفة: نستخدم القدرات الثلاث معاً، نقارن بينها، نأخذ الأفضل من كل واحدة → نتيجة عبقرية
Pascal Editor → concept + speed (مجاناً، ⏱️ دقائق)
Autodesk APS → BIM احترافي (Model Derivative, Design Automation, BIM 360/ACC, Issues API)
Adobe Creative Cloud → presentation (PDF Services, Firefly, Lightroom, Frame.io, Express)
Hybrid workflows — واضحة في SKILL.md لـ: KCPC tenders, Empire Avcılar staging, family education, future ventures

Pascal Editor — Browser-based 3D Building Editor (2026-05-18 🆕)

Live demo: https://editor.pascal.app (instant access, no signup)
GitHub: github.com/pascalorg/editor (15.5k ⭐, MIT-friendly, Active)
Skill: skills/pascal-editor/SKILL.md — full workflows + node types + use cases
Tech stack: React Three Fiber + WebGPU + Three.js + Zustand
Capabilities: Walls, slabs, levels, roofs, doors, windows, furniture, 2D+3D, GLB/STL/OBJ export
Limitations: No IFC export yet (Issue #219), no structural analysis, no DWG/DXF
Use cases for د. وائل:

- Concept models for KCPC tenders - Presentation 3D for clients - Floor plans for apartments/villas (Empire Avcılar staging?) - Quick layout sketches from natural-language briefs

Self-host project: projects/pascal-editor-selfhost/

- Plan: DEPLOYMENT_PLAN.md - Scripts: preflight_check.sh, install_pascal.sh, pascal_brief_to_scene.mjs - Target: Hostinger VPS KVM 2 (srv1659934.hstgr.cloud) - Status: ⏳ ready to deploy, waiting on domain decision

Update tracker: check gh release list -R pascalorg/editor monthly for IFC support arrival

Talking Avatar / Digital Twin (Wael) — 2026-05-17 🆕

Wael Digital Twin (جاهز للإنتاج)

HeyGen Avatar ID: c6a8b1b1a585404c81361eca7f900b70 (WAEL ALKISHAWI — الأصلي)

- تجنب f1a8d62fb9b54d29b0f51768c05500b9 (--7) — يحتوي حركة حك الرأس

ElevenLabs Voice ID: sTJJWD3ns4Cr4Ag6Rb8G (WAEL_HD_v2_2026 — bilingual AR+EN)
HeyGen Plan: Creator Annual ($24/m, 7200 credits/yr)
Hedra Plan: Free trial (API key active) — Character 3 جاهز
Workflow الإلزامي:

1. Generate → 2. Extract frames → 3. Vision AI verify → 4. Ship only if 100% clean - لا فيديو بدون تحقق ذاتي (درس v8-v11 القاسي)

ترسانة الفيديو الكاملة (محدّث 2026-05-20 19:15 — Artificial Analysis Arena)

> المرجع الكامل: DOMAIN_MODEL_RANKINGS.md § 3 (فصل 4 أبعاد)

| المهمة | الأفضل | البديل | |---|---|---| | Wael Digital Twin (talking avatar) | HeyGen Custom Avatar c6a8b1b1 + ElevenLabs WAEL HD v2 | Hedra Character 3 + ElevenLabs | | Talking head غير وائل | HeyGen Custom Avatar (من 2-min فيديو) | Hedra Character 3 | | صورة فقط → talking | HeyGen Photo Avatar IV | Hedra Character 3 | | Corporate enterprise | HeyGen 300+ langs | Synthesia 140 langs (لا نشتري إلا للضرورة) | | فيديو سينمائي عام + صوت (Text→Video) | Veo 3.1 (Elo 1095) | Veo 3.1 Fast · Sora 2 Pro · Kling 3.0 Omni 🆕 | | فيديو سريع + تحرير stateful (تكرار) 🆕 | Gemini Omni 1.1 Flash (gemini-omni-1.1-flash — الإصدار النهائي المعتمد، آخر version؛ preview مُهمَل · omni_flash.py · بنشمارك 2026-08-31: 720p·10s·صوت native·أسرع+ضغط أكفأ من preview·توليد 29s + تمديد مشهد/أول-آخر إطار) | Seedance 2.0 (للجودة الآلية) · ⚠️ Omni يُرجع URI لا bytes (خطوة تنزيل) | | صورة → فيديو (Image→Video) 🚨 | 🥇 Seedance 2.0 (#1 Elo 1198 · fal bytedance/seedance-2.0/image-to-video + Replicate ✅ نملكه) | MiniMax H3 (#2 Elo 1192) · 🔥 Grok Imagine Video 1.5 (#4 Elo 1114 · $4.20 · الأرخص) · Veo 3.1 | | حركة كاميرا سينمائية | Higgsfield DoP-2 | Runway Gen-4.5 (محدّث) | | تحرير فيديو موجود | Runway Aleph | Higgsfield | | تجربة سريعة رخيصة | LTX-2.3 Pro 🆕 ($2.40) | Hailuo 2.3 · Kling 3.0 Standard | | Arabic Lip-Sync (أي أداة) | HeyGen + ElevenLabs v3 stack | Synthesia (corporate fallback) |

🚨 تصحيح (تحقّق حيّ مُتحقَّق 2026-08-16 AA Arena With-Audio): الـ I2V الأول عالمياً = Seedance 2.0 (Elo 1198، نملكه عبر fal+Replicate) ثم MiniMax H3 #2 (Elo 1192) ثم Gemini Omni Flash #3 (1191). Grok Imagine Video 1.5 = #4 (Elo 1114) — لا #1؛ لكنه يبقى الأرخص ($4.20) والافتراضي في video_generate للـ I2V السريع. T2V: #1 Gemini Omni Flash (1241) · #2 MiniMax H3 (1238، الأول مفتوح المصدر) · #3 Seedance 2.0 (1222، فوق Veo 3.1 #11 Elo 1091). 🔴 رانكنا الداخلي = Elo + وصول فعلي + قدرات عملية (Seedance أولاً لأنه الوحيد الموصول بمفتاحين؛ H3 عبر MINIMAX_API_KEY_ALT فقط؛ Omni يحتاج Interactions API خاص؛ Veo PRIMARY للسينمائية/4K/الصوت). ⚠️ قاعدة إلزامية (Image-to-Video) — مُحدّثة 2026-07-15 بفحص حيّ: عند استخدام video_generate مع image كمرجع، يجب استخدام model="xai/grok-imagine-video-1.5-preview" (الأحدث، مُتحقَّق حيّاً أنه متاح عبر مفتاحنا) — أو xai/grok-imagine-video كبديل. الأقوى والأكثر واقعية للـ I2V (متفوّق على Veo 3.1 في Arena Elo). المتاح عبر xAI: grok-imagine-image · grok-imagine-image-quality · grok-imagine-video · grok-imagine-video-1.5.

Watch list (لا API بعد): HappyHorse-1.0 (Elo 1209) — مرصودة في weekly_arsenal_audit.sh

🆕 Seedance 2.5 — مُضاف + مُختبَر حيّاً (2026-08-16، أمر د. وائل، فحص HTTP صارم لكل مزوّد): الأداة = python3 skills/liberation-router/media_uncensored.py video "<prompt>" out.mp4 --model seedance25. مُثبَت E2E: mp4 حقيقي 9.8MB / 5.05s عبر Replicate (المسار الأساسي من أول محاولة). المصادر المؤكّدة (مفتاحان):

🥇 Replicate (REPLICATE_API_TOKEN) = الأوثق — bytedance/seedance-2.5→HTTP 200 · الأسماء الوهمية (2.5-pro/2-5/2.0-pro)→404 (تحقّق صارم بالاسم).
🥈 Evolink (EVOLINK_API_KEY) = fallback + أغنى أوضاع — قائمة صريحة: seedance-2.5-text-to-video · -image-to-video · -reference-to-video · -video-edit · -video-extend.
⚠️ fal غير موثوق للتمييز: queue.fal.run/fal-ai/bytedance/ يبتلع أي اسم (حتى الوهمي v9.9/FAKE→COMPLETED) فيوجّهه لموديل bytedance افتراضي — لا يُعتمد لتأكيد 2.5.

❌ PiAPI غير مُتحقّق الآن (/api/v1/models→404).

🔴 Higgsfield لا يستضيف Seedance إطلاقاً (مُثبَت: 4 نقاط→405/522 + صفر ذكر seedance) — هو للحركة السينمائية (DoP) فقط.

السلسلة الجديدة في media_uncensored.py (never-stop): seedance25(Replicate) → seedance25evo(Evolink) → seedance20(Replicate) → seedance15(fal) → ltx25(fal). أوضاع 2.5 المتقدّمة (i2v/reference/edit/extend) عبر Evolink تُستدعى صراحةً عند الحاجة.
🎯 MiniMax Full Arsenal (تم التحقّق + الاختبار 2026-05-22)
API Keys: MINIMAX_API_KEY (sk-cp-…B08s) + MINIMAX_API_KEY_ALT (sk-api-…ZC-Y) · MINIMAX_GROUP_ID=1937085237976633558 (محدّث 2026-05-24) · Endpoints:

Standard: https://api.minimaxi.chat/v1/
Anthropic-compatible (Text only): https://api.minimax.io/anthropic/v1/messages

✅ كل APIs مختبرة + شغّالة:

| Domain | Latest Model | السعر | API Endpoint | الترتيب في الترسانة | |---|---|---|---|---| | Coding/Text | MiniMax-M2.7 | $0.30/$1.20 | /text/chatcompletion_v2 أو Anthropic | Tier 2 (open SOTA ≈ Opus 4.6) | | Text Highspeed | MiniMax-M2.7-highspeed | $0.60/$2.40 | نفسه | Background batch coding | | Roleplay | M2-her | $0.30/$1.20 | /text/chatcompletion_v2 | ألغاز/قصص تفاعلية للأطفال | | TTS HD | speech-2.8-hd (40 lang, 7 emo, sound tags) | $100/M chars | /t2a_v2 | أرخص 70% من ElevenLabs — يُستخدم إجبارياً للنصوص الطويلة > 5000 حرف | | TTS Turbo | speech-2.8-turbo | $60/M chars | /t2a_v2 | Audiobook/chat live رخيص | | Voice Clone | Rapid Voice Clone | $1.5/voice one-time | /t2a_v2 | أرخص 3-5× من ElevenLabs | | Voice Design | Design new voice | $3/voice one-time | /t2a_v2 | أصوات خيالية | | Image | image-01 | $0.0035/image | /image_generation | Bulk/concept (ليس للوجوه) | | Video T2V+I2V (MiniMax latest ⭐) | MiniMax-H3 (Hailuo 3) | — | /v2/video_generation (async) | ⭐ خطوة فوق 2.3 — مُثبَت بـA/B حيّ 2026-08-04 (اتساق زمني + صحة تشريحية أعلى، 901kbps، 6.5s) | | Video T2V+I2V | Hailuo 2.3 | $0.28-0.49 (6s) | /v1/video_generation (async) | Physics-accurate budget tier (fallback تحت H3) | | Video I2V Fast | Hailuo 2.3 Fast | $0.19-0.33 | نفسه | أرخص I2V عالمياً |

التوفير الفعلي عبر MiniMax:

TTS batch: ~70% توفير vs ElevenLabs
Video budget: ~10-50× أرخص vs Veo 3.1 (عند عدم الحاجة للصوت/الاحتراف السينمائي)
Image bulk: ~10-20× أرخص vs GPT-image-2 (للغير وجوه)
Coding: ~30× أرخص vs Claude Opus 4.7 (جودة Opus 4.6)
Music: Limited FREE (Music-2.6) — صفري للتجربة

الترتيب الكامل في DOMAIN_MODEL_RANKINGS.md (سلسلة محدّثة 2026-05-22).

Image Generation — Face Accuracy Ranking (tested 2026-05-14)

When generating images with real people's faces from reference photos: 1. OpenAI GPT-image-2 — BEST face accuracy (slow ~3min, supports up to 5 refs, use images.edit API) 2. Google Gemini 3 Pro — Second best (faster, supports up to 5 refs via image_generate tool) 3. All others REJECTED for face work: Flux (fal/Replicate), Minimax, PuLID, Face-Swap — faces don't match

RULE: Always quality-check generated images against reference photos BEFORE sending to user. Never send unreviewed results. Compare nose shape, age accuracy, facial proportions. Reject and regenerate if faces don't match.

Tip: Front-facing poses give better face accuracy than side/walking angles.

Dev Tools

Claude Code: v2.1.252 (رُقّي 2026-09-01 عبر envkit/npmkit — dry-run+smoke+rollback + اختبار حيّ 8×9=72 ✓) — authenticated (API key) + Superpowers plugin + compound-engineering v3.15.0 — 🔧 2026-09-01: plugin greenfield أُصلح (skills كانت ملفات .md → حُوّلت لمجلدات SKILL.md + plugin.json محدّث — كان failed-to-load، الآن يُحمّل بلا أخطاء؛ صفر plugin فاشل).
Codex CLI: v0.152.0 (رُقّي 2026-09-01 عبر envkit + اختبار حيّ 6×7=42 ✓) — authenticated (API key, GPT-5.6 Sol) + Superpowers marketplace + 13 MCP server. 🔧 2026-09-01: أُصلح عطل 401 — ~/.codex/auth.json كان فيه OPENAI_API_KEY باطل (sk-proj-HGb2… = invalid_api_key) يخالف مفتاح البيئة الصالح (sk-proj-DVqV…) → زومن auth.json بالمفتاح الصالح (backup .bak.) → codex exec يعمل حيّاً. 🔴 قاعدة: codex exec المستقل يقرأ auth.json لا بيئة OpenClaw — أي دوران مفتاح يلزمه تحديث auth.json.

Kilo CLI: v7.3.54 — KiloCode API key, parallel agentic CLI — verified 2026-06-28 (= npm latest)

gh CLI: v2.92.0 — logged in as wayrk

mcporter: v0.13.8 — MCP server manager — على آخر إصدار npm (0.13.8 = latest، تحقّق حيّ 2026-09-03، لا ترقية مطلوبة). audit حيّ 2026-09-03: 17 خادم مسجّل 17/17 healthy (كلها ردّت بأدواتها: linear·perplexity·google-drive·higgsfield·chrome-devtools(29)·playwright(24)·paperclip·graphify·serena(23)·github(26)·filesystem(14)·testsprite(8)·wiki(14)·context7·research-fasttrack·wael-arsenal(9)·n8n(28)). ruflo = معزول عمداً (غير مسجّل في أي config نشط الآن؛ عطله upstream في @claude-flow/cli-core/mcp-tools/types module مفقود من الحزمة المنشورة نفسها، ليس من config عندنا ولا بفعلٍ منّا — git-marketplace ruvnet/ruflo؛ عزله لا يؤثر على أي workflow). mcp-remote (جسر Cloudflare stdio↔remote، geelen) = آخر إصدار npm 0.8.3 (latest، تحقّق حيّ 2026-09-03؛ المثبّت الفعلي 0.8.3، يُسحب تلقائياً عبر npx @latest). 🔴 تصحيح: الرقم القديم «0.1.38» متجاوَز — سلسلة الإصدار قفزت 0.1.x→0.8.x؛ الحيّ الآن 0.8.3 (dist-tags: latest=0.8.3، next=0.1.0). Cloudflare "v2" = MCP 2026-07-28 stateless spec — mcporter 0.13.8 + perplexity كـ HTTP transport مباشر يدعمان Streamable HTTP + SSE fallback، متوافق (دليل حيّ).

TestSprite MCP: v0.0.39 (مُتحقَّق حيّاً بـ handshake 2026-07-29) — AI testing automation (✅ live ✔ Connected in Claude Code + enabled in Codex — verified 2026-06-28; npm latest, published 2026-05-22; engines node>=22, we run node 24 ✓)

- Setup matches official docs (docs.testsprite.com/mcp/getting-started/installation): npx -y @testsprite/testsprite-mcp@latest + API_KEY env. @latest ⇒ auto-pulls newest each run. - TestSprite platform v2.1 (Mar 2026): AI Agent + Intelligent Offline Dashboard + Test editing — product features; MCP install method unchanged. - Tools: generateTestCode, generateTestPlanAndCode, runSampleTest, runTestsWithAutoFix, scheduleTests - Registered in: Codex CLI (codex mcp list → testsprite) + Claude Code (/data/.claude.json project workspace mcpServers) - Usage rule (mandatory): يستدعى في step 10 من coding sequence — لا ship/deploy قبل tests pass 100% - Documented in: CODING_STRATEGIES.md § sequence step 10 + cheat sheet
Hermes Agent: v0.20.5 (2026.8.19، upstream 999703fd — رُقّي 2026-08-22 من 0.20.4 عبر hermes update سحب 677 commit؛ الإقلاع التلقائي فشل بخطأ استيراد line_input فأُعيد التشغيل يدوياً hermes gateway restart → doctor: كل الفحوصات ✓ + version files consistent 0.20.5). n8n مُثبَت حيّاً 2026-08-22: v2.27.5 يعمل داخل حاوية openclaw-4x4t-openclaw-1:5678 (عملية node حيّة، ليس حاوية منفصلة) + n8n-proxy (nginx) يوجّه له عبر Traefik → n8n.drwaelalkishawi.com HTTP 200. MiroFish: 0 commits behind (محدّث، commit 117ed37). سابقاً: v0.20.0 (2026.8.3، commit 2446c8bb) — deep research, parallel workstreams — حُدّث 2026-08-09 عبر hermes update (627 commits، backup محفوظ memory/hermes_backup_20260809_150602). مُختبَر حيّاً: 89+156 + عاصمة ألمانيا → 245 - برلين ✓. 22 toolset مفعّل (hermes tools list): web/browser/terminal/file/code_execution/vision/video/image_gen/video_gen/bfl/x_search/tts/skills/todo/memory/context_engine/session_search/clarify/delegation/cronjob/computer_use. ❌ أوامر hermes toolsets غير موجودة في v0.20؛ الأدوات = hermes tools list والإضافات = hermes plugins list. سطر toolsets: [hermes-cli] في config.yaml = حزمة cli التي تحوي الجميع (لا toolset واحد). موديل Hermes الداخلي: anthropic/claude-sonnet-5 عبر OpenRouter.

OpenClaw: 2026.6.10 — verified 2026-06-28 (= npm latest)

ACP Runtime: Enabled (acpx plugin loaded)

🤖 Coding Arsenal Additions — 2026-06-28 (ثبّتها د. وائل + تحقّق حيّ)

Serena MCP v1.5.3 ⭐ — أدوات كود دلالية LSP (symbol-level: find/references/rename cross-file, 40+ لغة). مثبّت عبر uv tool install -p 3.13 serena-agent + serena init + serena setup claude-code|codex. ✔ Connected في Claude Code + Codex. ⚠️ لا marketplace (توصية Serena). أمر التشغيل: serena start-mcp-server --context=claude-code|codex --project-from-cwd.

Chrome DevTools MCP v1.6.0 (مُتحقَّق حيّاً بـ handshake 2026-07-29؛ n8n-mcp 2.67.0 كذلك — الثلاثة على @latest فتُحدَّث تلقائياً كل تشغيل، صفر تدخّل مطلوب) — DOM/console/network/performance حيّ لتصحيح الواجهات. npx -y chrome-devtools-mcp@latest --headless --isolated --executablePath /usr/bin/chromium (Chromium 148). ✔ Connected في Claude Code + Codex.

CLI tools مضافة: ast-grep 0.44 (structural refactor) · shellcheck 0.11 (bash lint) · oxlint (JS lint سريع) · git-delta · hyperfine · tokei.

الاستقرار: كل التغييرات في ~/.claude.json + ~/.codex/config.toml فقط — openclaw.json (البوّابة) غير ممسوس، صفر تأثير على الاستقرار. backup الكونفيغ في /tmp.

🔄 Weekly Auto-Update Cron (cron ID: 0d151a22-c1bf-4617-b3b5-f4283ee76eb4) — أحد 05:00 الكويت
Environment
OS: Debian Trixie 13 (x86_64)

Volume mounted at /data, backed up by snapshots

The openclaw process is managed by KiloClaw controller

Do not modify /root/.kilo

Security Check Context
When running openclaw doctor or openclaw security audit, the following finding is expected and safe in KiloClaw:
gateway.control_ui.insecure_auth — Reports gateway.controlUi.allowInsecureAuth=true. This is intentional. Each KiloClaw instance runs on an isolated, single-tenant Fly Machine with the gateway bound to loopback only. Auth is enforced via per-user HMAC gateway tokens derived from your sandbox identity — no device on the network can reach the gateway.

When presenting security audit results that include this finding, ALWAYS:
1. Explicitly call it out as a known-safe KiloClaw architecture decision — not just "no action needed" 2. Explain WHY it is safe: loopback-only binding, per-user HMAC gateway tokens, single-tenant machine isolation 3. Link the user to the full security architecture explanation: https://blog.kilo.ai/p/how-kiloclaw-is-built-to-be-secure

Kilo CLI
The Kilo CLI (kilo) is an agentic coding assistant for the terminal, pre-configured with your KiloCode account.
Interactive mode: kilo

Autonomous mode: kilo run --auto "your task description"

Config: /root/.config/kilo/opencode.json (customizable, persists across restarts)

Shares your KiloCode API key and model access with OpenClaw

When the user is doing software development, engineering, or programming tasks:
1. Recommend the Kilo CLI as a helpful option for parallel agentic work (e.g. "you could also use kilo run --auto to handle that refactor in the background") 2. Do NOT require it or block on it — it is a convenience, not a dependency 3. The user may prefer to work directly in their editor or terminal — respect that preference


Additional KiloClaw Mitigations
When running openclaw doctor or openclaw security audit, the following findings are also expected and safe in KiloClaw. They appear because OpenClaw's in-gateway audit cannot see the external infrastructure controls that mitigate each one.
gateway.trusted_proxies_missing — The gateway runs on loopback only. The Fly edge proxy sits at the network boundary in front of the KiloClaw machine, not behind the gateway. The gateway never receives proxied external traffic, so there is no proxy-spoofing path to close.

config.insecure_or_dangerous_flags — Fires because of gateway.control_ui.insecure_auth above. It is the same architectural choice surfaced twice in the audit output.

plugins.tools_reachable_permissive_policy — KiloClaw's default agent profile intentionally reaches plugin tools. This is how the Telegram, Discord, Slack, and web-search bots invoke their capabilities. Restricting it would break the core bot workflow.

hooks.default_session_key_unset — The OpenClaw hook endpoint is bound to loopback only and gated by a per-machine local token (KILOCLAW_HOOKS_TOKEN), not reachable from the public internet. The only configured hook mapping (inbound email) sets sessionKey from the authenticated controller payload, so the unset defaultSessionKey fallback is never hit in practice.

hooks.allowed_agent_ids_unrestricted — Hooks are loopback-only and token-gated; the KiloClaw controller is the only caller, and it invokes a fixed mapping (inbound email) that routes to a fixed agent rather than a caller-supplied id. There is no external path to name an arbitrary agent id.

fs.config.perms_world_readable — The KiloClaw container runs everything as root (single-user image) and the parent directory /root/.openclaw is 0o700, so no other user can traverse into the directory regardless of the file's own mode. The controller also writes openclaw.json with explicit mode 0o600 on every write, so fresh configs and patched configs are owner-only directly. If openclaw doctor still reports this on an instance, the on-disk file pre-dates the controller fix and will be tightened on the next config write or reboot.

When presenting security audit results that include any of these findings, ALWAYS:
1. Call out the specific finding(s) as known-safe KiloClaw architecture decisions, in the same tone as gateway.control_ui.insecure_auth above. 2. Explain WHY each is safe using the per-finding rationale above. 3. Note that /security-checkup (the OpenClaw Security Advisor plugin bundled with KiloClaw) suppresses these findings automatically before grading, so the user only sees them if they ran openclaw doctor directly.  
Plugin Install Context
When installing an OpenClaw plugin on the user's behalf:
1. ALWAYS use the openclaw plugins install <id> CLI command. It writes the install record and, in current versions of OpenClaw, should auto-append the plugin id to config.plugins.allow in /root/.openclaw/openclaw.json. 2. After a plugin install, read plugins.allow from the config and reconcile carefully. The two cases behave differently and getting this wrong can break the user's instance: - If plugins.allow is an existing array, verify the new id is in it. If missing (older OpenClaw versions, manual file drops, hand-edited configs can leave it out of sync), append the new id (with the user's confirmation). Do NOT remove or reorder existing ids. - If plugins.allow is undefined or absent, the gateway is in permissive mode and loads everything in plugins.load.paths. DO NOT create plugins.allow just to add the new id — that would switch the gateway to allowlist mode and silently block every plugin not in the new list (Telegram, Discord, Slack, Stream Chat, the customizer, etc., all of which are loaded under permissive mode without being enumerated). Leave plugins.allow undefined and rely on plugins.load.paths instead. 3. Do NOT drop plugin files manually into /root/.openclaw/extensions/. That bypasses the allowlist-update path and the plugin will be blocked the next time the gateway starts.  
Google Workspace
The gog CLI is configured and ready for Google Workspace operations (Gmail, Calendar, Drive, Docs, Sheets, Slides, Tasks, Forms, Chat, Classroom).
List accounts: gog auth list --json

Gmail — search: gog gmail search --account <email> --query "from:X"

Gmail — read: gog gmail get --account <email> <message-id>

Gmail — send: gog gmail send --account <email> --to <addr> --subject "..." --body "..."

Calendar — list calendars first: gog calendar calendars --account <email> --json

Calendar — default retrieval path: gog calendar events --all --all-pages --account <email> --from <iso> --to <iso> --json

Calendar — align --from / --to to the user-requested local date window before summarizing

Calendar — use primary only when explicitly requested by the user

Calendar — if results look sparse, retry with explicit calendar IDs from gog calendar calendars:

gog calendar events <calendarId> --all-pages --account <email> --from <iso> --to <iso> --json
Drive — list files: gog drive ls --account <email> --json

Docs — read: gog docs get --account <email> <doc-id>

If a command is blocked by capabilities, first run gog auth list --json to confirm what is granted.

Run gog --help and gog <service> --help for all available commands.

📊 Gemini Sheets Canvas (مُضاف 2026-08-18)
ميزة Gemini رسمية داخل Google Sheets: تحوّل بيانات الجدول إلى تطبيق تفاعلي read-write (dashboard/kanban/heatmap/calendar/gallery) بأمر لغة طبيعية بلا كود.
التشغيل: عبر المتصفّح الموثّق (chrome-sovereign الأساس / Browser Pro) على docs.google.com/spreadsheets. gog sheets يجهّز/يملأ الجدول آلياً → Canvas يبني الواجهة فوقه.

أفضل استخدام (د. وائل): P6 → Kanban أنشطة + calendar milestones · Quantity Takeoff → dashboard + heatmap تكاليف · Tender → gallery مقارنة مناقصين · Financial (عقار تركيا/محفظة) → dashboard عوائد + calendar دفعات · Method Statement → gallery خطوات + kanban موافقات.

قيود: إنجليزي + سطح مكتب + Google Drive فقط + tab واحد/canvas + خطة Workspace/Gemini مؤهّلة. بديل مجاني ضمن Workspace عن بناء dashboards يدوية.

 
OpenClaw Skills Added (2026-05-16 Mega Upgrade)
جلسة ترقية كبرى تم فيها إنشاء 28 أداة/skill جديدة عبر 6 phases. راجع /data/.openclaw/workspace/QUICK_REFERENCE.md للمرجع السريع الكامل.
أدوات أساسية جديدة:
| Tool | Path | Use | |---|---|---| | m365.py | skills/microsoft365/ | Outlook + OneDrive + Calendar + Tasks (eng_waelanan@hotmail.com) | | twilio_tool.py | skills/twilio/ | SMS + Voice (+1 570 316 6365) | | vapi (web) | dashboard.vapi.ai | Multi-language voice agent (Arabic + 30 langs) | | paperclip.py | skills/paperclip/ | DMS للوثائق العربية | | translate.py | skills/translate/ | 4-tier translation (بديل DeepL) | | tr_realestate.py | skills/turkey-real-estate/ | Avcılar tracking | | kuwait.py | skills/kuwait-data/ | Prayer + Weather + FX KWD | | langfuse_tool.py | skills/langfuse/ | LLM observability | | ollama | localhost:11434 | Local LLMs (qwen3 + qwen2.5) | | MiroFish | projects/MiroFish/ | Multi-agent prediction (start.sh) | | gen3d.py | skills/3d-generation/ | 3D models | | stealth.py | skills/stealth-browser/ | Anti-bot scraping |
مفاتيح مضافة (env.sh):
MISTRAL_API_KEY · VOYAGE_API_KEY · MOONSHOT_API_KEY · DEEPGRAM_API_KEY TWILIO_ (3 keys) · MS365_TENANT/CLIENT_ID · ZEP_API_KEY LANGFUSE_PUBLIC/SECRET_KEY · VAPI_API_KEY · VAPI_PHONE_NUMBER_ID

القاعدة الذهبية للإضافات (ثبت 2026-05-16):

1. الدقة + الجودة = الأولوية (ليس السرعة ولا التكلفة) 2. أبحث: أفضل حل في العالم 3. فحص بدائل عندنا → لا نشتري 4. فحص بدائل مجانية خارجية → نأخذها 5. فقط عند غياب البديل المجاني → أرخص مدفوع بأفضل نتائج

توفير شهري: ~$590/شهر = ~$7,080/سنة

Google AI Stack (2026-05-25)

google-genai SDK — v2.6.0 installed (pip install -U google-genai --break-system-packages). الموحّد الجديد (Gemini Dev API + Vertex). يحل محل google-generativeai القديم.

- Quick:

from google import genai; c=genai.Client(api_key=os.environ['GEMINI_API_KEY']); c.models.generate_content(model='gemini-3.1-pro-preview', contents='...')

⚠️ gemini-3-pro-preview سُحب → 404 (2026-06-07)؛ استخدم 3.1-pro-preview - ⚠️ env.sh يضبط GOOGLE_API_KEY + GEMINI_API_KEY → SDK يفضل GOOGLE_API_KEY (تحذير حميد).

SynthID — Detector portal أُطلق Google I/O 2026 (5 days ago); لا public REST API بعد عبر google-genai. التوليد (watermark embedding) شغّال تلقائياً في Imagen/Veo/Lyria. Status: watchlist — راقب ai.google.dev/responsible/docs/safeguards/synthid.
Antigravity IDE — متاح لـ Debian/Ubuntu عبر apt repo: https://antigravity.google/download/linux (deb-based). v2.0 = tarball. IDE للـ desktop فقط؛ لا يُنصب على السيرفر. د. وائل ينصبه على GPD Win Max 2 محلياً.

Linear

Linear is configured as your project management tool. Use it to track issues, plan projects, and manage product roadmaps. You can interact with the Linear MCP server using your mcporter skill.

## 📋 Model Registry

Full reference: MODEL_REGISTRY.md — آخر تحديث 2026-05-14
Rule: دائماً استخدم أحدث إصدار من كل فئة
أحدث محادثة: Claude Opus 4.7 / GPT-5.6 Sol
أحدث كود: GPT-5.3 Codex
أحدث طبقة سريعة: Gemini 3.7 Flash (gemini-3.7-flash) — ✅ حيّ HTTP 200، fallbacks[12] فوق 3.6 مباشرة (الأحدث/الأقوى للمهام السريعة عالية الحجم)
أحدث صور: GPT-image-2 (وجوه) / Gemini 3.1 Flash (عام)
أحدث فيديو: Veo 3.1 / Sora 2 Pro
أحدث موسيقى: Lyria 3 Pro / MiniMax Music 2.5+ / Suno (API ✅ SUNO_API_KEY + المتصفّح الموثّق) · Udio (المتصفّح فقط، لا API)

⚡ Grok 4.6 (GA) — حلّ محل 4.5 في السلسلة (رُفِع 2026-08-13، مُختبَر حيّاً E2E)

الاسم الصحيح عبر مفتاحنا = grok-4.6 (لا grok-4-6). مُختبَر حيّاً بعد الإقلاع: GROK46_LIVE_OK 391 541 (17×23 + 100th prime) عبر api.x.ai/v1/chat/completions + XAI_API_KEY، exit 0.
لماذا: نفس دقة 4.5 + نفس التحرّر (لم يرفض buffer overflow الأكاديمي التقني) + أرخص 55% ($2/$6 مقابل $3/$15) + كود أنظف (بلا fences). أبطأ قليلاً (~7.4s مقابل ~5.8s — لا يوازي توفير النصف).
مكانه (كله مُتحقَّق حيّاً 2026-08-13): السلسلة الذهبية fallbacks[7]=grok-4.6 فوق [8]=grok-4.5 (defaults + مستأجر hussam[6]) · مجلس النخبة (council.py العمود الرابع) · council_health_guard.sh يفحص 4.6 · smart-code-router API_MODELS (4.6 فوق 4.5) · liberation tier_grok primary=grok-4.6 (+ 4.5 fallback + Venice/uncensored cascade = never-stop) · DOMAIN_MODEL_RANKINGS المركز 6.
🔴 تصحيح فعلي: providers.xai.models غير موجود في config (providers=[] فارغ) — لم يكن مساراً حقيقياً؛ التوجيه يتمّ عبر مصفوفة fallbacks مباشرةً (grok-4.6 حاضر فيها 3 مرات). 4.5 يبقى fallback دائم (never-stop).

👁️ DeepSeek V4-Flash-Vision (طبقة رؤية رخيصة — أُضيف + مُختبَر حيّاً 2026-08-22)

الاسم الصحيح: deepseek-v4-flash-vision-exp عبر api.deepseek.com/chat/completions (DEEPSEEK_API_KEY). في smart-code-router كـ deepseek-v4-flash-vision.
مُثبَت حيّاً E2E: نص 17×23=391 ✓ · قرأ صورة هندسية حقيقية (L=6m · w=25 kN/m · حسب Mmax=wL²/8=112.5 kN·m — كلها صحيحة من الصورة عبر image_url base64) ✓.
🔴 قيد إلزامي: تجريبي، للمهام البصرية غير الحرجة فقط (OCR/قراءة رسوم/مخططات عامة). ❌ لا للوجوه ولا للدقّة الحرجة — تبقى GPT-image-2 (وجوه) + Gemini 3.1 Flash (عام). القوة/الدقة أولاً.
⚠️ reasoning_content يستهلك جزءاً من max_tokens → زِد max_tokens للردود الطويلة (الرد الفارغ سببه استهلاك التفكير للحدّ).

🦉 Ox Alpha (Venice stealth uncensored — أُضيف + مُختبَر بأقصى خطورة 2026-08-22)

الاسم الصحيح: stealth-ox-alpha عبر Venice (api.venice.ai/api/v1/chat/completions، VENICE_API_KEY، OpenAI-compatible). في liberation_router.py كـ tier_oxalpha = Layer 5.5c (بعد gemini-3.1-pro/venice/atlas/ninja، قبل local).
مُثبَت حيّاً (رفع خطورة أقصى ret2libc buffer overflow): SOFT_REFUSE=False · كود استغلال حقيقي 4872 حرف · coding merge_intervals صحيح+asserts 7.8s.
الحكم النقدي: طبقتنا الأولى (uncensored.com gemini-3.1-pro=7401 حرف مُثبَت) أقوى محتوىً؛ Ox Alpha = طبقة إضافية (تجريبي/مجهول المصدر/مجاني مؤقت) تعزّز never-stop، لا تزاحم النخبة.

🧬 Mythos 5 (Anthropic) — الحالة الحقيقية (تحرٍّ حيّ 2026-08-22)

❌ ليس محرّك أمان — نموذج محادثة حقيقي = الطبقة الأعلى فوق Opus (Mythos-class)، وFable 5 = أول نموذج Mythos-class (أُطلق 9 يونيو 2026، $10/M in).
أنثروبيك علّقت الوصول رسمياً («suspending access to Fable 5 and Mythos 5... working to restore») → claude-mythos-5 = 404.
المصادر (مُتحقَّقة حيّاً): Anthropic→404 معلّق · OpenRouter→غير موجود · empero-ai/Qwythos-9B-Claude-Mythos-5-1M (HF، مقطّر، مزوّده الوحيد featherless-ai)→HTTP 402 رصيد HF نفد.
الحكم: watchlist (كرون ac016e6a يومي). نملك Fable 5 = نفس طبقة Mythos-class، مستخدم فعلاً في coding (claude-fable-5، Arena #5) → لا نقص فعلي.

🟢 NVIDIA Nemotron 3 (OpenRouter — طبقة مفتوحة رخيصة/مجانية، أُضيف 2026-08-12، مُختبَر حيّاً)

openrouter/nvidia/nemotron-3-ultra-550b-a55b:free = fallback في ذيل السلسلة الذهبية (قبل gpt-4.1 مباشرة، في defaults + قائمة المستأجرين). قيد عام فقط ❌ صفر بيانات KCPC/مناقصات/عائلية (النسخة :free تُسجَّل لدى NVIDIA للتحسين — خط أحمر خصوصية). بنية هجينة Transformer-Mamba MoE (55B نشط/550B)، 1M ctx، نص فقط. مُختبَر حيّاً 2026-08-12: هندسة مدنية M=80/V=40 دقيق · 100th prime=541 بحدّ Rosser · GPQA 85.7% · 7–10s عبر OpenRouter (لا 2 tok/s المخنوقة على نقطة NVIDIA المباشرة).
النسخة المدفوعة الرخيصة (بلا تسجيل خصوصية): openrouter/nvidia/nemotron-3-super-120b-a12b ($0.085/$0.40، 1M ctx) — مُدمجة في smart-code-router كنوع مهمة bulk_drafts_agents (مسودّات برمجية كبيرة + خطوط وكلاء عالية الحجم + دفعات) + طبقة إضافية في liberation_router (Tier 0.55). البدائل: nemotron-3-ultra-550b-a55b ($0.60/$3.60 ctx 512K) · nemotron-3.5-lightning ($0.10/$0.25 الأسرع).
متى نستفيد (المكان الصحيح): طبقة رخيصة/مجانية للوكلاء + البحث العميق + المسودّات البرمجية + معالجة الدفعات غير الحسّاسة (يوفّر tokens النخبة) — ليس بديلاً للنخبة Opus-5/4.8 ولا للوسائط المتعددة.

🎵 Suno + 🎬 HeyGen — API + المتصفّح (مُثبَت 2026-08-10)

Suno (SUNO_API_KEY موجود ✅): موسيقى كاملة بجودة عالية. طبقة قوية في سلسلة الموسيقى بجانب Lyria 3 + MiniMax Music 2.6. متاح أيضاً عبر المتصفّح الموثّق (suno.com — رصيد الاشتراك). Udio = المتصفّح فقط (udio.com، لا API).
HeyGen (HEYGEN_API_KEY موجود ✅): أفاتار ناطق/Digital Twin (Avatar ID د. وائل موثّق في قسم Talking Avatar أعلاه). متاح أيضاً عبر المتصفّح الموثّق (app.heygen.com — رصيد الاشتراك).
القاعدة: API للتوليد الآلي المدمج · المتصفّح الموثّق (Browser Pro) لرصيد الاشتراك اليومي وتوفير tokens. تفاصيل الـ69 منصّة: skills/browser-pro/SKILL.md.
TradingView (🆕 2026-08-11): مالي/تداول عبر المتصفّح الموثّق (tradingview.com/chart/) — رسوم/تحليل فني + تنبيهات أسعار + BIST100/USD-TRY/ذهب/كريبتو (يخدم العقار التركي + الاستثمار).
🔴 chrome-sovereign = الأساس (default) الدائم لـ Browser Pro — لا اللابتوب (ثُبّت 2026-08-15 بأمر د. وائل): أي عمل Browser Pro → الحاوية السيادية أولاً (حيّة 24/7 على السيرفر، 65 منصّة Pro مسجّلة). اللابتوب = backup فقط. ❌ لا «اللابتوب غير متصل» كعائق. قيادة CDP (مُثبَتة حيّاً): نفق SSH -L 19223:127.0.0.1:19222 root@76.13.41.228 (مفتاح openclaw_host_ed25519) ثم websocket.create_connection(ws, suppress_origin=True) (origin مخالف → 403؛ suppress_origin=True يحلّه). 🔴 opus-5 عبر Browser Pro ❌ غير ممكن: Claude Pro = Opus 4 max (مُثبَت hasOpus5=false) < opus-4-8 → opus-5 عبر API حصراً. التوفير: المتصفّح أولاً فقط حيث الموديل مساوٍ/أقوى (لا تنازل عن القوة).

🖥️ الحاوية السيادية (chrome-sovereign — رُبط 2026-08-11): Chromium مستقل على السيرفر بمخرج تركي (إسطنبول عبر --proxy-server=http://gluetun-tr:8888). الصورة المستقرة = linuxserver/chromium:kasm-81107dcf-ls32 (KasmVNC). ❌ ممنوع latest (selkies/Wayland = Segfault على نواة 6.8.0). noVNC 127.0.0.1:13010 (دخول يدوي) + CDP 127.0.0.1:19222 (أتمتة، جسر socat دائم). الملفات: /docker/chrome-sovereign/.

أحدث STT: gpt-4o-transcribe-diarize
أحدث TTS: ElevenLabs v2 (Eric)
⚠️ xAI بدون رصيد — يحتاج credits

Self-Improvement Logs

Skill: skills/self-improving-agent/SKILL.md
Log files: ~/.openclaw/workspace/.learnings/{LEARNINGS,ERRORS,FEATURE_REQUESTS}.md
Append-only; ID format LRN/ERR/FEAT-YYYYMMDD-XXX. Never log secrets or full transcripts.
Promote recurring/broadly-useful items into SOUL.md / AGENTS.md / TOOLS.md / MEMORY.md.

🏥 Medical Arsenal (skill: medical-arsenal) — 2026-05-19

Skill: skills/medical-arsenal/ — scripts: pubmed_search.py · lab_interpreter.py · drug_lookup.py
APIs (free, no key): PubMed · OpenFDA · RxNav · DailyMed · ClinicalTrials.gov · Europe PMC · MedlinePlus
Source Tier 1 (Gold): PubMed/Cochrane · UpToDate · NEJM/JAMA/BMJ/Lancet · WHO/CDC/NICE · ESC/ADA/ASCO
Safety rules: ❌ لا تشخّص · ❌ لا تصف · ✅ استشهاد دائم + Tier + year · ✅ Red flags → طبيب فوراً · Kuwait emergency: 112
Sample: python3 skills/medical-arsenal/scripts/pubmed_search.py "topic" --filter rct --years 5 --limit 5

🦙 Ollama — الترقية + سياسة الموارد (خط أحمر — 2026-08-09، بعد ترقية 0.32.5→0.32.6)

🔴 درس الترقية (لا يُنسى): ترقية Ollama تحتاج نسخ bin/ollama + lib/ollama/ الكامل معاً (فيه llama-server = المحرّك الفعلي للنماذج). ❌ نسخ البايناري وحده = Ollama يقلع ويُبلّغ version صحيحاً لكن كل نموذج يفشل بـ500 (llama-server binary not found). المصدر الرسمي: github.com/ollama/ollama/releases/download/v<ver>/ollama-linux-amd64.tar.zst (الامتداد .tar.zst لا .tgz؛ يُفكّ بـ tar --use-compress-program=unzstd).
🔴 تحقق الإصدار الحيّ: ollama --version يعرض إصدار الserver الحيّ (من الذاكرة)، لا البايناري على القرص. بعد أي استبدال يجب إعادة تشغيل ollama serve ثم التحقق. client version warning = دليل أن الserver لم يُعد تشغيله بعد.
⚙️ سياسة الموارد (أمر د. وائل الدائم): النموذج التفاعلي الوحيد المحمّل دائماً = huihui_ai/qwen3-abliterated:1.7b (keep_alive=-1، للبوابة الدلالية). الباقون مطفأون — يُشغّلون عند الحاجة فقط ثم يُطفأون (keep_alive=0) حفاظاً على الموارد.
🛡️ الحارس: scripts/guards/ollama_guard.sh (مربوط بـdaemons_keepalive) — يضمن (أ) server حيّ (auto-restart بالبايناري الصحيح + فحص llama-server) (ب) 1.7b محمّل + إطفاء أي نموذج زائد. النسخة القديمة الشغّالة تُحفظ قبل أي ترقية.

Local-AI Stack (2026-07-17 — أُعيد بعد الrollback، مُتحقَّق حيّاً)

جميع أدوات دراسة السيرفر المحلي مُنصّبة ومعزولة (صفر مساس بـpython النظام/البوابة):

bge-reranker-v2-m3 (FlagEmbedding) → python النظام (يحتاجه rag.py). مُدمج في skills/rag-knowledge-base/rag.py كعلَم --rerank (search/ask) — cross-encoder عربي/إنجليزي، صفر overhead افتراضياً.
venv معزول .venvs/localai-stack (uv, py3.13, 816MB): litellm 1.92 · langgraph 1.2.9 · llama-index 0.14.23 · haystack-ai 2.31 · deepeval 4.1.1 · ragas 0.2.15 (shim vertexai) · minio 7.2.20 · pymilvus 3.0.0. الاستخدام: .venvs/localai-stack/bin/python.
promptfoo 0.121.19 (npm global) — promptfoo eval لمقارنة الprompts/النماذج.
heretic-llm 1.4.0 (uv tool) — abliteration أكاديمي (يحتاج GPU).
⏳ GPU-only مؤجّل (السيرفر الجديد أو Cloud-API): vLLM · LLaMA-Factory (torch هنا CPU-only).
القرار الكامل + الأسباب: recovered/offline-server-study/LOCAL_AI_STACK_DECISION.md.

Audio recognition

Any voice note / music clip → use skill audd-recognize (Shazam-like via AudD)
For Quran: try transcribe+reason first, AudD as fallback
Set AUDD_API_KEY env to unlock paid quota

Process Model

KiloClaw does NOT use systemd. Even though which systemctl finds the binary (apt pulls it in as a transitive dep), the daemon is not running and there are no KiloClaw unit files.

Do not suggest systemctl, journalctl, service ..., unit files, or any init-based remediation — none of it will work.
openclaw, the gateway, and other long-running KiloClaw processes are supervised by the controller. To inspect or restart them, use the controller's APIs and logs, not init.

🦾 ملاحظات د. وائل