🦾 OpenClaw — CAPABILITIES.md

🎯 Media Golden Chains v2 (2026-05-24)

• Image: OpenAI gpt-image-2-2026-04-21 → gpt-image-1.5 (transparent) → Gemini 3.1 flash-image-preview → grok-imagine-image-quality → gpt-image-1-mini → MiniMax image-01 → Flux
• Video T2V: Veo 3.1 → Sora 2 Pro → Sora 2 → Veo 3.1 lite → Kling/Hailuo/LTX
• Video I2V: xAI grok-imagine-video → Veo 3.1 Fast → Hedra Character 3 (verified)
• Talking Avatar (Wael): HeyGen c6a8b1b1 + ElevenLabs WAEL_HD_v2 → Hedra Character 3 (verified)
• Lip-sync: Replicate sync/lipsync-2 → Hedra → HeyGen Photo Avatar IV
• Music: Lyria 3 Pro → MiniMax Music-2.6 (FREE) → Replicate musicgen
• TTS Arabic: ElevenLabs v3 (Eric/WAEL) → Groq Orpheus Arabic Saudi (FREE) → ElevenLabs multilingual_v2 → MiniMax speech-2.8-hd → gpt-4o-mini-tts → Gemini TTS
• STT Arabic: gpt-4o-mini-transcribe-2025-12-15 → gpt-4o-transcribe-diarize → Groq whisper-large-v3-turbo → AssemblyAI → Deepgram
• Research: Gemini deep-research-max-preview-04-2026 → Perplexity sonar-deep-research → Tavily → Firecrawl
• Code: Claude Opus 4.7 → gpt-5.1-codex-max → gpt-5.3-codex → Kimi K2.6 → DeepSeek v4-pro → Mistral medium-2604/codestral-2508
• مفاتيح ناقصة (مرفوعة): Cartesia, Synthesia, D-ID, Suno, Udio, Sync.so, DeepL

<!-- WEEKLY_AUDIT_STAMP --> > Last weekly audit: 2026-05-31T09:45:27Z — see memory/weekly-full-audit-2026-05-31.md <!-- END_WEEKLY_AUDIT_STAMP --> Single Source of Truth | Last updated: 2026-05-19

> 🔗 الملفات المرتبطة: > - GOLDEN_RULES.md — القواعد الذهبية (دقة 100% + Never-Stop + Best Value) > - DECISION_MATRIX.md — قاعدة اختيار الأداة الأفضل (اختصار سريع) > - CAPABILITIES.md — هذا الملف (المرجع الشامل)

> 🎯 العقد الذهبي: دائماً الأقوى × الأرخص × الأنسب → نتيجة 100% دقيقة → fallback تلقائي بدون توقف.

---

📊 الإحصائيات الكاملة (مُحقّقة 2026-05-13)

| المحور | العدد | |---|---| | 🔑 API Keys (env vars) | 56 (39 خدمة) | | 🧩 Skills (محلية + مدمجة) | 88 (35 محلية + 53 مدمجة) | | 🔌 OpenClaw Extensions | 96 (50 plugin + 46 core module) | | 🐍 Python Packages | 291 (46 حرجة مُختبرة) | | 🛠️ CLIs مثبتة | 21+ | | 📜 Scripts خاصة | 8 | | 🤖 AI Agents (تفويض مهام) | 4 (Hermes + Claude Code + Codex + Kilo) | | ☁️ Cloud Storage | R2 unlimited + Supabase |

---

🧠 1. LLMs (Text Reasoning) — مرتّبة من الأقوى للأخف

| # | المزوّد | الموديل الأحدث (2026-05) | متى أستخدمه | المفتاح | |---|---|---|---|---| | 🥇 | Anthropic Claude | Opus 4.7 · Sonnet 4.6 · Haiku 4.5 | تفكير عميق، تحليل قانوني/طبي/هندسي، شغل دقيق | ANTHROPIC_API_KEY | | 🥇 | OpenAI GPT | GPT-5.5 Pro · GPT-5.5 · Mini · Nano · o3-pro | reasoning متقدم، coding، استدلال | OPENAI_API_KEY | | 🥇 | Google Gemini | 2.5 Pro · 2.5 Flash · NotebookLM · Veo 3 · Imagen 4 · Lyria 3 Pro | multimodal ضخم (1M tokens)، vision، video، audio | GEMINI_API_KEY | | 🥈 | xAI Grok | Grok 4.1 Fast Reasoning (عبر OpenRouter/xAI) | بحث آني + X integration | OPENROUTER_API_KEY / xAI | | 🥈 | DeepSeek | V3.2 · R1 | reasoning رخيص + كود | DEEPSEEK_API_KEY | | 🥈 | Groq | Llama 4 70B · Mixtral · Whisper-large-v3 | سرعة فائقة (500+ tok/s) — مهام خفيفة فورية | GROQ_API_KEY | | 🥉 | OpenRouter | 400+ موديل (Claude/GPT/Gemini/Grok/DeepSeek/Qwen/GLM-Z) | fallback شامل، موديلات نادرة | OPENROUTER_API_KEY | | 🥉 | Perplexity | Sonar Pro · Sonar Reasoning Pro | بحث ويب + استدلال (مع citations) | PERPLEXITY_API_KEY | | 💰 | KiloCode Pass Pro | Frontier auto-routing (Claude/GPT/Gemini) | خصم 90% prompt cache | (عبر Kilo Gateway) |

🎯 قاعدة الاختيار (LLM):

• مهمة طبية/قانونية/هندسية حرجة → Opus 4.7 أو GPT-5.5 Pro + تحقّق ثاني
• coding ثقيل → Claude Code (Sonnet 4.6) أو Codex (GPT-5.5)
• بحث ويب → Perplexity Sonar Pro (الأرخص + citations) أو Grok (بحث X)
• كميات نصوص ضخمة (>500K tokens) → Gemini 2.5 Pro (1M context)
• مهام خفيفة (تلخيص، ترجمة) → Gemini 2.5 Flash أو DeepSeek V4 أو Groq Llama
• الافتراضي في OpenClaw → Claude Opus 4.7 (Anthropic Direct) → ChatGPT 5.5 → Gemini 3.1 Pro → Grok 4.3 → Gemini 3.5 Flash → …
• fallback chain الكاملة: راجع openclaw.json + MEMORY.md + GOLDEN_RULES.md
• Auto-Route by Context: دائماً Opus Direct (1M) → compaction عند 850K → fallback chain
• Nexos: أُزيل من chain التلقائي (M-027). يدوي فقط عبر NEXOS_API_KEY عند طلب صريح بالنص.

🖼️ 2. توليد الصور — مرتّبة من الأعلى جودة

| # | الموديل | المزوّد | تفوّق في | المفتاح | |---|---|---|---|---| | 🥇 | OpenAI GPT-image-2 ✨ PRIMARY | OpenAI | الأفضل للوجوه المرجعية (عائلة د. وائل) + تحرير + نصوص + composition | OPENAI_API_KEY | | 🥇 | Gemini 3 Pro Image (Nano Banana Pro) | Google | Photorealism + الوجوه + النصوص العربية | GEMINI_API_KEY | | 🥇 | Imagen 4 Pro / Imagen 3 Ultra | Google | جودة سينمائية، فهم prompt دقيق | GEMINI_API_KEY | | 🥈 | Flux 1.1 Pro Ultra | Black Forest Labs (FAL) | تفاصيل عالية، 4MP | FAL_KEY | | 🥈 | Higgsfield SOUL | Higgsfield | text2image سينمائي | HIGGSFIELD_API_KEY | | 🥈 | Recraft V3 | Recraft (Replicate) | Vector + brand graphics | REPLICATE_API_TOKEN | | 🥉 | Midjourney v7 | PiAPI | جمالية فنية، أنماط فريدة | PIAPI_API_KEY | | 🥉 | SDXL / Stable Diffusion | Replicate / FAL | مرونة، fine-tuning | REPLICATE_API_TOKEN / FAL_KEY | | 🛠️ | Skywork Image | Skywork | بدائل آسيوية | SKYWORK_API_KEY | | 🛠️ | MiniMax Image | MiniMax | الوجوه الآسيوية | MINIMAX_API_KEY |

🎯 قاعدة الاختيار (Image):

• صور عائلة/photorealistic (جيهان/هبة) → Nano Banana Pro أو Imagen 4 Pro
• صور تحوي نص عربي → Nano Banana Pro أو gpt-image-2
• جودة سينمائية فنية → Higgsfield SOUL أو Midjourney v7
• vector / logos / branding → Recraft V3
• تحرير صورة موجودة (inpaint/outpaint) → gpt-image-2 أو Flux Fill
• جودة قصوى 4MP+ → Flux 1.1 Pro Ultra

🎬 3. توليد الفيديو — مرتّبة من الأعلى جودة

| # | الموديل | المزوّد | تفوّق في | المفتاح | |---|---|---|---|---| | 🥇 | Veo 3 | Google | جودة سينمائية + صوت متزامن | GEMINI_API_KEY | | 🥇 | Kling 2.5 Master | Kling AI | حركة طبيعية، شخصيات متسقة | KLING_ACCESS_KEY | | 🥇 | Runway Gen-4 Turbo + Aleph | Runway | تحرير فيديو، motion control | RUNWAY_API_KEY | | 🥇 | Hedra Character 3 / Avatar / Omnia ✨ NEW 2026-05-17 | Hedra | talking heads سينمائية، micro-expressions, lip-sync, prompt-driven | HEDRA_API_KEY | | 🥈 | Higgsfield DoP-2 | Higgsfield | حركة كاميرا سينمائية محددة | HIGGSFIELD_API_KEY | | 🥈 | HeyGen Avatar IV (Custom Trained) ✨ NEW 2026-05-17 | HeyGen | Wael Digital Twin (Custom Avatar from video) + Creator plan 7200 credits/yr | HEYGEN_API_KEY | | 🥉 | MiniMax Hailuo 02 | MiniMax | Image-to-video رخيص | MINIMAX_API_KEY | | 🥉 | Wan 2.6 | Replicate/FAL | بدائل | FAL_KEY / REPLICATE | | 🛠️ | Pika / Hunyuan | PiAPI | تجريب إضافي | PIAPI_API_KEY |

🎯 قاعدة الاختيار (Video):

• فيديو سينمائي + صوت → Veo 3
• صورة → فيديو طبيعي → Kling 2.5 Master
• حركة كاميرا محددة → Higgsfield DoP-2 أو Runway
• شخص يتكلم (Wael Digital Twin) → HeyGen Custom Avatar c6a8b1b1 + ElevenLabs WAEL_HD_v2 (sTJJWD3ns4Cr4Ag6Rb8G) ✨
• توليد سريع talking head + emotional → Hedra Character 3 ✨
• فيديو رخيص (تجارب) → MiniMax Hailuo 02

🎙️ 4. الصوت (TTS + STT + Music)

Text-to-Speech (TTS)

صوت Eric (Default): cjVigY5qzO86Huf0OWal — ElevenLabs eleven_multilingual_v2 صوت د. وائل المستنسخ (WAEL): dbAtpwltUoa4IgLr2dLX

Speech-to-Text (STT)

Music Generation

---

📄 5. PDF / Documents / OCR

| # | الأداة | تفوّق في | المفتاح | |---|---|---|---| | 🥇 | Adobe PDF Services | استخراج/تحويل/OCR/توقيع — جودة Adobe الأصلية | ADOBE_CLIENT_ID/SECRET | | 🥇 | Mathpix | OCR للمعادلات الرياضية + جداول هندسية | MATHPIX_APP_ID/KEY | | 🥈 | Gemini 2.5 Pro Vision | قراءة PDFs + صور بفهم سياقي (1M tokens) | GEMINI_API_KEY | | 🥈 | Claude Vision (Opus/Sonnet) | فهم مخططات معقدة | ANTHROPIC_API_KEY | | 🥈 | GPT-5.5 Vision | OCR + reasoning متزامن | OPENAI_API_KEY | | 🛠️ | Tesseract 5.5.2 (ara+eng) | OCR محلي مجاني — عربي + إنجليزي | (محلي) | | 🛠️ | PyMuPDF + pdfplumber + poppler | استخراج نص + جداول + صور محلياً | (محلي) | | 🛠️ | Pandoc 3.9 | تحويل بين 30+ صيغة مستندات | (محلي) |

قاعدة OCR:

• PDF هندسي بمعادلات → Mathpix ثم Adobe Extract
• Shop drawings مع markups → Adobe + Gemini Vision
• صور بنصوص عربية → Gemini 2.5 Pro أو Claude Vision
• OCR بسيط/سريع → Tesseract (مجاني محلي)

🏗️ 6. هندسة / BIM / Project Management

| الأداة | الوصف | المفتاح/Library | |---|---|---| | Autodesk APS (Forge) | Revit/AutoCAD/IFC parsing, Model Derivative, Design Automation | AUTODESK_CLIENT_ID/SECRET | | xerparser (Python) | قراءة ملفات Primavera P6 (.xer) — Tasks, WBS, Resources, Predecessors | محلي | | ifcopenshell 0.8.5 | قراءة/كتابة ملفات IFC (BIM) | محلي | | PMWeb (KCPC) | manual mode فقط (لا REST API) | URL: pmweb.kcpckw.com | | WolframAlpha Pro | معادلات هندسية، تكامل، تفاضل، فيزياء | WOLFRAM_APP_ID + skill | | construction (skill) | project management، scheduling، materials، safety | محلي | | construction-assistant (skill) | إدارة مشاريع: progress, materials, safety, BOQ | محلي | | p6_parse.py (script) | parse Primavera .xer files مخصص | محلي |

Autodesk APIs المتاحة:

• Model Derivative API — تحويل لأي صيغة + extract metadata
• Design Automation API — تشغيل AutoCAD/Revit/Inventor scripts في السحاب
• Data Management API — BIM 360 / ACC / OSS buckets
• Webhooks API — إشعارات لحظية
• Viewer SDK — عرض النماذج في المتصفح

🔍 7. البحث والمعرفة

| # | المحرك | تفوّق في | المفتاح | |---|---|---|---| | 🥇 | Exa (built-in) | بحث semantic عميق | (مدمج) | | 🥇 | Perplexity Sonar Pro | بحث + إجابة + citations | PERPLEXITY_API_KEY | | 🥈 | Oxylabs AI Studio | scraping احترافي مع AI extraction | OXYLABS_AISTUDIO_API_KEY | | 🥈 | Brave Search | fallback خاصوصية | BRAVE_API_KEY | | 🥈 | Tavily | بحث للـ AI agents (research عميق) | TAVILY_API_KEY | | 🥈 | Firecrawl | scraping صفحات JS-heavy | FIRECRAWL_API_KEY | | 🥉 | Apify | 5000+ scraper جاهز (Maps, Twitter, Amazon...) | APIFY_API_TOKEN | | 🥉 | DuckDuckGo (skill + MCP) | مجاني بالكامل | (مدمج) | | 📚 | arXiv + Wikipedia + PubMed (MCP) | علوم/موسوعة/طب | (مدمج) | | 🔬 | Genspark | بحث AI agentic | GENSPARK_API_KEY | | 🔬 | Manus | research محقّق متعدد المصادر | MANUS_API_KEY | | 🧮 | Wolfram Alpha | حسابات + علوم | WOLFRAM_APP_ID | | 🔍 | X Search (xAI built-in) | بحث في X/Twitter مباشر | (مدمج) |

قاعدة الاختيار (Research):

• سؤال علمي/طبي → Perplexity + PubMed/arXiv
• بحث عن شركات/أسعار → Perplexity + Apify
• بحث عميق متعدد الجوانب → Genspark أو Manus أو Hermes (deep research)
• scraping موقع معيّن → Firecrawl (محتوى) أو Oxylabs (structured) أو Apify (5000+ template)
• معادلات/علوم تطبيقية → Wolfram Alpha
• بحث في X/Twitter → X Search أو xurl

🤖 8. AI Agents — تفويض المهام

| Agent | الإصدار | القدرة | متى أستخدمه | |---|---|---|---| | Hermes | v0.13.0 (updated 2026-05-13) | deep research، parallel workstreams، kanban، self-improving | مهام بحثية طويلة، مشاريع متعددة المسارات | | Claude Code | v2.1.138 | coding agent (ACP) — Sonnet 4.6 | بناء features جديدة، refactoring كبير، مراجعة PR | | Codex CLI | v0.130.0 | coding agent (ACP) — GPT-5.5 | coding تفاعلي، iterative development | | OpenClaw Subagents | (built-in) | isolated sessions، parallel tasks | أي مهمة تحتاج عزل أو توازي |

قاعدة التفويض:

• مهمة coding معقدة → Claude Code (للدقة) أو Codex (للسرعة)
• بحث عميق متعدد المصادر → Hermes (deep research mode)
• مهمة طويلة بالخلفية → OpenClaw Subagent (isolated)
• مشروع متعدد المهام → Hermes Kanban (يوزّع ويتابع)

🛠️ 9. أدوات التطوير والاختبار

| الأداة | الوصف | |---|---| | TestSprite | اختبار أكواد تلقائي — يولّد tests + يشغّلها + يبلّغ | TESTSPRITE_API_KEY | | GitHub (gh CLI 2.92) | issues, PRs, releases, gists — مسجّل كـ wayrk | | xurl | X/Twitter API client | | gh-issues skill | تفويض إصلاح bugs لسب أجنتس تلقائياً | | mcporter 0.9.0 | إدارة MCP servers |

قاعدة الاختبار:

• كود جديد → TestSprite يولّد ويشغّل الاختبارات تلقائياً
• كود على GitHub → gh CLI للـ PR + Claude Code/Codex للمراجعة
• bugs → gh-issues skill يفوّض الإصلاح لسب أجنتس

🗄️ 10. التخزين وقواعد البيانات

| الأداة | الاستخدام | المفتاح | |---|---|---| | Cloudflare R2 (unlimited) | تخزين سحابي — backups + مشاريع + ملفات كبيرة | R2_ (6 keys) | | Supabase (PostgreSQL + Storage + pgvector) | DB دائم + semantic search | SUPABASE_ (4 keys) | | Notion | قاعدة معرفة منظّمة | NOTION_API_KEY | | Memory KG (MCP) | knowledge graph للسياق | (مدمج) | | *memory/.md (محلي) | يوميات + سياق سريع | (ملفات) |

R2 Manager (scripts/r2_manager.py):

• ملفات >10MB أو مشاريع → R2 (يوفّر storage محلي)
• بيانات structured + بحث → Supabase (PostgreSQL + pgvector)
• معرفة منظّمة + مشاركة → Notion
• سياق يومي سريع → memory/.md

LLM (8 auto + 1 manual): OPENAI · ANTHROPIC · GEMINI · GROQ · DEEPSEEK · OPENROUTER · PERPLEXITY · KILOCODE · (NEXOS manual-only)
Audio (3):     ELEVENLABS · MINIMAX · ASSEMBLYAI
Video (5):     KLING(2) · RUNWAY · HEYGEN · HIGGSFIELD(2) · MINIMAX
Image (5):     FAL · REPLICATE · SKYWORK · PIAPI · gpt-image-2/Imagen(via LLM keys)
Research (8):  EXA · BRAVE · FIRECRAWL · GENSPARK · MANUS · TAVILY · APIFY(2) · OXYLABS
Engineering(5): WOLFRAM · ADOBE(6) · AUTODESK(2) · MATHPIX(2) · GOG
Storage (3):   CLOUDFLARE R2(6) · SUPABASE(4) · NOTION
Productivity(2): LINEAR · TESTSPRITE
Geo (2):       MAPBOX · TOMORROW_IO

🔥 Total Stack (2026-05-13):* 56 API key · 39 service · 88 skill · 51 plugin · 291 Python package · 21+ CLI · 8 scripts · 4 AI agents · R2 unlimited storage · Hermes deep research · OCR عربي محلي

> 💡 هذا الملف هو المرجع الذهبي. أي إضافة/تعديل لأداة → تحديث هنا فوراً.