إذا كنت تعمل مع وكلاء OpenClaw AI، فأنت تعلم أهمية رؤية ما يحدث داخل الوكيل. ClawMetry هي الأداة التي تمنحك هذه الرؤية: لوحة تحكم في الوقت الفعلي تعرض لك كل خطوة يفكر فيها الوكيل، وكل قناة يتواصل من خلالها. في هذا الدليل العملي، سنأخذك خطوة بخطوة من التثبيت إلى التشغيل، مع حلول لأكثر الأخطاء شيوعاً.

سواء كنت مطوراً مبتدئاً أو محترفاً، ستجد هنا كل ما تحتاجه لبدء مراقبة وكلائك بكل سهولة. لن ننسخ README، بل سنشرحه بلغة عملية مع أمثلة من الواقع العربي.

ما هو ClawMetry؟

ClawMetry هي أداة مراقبة مفتوحة المصدر لوكلاء OpenClaw AI. تسمح لك برؤية ما يفكر فيه وكيلك في الوقت الفعلي، وعرض القنوات التي يتواصل من خلالها (مثل Slack وTelegram) في لوحة تحكم واحدة. تم تطويرها بواسطة vivekchand وتدعم التثبيت عبر pip أو Docker.

من يحتاج ClawMetry؟

• مطورو وكلاء OpenClaw AI الذين يريدون تصحيح الأخطاء وتحسين الأداء.
• أصحاب المشاريع الصغيرة الذين يستخدمون وكلاء AI لأتمتة المهام ويريدون مراقبتها.
• صناع المحتوى التقني الذين يشرحون وكلاء AI ويحتاجون أداة عرض توضيحي.

المميزات الرئيسية

• اكتشاف تلقائي للقنوات: يقرأ ملف تكوين OpenClaw ويعرض القنوات المفعلة فقط.
• لوحة تحكم في الوقت الفعلي: تحديث مباشر دون الحاجة لتحديث الصفحة.
• سهولة التثبيت: أمر واحد عبر pip أو Docker.
• مجاني ومفتوح المصدر: رخصة MIT تسمح بالتعديل والتوزيع.

المتطلبات الأساسية

• نظام تشغيل: Windows، macOS، أو Linux.
• Python 3.8 أو أحدث (للتثبيت عبر pip).
• Docker (اختياري، للتثبيت عبر الحاوية).
• ملف تكوين OpenClaw: `~/.openclaw/openclaw.json` (يتم إنشاؤه تلقائياً عند تشغيل OpenClaw).

تركيب ClawMetry خطوة بخطوة

الطريقة الأولى: التثبيت عبر pip (موصى به للمطورين)

1. تأكد من تثبيت Python 3.8+: python --version
2. ثبت ClawMetry: pip install clawmetry
3. شغل الأداة: clawmetry
4. افتح المتصفح على http://localhost:8900

الطريقة الثانية: التثبيت عبر Docker (موصى به للعزلة)

1. اسحب الصورة: docker pull clawmetry (أو استخدم docker run -p 8900:8900 clawmetry)
2. شغل الحاوية: docker run -p 8900:8900 clawmetry
3. افتح المتصفح على http://localhost:8900

الطريقة الثالثة: التثبيت من المصدر (للمطورين المتقدمين)

1. استنسخ المستودع: git clone https://GitHub.com/vivekchand/clawmetry.git
2. ادخل إلى المجلد: cd clawmetry
3. ثبت المتطلبات: pip install flask
4. شغل لوحة التحكم: python3 dashboard.py
5. افتح المتصفح على http://localhost:8900

ملف .env والتكوين

ClawMetry لا يتطلب ملف .env منفصل. بدلاً من ذلك، يقرأ تلقائياً ملف تكوين OpenClaw الموجود في ~/.openclaw/openclaw.json. إذا لم يكن الملف موجوداً، قد تحتاج إلى تشغيل OpenClaw أولاً أو إنشاء ملف تكوين يدوي. مثال لمحتوى الملف:

{
  "channels": {
    "slack": {"token": "xoxb-..."},
    "telegram": {"token": "123:..."}
  }
}

تشغيل ClawMetry

بعد التثبيت، شغل الأداة باستخدام الأمر clawmetry (أو python3 dashboard.py إذا كنت من المصدر). ستظهر رسالة تفيد بأن الخادم يعمل على المنفذ 8900. افتح المتصفح على http://localhost:8900 لرؤية لوحة التحكم. إذا كانت القنوات مفعلة، ستظهر فوراً.

أخطاء شائعة وحلولها

استخدامات عملية

• تصحيح أخطاء الوكيل: راقب تسلسل أفكار الوكيل لتحديد أين يحدث الخطأ.
• مراقبة الأداء: تعرف على زمن استجابة كل قناة لتحسين الأداء.
• عرض توضيحي: استخدم اللوحة لعرض قدرات وكيلك أمام العملاء أو الفريق.

هل يستحق ClawMetry التجربة؟

نعم، إذا كنت تستخدم OpenClaw AI وتحتاج إلى رؤية ما يحدث داخل وكيلك. الأداة مجانية، سهلة التثبيت، وتوفر قيمة فورية. لكن إذا كنت تستخدم وكيلاً واحداً بسيطاً ولا تحتاج مراقبة، فقد لا تكون ضرورية.

بدائل مشابهة

• LangSmith: منصة مراقبة مدفوعة من LangChain.
• Weights & Biases: أداة مراقبة تجارب ML.
• OpenClaw Logs: سجلات مدمجة في OpenClaw (أقل تفصيلاً).

أسئلة شائعة

هل ClawMetry يعمل مع وكلاء غير OpenClaw؟

لا، مصمم خصيصاً لـ OpenClaw AI.

هل يمكنني تشغيل ClawMetry على خادم بعيد؟

نعم، يمكنك تشغيله على خادم والوصول إليه عبر IP العام، لكن تأكد من إعدادات الأمان.

كلي أمان؟ هل يرسل بياناتي إلى الخارج؟

ClawMetry يعمل محلياً ولا يرسل أي بيانات خارجية. جميع البيانات تبقى على جهازك.