> العربية translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes.
# 🦞 ClawMetry
[](https://clickpy.clickhouse.com/dashboard/clawmetry)
[](https://clickpy.clickhouse.com/dashboard/clawmetry)
[](https://pypi.org/project/clawmetry/)
[](https://github.com/vivekchand/clawmetry/stargazers)
[](https://opensource.org/licenses/MIT)
**شاهد وكيلك وهو يفكّر.** مراقبة فورية لـ **14 بيئة تشغيل لوكلاء الذكاء الاصطناعي**: [OpenClaw](https://github.com/openclaw/openclaw)، [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)، Claude Code، OpenAI Codex و10 أخرى. لوحة تحكم واحدة لأسطول وكلائك بالكامل.
> 🌐 **اقرأ هذا بلغة:** [English](README.md) · [简体中文](docs/i18n/zh-CN/README.md) · [日本語](docs/i18n/ja/README.md) · [한국어](docs/i18n/ko/README.md) · [Español](docs/i18n/es/README.md) · [Português (BR)](docs/i18n/pt-BR/README.md) · [Français](docs/i18n/fr/README.md) · [Deutsch](docs/i18n/de/README.md) · [हिन्दी](docs/i18n/hi/README.md) · [العربية](docs/i18n/ar/README.md) · [Русский](docs/i18n/ru/README.md) · [المزيد ←](docs/i18n/)
أمر واحد. بلا إعدادات. يكتشف كل شيء تلقائيًا.
```bash
pip install clawmetry && clawmetry
```
يفتح على **http://localhost:8900** وينتهي الأمر.
## يعمل مع 14 بيئة تشغيل للوكلاء
بدأت ClawMetry كأداة مراقبة لـ OpenClaw، والآن تقيس **أسطول وكلائك بالكامل** في لوحة تحكم واحدة، وتكتشف تلقائيًا كل بيئة تشغيل على جهازك:
🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n**
OpenClaw وNemoClaw مجانيان في التطبيق مفتوح المصدر؛ أما بقية بيئات التشغيل فتُفعَّل عبر ClawMetry Cloud أو ترخيص Pro ذاتي الاستضافة. بدّل بين بيئات التشغيل من الرأس، وكل تبويب - التكلفة، الرموز، الأدوات، التتبعات - يعيد تحديد نطاقه إلى تلك البيئة. راجع **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** للاطلاع على التقسيم الدقيق بين المجاني والمدفوع، ومصفوفة المستويات، وشكل `/api/entitlement`، وأداة سطر الأوامر `clawmetry license`.
## ما الذي ستحصل عليه
- **Flow** — رسم بياني متحرك حي يعرض تدفق الرسائل عبر القنوات والدماغ والأدوات والعودة
- **Overview** — فحوصات صحية، خريطة حرارية للنشاط، عدد الجلسات، معلومات النموذج
- **Usage** — تتبع الرموز والتكلفة مع تفصيل يومي/أسبوعي/شهري
- **Sessions** — جلسات الوكيل النشطة مع النموذج والرموز وآخر نشاط
- **Crons** — المهام المجدولة مع الحالة، التشغيل التالي، المدة
- **Logs** — بث السجلات الفورية بترميز لوني
- **Memory** — تصفح SOUL.md، MEMORY.md، AGENTS.md، الملاحظات اليومية
- **Transcripts** — واجهة فقاعات دردشة لقراءة سجلات الجلسات
- **Alerts** — حدود ميزانية، محفزات معدل الأخطاء، كشف عدم اتصال الوكيل؛ يوجّه إلى Slack وDiscord وPagerDuty وTelegram والبريد الإلكتروني
- **Approvals** — حجب عمليات الحذف المدمّرة، الدفع القسري، تعديلات قاعدة البيانات، sudo، تثبيت الحزم، واستدعاءات الشبكة خلف موافقة بنقرة واحدة
## لقطات شاشة
### 🧠 Brain — بث حي لأحداث الوكيل
### 📊 Overview — استخدام الرموز وملخص الجلسات
### ⚡ Flow — تغذية استدعاء الأدوات الفورية
### 💰 Tokens — تفصيل التكلفة حسب النموذج والجلسة
### 🧬 Memory — متصفح ملفات مساحة العمل
### 🔐 Security — الوضعية الأمنية وسجل التدقيق
### 🚨 Alerts — حدود الميزانية، محفزات معدل الأخطاء، ووصلات ويب إلى Slack / Discord / PagerDuty / البريد الإلكتروني
### ✋ Approvals — حجب استدعاءات الأدوات الخطرة خلف موافقة يدوية؛ قواعد حماية مدعومة بسياسات
**الحجب قبل التنفيذ لـ Claude Code** — أمر واحد يثبّت خطاف
PreToolUse يوقف استدعاءات الأدوات المطابقة *قبل* تشغيلها وينتظر
قرارك (بنقرة واحدة من هاتفك عند تفعيل
[إشعارات الدفع السحابية](https://app.clawmetry.com/push)):
```bash
clawmetry hooks install # writes ~/.claude/settings.json (idempotent)
clawmetry hooks status # what's wired + how many policies are active
clawmetry hooks uninstall # removes only ClawMetry's entries
```
الرفض يحجب استدعاء تلك الأداة فقط - يحتفظ الوكيل بجلسته ويمكنه
تجربة نهج آخر. الموافقة من هاتفك تتخطى موجّه الأذونات الخاص بـ Claude Code
(أنت أجبت بالفعل). الأدوات غير المطابقة تكلّف حوالي 40 مللي ثانية
وتمر عبر تدفق الأذونات المعتاد لـ Claude Code. تحصل أيضًا على إشعار دفع على هاتفك عندما ينتظرك Claude Code نفسه (إشعارات `permission_prompt` /
`idle_prompt`).
## التثبيت
**سطر واحد (موصى به):**
```bash
curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash
```
**pip:**
```bash
pip install clawmetry
clawmetry
```
**من المصدر:**
```bash
git clone https://github.com/vivekchand/clawmetry.git
cd clawmetry && pip install flask && python3 dashboard.py
```
## تطوير الواجهة الأمامية v2
تطبيق React الخاص بالإصدار v2 موجود في `frontend/` ويُخدَّم على
`/v2` عند تشغيل خادم Flask مع تفعيل v2.
استخدم طرفيتين أثناء التطوير:
```bash
# Terminal 1: Flask API/server on :8900
CLAWMETRY_V2=1 python3 dashboard.py
```
```bash
# Terminal 2: Vite dev server on :5173
cd frontend
nvm use
npm ci
npm run dev
```
افتح `http://localhost:5173/v2/`. يقوم Vite بتمرير طلبات `/api` إلى
`http://localhost:8900`، بحيث يمكن لتطبيق React التواصل مع خادم Flask
المحلي دون إعداد CORS إضافي.
لبناء الحزمة التي تُشحن مع حزمة Python:
```bash
cd frontend
npm run build
```
تُكتب الحزمة الإنتاجية في `clawmetry/static/v2/dist/`.
## توافق بيئات التشغيل / الوكلاء
تراقب ClawMetry العديد من بيئات تشغيل وكلاء الذكاء الاصطناعي، وليس فقط OpenClaw. كل بيئة تشغيل غير OpenClaw تأتي مع محوّل قراءة مخصص يترجم صيغة الجلسة الأصلية إلى الأشكال الموحّدة لـ ClawMetry؛ يقوم الخادم الخلفي بإدخالها في نفس مخزن DuckDB + اللقطة السحابية، مع وسم بيئة التشغيل، ويعرض تبويب إعادة تشغيل الجلسة **مبدّل بيئة تشغيل** عند وجود أكثر من واحدة. راجع [`docs/compatibility.md`](docs/compatibility.md) للمصفوفة الكاملة + دليل إضافة بيئات تشغيل، و[`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) لمقدمة عائلة OpenClaw.
| بيئة التشغيل / الوكيل | الحالة | ملاحظات |
|---|---|---|
| **OpenClaw** | أصلي | بيئة التشغيل المرجعية، تُكتشف تلقائيًا |
| **PicoClaw** | محوّل تجريبي | JSONL مسطّح لـ `providers.Message` (`~/.picoclaw/workspace/sessions`). نصوص، نموذج، استدعاءات أدوات. |
| **NanoClaw** | محوّل تجريبي | SQLite لكل جلسة (`data/v2-sessions`). نصوص + عدد الرسائل. |
| **Hermes** | محوّل تجريبي | SQLite في `~/.hermes/state.db`. نصوص، نموذج، رموز/تكلفة. |
| **Claude Code** | محوّل تجريبي | JSONL في `~/.claude/projects/.../.jsonl`. نصوص، نموذج، استدعاءات أدوات + تفكير، استخدام الرموز. |
| **Codex** | محوّل تجريبي | Rollout JSONL في `~/.codex/sessions/...`. نصوص، نموذج، استدعاءات أدوات، استخدام الرموز. |
| **Cursor** | محوّل تجريبي | SQLite `state.vscdb`. نصوص دردشة/تحرير، نموذج. |
| **Aider** | محوّل تجريبي | `.aider.chat.history.md` لكل مشروع. نصوص، نموذج، عدد الرموز. |
| **Goose** | محوّل تجريبي | SQLite في `~/.local/share/goose`. نصوص، نموذج، استدعاءات أدوات، إجمالي الرموز. |
| **opencode** | محوّل تجريبي | SQLite في `~/.local/share/opencode`. نصوص، نموذج، استدعاءات أدوات، رموز + تكلفة. |
| **Qwen Code** | محوّل تجريبي | JSONL في `~/.qwen/projects/.../chats`. نصوص، نموذج، استدعاءات أدوات، استخدام الرموز. |
| **Pi** | محوّل تجريبي | JSONL في `~/.pi/agent/sessions`. نصوص، نموذج، استدعاءات أدوات، رموز + تكلفة. |
| **Deep Agents** | محوّل تجريبي | SQLite في `~/.deepagents/.state/sessions.db`. نصوص، نموذج، استدعاءات أدوات، رموز + تكلفة. |
| **n8n** | محوّل تجريبي | SQLite في `~/.n8n/database.sqlite`. تنفيذات سير العمل، تشغيلات العقد، مطالبات وكيل الذكاء الاصطناعي، النموذج + الرموز حيث يسجّلها n8n. |
"محوّل تجريبي" يعني أن ClawMetry تشحن قارئًا لصيغة القرص الفعلية لبيئة التشغيل تلك، وكل واحد مبني ومُتحقَّق منه مقابل تثبيت حقيقي على جهاز حقيقي (راجع `tests/fixtures/runtimes/
