--- name: translate description: ترجمة متعددة المستويات (عربي ↔ إنجليزي + 100 لغة) مع الحفاظ على تنسيق الوثائق. 3 طبقات: Google Translate (مجاني، فوري للنصوص القصيرة)، Gemini/Mistral (جودة + رخيص للمتوسط)، Claude Opus (premium للوثائق الهندسية والقانونية والطبية). يدعم Word/Excel/PowerPoint/PDF مع الحفاظ على التنسيق + الجداول + الصور. بديل أقوى لـ DeepL مع توفير $25/شهر. license: MIT ---
Translate — Multi-tier Translation for OpenClaw
ترجمة ذكية متعددة المستويات بدون اشتراك DeepL.
Stack
| الطبقة | المحرك | الاستخدام | التكلفة |
|---|---|---|---|
| Quick | deep-translator (Google) | نصوص قصيرة، سريعة | 🆓 مجاني |
| Standard | Gemini 3.1 Pro | جودة جيدة، اقتصادي | $0.05/page |
| Premium | Claude Opus 4.7 | KCPC، عقود، طبي، قانوني | $0.30/page |
| Boost | Mistral medium | كميات كبيرة سريعة | $0.10/page |
| Free LLM | DeepSeek V4 / Mistral / Groq | يومي مجاني/رخيص | 🆓 |
Supported Formats
- ✅ نص خام — أي لغة
- ✅ PDF — استخراج + ترجمة + إعادة بناء
- ✅ Word (.docx) — يحفظ تنسيق + جداول + صور
- ✅ Excel (.xlsx) — يترجم cells + يحفظ formulas
- ✅ PowerPoint (.pptx) — يترجم slides + shapes
- ✅ Markdown — يحفظ structure
- ✅ Plain text — مباشر
Domains (Specialized)
general— عام (الافتراضي)engineering/civil— هندسي/مدني (KCPC, method statements)legal— قانوني (عقود)medical— طبيtechnical— تقنيbusiness— تجاري/إداري
Commands
Quick translate text
bash
python3 translate.py text "مرحبا" --to en
python3 translate.py text "Hello world" --to ar --quality quick
Premium translate (هندسي/قانوني)
bash
python3 translate.py text "بيان منهجية صب الخرسانة" --to en --quality premium --domain civil
Translate file (preserving format)
bash
python3 translate.py file contract.docx --to en --output contract_en.docx --quality premium
python3 translate.py file boq.xlsx --to en --quality standard
python3 translate.py file presentation.pptx --to en --quality standard
python3 translate.py file specs.pdf --to en --quality premium --domain civil
Batch translate
bash
python3 translate.py batch /path/to/folder --to en --pattern "*.docx"
Translation memory (auto-stored)
bash
python3 translate.py history --limit 20
python3 translate.py search "concrete"
Auto-detection
- مصدر اللغة → تلقائي (لا تحتاج تحدد source)
- نوع الوثيقة → من الـ extension
- المجال → تلقائي حسب المحتوى (أو حدّد --domain)
Quality Tiers Detail
Quick (Google Translate via deep-translator)
- ⚡ Latency: ~500ms
- 💰 Cost: $0
- 📊 Quality: ⭐⭐⭐⭐
- 🎯 Use: نصوص قصيرة، رسائل، مصطلحات عامة
Standard (Gemini 3.1 Pro)
- ⚡ Latency: ~2s
- 💰 Cost: ~$0.001 per 1K tokens (~$0.05/page)
- 📊 Quality: ⭐⭐⭐⭐⭐
- 🎯 Use: تقارير، إيميلات، وثائق متوسطة
Premium (Claude Opus 4.7)
- ⚡ Latency: ~5s
- 💰 Cost: ~$0.015 per 1K tokens (~$0.30/page)
- 📊 Quality: ⭐⭐⭐⭐⭐⭐
- 🎯 Use: عقود، method statements, طبي، قانوني، رياضي
Languages Supported
- العربية ↔ الإنجليزية (الأساسي)
- + 100 لغة أخرى (Spanish, French, German, Chinese, Turkish, etc.)