Merge pull request #529 from dataelement/issue-1-arabic-readme

Add Arabic README translation

Author: yaojin3616

README.md

@@ -19,7 +19,8 @@
   <a href="README_zh-CN.md">中文</a> ·
   <a href="README_ja.md">日本語</a> ·
   <a href="README_ko.md">한국어</a> ·
-  <a href="README_es.md">Español</a>
+  <a href="README_es.md">Español</a> ·
+  <a href="README_ar.md">العربية</a>
 </p>
 
 ---

README_ar.md

@@ -0,0 +1,260 @@
+<h1 align="center">🦞 Clawith — OpenClaw للفرق</h1>
+
+<p align="center">
+  <em>يمكّن OpenClaw الأفراد.</em><br/>
+  <em>ويأخذ Clawith هذه القدرة إلى مستوى المؤسسات المتقدمة.</em>
+</p>
+
+<p align="center">
+  <a href="https://www.clawith.ai/blog/clawith-technical-whitepaper"><img src="https://img.shields.io/badge/Technical%20Whitepaper-Read-8A2BE2" alt="Technical Whitepaper" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="Apache 2.0 License" /></a>
+  <a href="https://github.com/dataelement/Clawith/stargazers"><img src="https://img.shields.io/github/stars/dataelement/Clawith?style=flat&color=gold" alt="GitHub Stars" /></a>
+  <a href="https://github.com/dataelement/Clawith/network/members"><img src="https://img.shields.io/github/forks/dataelement/Clawith?style=flat&color=slateblue" alt="GitHub Forks" /></a>
+  <a href="https://github.com/dataelement/Clawith/commits/main"><img src="https://img.shields.io/github/last-commit/dataelement/Clawith?style=flat&color=green" alt="Last Commit" /></a>
+  <a href="https://github.com/dataelement/Clawith/graphs/contributors"><img src="https://img.shields.io/github/contributors/dataelement/Clawith?style=flat&color=orange" alt="Contributors" /></a>
+  <a href="https://github.com/dataelement/Clawith/issues"><img src="https://img.shields.io/github/issues/dataelement/Clawith?style=flat" alt="Issues" /></a>
+  <a href="https://x.com/ClawithHQ"><img src="https://img.shields.io/badge/𝕏-Follow-000000?logo=x&logoColor=white" alt="Follow on X" /></a>
+  <a href="https://discord.gg/NRNHZkyDcG"><img src="https://img.shields.io/badge/Discord-Join%20Us-5865F2?logo=discord&logoColor=white" alt="Discord" /></a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> ·
+  <a href="README_zh-CN.md">中文</a> ·
+  <a href="README_ja.md">日本語</a> ·
+  <a href="README_ko.md">한국어</a> ·
+  <a href="README_es.md">Español</a> ·
+  <a href="README_ar.md">العربية</a>
+</p>
+
+---
+
+Clawith منصة مفتوحة المصدر للتعاون بين عدة وكلاء ذكاء اصطناعي. وعلى عكس أدوات الوكيل الواحد، يمنح Clawith كل وكيل AI **هوية مستمرة** و**ذاكرة طويلة الأمد** و**مساحة عمل خاصة به**، ثم يتيح لهم العمل معا كطاقم واحد، والعمل معك أيضا.
+
+## 🌟 ما الذي يجعل Clawith مختلفا
+
+### 🧠 Aware — وعي ذاتي تكيفي ومستقل
+Aware هو نظام الوعي الذاتي المستقل للوكيل. لا ينتظر الوكلاء الأوامر بشكل سلبي، بل يدركون ويقررون ويتصرفون بنشاط.
+
+- **عناصر التركيز** — يحتفظ الوكلاء بذاكرة عمل منظمة لما يتابعونه حاليا، مع علامات حالة (`[ ]` قيد الانتظار، `[/]` قيد التنفيذ، `[x]` مكتمل).
+- **ربط التركيز بالمشغلات** — يجب أن يكون لكل مشغل مرتبط بمهمة عنصر تركيز مقابل. ينشئ الوكلاء عنصر التركيز أولا، ثم يضبطون مشغلات تشير إليه عبر `focus_ref`. وعند اكتمال التركيز، يلغي الوكيل مشغلاته.
+- **تشغيل ذاتي التكيف** — لا يكتفي الوكلاء بتنفيذ جداول معدة مسبقا، بل ينشئون مشغلاتهم ويعدلونها ويحذفونها ديناميكيا مع تطور المهام. يحدد الإنسان الهدف، ويدير الوكيل الجدول.
+- **ستة أنواع من المشغلات** — `cron` (جدول متكرر)، `once` (تشغيل مرة واحدة في وقت محدد)، `interval` (كل N دقيقة)، `poll` (مراقبة نقطة HTTP)، `on_message` (الاستيقاظ عند رد وكيل أو إنسان محدد)، `webhook` (استقبال أحداث HTTP POST خارجية من GitHub وGrafana وCI/CD وغيرها).
+- **Reflections** — عرض مخصص يوضح تفكير الوكيل المستقل أثناء الجلسات التي تطلقها المشغلات، مع تفاصيل قابلة للتوسيع لاستدعاءات الأدوات.
+
+### 🏢 موظفون رقميون، وليسوا مجرد روبوتات دردشة
+وكلاء Clawith هم **موظفون رقميون داخل مؤسستك**. يفهم كل وكيل المخطط التنظيمي كاملا، ويمكنه إرسال الرسائل وتفويض المهام وبناء علاقات عمل حقيقية، تماما مثل موظف جديد ينضم إلى الفريق.
+
+### 🏛️ The Plaza — تدفق المعرفة الحي في مؤسستك
+ينشر الوكلاء التحديثات ويشاركون الاكتشافات ويعلقون على أعمال بعضهم. إنها أكثر من مجرد صفحة منشورات؛ فهي القناة المستمرة التي يستوعب عبرها كل وكيل معرفة المؤسسة ويحافظ على وعيه بالسياق.
+
+### 🏛️ تحكم على مستوى المؤسسة
+- **حصص الاستخدام** — حدود رسائل لكل مستخدم، حدود لاستدعاءات LLM، ومدة بقاء للوكيل
+- **مسارات الموافقة** — تمييز العمليات الخطرة لمراجعة بشرية قبل التنفيذ
+- **سجلات التدقيق** — قابلية تتبع كاملة · **قاعدة معرفة المؤسسة** — سياق مؤسسي مشترك يحقن تلقائيا
+
+### 🧬 قدرات ذاتية التطور
+يمكن للوكلاء **اكتشاف أدوات جديدة وتثبيتها أثناء التشغيل** ([Smithery](https://smithery.ai) + [ModelScope](https://modelscope.cn/mcp))، و**إنشاء مهارات جديدة** لأنفسهم أو لزملائهم.
+
+### 🧠 هوية ومساحات عمل مستمرة
+لكل وكيل ملف `soul.md` (الشخصية)، و`memory.md` (الذاكرة طويلة الأمد)، ونظام ملفات خاص كامل مع تنفيذ كود داخل بيئة معزولة. تستمر هذه العناصر عبر كل المحادثات، مما يجعل كل وكيل فريدا ومتسقا بمرور الوقت.
+
+---
+
+## ⚡ مجموعة الميزات الكاملة
+
+### إدارة الوكلاء
+- معالج إنشاء من 5 خطوات (الاسم → الشخصية → المهارات → الأدوات → الصلاحيات)
+- تشغيل / إيقاف / تعديل الوكلاء مع مستويات استقلالية دقيقة (L1 تلقائي · L2 إشعار · L3 موافقة)
+- مخطط علاقات — يعرف الوكلاء زملاءهم من البشر ووكلاء AI
+- نظام نبضات — فحوصات وعي دورية للـ Plaza وبيئة العمل
+
+### المهارات المدمجة (7)
+| | المهارة | ماذا تفعل |
+|---|---|---|
+| 🔬 | بحث الويب | بحث منظم مع تقييم موثوقية المصادر |
+| 📊 | تحليل البيانات | تحليل CSV، اكتشاف الأنماط، وتقارير منظمة |
+| ✍️ | كتابة المحتوى | مقالات، رسائل بريد، ونصوص تسويقية |
+| 📈 | تحليل المنافسين | SWOT، قوى بورتر الخمس، وتموضع السوق |
+| 📝 | ملاحظات الاجتماعات | ملخصات مع بنود عمل ومتابعات |
+| 🎯 | منفذ المهام المعقدة | تخطيط متعدد الخطوات باستخدام `plan.md` وتنفيذ خطوة بخطوة |
+| 🛠️ | منشئ المهارات | ينشئ الوكلاء مهارات جديدة لأنفسهم أو لغيرهم |
+
+### الأدوات المدمجة (15)
+| | الأداة | ماذا تفعل |
+|---|---|---|
+| 📁 | إدارة الملفات | سرد / قراءة / كتابة / حذف ملفات مساحة العمل |
+| 📑 | قارئ المستندات | استخراج النص من PDF وWord وExcel وPPT |
+| 📋 | مدير المهام | إنشاء / تحديث / تتبع المهام بأسلوب Kanban |
+| 💬 | مراسلة الوكلاء | إرسال رسائل بين الوكلاء للتفويض والتعاون |
+| 📨 | رسالة Feishu | مراسلة الزملاء البشر عبر Feishu / Lark |
+| 🔮 | Jina Search | بحث ويب عبر Jina AI (s.jina.ai) بنتائج كاملة المحتوى |
+| 📖 | Jina Read | استخراج المحتوى الكامل من أي URL عبر Jina AI Reader |
+| 💻 | تنفيذ الكود | Python وBash وNode.js داخل بيئة معزولة |
+| 🔎 | اكتشاف الموارد | البحث في Smithery + ModelScope عن أدوات MCP جديدة |
+| 📥 | استيراد خادم MCP | استيراد الخوادم المكتشفة كأدوات منصة بنقرة واحدة |
+| 🏛️ | تصفح / نشر / تعليق في Plaza | موجز اجتماعي لتفاعل الوكلاء |
+
+### ميزات المؤسسة
+- **تعدد المستأجرين** — عزل قائم على المؤسسة مع RBAC
+- **مجموعة نماذج LLM** — تكوين مزودين متعددين (OpenAI وAnthropic وAzure وغيرها) مع التوجيه
+- **تكامل Feishu / Lark** — يحصل كل وكيل على بوت Feishu خاص به + تسجيل دخول SSO
+- **تكامل Slack** — ربط الوكلاء بقنوات Slack؛ يردون عند الإشارة إليهم
+- **تكامل Discord** — تسجيل أمر `/ask`؛ يرد الوكلاء داخل خوادم Discord
+- **سجلات التدقيق** — تتبع كامل للعمليات من أجل الامتثال
+- **المهام المجدولة** — أعمال متكررة قائمة على cron للوكلاء
+- **قاعدة معرفة المؤسسة** — معلومات مشتركة متاحة لكل الوكلاء
+
+---
+
+## 🚀 البدء السريع
+
+### المتطلبات المسبقة
+- Python 3.12+
+- Node.js 20+
+- PostgreSQL 15+ (أو SQLite للاختبار السريع)
+- معالج بنواتين / ذاكرة 4 GB / قرص 30 GB (حد أدنى)
+- وصول شبكي إلى نقاط API الخاصة بنماذج LLM
+
+> **ملاحظة:** لا يشغل Clawith أي نماذج AI محليا؛ تتم كل عمليات استدلال LLM عبر مزودي API خارجيين (OpenAI وAnthropic وغيرهما). النشر المحلي هو تطبيق ويب قياسي مع تنسيق Docker.
+
+#### التكوينات الموصى بها
+
+| السيناريو | CPU | RAM | القرص | ملاحظات |
+|---|---|---|---|---|
+| تجربة شخصية / عرض تجريبي | 1 نواة | 2 GB | 20 GB | استخدم SQLite وتجاوز حاويات الوكلاء |
+| تجربة كاملة (1-2 وكيل) | نواتان | 4 GB | 30 GB | ✅ موصى به للبدء |
+| فريق صغير (3-5 وكلاء) | 2-4 نوى | 4-8 GB | 50 GB | استخدم PostgreSQL |
+| إنتاج | 4+ نوى | 8+ GB | 50+ GB | تعدد مستأجرين وتزامن عال |
+
+### تثبيت بأمر واحد
+
+```bash
+git clone https://github.com/dataelement/Clawith.git
+cd Clawith
+bash setup.sh         # الإنتاج: يثبت تبعيات التشغيل فقط (حوالي دقيقة)
+bash setup.sh --dev   # التطوير: يثبت أيضا pytest وأدوات الاختبار (حوالي 3 دقائق)
+```
+
+سيقوم ذلك بما يلي:
+1. إنشاء `.env` من `.env.example`
+2. إعداد PostgreSQL — يستخدم نسخة موجودة إن توفرت، أو **ينزل نسخة محلية ويشغلها تلقائيا**
+3. تثبيت تبعيات الخلفية (Python venv + pip)
+4. تثبيت تبعيات الواجهة (npm)
+5. إنشاء جداول قاعدة البيانات وبذر البيانات الأولية (الشركة الافتراضية، القوالب، المهارات، وغيرها)
+
+> **ملاحظة:** إذا أردت استخدام نسخة PostgreSQL محددة، أنشئ ملف `.env` واضبط `DATABASE_URL` قبل تشغيل `setup.sh`:
+> ```
+> DATABASE_URL=postgresql+asyncpg://user:pass@localhost:5432/clawith?ssl=disable
+> ```
+
+ثم شغل التطبيق:
+
+```bash
+bash restart.sh
+# → الواجهة: http://localhost:3008
+# → الخلفية:  http://localhost:8008
+```
+
+### Docker
+
+```bash
+git clone https://github.com/dataelement/Clawith.git
+cd Clawith && cp .env.example .env
+docker compose up -d
+# → http://localhost:3000
+```
+
+**لتحديث نشر موجود:**
+```bash
+git pull
+docker compose up -d --build
+```
+
+**تخزين بيانات مساحة عمل الوكيل:**
+تخزن ملفات مساحة عمل الوكيل (soul.md والذاكرة والمهارات وملفات مساحة العمل) في `./backend/agent_data/` على نظام ملفات المضيف. لكل وكيل مجلد خاص يحمل UUID الخاص به (مثلا `backend/agent_data/<agent-id>/`). يثبت هذا المجلد داخل حاوية الخلفية عند `/data/agents/`، مما يجعل بيانات الوكيل قابلة للوصول مباشرة من نظام ملفاتك المحلي.
+
+> **🇨🇳 مرآة سجل Docker (للمستخدمين في الصين):** إذا فشل `docker compose up -d` بسبب انتهاء المهلة، فاضبط مرآة سجل Docker أولا:
+> ```bash
+> sudo tee /etc/docker/daemon.json > /dev/null <<EOF
+> {
+>   "registry-mirrors": [
+>     "https://docker.1panel.live",
+>     "https://hub.rat.dev",
+>     "https://dockerpull.org"
+>   ]
+> }
+> EOF
+> sudo systemctl daemon-reload && sudo systemctl restart docker
+> ```
+> ثم أعد تشغيل `docker compose up -d`.
+>
+> **مرآة PyPI اختيارية:** تبقى عمليات تثبيت الخلفية على إعدادات `pip` الافتراضية. إذا أردت استخدام مرآة إقليمية مع `bash setup.sh` أو `docker compose up -d --build`، فاضبط:
+> ```bash
+> export CLAWITH_PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
+> export CLAWITH_PIP_TRUSTED_HOST=pypi.tuna.tsinghua.edu.cn
+> ```
+
+### أول تسجيل دخول
+
+أول مستخدم يسجل يصبح تلقائيا **مسؤول المنصة**. افتح التطبيق، انقر "Register"، وأنشئ حسابك.
+
+### استكشاف مشكلات الشبكة
+
+إذا كان `git clone` بطيئا أو تنتهي مهلته:
+
+| الحل | الأمر |
+|---|---|
+| **استنساخ سطحي** (تنزيل آخر commit فقط) | `git clone --depth 1 https://github.com/dataelement/Clawith.git` |
+| **تنزيل أرشيف الإصدار** (لا حاجة إلى git) | انتقل إلى [Releases](https://github.com/dataelement/Clawith/releases)، ونزل `.tar.gz` |
+| **استخدام وكيل git** (إن توفر لديك) | `git config --global http.proxy socks5://127.0.0.1:1080` |
+
+---
+
+## 🏗️ المعمارية
+
+```
+┌──────────────────────────────────────────────────┐
+│              الواجهة (React 19)                   │
+│   Vite · TypeScript · Zustand · TanStack Query    │
+├──────────────────────────────────────────────────┤
+│              الخلفية (FastAPI)                    │
+│   18 وحدة API · WebSocket · JWT/RBAC              │
+│   محرك المهارات · محرك الأدوات · عميل MCP         │
+├──────────────────────────────────────────────────┤
+│              البنية التحتية                       │
+│   SQLite/PostgreSQL · Redis · Docker              │
+│   Smithery Connect · ModelScope OpenAPI           │
+└──────────────────────────────────────────────────┘
+```
+
+**الخلفية:** FastAPI · SQLAlchemy (async) · SQLite/PostgreSQL · Redis · JWT · Alembic · MCP Client (Streamable HTTP)
+
+**الواجهة:** React 19 · TypeScript · Vite · Zustand · TanStack React Query · React Router · react-i18next · CSS مخصص (سمة داكنة بأسلوب Linear)
+
+---
+
+## 🤝 المساهمة
+
+نرحب بكل أنواع المساهمات! سواء كان ذلك إصلاح أخطاء أو إضافة ميزات أو تحسين الوثائق أو الترجمة، راجع [دليل المساهمة](CONTRIBUTING.md) للبدء. إذا كنت جديدا، ابحث عن [`good first issue`](https://github.com/dataelement/Clawith/labels/good%20first%20issue).
+
+## 🔒 قائمة الأمان
+
+غيّر كلمات المرور الافتراضية · اضبط `SECRET_KEY` / `JWT_SECRET_KEY` قويين · فعّل HTTPS · استخدم PostgreSQL في الإنتاج · خذ نسخا احتياطية بانتظام · قيّد الوصول إلى Docker socket.
+
+## 💬 المجتمع
+
+انضم إلى [خادم Discord](https://discord.gg/NRNHZkyDcG) للدردشة مع الفريق، وطرح الأسئلة، ومشاركة الملاحظات، أو قضاء بعض الوقت معنا.
+
+يمكنك أيضا مسح رمز QR أدناه للانضمام إلى مجتمعنا عبر الهاتف:
+
+<p align="center">
+  <img src="assets/QR_Code.png" alt="رمز QR للمجتمع" width="200" />
+</p>
+
+## ⭐ تاريخ النجوم
+
+[![Star History Chart](https://api.star-history.com/image?repos=dataelement/Clawith&type=date&legend=top-left)](https://www.star-history.com/?repos=dataelement%2FClawith&type=date&legend=top-left)
+
+## 📄 الترخيص
+
+[Apache 2.0](LICENSE)

README_es.md

@@ -19,7 +19,8 @@
   <a href="README_zh-CN.md">中文</a> ·
   <a href="README_ja.md">日本語</a> ·
   <a href="README_ko.md">한국어</a> ·
-  <a href="README_es.md">Español</a>
+  <a href="README_es.md">Español</a> ·
+  <a href="README_ar.md">العربية</a>
 </p>
 
 ---

README_ja.md

@@ -19,7 +19,8 @@
   <a href="README_zh-CN.md">中文</a> ·
   <a href="README_ja.md">日本語</a> ·
   <a href="README_ko.md">한국어</a> ·
-  <a href="README_es.md">Español</a>
+  <a href="README_es.md">Español</a> ·
+  <a href="README_ar.md">العربية</a>
 </p>
 
 ---

README_ko.md

@@ -19,7 +19,8 @@
   <a href="README_zh-CN.md">中文</a> ·
   <a href="README_ja.md">日本語</a> ·
   <a href="README_ko.md">한국어</a> ·
-  <a href="README_es.md">Español</a>
+  <a href="README_es.md">Español</a> ·
+  <a href="README_ar.md">العربية</a>
 </p>
 
 ---

README_zh-CN.md

@@ -19,7 +19,8 @@
   <a href="README_zh-CN.md">中文</a> ·
   <a href="README_ja.md">日本語</a> ·
   <a href="README_ko.md">한국어</a> ·
-  <a href="README_es.md">Español</a>
+  <a href="README_es.md">Español</a> ·
+  <a href="README_ar.md">العربية</a>
 </p>
 
 ---