Reference OS 5 دقائق قراءة ١٦ مايو ٢٠٢٦ شرح مشروع GitHub حديث وطريقة تركيبه واستخدامه عملياً دليل تركيب ClawMetry: لوحة مراقبة وكلاء OpenClaw AI في الوقت الفعلي في هذا الدليل، ستتعلم تثبيت ClawMetry…
اختر القسم الذي تحتاجه الآن
الفكرة التي تمنع التسرع
هل تعتقد أن مراقبة وكلاء AI تتطلب أدوات معقدة ومدفوعة؟ ClawMetry تثبت العكس: أداة مجانية ومفتوحة المصدر تمنحك رؤية كاملة لوكلائك في دقائق.
قبل أن تطبق، اعرف أين تقف بالضبط
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت تعمل مع وكلاء OpenClaw AI، فأنت تعلم أهمية رؤية ما يحدث داخل الوكيل. ClawMetry هي الأداة التي تمنحك هذه الرؤية: لوحة تحكم في الوقت الفعلي تعرض لك كل خطوة يفكر فيها الوكيل، وكل قناة يتواصل من خلالها. في هذا الدليل العملي، سنأخذك خطوة بخطوة من التثبيت إلى التشغيل، مع حلول لأكثر الأخطاء شيوعاً.
سواء كنت مطوراً مبتدئاً أو محترفاً، ستجد هنا كل ما تحتاجه لبدء مراقبة وكلائك بكل سهولة. لن ننسخ README، بل سنشرحه بلغة عملية مع أمثلة من الواقع العربي.
ClawMetry هي أداة مراقبة مفتوحة المصدر لوكلاء OpenClaw AI. تسمح لك برؤية ما يفكر فيه وكيلك في الوقت الفعلي، وعرض القنوات التي يتواصل من خلالها (مثل Slack وTelegram) في لوحة تحكم واحدة. تم تطويرها بواسطة vivekchand وتدعم التثبيت عبر pip أو Docker.
python --versionpip install clawmetryclawmetryhttp://localhost:8900docker pull clawmetry (أو استخدم docker run -p 8900:8900 clawmetry)docker run -p 8900:8900 clawmetryhttp://localhost:8900git clone https://GitHub.com/vivekchand/clawmetry.gitcd clawmetrypip install flaskpython3 dashboard.pyhttp://localhost:8900ClawMetry لا يتطلب ملف .env منفصل. بدلاً من ذلك، يقرأ تلقائياً ملف تكوين OpenClaw الموجود في ~/.openclaw/openclaw.json. إذا لم يكن الملف موجوداً، قد تحتاج إلى تشغيل OpenClaw أولاً أو إنشاء ملف تكوين يدوي. مثال لمحتوى الملف:
{
"channels": {
"slack": {"token": "xoxb-..."},
"telegram": {"token": "123:..."}
}
}بعد التثبيت، شغل الأداة باستخدام الأمر clawmetry (أو python3 dashboard.py إذا كنت من المصدر). ستظهر رسالة تفيد بأن الخادم يعمل على المنفذ 8900. افتح المتصفح على http://localhost:8900 لرؤية لوحة التحكم. إذا كانت القنوات مفعلة، ستظهر فوراً.
نعم، إذا كنت تستخدم OpenClaw AI وتحتاج إلى رؤية ما يحدث داخل وكيلك. الأداة مجانية، سهلة التثبيت، وتوفر قيمة فورية. لكن إذا كنت تستخدم وكيلاً واحداً بسيطاً ولا تحتاج مراقبة، فقد لا تكون ضرورية.
لا، مصمم خصيصاً لـ OpenClaw AI.
نعم، يمكنك تشغيله على خادم والوصول إليه عبر IP العام، لكن تأكد من إعدادات الأمان.
ClawMetry يعمل محلياً ولا يرسل أي بيانات خارجية. جميع البيانات تبقى على جهازك.
خطوات عملية مرتبة من التشخيص إلى النتيجة
لماذا؟ ClawMetry يعتمد على Python، والإصدار القديم يسبب أخطاء.
كيف؟ شغل الأمر python --version في الطرفية. إذا كان الإصدار أقل من 3.8، قم بتثبيت الأحدث من python.org.
الناتج: ظهور إصدار Python 3.8 أو أعلى.
لماذا؟ أسهل طريقة للمطورين.
كيف؟ شغل الأمر pip install clawmetry في الطرفية.
الناتج: رسالة نجاح التثبيت.
لماذا؟ لبدء لوحة المراقبة.
كيف؟ شغل الأمر clawmetry في الطرفية.
الناتج: رسالة تفيد بأن الخادم يعمل على http://localhost:8900.
لماذا؟ لرؤية القنوات والبيانات.
كيف؟ افتح المتصفح على http://localhost:8900.
الناتج: ظهور لوحة تحكم تعرض القنوات المفعلة (إن وجدت).
لماذا؟ ClawMetry يقرأ ملف openclaw.json لعرض القنوات.
كيف؟ تحقق من وجود الملف في ~/.openclaw/openclaw.json. إذا لم يكن موجوداً، شغل OpenClaw أولاً أو أنشئ الملف يدوياً.
الناتج: ظهور القنوات في لوحة التحكم.
حوّل القراءة إلى تنفيذ سريع
{
"channels": {
"slack": {"token": "xoxb-your-slack-token"},
"telegram": {"token": "123456:your-telegram-token"}
}
}docker run -p 8900:8900 clawmetry
clawmetry --port 8901
اعرف أين يتعثر الناس وكيف تتجنب ذلك
ماذا تفعل حسب حالتك؟
إذا: إذا كنت تستخدم OpenClaw AI وتحتاج مراقبة
إذن: قم بتثبيت ClawMetry عبر pip أو Docker.
إذا: إذا واجهت خطأ في التثبيت
إذن: راجع جدول الأخطاء الشائعة وحلولها.
إذا: إذا كانت القنوات لا تظهر
إذن: تحقق من ملف openclaw.json.
إذا: إذا كنت تحتاج مراقبة متقدمة أو مدفوعة
إذن: فكر في بدائل مثل LangSmith.
جدول صغير يمنع التسويف
نقاط مختصرة ترجع لها لاحقاً
1. ClawMetry مجاني ومفتوح المصدر (رخصة MIT).
2. يعمل محلياً ولا يرسل بيانات للخارج.
3. يدعم التثبيت عبر pip أو Docker.
4. يقرأ تلقائياً ملف تكوين OpenClaw.
5. يعرض القنوات في الوقت الفعلي دون تحديث الصفحة.
6. تم تطويره بواسطة vivekchand على GitHub.
7. يتطلب Python 3.8 أو أحدث.
8. المنفذ الافتراضي هو 8900.
9. يمكن تغيير المنفذ باستخدام --port.
إجابات مباشرة على ما يبحث عنه الزائر
تعريفات مختصرة تمنع الالتباس
أداة مراقبة مفتوحة المصدر لوكلاء OpenClaw AI تعرض القنوات والأفكار في الوقت الفعلي.
إطار عمل لبناء وكلاء ذكاء اصطناعي يمكنهم التواصل عبر قنوات متعددة.
مدير حزم Python يستخدم لتثبيت المكتبات.
أداة لتشغيل التطبيقات في حاويات معزولة.
واجهة رسومية تعرض بيانات المراقبة.
استخدمها كمسارات متابعة داخل نفس الموضوع
تحول القارئ: من مطور لا يعرف كيف يراقب وكلاء AI إلى مستخدم قادر على تثبيت ClawMetry وتشغيله واستخدامه بثقة.
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
ClawMetry أداة بسيطة لكنها قوية لمن يعملون مع OpenClaw AI. باتباع هذا الدليل، يمكنك البدء في مراقبة وكلائك في دقائق. تذكر أن الأداة لا تزال في مرحلة التطوير، لذا تابع التحديثات على GitHub للحصول على ميزات جديدة. إذا واجهت أي مشكلة، عد إلى هذا الدليل أو راجع README الرسمي.
حتى يبقى المرجع صالحاً مع الوقت
FAQ
استمر في القراءة
