From 4b2b1713ae12fbb69315b0f16c0f7e842c597d61 Mon Sep 17 00:00:00 2001 From: vivekchand <987905+vivekchand@users.noreply.github.com> Date: Fri, 21 Aug 2026 04:13:46 +0000 Subject: [PATCH] docs(i18n): sync translated READMEs --- docs/i18n/ar/README.md | 456 +++++--------------------------- docs/i18n/bn/README.md | 449 +++++--------------------------- docs/i18n/de/README.md | 454 +++++--------------------------- docs/i18n/el/README.md | 520 +++++-------------------------------- docs/i18n/es-419/README.md | 448 +++++--------------------------- docs/i18n/es/README.md | 450 +++++--------------------------- docs/i18n/fa/README.md | 446 +++++-------------------------- docs/i18n/fil/README.md | 448 +++++--------------------------- docs/i18n/fr/README.md | 449 +++++--------------------------- docs/i18n/gu/README.md | 451 +++++--------------------------- docs/i18n/he/README.md | 452 +++++--------------------------- docs/i18n/hi/README.md | 453 +++++--------------------------- docs/i18n/id/README.md | 449 +++++--------------------------- docs/i18n/it/README.md | 449 +++++--------------------------- docs/i18n/ja/README.md | 428 +++++------------------------- docs/i18n/kn/README.md | 453 +++++--------------------------- docs/i18n/ko/README.md | 452 +++++--------------------------- docs/i18n/ml/README.md | 452 +++++--------------------------- docs/i18n/mr/README.md | 455 +++++--------------------------- docs/i18n/nl/README.md | 451 +++++--------------------------- docs/i18n/pa/README.md | 446 +++++-------------------------- docs/i18n/pl/README.md | 449 +++++--------------------------- docs/i18n/pt-BR/README.md | 448 +++++--------------------------- docs/i18n/pt-PT/README.md | 447 +++++-------------------------- docs/i18n/ru/README.md | 451 +++++--------------------------- docs/i18n/sv/README.md | 447 +++++-------------------------- docs/i18n/ta/README.md | 447 +++++-------------------------- docs/i18n/te/README.md | 429 +++++------------------------- docs/i18n/th/README.md | 456 +++++--------------------------- docs/i18n/tr/README.md | 454 +++++--------------------------- docs/i18n/uk/README.md | 449 +++++--------------------------- docs/i18n/ur/README.md | 448 +++++--------------------------- docs/i18n/vi/README.md | 450 +++++--------------------------- docs/i18n/zh-CN/README.md | 444 +++++-------------------------- docs/i18n/zh-TW/README.md | 446 +++++-------------------------- 35 files changed, 2167 insertions(+), 13609 deletions(-) diff --git a/docs/i18n/ar/README.md b/docs/i18n/ar/README.md index e1bd225326..fc332e128b 100644 --- a/docs/i18n/ar/README.md +++ b/docs/i18n/ar/README.md @@ -1,431 +1,108 @@ - -> العربية translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. - - + > العربية translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**شاهد وكيلك وهو يفكّر.** مراقبة فورية لـ **22 بيئة تشغيل لوكلاء الذكاء الاصطناعي**: [OpenClaw](https://github.com/openclaw/openclaw)، [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)، Claude Code، OpenAI Codex و19 أخرى. لوحة تحكم واحدة لأسطول وكلائك بالكامل. +**شاهد تفكير وكيلك.** مراقبة فورية لـ **23 بيئة تشغيل لوكلاء الذكاء الاصطناعي**: [OpenClaw](https://github.com/openclaw/openclaw)، [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)، Claude Code، OpenAI Codex و19 غيرها. لوحة تحكم واحدة لأسطول الوكلاء بأكمله. -> 🌐 **اقرأ هذا بلغة:** [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/) +> 🌐 **اقرأ هذا بلغة:** [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** وانتهى الأمر. +يفتح على **http://localhost:8900**. بدون إعدادات: يجد بيئات تشغيل الوكلاء +الموجودة لديك بالفعل، يقرأها للقراءة فقط، ولا يغيّر شيئًا في طريقة عملها. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## يعمل مع 20 بيئة تشغيل للوكلاء - -بدأت ClawMetry كأداة مراقبة لـ OpenClaw، والآن تقيس **أسطول وكلائك بالكامل** في لوحة تحكم واحدة، وتكتشف كل بيئة تشغيل على جهازك تلقائياً: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -بيئتا 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 - بث حي لأحداث الوكيل -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview - استخدام الرموز وملخص الجلسة -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow - تغذية فورية لاستدعاءات الأدوات -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens - تفصيل التكلفة حسب النموذج والجلسة -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory - متصفح ملفات مساحة العمل -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security - الوضع الأمني وسجل التدقيق -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts - حدود الميزانية، محفزات معدل الأخطاء، خطافات الويب إلى Slack / Discord / PagerDuty / البريد الإلكتروني -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals - حجب استدعاءات الأدوات الخطرة خلف موافقة يدوية؛ قواعد حماية مدعومة بسياسات -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**الحجب قبل التنفيذ لـ 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 -``` +## يعمل مع 23 بيئة تشغيل للوكلاء -افتح `http://localhost:5173/v2/`. يقوم Vite بتوجيه طلبات `/api` إلى -`http://localhost:8900`، بحيث يمكن لتطبيق React التواصل مع خادم Flask المحلي -دون إعداد CORS إضافي. +**مجانًا في التطبيق مفتوح المصدر:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -لبناء الحزمة التي تُشحن مع حزمة بايثون: +**في خطة مدفوعة:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -```bash -cd frontend -npm run build -``` +كل بيئة تشغيل تحصل على نفس لوحة التحكم. شغّل عدة بيئات في آن واحد، ومحوّل +الترويسة يعيد تحديد نطاق كل تبويب ليخصّ إحداها. -تُكتَب الحزمة الإنتاجية إلى `clawmetry/static/v2/dist/`. +هل بنيت وكيلك الخاص باستخدام SDK بدلًا من ذلك؟ يتتبّع المعترِض (interceptor) +استدعاءات نموذج اللغة الخاصة به أيضًا. راجع [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -## توافق بيئات التشغيل / الوكلاء +## ما الذي تحصل عليه -تراقب ClawMetry العديد من بيئات تشغيل وكلاء الذكاء الاصطناعي، وليس OpenClaw فقط. كل بيئة تشغيل غير OpenClaw تأتي بمحوّل قراءة مخصص يترجم صيغة الجلسة الأصلية الخاصة بها إلى الأشكال الموحدة لـ ClawMetry؛ يستوعبها الخادم الخلفي في نفس مخزن DuckDB + اللقطة السحابية، مع وسمها ببيئة التشغيل، ويعرض تبويب إعادة تشغيل الجلسة **محدّد بيئة تشغيل** عند وجود أكثر من واحدة. راجع [`docs/compatibility.md`](docs/compatibility.md) للاطلاع على المصفوفة الكاملة + دليل إضافة بيئات تشغيل جديدة، و[`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) لمقدمة عائلة OpenClaw. +- **الجلسات والنصوص الكاملة**: ما فعله كل وكيل، دورًا بعد دور، مع إعادة التشغيل +- **التكلفة والرموز (tokens)**: لكل بيئة تشغيل ونموذج وجلسة ويوم، مع إشارات الشذوذ +- **التدفق (Flow)**: رسم بياني حي للرسائل المتنقلة عبر القنوات والنماذج والأدوات +- **العقل (Brain)**: تدفق أحداث التفكير واستدعاء الأدوات لحظة حدوثها +- **الذاكرة والمهارات**: الملفات والمهارات التي حمّلتها كل بيئة تشغيل فعليًا +- **الصحة والسجلات**: القرص، الذاكرة، معدلات الأخطاء، حدود المعدل، تدفق السجل الحي +- **التنبيهات**: حدود الميزانية، ارتفاعات الأخطاء، توقف الوكيل عن العمل، موجّهة إلى Slack وDiscord وPagerDuty وTelegram والبريد الإلكتروني +- **الموافقات**: أوقف استدعاءات الأدوات الخطرة *قبل* تنفيذها ووافق عليها من هاتفك ([كيف](docs/APPROVALS.md)) -هل تشغّل أداة [numbat](https://github.com/perplexityai/numbat) الأمنية للوكلاء من Perplexity؟ تستوعب ClawMetry نتائجها وقرارات الإنفاذ الخاصة بها جاهزة للاستخدام - راجع [`docs/NUMBAT.md`](docs/NUMBAT.md). +## التسعير -| بيئة التشغيل / الوكيل | الحالة | ملاحظات | +| الخطة | ما تغطيه | السعر | |---|---|---| -| **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** | محوّل تجريبي | JSONL خاص بالتشغيل على `~/.codex/sessions/...`. سجلات المحادثة، النموذج، استدعاءات الأدوات، استخدام الرموز. | -| **Cursor** | محوّل تجريبي | SQLite بصيغة `state.vscdb`. سجلات محادثة/composer، النموذج. | -| **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`. تنفيذات سير العمل، تشغيلات العُقد، مطالبات AI Agent، النموذج + الرموز حيثما يسجّلها n8n. | -| **Antigravity** | محوّل تجريبي | Brain JSONL تحت `~/.gemini//brain/`. المحادثات، خطوات الأدوات، التفكير، تقسيم رموز Gemini لكل توليد + التكلفة، استهلاك التوليد في الخلفية. | -| **GitHub Copilot** | محوّل تجريبي | ملف `events.jsonl` الخاص بـ Copilot CLI تحت `~/.copilot/session-state/` + سجل استخدام `session-store.db` لكل استدعاء. المحادثات، استدعاءات الأدوات، توجيه النموذج، تقسيم الرموز المدرك للتخزين المؤقت، التكلفة المفوترة عبر رصيد الذكاء الاصطناعي للمورّد. | -| **Grok** | محوّل تجريبي | Grok Build CLI من xAI (ثنائي Rust تحت `~/.grok/bin/grok`)‏: سجل أحداث عام على `~/.grok/logs/unified.jsonl` + لكل جلسة `~/.grok/sessions///{events.jsonl,summary.json}`. المحادثات، تقسيم الرموز لكل دور، توجيه النموذج، وحمولة المستودع الصادرة من الأداة والمخزَّنة مؤقتاً تحت `~/.grok/upload_queue/` بحيث يمكنك رؤية ما غادر جهازك. | - -"محوّل تجريبي" تعني أن ClawMetry تشحن قارئاً لصيغة القرص الفعلية لبيئة التشغيل تلك، مبنياً ومُتحقَّقاً منه على تثبيت حقيقي على جهاز حقيقي (راجع `tests/fixtures/runtimes//`). المحوّلات للقراءة فقط؛ وكل واحد منها صريح بشأن ما تخزّنه بيئة التشغيل فعلياً (مثلاً PicoClaw/NanoClaw/Cursor لا تكتب تكلفة الرموز إلى القرص). عند تشغيل عدة بيئات تشغيل على عقدة واحدة، يُحدد محدّد بيئة التشغيل نطاق عرض الجلسات لواحدة منها لتعمّق نظيف. - -## تتبّع أي وكيل SDK - إسناد التكلفة خارج الحلقة - -بيئات التشغيل أعلاه جميعها تكتب الجلسات إلى القرص. **وكيل الإنتاج** الخاص بك - الذي بنيته على OpenAI Agents SDK أو LangChain أو Vercel AI SDK أو LlamaIndex أو E2B أو حلقة `httpx` عادية - لا يفعل ذلك. لا يزال محوّل ClawMetry بلا إعداد يلتقط استدعاءات LLM الخاصة به (التكلفة، الرموز، زمن الاستجابة، الأخطاء) عن طريق تصحيح `httpx`/`requests` بشكل قردي: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -تقوم `set_source()` (أو متغير البيئة `CLAWMETRY_SOURCE=support-agent`) بوسم كل استدعاء **بمصدر مسمّى**، بحيث يظهر كل منتج تشغّله كسطر مستقل قابل لإسناد التكلفة في بطاقة **🔌 المصادر خارج الحلقة** في تبويب Overview بلوحة التحكم - الاستدعاءات والمزوّدون وزمن الاستجابة ومعدل الأخطاء لكل وكيل. لم تحدد مصدراً؟ تظل الاستدعاءات متتبَّعة، وتبقى البطاقة مخفية فقط. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -هذه هي نفس طبقة البيانات التي تغذّيها محوّلات بيئة التشغيل (DuckDB ← اللقطة السحابية)، لذا تتزامن المصادر خارج الحلقة مع لوحة التحكم السحابية مثل كل شيء آخر، بتشفير من طرف إلى طرف. - -## OpenTelemetry - محايد تجاه المورّد، أرسل تتبعاتك إلى أي مكان - -تتحدث ClawMetry **OpenTelemetry** في الاتجاهين، باستخدام **اتفاقيات GenAI الدلالية**، بحيث لا تُحبس تتبعات وكيلك أبداً داخل أداة واحدة. - -**التصدير**: كل جلسة - استدعاءات LLM، الأدوات، الوكلاء الفرعيون، الرموز، التكلفة - كـ نطاقات GenAI عبر OTLP/HTTP إلى أي جامع (Datadog أو Grafana أو Honeycomb أو جامع OTel الخاص بك): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -رؤوس المصادقة وفترة الاستطلاع اختيارية عبر متغيرات البيئة: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**الاستيعاب** - يقبل مستقبل OTLP المدمج التتبعات والسجلات والمقاييس من أي مصدر آخر على `/v1/traces` و`/v1/logs` و`/v1/metrics`. وجّه أي تطبيق مزوَّد بأدوات OpenTelemetry إليه: +| **مجانية** | OpenClaw وNVIDIA NemoClaw، لوحة التحكم الكاملة، محليًا فقط | $0 | +| **Starter** | كل بيئة تشغيل أخرى مذكورة أعلاه، عرض الأسطول، المزامنة السحابية | 9$ لكل عقدة / شهر | +| **Pro** | Starter بالإضافة إلى الحوكمة: الموافقات، سياسات مخاطر الأدوات، التقييمات، كشف الشذوذ، محسّن التكلفة، تصدير OTel | 19$ لكل عقدة / شهر | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -تعمل تتبعات وسجلات OTLP/JSON على `pip install clawmetry` عادي، بلا إضافات. أما استيعاب protobuf (ومقاييس OTLP/JSON) فيحتاج إلى `pip install clawmetry[otel]`. التطبيق الذي يحدد `service.name` الخاص به يظهر كوكيله المستقل في محدّد بيئة التشغيل، مع تكلفته ورموزه. - -تحصل على لوحة تحكم ClawMetry بلا إعداد ومحلية أولاً **و** بياناتك في أي خادم خلفي يستخدمه فريقك بالفعل - بلا احتكار، وبلا وكيل ثانٍ للتثبيت. - -## الإعداد - -معظم الأشخاص لا يحتاجون لأي إعداد. تكتشف ClawMetry تلقائياً مساحة عملك وسجلاتك وجلساتك ومهامك المجدولة. - -إذا كنت بحاجة للتخصيص: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -جميع الخيارات: `clawmetry --help` - -## القنوات المدعومة - -تعرض ClawMetry النشاط الحي لكل قناة OpenClaw قمت بإعدادها. تظهر في مخطط Flow فقط القنوات المُعدَّة فعلياً في ملف `openclaw.json` الخاص بك - أما غير المُعدَّة فتُخفى تلقائياً. - -انقر على أي عقدة قناة في Flow لرؤية عرض فقاعات محادثة حي مع عدّاد الرسائل الواردة/الصادرة. - -| القناة | الحالة | نافذة حية | ملاحظات | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ كاملة | ✅ | الرسائل، الإحصاءات، تحديث كل 10 ثوان | -| 💬 **iMessage** | ✅ كاملة | ✅ | تقرأ `~/Library/Messages/chat.db` مباشرة | -| 💚 **WhatsApp** | ✅ كاملة | ✅ | عبر WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ كاملة | ✅ | عبر signal-cli | -| 🟣 **Discord** | ✅ كاملة | ✅ | اكتشاف الخادم + القناة | -| 🟪 **Slack** | ✅ كاملة | ✅ | اكتشاف مساحة العمل + القناة | -| 🌐 **Webchat** | ✅ كاملة | ✅ | جلسات واجهة الويب المدمجة | -| 📡 **IRC** | ✅ كاملة | ✅ | واجهة فقاعات بنمط الطرفية | -| 🍏 **BlueBubbles** | ✅ كاملة | ✅ | iMessage عبر واجهة BlueBubbles REST | -| 🔵 **Google Chat** | ✅ كاملة | ✅ | عبر خطافات ويب Chat API | -| 🟣 **MS Teams** | ✅ كاملة | ✅ | عبر إضافة بوت Teams | -| 🔷 **Mattermost** | ✅ كاملة | ✅ | دردشة فريق ذاتية الاستضافة | -| 🟩 **Matrix** | ✅ كاملة | ✅ | لا مركزية، دعم E2EE | -| 🟢 **LINE** | ✅ كاملة | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ كاملة | ✅ | رسائل مباشرة لا مركزية NIP-04 | -| 🟣 **Twitch** | ✅ كاملة | ✅ | دردشة عبر اتصال IRC | -| 🔷 **Feishu/Lark** | ✅ كاملة | ✅ | اشتراك أحداث WebSocket | -| 🔵 **Zalo** | ✅ كاملة | ✅ | Zalo Bot API | - -> **الاكتشاف التلقائي:** تقرأ ClawMetry ملف `~/.openclaw/openclaw.json` الخاص بك وتعرض فقط القنوات التي أعددتها فعلياً. لا حاجة لإعداد يدوي. - -## نشر Docker - -تريد تشغيل ClawMetry في حاوية؟ لا مشكلة! 🐳 - -**بداية سريعة مع Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**مثال Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **ملاحظة:** عند التشغيل داخل Docker، اربط دلائل بيانات وسجلات وكيلك (مثل `~/.openclaw`، `~/.claude`، `~/.codex`) حتى تتمكن ClawMetry من اكتشاف إعدادك تلقائياً. - -## المتطلبات - -- بايثون 3.8+ -- Flask (يُثبَّت تلقائياً عبر pip) -- بيئة تشغيل لوكيل ذكاء اصطناعي على نفس الجهاز: OpenClaw أو NVIDIA NemoClaw أو Claude Code أو Codex أو Cursor أو Goose أو Hermes أو opencode أو Qwen Code أو Aider أو NanoClaw أو PicoClaw أو Pi أو Deep Agents أو n8n أو Antigravity أو GitHub Copilot أو Grok أو QM (أو أحجام مثبَّتة لـ Docker) -- لينكس أو macOS - -## دعم NemoClaw / OpenShell - -تكتشف ClawMetry تلقائياً [NemoClaw](https://github.com/NVIDIA/NemoClaw) - غلاف الأمان المؤسسي من NVIDIA لـ OpenClaw الذي يشغّل الوكلاء داخل حاويات OpenShell المعزولة. +الخطط السنوية والمؤسسات والأرقام الحالية موجودة على +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. مفاتيح الترخيص +للاستضافة الذاتية تعمل بدون السحابة (`clawmetry license`). التقسيم الدقيق +بين المجاني والمدفوع موجود في [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -لا حاجة لإعداد إضافي في معظم الحالات. يكتشف الخادم الخلفي للمزامنة ملفات الجلسات تلقائياً سواء كانت موجودة في `~/.openclaw/` على المضيف أو داخل حاوية OpenShell. +## بياناتك تبقى على جهازك -### كيف يعمل +يقرأ ClawMetry ملفات الجلسات والسجلات المحلية. لا شيء يغادر جهازك ما لم +تشغّل `clawmetry connect`. وحتى عندئذٍ، تكون اللقطة (snapshot) مشفّرة من +طرف إلى طرف بمفتاح لا يغادر جهازك أبدًا، ويُفكّ تشفيرها في متصفحك. -تكتشف ClawMetry NemoClaw بطريقتين: - -1. **اكتشاف الثنائي** - يتحقق من وجود أداة سطر الأوامر `nemoclaw` ويشغّل `nemoclaw status` للحصول على معلومات الصندوق الرملي -2. **اكتشاف الحاوية** - يفحص حاويات Docker العاملة بحثاً عن صور `openshell` أو `nemoclaw` أو `ghcr.io/nvidia/`، ثم يقرأ الجلسات عبر أحجام مثبَّتة أو `docker cp` - -تُوسَم ملفات الجلسات المُزامنة من حاويات NemoClaw بـ `runtime=nemoclaw` وبيانات وصفية `container_id` في لوحة التحكم السحابية، حتى تتمكن من تمييزها عن جلسات OpenClaw القياسية للوهلة الأولى. - -### الإعداد الموصى به: خادم المزامنة على المضيف - -للحصول على أفضل تجربة، شغّل خادم المزامنة الخاص بـ ClawMetry على **الجهاز المضيف** (وليس داخل الصندوق الرملي). هذا يتجنب قيود سياسة شبكة NemoClaw. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -سيجد خادم المزامنة تلقائياً الجلسات داخل أي حاويات OpenShell عاملة. - -### اختياري: اسم صندوق رملي صريح - -إذا لم يعمل الاكتشاف التلقائي، وجّه ClawMetry إلى الصندوق الرملي الصحيح: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### التشغيل داخل الصندوق الرملي (متقدم) - -إذا كان عليك تشغيل خادم المزامنة **داخل** صندوق OpenShell الرملي، أضف قاعدة الخروج هذه إلى سياسة شبكة NemoClaw الخاصة بك حتى يتمكن من الوصول إلى واجهة استيعاب ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -طبّقها بـ: +## التثبيت ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # ثم: clawmetry ``` -### المنافذ والنقاط الطرفية - -| النقطة الطرفية | المنفذ | البروتوكول | مطلوب | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | نعم (خادم المزامنة ← السحابة) | -| `localhost:8900` | 8900 | HTTP | نعم (واجهة لوحة التحكم المحلية) | -| مقبس Docker (‏`/var/run/docker.sock`‏) | — | مقبس يونكس | لاكتشاف جلسات الحاوية | - -يقوم خادم المزامنة بإجراء استدعاءات HTTPS صادرة فقط إلى `ingest.clawmetry.com`. لا حاجة لأي منافذ واردة. - ---- - -## النشر السحابي - -راجع **[دليل اختبار السحابة](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** لأنفاق SSH، والوكيل العكسي، وDocker. +أو السطر الواحد: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -## الاختبار +يتطلب Python 3.8 فما فوق على macOS أو Linux أو Windows، وعلى الأقل بيئة +تشغيل وكيل واحدة على نفس الجهاز. تعليمات Docker: [docs/DOCKER.md](docs/DOCKER.md). -يُختبَر هذا المشروع باستخدام BrowserStack. +## التوثيق -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +| | | +|---|---| +| [توافق بيئات التشغيل](docs/compatibility.md) | ما يقرأه كل محوّل، وكيفية إضافة بيئة تشغيل | +| [الأهليات](docs/ENTITLEMENTS.md) | المجاني مقابل المدفوع، مصفوفة الفئات، أداة الترخيص CLI | +| [الموافقات والسياسات](docs/APPROVALS.md) | التحقق قبل التنفيذ، تقييم المخاطر، الموافقات عبر الهاتف | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | صدّر آثار التتبع إلى أي مكان، استقبل OTLP من أي مصدر | +| [تتبع SDK](docs/SDK_TRACKING.md) | إسناد التكلفة للوكلاء التي بنيتها بنفسك | +| [قنوات الدردشة](docs/CHANNELS.md) | محوّلات الدردشة الظاهرة في التدفق (Flow) | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | إعدادات NVIDIA NemoClaw المعزولة (sandboxed) | +| [Docker](docs/DOCKER.md) | الصورة، الـcompose، تركيب وحدات التخزين | +| [البنية المعمارية](ARCHITECTURE.md) · [التطوير](docs/DEVELOPMENT.md) | كيف يعمل من الداخل؛ التشغيل من المصدر | +| [القياس عن بُعد](docs/TELEMETRY.md) | إشعارات التثبيت وفتح سطح المكتب المجهولة، وكيفية إيقافها | -## القياس عن بُعد +## لقطات الشاشة -ترسل ClawMetry إشارات تنبيه مجهولة لدورة حياة التثبيت إلى -`https://app.clawmetry.com/api/install`: إشارة `install` واحدة أول -مرة تشغّل فيها سطر أوامر `clawmetry` على جهاز جديد، وإشارة `update` -واحدة عند أول تشغيل بعد الترقية إلى إصدار جديد، وإشارة `onboarded` -واحدة عند إكمال خيار الإعداد داخل لوحة التحكم. نستخدم هذا لعدّ -التثبيتات الحقيقية (أرقام تنزيل PyPI الخام هي بنسبة ~98% مرايا، -وCI، وإعادة تنزيلات التحديث التلقائي) ولمعرفة أطر عمل الوكلاء -وإصداراتها المستخدمة فعلياً في الواقع. +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **نظرة عامة**: الرموز، الجلسات، الصحة | **العقل (Brain)**: تدفق أحداث الوكيل الحي | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **التكلفة**: حسب النموذج والجلسة | **الموافقات**: إيقاف استدعاءات الأدوات الخطرة | -**حد أقصى POST واحد لكل حدث دورة حياة لكل إصدار**، ويحتوي على: - -| الحقل | مثال | السبب | -|---|---|---| -| `install_id` | UUID عشوائي مخزَّن في `~/.clawmetry/install_id` | إزالة التكرار؛ مجهول حتى تربط Cloud sync صراحة (نبضة قلب الخادم الموثّقة تحمل عندها المعرّف، رابطةً هذا التثبيت بحسابك) | -| `event` | `install` / `update` / `onboarded` | تثبيت جديد مقابل ترقية لتثبيت موجود | -| `version` | `0.12.167` | الإصدارات المستخدمة فعلياً | -| `os` / `os_version` | `Darwin` / `25.3.0` | أولويات دعم المنصة | -| `python` | `3.11.15` | مصفوفة دعم إصدار بايثون | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | مع أي وكلاء يجب أن نتكامل تالياً | -| `is_ci` / `ci_provider` | `true` / `github_actions` | فصل تثبيتات البشر عن ضجيج CI | - -**ما لا نرسله**: عنوان IP (تشتق السحابة رمز البلد من جانب الخادم -من الطلب، ثم تتجاهل عنوان IP)، اسم المضيف، اسم المستخدم، مسار مساحة -العمل، محتويات الملفات، مفتاح API الخاص بك، بريدك الإلكتروني، أي -معلومات تعريف شخصية أو خاصة بمساحة العمل. الحمولة السلكية قابلة -للتدقيق في [`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**إلغاء الاشتراك** (أي واحد من هذه يعطّله بشكل دائم): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -فشل الشبكة هنا لا يمنع أبداً تشغيل `clawmetry` - الإشارة تُرسَل بدون -انتظار على خيط خلفي بمهلة 3 ثوان. +المزيد، لكل بيئة تشغيل: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## تاريخ النجوم @@ -439,11 +116,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## الترخيص -MIT - ---- +MIT · بناه [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 شاهد وكيلك وهو يفكّر
- بُني بواسطة @vivekchand · clawmetry.com · جزء من نظام OpenClaw -

+ diff --git a/docs/i18n/bn/README.md b/docs/i18n/bn/README.md index ba09430c04..d63c54bf99 100644 --- a/docs/i18n/bn/README.md +++ b/docs/i18n/bn/README.md @@ -1,428 +1,106 @@ - + > বাংলা translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**আপনার এজেন্টকে ভাবতে দেখুন।** **২০টি AI এজেন্ট রানটাইমের** জন্য রিয়েল-টাইম অবজার্ভেবিলিটি: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex এবং আরও ১৬টি। আপনার পুরো এজেন্ট ফ্লিটের জন্য একটি ড্যাশবোর্ড। +**আপনার এজেন্টের চিন্তাভাবনা দেখুন।** **২৩টি AI এজেন্ট রানটাইমের** জন্য রিয়েল-টাইম অবজার্ভেবিলিটি: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex এবং আরও ১৯টি। আপনার পুরো এজেন্ট ফ্লিটের জন্য একটি ড্যাশবোর্ড। > 🌐 **এই ভাষায় পড়ুন:** [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** ঠিকানায় খুলে যায় এবং কাজ শেষ। +**http://localhost:8900** এ খোলে। শূন্য কনফিগারেশন: এটি আপনার কাছে থাকা এজেন্ট রানটাইমগুলো খুঁজে বের করে, সেগুলো শুধু পড়ে (read-only), এবং সেগুলো কীভাবে চলে তাতে কোনো পরিবর্তন আনে না। ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## ২০টি এজেন্ট রানটাইমের সাথে কাজ করে - -ClawMetry শুরু হয়েছিল OpenClaw-এর জন্য অবজার্ভেবিলিটি হিসেবে, আর এখন এটি আপনার **পুরো এজেন্ট ফ্লিটকে** একটি ড্যাশবোর্ডেই পরিমাপ করে, আপনার মেশিনে থাকা প্রতিটি রানটাইম স্বয়ংক্রিয়ভাবে শনাক্ত করে: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw এবং NemoClaw ওপেন-সোর্স অ্যাপে বিনামূল্যে; বাকি রানটাইমগুলো চালু হয় ClawMetry Cloud বা সেলফ-হোস্টেড Pro লাইসেন্সের মাধ্যমে। হেডার থেকে রানটাইম পাল্টান, আর প্রতিটি ট্যাব — খরচ, টোকেন, টুল, ট্রেস — সেই রানটাইমের সাথে সামঞ্জস্য রেখে নতুন করে দেখাবে। সঠিক ফ্রি/পেইড বিভাজন, টিয়ার ম্যাট্রিক্স, `/api/entitlement` শেপ এবং `clawmetry license` CLI-এর জন্য দেখুন **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)**। - -## আপনি যা পাবেন - -- **Flow** — চ্যানেল, ব্রেইন, টুল এবং ফিরতি পথ দিয়ে মেসেজ কীভাবে প্রবাহিত হচ্ছে তা দেখানো লাইভ অ্যানিমেটেড ডায়াগ্রাম -- **Overview** — হেলথ চেক, অ্যাক্টিভিটি হিটম্যাপ, সেশন সংখ্যা, মডেল তথ্য -- **Usage** — দৈনিক/সাপ্তাহিক/মাসিক বিভাজনসহ টোকেন এবং খরচ ট্র্যাকিং -- **Sessions** — মডেল, টোকেন, শেষ কার্যকলাপসহ সক্রিয় এজেন্ট সেশন -- **Crons** — স্ট্যাটাস, পরবর্তী রান, সময়কালসহ শিডিউল করা জব -- **Logs** — কালার-কোডেড রিয়েল-টাইম লগ স্ট্রিমিং -- **Memory** — SOUL.md, MEMORY.md, AGENTS.md, দৈনিক নোট ব্রাউজ করুন -- **Transcripts** — সেশন হিস্ট্রি পড়ার জন্য চ্যাট-বাবল UI -- **Alerts** — বাজেট ক্যাপ, এরর-রেট ট্রিগার, এজেন্ট-অফলাইন শনাক্তকরণ; Slack, Discord, PagerDuty, Telegram, Email-এ পাঠানো হয় -- **Approvals** — ধ্বংসাত্মক ডিলিট, ফোর্স পুশ, DB মিউটেশন, sudo, প্যাকেজ ইনস্টল, নেটওয়ার্ক কল এক-ক্লিক অনুমোদনের পেছনে আটকে রাখুন - -## স্ক্রিনশট - -### 🧠 Brain — লাইভ এজেন্ট ইভেন্ট স্ট্রিম -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — টোকেন ব্যবহার ও সেশন সারাংশ -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — রিয়েল-টাইম টুল কল ফিড -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — মডেল ও সেশন অনুযায়ী খরচের বিভাজন -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — ওয়ার্কস্পেস ফাইল ব্রাউজার -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — অবস্থান ও অডিট লগ -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — বাজেট ক্যাপ, এরর-রেট ট্রিগার, Slack / Discord / PagerDuty / Email-এ ওয়েবহুক -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — ঝুঁকিপূর্ণ টুল কল ম্যানুয়াল সাইন-অফের পেছনে আটকে রাখুন; পলিসি-সমর্থিত সুরক্ষা নিয়ম -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**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-এর নিজস্ব -পারমিশন প্রম্পট এড়িয়ে যায় (আপনি ইতিমধ্যেই উত্তর দিয়েছেন)। মিলে যায়নি এমন টুল -প্রায় ৪০ms খরচ করে এবং 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 ফ্রন্টএন্ড ডেভেলপমেন্ট - -v2 React অ্যাপটি `frontend/`-এ থাকে এবং v2 চালু করে ফ্লাস্ক -সার্ভার শুরু করলে `/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 -``` +**ওপেন সোর্স অ্যাপে বিনামূল্যে:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -`http://localhost:5173/v2/` খুলুন। Vite `/api` রিকোয়েস্টগুলো -`http://localhost:8900`-এ প্রক্সি করে দেয়, তাই React অ্যাপ অতিরিক্ত CORS -সেটআপ ছাড়াই লোকাল Flask সার্ভারের সাথে যোগাযোগ করতে পারে। +**পেইড প্ল্যানে:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -Python প্যাকেজের সাথে যে বান্ডেলটি শিপ হয় তা বিল্ড করতে: - -```bash -cd frontend -npm run build -``` +প্রতিটি রানটাইম একই ড্যাশবোর্ড পায়। একসাথে একাধিক চালান এবং হেডার সুইচার প্রতিটি ট্যাবকে তাদের যেকোনো একটির পরিসরে পুনরায় সাজিয়ে দেয়। -প্রোডাকশন বান্ডেলটি `clawmetry/static/v2/dist/`-এ লেখা হয়। +SDK দিয়ে নিজের এজেন্ট তৈরি করেছেন? ইন্টারসেপ্টর সেটির LLM কলও ট্র্যাক করে। দেখুন [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md)। -## রানটাইম / এজেন্ট সামঞ্জস্যতা +## আপনি যা পাবেন -ClawMetry শুধু OpenClaw নয়, আরও অনেক AI-এজেন্ট রানটাইম পর্যবেক্ষণ করে। প্রতিটি OpenClaw-ব্যতীত রানটাইম একটি ডেডিকেটেড রিডার অ্যাডাপ্টার নিয়ে আসে যা তার নিজস্ব সেশন ফরম্যাটকে ClawMetry-এর ইউনিফায়েড শেপে রূপান্তর করে; ডেমন সেগুলোকে একই DuckDB স্টোর + ক্লাউড স্ন্যাপশটে ইনজেস্ট করে, রানটাইম দিয়ে ট্যাগ করে, আর Session replay ট্যাবে একাধিক রানটাইম থাকলে একটি **রানটাইম সুইচার** দেখায়। সম্পূর্ণ ম্যাট্রিক্স + রানটাইম যোগ করার গাইডের জন্য দেখুন [`docs/compatibility.md`](docs/compatibility.md), এবং OpenClaw-পরিবার প্রাইমারের জন্য [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md)। +- **সেশন ও ট্রান্সক্রিপ্ট**: প্রতিটি এজেন্ট ধাপে ধাপে কী করেছে, রিপ্লে সহ +- **খরচ ও টোকেন**: রানটাইম, মডেল, সেশন এবং দিন অনুযায়ী, অস্বাভাবিকতার সংকেত সহ +- **ফ্লো**: চ্যানেল, মডেল এবং টুলের মধ্য দিয়ে যাওয়া বার্তাগুলোর লাইভ ডায়াগ্রাম +- **ব্রেইন**: রিজনিং ও টুল-কল ইভেন্ট স্ট্রিম যেমনটা ঘটছে তখনই +- **মেমরি ও স্কিল**: প্রতিটি রানটাইম আসলে যে ফাইল ও স্কিল লোড করেছে +- **স্বাস্থ্য ও লগ**: ডিস্ক, মেমরি, এরর রেট, রেট লিমিট, লাইভ লগ স্ট্রিম +- **অ্যালার্ট**: বাজেট ক্যাপ, এরর স্পাইক, এজেন্ট-অফলাইন, যা Slack, Discord, PagerDuty, Telegram, Email-এ পাঠানো হয় +- **অ্যাপ্রুভাল**: ঝুঁকিপূর্ণ টুল কল চালানোর *আগে* বিরতি দিন এবং আপনার ফোন থেকে অনুমোদন করুন ([কীভাবে](docs/APPROVALS.md)) -[Perplexity-এর numbat](https://github.com/perplexityai/numbat) এজেন্ট-সিকিউরিটি টুল চালাচ্ছেন? ClawMetry এর ফলাফল ও এনফোর্সমেন্ট সিদ্ধান্তগুলো বাক্সের বাইরেই ইনজেস্ট করে নেয় — দেখুন [`docs/NUMBAT.md`](docs/NUMBAT.md)। +## মূল্য নির্ধারণ -| রানটাইম / এজেন্ট | স্ট্যাটাস | নোট | +| প্ল্যান | যা কভার করে | মূল্য | |---|---|---| -| **OpenClaw** | Native | রেফারেন্স রানটাইম, স্বয়ংক্রিয়ভাবে শনাক্ত হয় | -| **PicoClaw** | Beta adapter | ফ্ল্যাট `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`)। ট্রান্সক্রিপ্ট, মডেল, টুল কল। | -| **NanoClaw** | Beta adapter | প্রতি-সেশন SQLite (`data/v2-sessions`)। ট্রান্সক্রিপ্ট + মেসেজ সংখ্যা। | -| **Hermes** | Beta adapter | SQLite `~/.hermes/state.db`। ট্রান্সক্রিপ্ট, মডেল, টোকেন/খরচ। | -| **Claude Code** | Beta adapter | JSONL `~/.claude/projects/.../.jsonl`। ট্রান্সক্রিপ্ট, মডেল, টুল কল + থিংকিং, টোকেন ব্যবহার। | -| **Codex** | Beta adapter | Rollout JSONL `~/.codex/sessions/...`। ট্রান্সক্রিপ্ট, মডেল, টুল কল, টোকেন ব্যবহার। | -| **Cursor** | Beta adapter | SQLite `state.vscdb`। চ্যাট/কম্পোজার ট্রান্সক্রিপ্ট, মডেল। | -| **Aider** | Beta adapter | প্রতি প্রজেক্টে `.aider.chat.history.md`। ট্রান্সক্রিপ্ট, মডেল, টোকেন গণনা। | -| **Goose** | Beta adapter | SQLite `~/.local/share/goose`। ট্রান্সক্রিপ্ট, মডেল, টুল কল, মোট টোকেন। | -| **opencode** | Beta adapter | SQLite `~/.local/share/opencode`। ট্রান্সক্রিপ্ট, মডেল, টুল কল, টোকেন + খরচ। | -| **Qwen Code** | Beta adapter | JSONL `~/.qwen/projects/.../chats`। ট্রান্সক্রিপ্ট, মডেল, টুল কল, টোকেন ব্যবহার। | -| **Pi** | Beta adapter | JSONL `~/.pi/agent/sessions`। ট্রান্সক্রিপ্ট, মডেল, টুল কল, টোকেন + খরচ। | -| **Deep Agents** | Beta adapter | SQLite `~/.deepagents/.state/sessions.db`। ট্রান্সক্রিপ্ট, মডেল, টুল কল, টোকেন + খরচ। | -| **n8n** | Beta adapter | SQLite `~/.n8n/database.sqlite`। ওয়ার্কফ্লো এক্সিকিউশন, নোড রান, AI Agent প্রম্পট, n8n যেখানে রেকর্ড করে সেখানে মডেল + টোকেন। | -| **Antigravity** | Beta adapter | `~/.gemini//brain/`-এর অধীনে Brain JSONL। কথোপকথন, টুল স্টেপ, থিংকিং, প্রতি-জেনারেশন Gemini টোকেন বিভাজন + খরচ, ব্যাকগ্রাউন্ড-জেনারেশন খরচ। | -| **GitHub Copilot** | Beta adapter | `~/.copilot/session-state/`-এর অধীনে Copilot CLI `events.jsonl` + প্রতি-কল ব্যবহারের `session-store.db` লেজার। কথোপকথন, টুল কল, মডেল রাউটিং, ক্যাশ-সচেতন টোকেন বিভাজন, ভেন্ডর-বিলড AI-ক্রেডিট খরচ। | -| **Grok** | Beta adapter | xAI Grok Build CLI (`~/.grok/bin/grok`-এর অধীনে Rust বাইনারি): গ্লোবাল ইভেন্ট লগ `~/.grok/logs/unified.jsonl` + প্রতি-সেশন `~/.grok/sessions///{events.jsonl,summary.json}`। কথোপকথন, প্রতি-টার্ন টোকেন বিভাজন, মডেল রাউটিং, এবং CLI-এর বাইরে যাওয়া রিপো পেলোড `~/.grok/upload_queue/`-এ স্টেজড, যাতে আপনার মেশিন থেকে কী বেরিয়ে গেছে তা দেখতে পারেন। | - -"Beta adapter" মানে ClawMetry সেই রানটাইমের প্রকৃত অন-ডিস্ক ফরম্যাটের জন্য একটি রিডার শিপ করে, প্রতিটি বাস্তব মেশিনে বাস্তব ইনস্টলের বিপরীতে তৈরি + যাচাই করা (`tests/fixtures/runtimes//` দেখুন)। অ্যাডাপ্টারগুলো রিড-অনলি; প্রতিটি তার রানটাইম আসলে কী সংরক্ষণ করে সে বিষয়ে সৎ (যেমন, PicoClaw/NanoClaw/Cursor ডিস্কে টোকেন খরচ লেখে না)। একই নোডে একাধিক রানটাইম চললে, রানটাইম সুইচার পরিষ্কার ডিপ-ডাইভের জন্য সেশন ভিউকে একটিতে সীমাবদ্ধ করে দেয়। - -## যেকোনো SDK এজেন্ট ট্র্যাক করুন — আউট-লুপ খরচ অ্যাট্রিবিউশন - -উপরের রানটাইমগুলো সবই ডিস্কে সেশন লেখে। আপনার নিজের **প্রোডাকশন এজেন্ট** — যেটা আপনি OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, বা একটি সাধারণ `httpx` লুপের ওপর তৈরি করেছেন — সেটা তা করে না। ClawMetry-এর জিরো-কনফিগ ইন্টারসেপ্টর `httpx`/`requests`-কে মাংকি-প্যাচ করে তার LLM কলগুলো (খরচ, টোকেন, লেটেন্সি, এরর) ঠিকই ধরে ফেলে: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (অথবা `CLAWMETRY_SOURCE=support-agent` এনভায়রনমেন্ট ভেরিয়েবল) প্রতিটি কলকে একটি **নামযুক্ত সোর্স** দিয়ে ট্যাগ করে, তাই আপনি যে প্রতিটি প্রোডাক্ট চালান তা ড্যাশবোর্ডের **🔌 Out-loop sources** কার্ডে Overview-তে নিজস্ব প্রথম-শ্রেণির, খরচ-অ্যাট্রিবিউটেবল লাইন হিসেবে দেখা যায় — প্রতি এজেন্টের জন্য কল, প্রোভাইডার, লেটেন্সি, এরর রেট। সোর্স সেট করা হয়নি? কলগুলো তখনও ট্র্যাক হয়; কার্ডটি শুধু লুকানো থাকে। - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -এটি একই ডেটা লেয়ার যা রানটাইম অ্যাডাপ্টারগুলো খাওয়ায় (DuckDB → ক্লাউড স্ন্যাপশট), তাই আউট-লুপ সোর্সগুলো বাকি সবকিছুর মতোই, E2E-এনক্রিপ্টেড অবস্থায় ক্লাউড ড্যাশবোর্ডে সিঙ্ক হয়। - -## OpenTelemetry — ভেন্ডর-নিরপেক্ষ, আপনার ট্রেস যেকোনো জায়গায় পাঠান - -ClawMetry উভয় দিকে **OpenTelemetry** বলতে পারে, **GenAI সিমান্টিক কনভেনশন** ব্যবহার করে, তাই আপনার এজেন্ট ট্রেস কখনও একটি টুলে আটকে থাকে না। - -প্রতিটি সেশন — LLM কল, টুল, সাব-এজেন্ট, টোকেন, খরচ — যেকোনো কালেক্টরে (Datadog, Grafana, Honeycomb, বা আপনার নিজের OTel Collector) OTLP/HTTP GenAI স্প্যান হিসেবে **এক্সপোর্ট** করুন: - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -অথ হেডার এবং পোল ইন্টারভাল ঐচ্ছিক এনভায়রনমেন্ট ভেরিয়েবল: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**ইনজেস্ট** — বিল্ট-ইন OTLP রিসিভার `/v1/traces`, `/v1/logs`, এবং `/v1/metrics`-এ যেকোনো জায়গা থেকে ট্রেস, লগ এবং মেট্রিক্স গ্রহণ করে। যেকোনো OpenTelemetry-ইনস্ট্রুমেন্টেড অ্যাপকে এটির দিকে পয়েন্ট করুন: +| **Free** | OpenClaw + NVIDIA NemoClaw, সম্পূর্ণ ড্যাশবোর্ড, শুধু লোকাল | $0 | +| **Starter** | উপরের বাকি সব রানটাইম, ফ্লিট ভিউ, ক্লাউড সিঙ্ক | নোড প্রতি মাসে $9 | +| **Pro** | Starter + গভর্নেন্স: অ্যাপ্রুভাল, টুল-রিস্ক পলিসি, ইভাল, অস্বাভাবিকতা শনাক্তকরণ, কস্ট অপটিমাইজার, OTel এক্সপোর্ট | নোড প্রতি মাসে $19 | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON ট্রেস ও লগ সাধারণ `pip install clawmetry`-তেই কাজ করে, কোনো এক্সট্রা লাগে না। Protobuf ইনজেস্ট (এবং OTLP/JSON মেট্রিক্স) এর জন্য দরকার `pip install clawmetry[otel]`। যে অ্যাপ নিজের `service.name` সেট করে সেটি রানটাইম সুইচারে তার নিজস্ব এজেন্ট হিসেবে দেখা যায়, তার নিজস্ব খরচ ও টোকেনসহ। - -আপনি পাবেন জিরো-কনফিগ, লোকাল-ফার্স্ট ClawMetry ড্যাশবোর্ড **এবং** আপনার দল ইতিমধ্যেই যা চালায় সেই ব্যাকএন্ডে আপনার ডেটা — কোনো লক-ইন নেই, দ্বিতীয় কোনো এজেন্ট ইনস্টল করতে হবে না। - -## কনফিগারেশন - -বেশিরভাগ মানুষের কোনো কনফিগারেশনই লাগে না। ClawMetry আপনার ওয়ার্কস্পেস, লগ, সেশন, এবং ক্রন স্বয়ংক্রিয়ভাবে শনাক্ত করে নেয়। - -কাস্টমাইজ করার দরকার হলে: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -সব অপশন: `clawmetry --help` - -## সমর্থিত চ্যানেল - -আপনি কনফিগার করা প্রতিটি OpenClaw চ্যানেলের জন্য ClawMetry লাইভ অ্যাক্টিভিটি দেখায়। আপনার `openclaw.json`-এ যেসব চ্যানেল আসলে সেটআপ করা আছে শুধু সেগুলোই Flow ডায়াগ্রামে দেখা যায় — কনফিগার না করাগুলো স্বয়ংক্রিয়ভাবে লুকানো থাকে। - -Flow-তে যেকোনো চ্যানেল নোডে ক্লিক করে ইনকামিং/আউটগোয়িং মেসেজ গণনাসহ একটি লাইভ চ্যাট বাবল ভিউ দেখুন। - -| চ্যানেল | স্ট্যাটাস | লাইভ পপআপ | নোট | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Full | ✅ | মেসেজ, পরিসংখ্যান, ১০সে রিফ্রেশ | -| 💬 **iMessage** | ✅ Full | ✅ | সরাসরি `~/Library/Messages/chat.db` পড়ে | -| 💚 **WhatsApp** | ✅ Full | ✅ | WhatsApp Web (Baileys) এর মাধ্যমে | -| 🔵 **Signal** | ✅ Full | ✅ | signal-cli এর মাধ্যমে | -| 🟣 **Discord** | ✅ Full | ✅ | গিল্ড + চ্যানেল শনাক্তকরণ | -| 🟪 **Slack** | ✅ Full | ✅ | ওয়ার্কস্পেস + চ্যানেল শনাক্তকরণ | -| 🌐 **Webchat** | ✅ Full | ✅ | বিল্ট-ইন ওয়েব UI সেশন | -| 📡 **IRC** | ✅ Full | ✅ | টার্মিনাল-স্টাইল বাবল UI | -| 🍏 **BlueBubbles** | ✅ Full | ✅ | BlueBubbles REST API এর মাধ্যমে iMessage | -| 🔵 **Google Chat** | ✅ Full | ✅ | Chat API ওয়েবহুকের মাধ্যমে | -| 🟣 **MS Teams** | ✅ Full | ✅ | Teams বট প্লাগইনের মাধ্যমে | -| 🔷 **Mattermost** | ✅ Full | ✅ | সেলফ-হোস্টেড টিম চ্যাট | -| 🟩 **Matrix** | ✅ Full | ✅ | বিকেন্দ্রীভূত, E2EE সমর্থন | -| 🟢 **LINE** | ✅ Full | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Full | ✅ | বিকেন্দ্রীভূত NIP-04 DM | -| 🟣 **Twitch** | ✅ Full | ✅ | IRC সংযোগের মাধ্যমে চ্যাট | -| 🔷 **Feishu/Lark** | ✅ Full | ✅ | ওয়েবসকেট ইভেন্ট সাবস্ক্রিপশন | -| 🔵 **Zalo** | ✅ Full | ✅ | Zalo Bot API | - -> **স্বয়ংক্রিয় শনাক্তকরণ:** ClawMetry আপনার `~/.openclaw/openclaw.json` পড়ে এবং শুধু আপনার আসলেই কনফিগার করা চ্যানেলগুলোই রেন্ডার করে। ম্যানুয়াল সেটআপের দরকার নেই। - -## Docker ডিপ্লয়মেন্ট - -কনটেইনারে ClawMetry চালাতে চান? কোনো সমস্যা নেই! 🐳 - -**Docker দিয়ে দ্রুত শুরু:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose উদাহরণ:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **নোট:** Docker-এ চালানোর সময়, আপনার এজেন্টের ডেটা + লগ ডিরেক্টরি মাউন্ট করুন (যেমন `~/.openclaw`, `~/.claude`, `~/.codex`) যাতে ClawMetry আপনার সেটআপ স্বয়ংক্রিয়ভাবে শনাক্ত করতে পারে। - -## প্রয়োজনীয়তা - -- Python 3.8+ -- Flask (pip এর মাধ্যমে স্বয়ংক্রিয়ভাবে ইনস্টল হয়) -- একই মেশিনে একটি AI এজেন্ট রানটাইম: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, বা QM (অথবা Docker এর জন্য মাউন্ট করা ভলিউম) -- Linux বা macOS - -## NemoClaw / OpenShell সমর্থন - -ClawMetry স্বয়ংক্রিয়ভাবে [NemoClaw](https://github.com/NVIDIA/NemoClaw) শনাক্ত করে — NVIDIA-এর এন্টারপ্রাইজ সিকিউরিটি র‍্যাপার যা OpenClaw এজেন্টদের স্যান্ডবক্সড OpenShell কনটেইনারের ভেতরে চালায়। +বার্ষিক প্ল্যান, এন্টারপ্রাইজ এবং হালনাগাদ সংখ্যা পাওয়া যাবে +**[clawmetry.com/pricing](https://clawmetry.com/pricing)** এ। সেলফ-হোস্টেড লাইসেন্স +কী ক্লাউড ছাড়াই কাজ করে (`clawmetry license`)। সঠিক ফ্রি/পেইড বিভাজন আছে +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) এ। -বেশিরভাগ ক্ষেত্রে কোনো অতিরিক্ত কনফিগারেশনের দরকার নেই। সিঙ্ক ডেমন সেশন ফাইলগুলো স্বয়ংক্রিয়ভাবে খুঁজে বের করে, সেগুলো হোস্টে `~/.openclaw/`-এ থাকুক বা OpenShell কনটেইনারের ভেতরেই থাকুক। +## আপনার ডেটা আপনার মেশিনেই থাকে -### কীভাবে কাজ করে +ClawMetry লোকাল সেশন ফাইল ও লগ পড়ে। আপনি `clawmetry connect` না চালানো পর্যন্ত +কিছুই আপনার মেশিনের বাইরে যায় না। তখনও স্ন্যাপশটটি এমন একটি কী দিয়ে +এন্ড-টু-এন্ড এনক্রিপ্টেড থাকে যেটি কখনো আপনার মেশিন ছেড়ে যায় না, এবং +এটি আপনার ব্রাউজারে ডিক্রিপ্ট করা হয়। -ClawMetry দুইভাবে NemoClaw শনাক্ত করে: - -1. **বাইনারি শনাক্তকরণ** — `nemoclaw` CLI আছে কিনা তা চেক করে এবং স্যান্ডবক্স তথ্য পেতে `nemoclaw status` চালায় -2. **কনটেইনার শনাক্তকরণ** — চলমান Docker কনটেইনারগুলোতে `openshell`, `nemoclaw`, বা `ghcr.io/nvidia/` ইমেজ স্ক্যান করে, তারপর ভলিউম মাউন্ট বা `docker cp` এর মাধ্যমে সেশন পড়ে - -NemoClaw কনটেইনার থেকে সিঙ্ক করা সেশন ফাইলগুলো ক্লাউড ড্যাশবোর্ডে `runtime=nemoclaw` এবং `container_id` মেটাডেটা দিয়ে ট্যাগ করা হয়, তাই আপনি এক নজরে সেগুলোকে স্ট্যান্ডার্ড OpenClaw সেশন থেকে আলাদা করতে পারবেন। - -### প্রস্তাবিত সেটআপ: HOST-এ সিঙ্ক ডেমন - -সেরা অভিজ্ঞতার জন্য, ClawMetry-এর সিঙ্ক ডেমনটি **হোস্ট মেশিনে** চালান (স্যান্ডবক্সের ভেতরে নয়)। এটি NemoClaw নেটওয়ার্ক পলিসি বিধিনিষেধ এড়িয়ে যায়। - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -সিঙ্ক ডেমন স্বয়ংক্রিয়ভাবে যেকোনো চলমান OpenShell কনটেইনারের ভেতরে সেশন খুঁজে বের করবে। - -### ঐচ্ছিক: স্পষ্ট স্যান্ডবক্স নাম - -স্বয়ংক্রিয় শনাক্তকরণ কাজ না করলে, ClawMetry-কে সঠিক স্যান্ডবক্সের দিকে নির্দেশ করুন: +## ইনস্টল করুন ```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### স্যান্ডবক্সের ভেতরে চালানো (অ্যাডভান্সড) - -যদি আপনাকে সিঙ্ক ডেমনটি **স্যান্ডবক্সের ভেতরে** OpenShell-এ চালাতেই হয়, তাহলে আপনার NemoClaw নেটওয়ার্ক পলিসিতে এই egress নিয়মটি যোগ করুন যাতে এটি ClawMetry ইনজেস্ট API-এ পৌঁছাতে পারে: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https +pip install clawmetry # তারপর: clawmetry ``` -প্রয়োগ করুন এভাবে: +অথবা এক-লাইনার: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -```bash -nemoclaw policy apply --file nemoclaw-policy.yaml -``` +macOS, Linux বা Windows-এ Python 3.8+ প্রয়োজন, এবং একই মেশিনে অন্তত একটি এজেন্ট +রানটাইম প্রয়োজন। Docker নির্দেশনা: [docs/DOCKER.md](docs/DOCKER.md)। -### পোর্ট এবং এন্ডপয়েন্ট +## ডকুমেন্টেশন -| এন্ডপয়েন্ট | পোর্ট | প্রোটোকল | প্রয়োজনীয় | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | হ্যাঁ (সিঙ্ক ডেমন → ক্লাউড) | -| `localhost:8900` | 8900 | HTTP | হ্যাঁ (লোকাল ড্যাশবোর্ড UI) | -| Docker socket (`/var/run/docker.sock`) | — | Unix socket | কনটেইনার সেশন আবিষ্কারের জন্য | +| | | +|---|---| +| [রানটাইম কম্প্যাটিবিলিটি](docs/compatibility.md) | প্রতিটি অ্যাডাপ্টার কী পড়ে, এবং কীভাবে একটি রানটাইম যোগ করবেন | +| [Entitlements](docs/ENTITLEMENTS.md) | ফ্রি বনাম পেইড, টিয়ার ম্যাট্রিক্স, লাইসেন্স CLI | +| [অ্যাপ্রুভাল ও পলিসি](docs/APPROVALS.md) | প্রি-এক্সিকিউশন গেটিং, রিস্ক স্কোরিং, ফোন অ্যাপ্রুভাল | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | যেকোনো জায়গায় ট্রেস এক্সপোর্ট করুন, যেকোনো কিছু থেকে OTLP ইনজেস্ট করুন | +| [SDK ট্র্যাকিং](docs/SDK_TRACKING.md) | নিজে তৈরি করা এজেন্টদের জন্য খরচ অ্যাট্রিবিউশন | +| [চ্যাট চ্যানেল](docs/CHANNELS.md) | Flow-তে দেখানো চ্যাট অ্যাডাপ্টারগুলো | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | স্যান্ডবক্সড NVIDIA NemoClaw সেটআপ | +| [Docker](docs/DOCKER.md) | ইমেজ, কম্পোজ, ভলিউম মাউন্ট | +| [আর্কিটেকচার](ARCHITECTURE.md) · [ডেভেলপমেন্ট](docs/DEVELOPMENT.md) | ভেতরে কীভাবে কাজ করে; সোর্স থেকে চালানো | +| [টেলিমেট্রি](docs/TELEMETRY.md) | বেনামী ইনস্টল এবং ডেস্কটপ-ওপেন পিং, এবং সেগুলো কীভাবে বন্ধ করবেন | -সিঙ্ক ডেমন শুধুমাত্র `ingest.clawmetry.com`-এ আউটবাউন্ড HTTPS কল করে। কোনো ইনবাউন্ড পোর্টের দরকার নেই। - ---- - -## ক্লাউড ডিপ্লয়মেন্ট - -SSH টানেল, রিভার্স প্রক্সি, এবং Docker-এর জন্য দেখুন **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)**। - -## টেস্টিং - -এই প্রজেক্টটি BrowserStack দিয়ে টেস্ট করা হয়। - -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) - -## টেলিমেট্রি - -ClawMetry বেনামী ইনস্টল-লাইফসাইকেল পিং পাঠায় -`https://app.clawmetry.com/api/install`-এ: নতুন মেশিনে প্রথমবার -`clawmetry` CLI চালানোর সময় একটি `install` পিং, নতুন ভার্সনে -আপগ্রেড করার পর প্রথম রানে একটি `update` পিং, এবং ইন-ড্যাশবোর্ড -অনবোর্ডিং পছন্দ সম্পূর্ণ করলে একটি `onboarded` পিং। আমরা এটি ব্যবহার -করি প্রকৃত ইনস্টল গণনা করতে (কাঁচা PyPI ডাউনলোড সংখ্যার ~৯৮% মিরর, CI, -এবং অটো-আপডেট রি-ডাউনলোড) এবং কোন এজেন্ট ফ্রেমওয়ার্ক ও ভার্সন আসলে -ব্যবহৃত হচ্ছে তা জানতে। +## স্ক্রিনশট -**প্রতি লাইফসাইকেল ইভেন্ট প্রতি ভার্সনে সর্বোচ্চ একটি POST**, যাতে থাকে: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **ওভারভিউ**: টোকেন, সেশন, স্বাস্থ্য | **ব্রেইন**: লাইভ এজেন্ট ইভেন্ট স্ট্রিম | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **খরচ**: মডেল ও সেশন অনুযায়ী | **অ্যাপ্রুভাল**: ঝুঁকিপূর্ণ টুল কল গেট করুন | -| ফিল্ড | উদাহরণ | কেন | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id`-এ সংরক্ষিত র‍্যান্ডম UUID | ডুপ্লিকেট এড়াতে; আপনি স্পষ্টভাবে Cloud sync সংযুক্ত না করা পর্যন্ত বেনামী (তারপর অথেন্টিকেটেড ডেমন হার্টবিট এটি বহন করে, এই ইনস্টলটিকে আপনার অ্যাকাউন্টের সাথে যুক্ত করে) | -| `event` | `install` / `update` / `onboarded` | নতুন ইনস্টল নাকি বিদ্যমান একটির আপগ্রেড | -| `version` | `0.12.167` | কোন ভার্সনগুলো ব্যবহৃত হচ্ছে | -| `os` / `os_version` | `Darwin` / `25.3.0` | প্ল্যাটফর্ম সমর্থনের অগ্রাধিকার | -| `python` | `3.11.15` | Python ভার্সন সমর্থন ম্যাট্রিক্স | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | পরবর্তীতে আমাদের কোন এজেন্টের সাথে ইন্টিগ্রেট করা উচিত | -| `is_ci` / `ci_provider` | `true` / `github_actions` | মানুষের ইনস্টল থেকে CI নয়েজ আলাদা করতে | - -**আমরা যা পাঠাই না**: IP (ক্লাউড সার্ভার-সাইডে রিকোয়েস্ট থেকে -কান্ট্রি কোড বের করে নেয়, তারপর IP ফেলে দেয়), হোস্টনেম, ইউজারনেম, -ওয়ার্কস্পেস পাথ, ফাইলের কন্টেন্ট, আপনার api_key, আপনার ইমেইল, বা -কোনো PII বা ওয়ার্কস্পেস-নির্দিষ্ট কিছু। ওয়্যার পেলোডটি -[`clawmetry/telemetry.py`](clawmetry/telemetry.py)-এ অডিটযোগ্য। - -**অপ্ট আউট করুন** (এর যেকোনো একটি স্থায়ীভাবে এটি নিষ্ক্রিয় করে দেয়): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -নেটওয়ার্ক ব্যর্থতা কখনও `clawmetry`-কে চালানো থেকে ব্লক করে না — পিংটি -একটি ডেমন থ্রেডে ৩ সেকেন্ড টাইমআউট সহ ফায়ার-অ্যান্ড-ফরগেট। +আরও, রানটাইম অনুযায়ী: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md)। ## স্টার হিস্ট্রি @@ -436,11 +114,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## লাইসেন্স -MIT - ---- +MIT · তৈরি করেছেন [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 আপনার এজেন্টকে ভাবতে দেখুন
- @vivekchand দ্বারা নির্মিত · clawmetry.com · OpenClaw ইকোসিস্টেমের একটি অংশ -

+ diff --git a/docs/i18n/de/README.md b/docs/i18n/de/README.md index 4a681d0c2a..e6c2fcca24 100644 --- a/docs/i18n/de/README.md +++ b/docs/i18n/de/README.md @@ -1,17 +1,16 @@ - + > Deutsch translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Sieh zu, wie dein Agent denkt.** Echtzeit-Observability für **22 KI-Agent-Runtimes**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex und 19 weitere. Ein Dashboard für deine gesamte Agent-Flotte. +**Sieh zu, wie dein Agent denkt.** Echtzeit-Observability für **23 KI-Agenten-Runtimes**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex und 19 weitere. Ein Dashboard für deine gesamte Agenten-Flotte. > 🌐 **Lies dies auf:** [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) · [mehr →](docs/i18n/) @@ -21,413 +20,89 @@ Ein Befehl. Keine Konfiguration. Erkennt alles automatisch. pip install clawmetry && clawmetry ``` -Öffnet sich unter **http://localhost:8900** und schon ist es fertig. +Öffnet sich unter **http://localhost:8900**. Keine Konfiguration nötig: Es findet die Agenten-Runtimes, +die du bereits hast, liest sie nur lesend aus und ändert nichts an ihrer Funktionsweise. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## Funktioniert mit 20 Agent-Runtimes - -ClawMetry begann als Observability für OpenClaw und erfasst jetzt deine **gesamte Agent-Flotte** in einem Dashboard, indem jede Runtime auf deinem Rechner automatisch erkannt wird: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw und NemoClaw sind in der Open-Source-App kostenlos; die anderen Runtimes werden mit ClawMetry Cloud oder einer selbst gehosteten Pro-Lizenz freigeschaltet. Wechsle die Runtime über den Header, und jeder Tab, Kosten, Tokens, Tools, Traces, bezieht sich neu auf diese Runtime. Siehe **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** für die genaue Aufteilung zwischen kostenlos und kostenpflichtig, die Tier-Matrix, die Form von `/api/entitlement` und die `clawmetry license`-CLI. - -## Das bekommst du - -- **Flow** — Live animiertes Diagramm, das zeigt, wie Nachrichten durch Kanäle, Brain, Tools und zurück fließen -- **Overview** — Health-Checks, Aktivitäts-Heatmap, Sitzungszähler, Modellinformationen -- **Usage** — Token- und Kostenverfolgung mit täglichen/wöchentlichen/monatlichen Aufschlüsselungen -- **Sessions** — Aktive Agent-Sitzungen mit Modell, Tokens, letzter Aktivität -- **Crons** — Geplante Jobs mit Status, nächstem Lauf, Dauer -- **Logs** — Farbcodiertes Echtzeit-Log-Streaming -- **Memory** — SOUL.md, MEMORY.md, AGENTS.md, tägliche Notizen durchsuchen -- **Transcripts** — Chat-Bubble-UI zum Lesen von Sitzungsverläufen -- **Alerts** — Budgetobergrenzen, Fehlerraten-Trigger, Erkennung von Offline-Agenten; Weiterleitung an Slack, Discord, PagerDuty, Telegram, E-Mail -- **Approvals** — Destruktive Löschvorgänge, Force-Pushes, DB-Mutationen, sudo, Paketinstallationen und Netzwerkaufrufe hinter einer Freigabe mit einem Klick absichern - -## Screenshots - -### 🧠 Brain — Live-Ereignisstrom des Agenten -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Token-Nutzung & Sitzungsübersicht -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Echtzeit-Feed der Tool-Aufrufe -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Kostenaufschlüsselung nach Modell & Sitzung -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Workspace-Dateibrowser -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Sicherheitslage & Audit-Log -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — Budgetobergrenzen, Fehlerraten-Trigger, Webhooks zu Slack / Discord / PagerDuty / E-Mail -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — Riskante Tool-Aufrufe hinter manueller Freigabe absichern; richtliniengestützte Schutzregeln -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Blockierung vor der Ausführung für Claude Code** — ein Befehl installiert -einen PreToolUse-Hook, der passende Tool-Aufrufe pausiert, *bevor* sie -ausgeführt werden, und auf deine Entscheidung wartet (ein Tap von deinem -Handy aus, wenn -[Cloud-Push-Benachrichtigungen](https://app.clawmetry.com/push) aktiviert sind): - -```bash -clawmetry hooks install # schreibt ~/.claude/settings.json (idempotent) -clawmetry hooks status # was verdrahtet ist + wie viele Richtlinien aktiv sind -clawmetry hooks uninstall # entfernt nur die Einträge von ClawMetry -``` - -Ein Deny blockiert nur diesen einen Tool-Aufruf, der Agent behält seine -Sitzung und kann einen anderen Ansatz versuchen. Eine Freigabe auf deinem -Handy überspringt Claude Codes eigenen Berechtigungsdialog (du hast ihn -bereits beantwortet). Nicht passende Tools kosten ~40ms und fallen zurück -in Claude Codes normalen Berechtigungsablauf. Außerdem bekommst du eine -Push-Benachrichtigung, wenn Claude Code selbst auf dich wartet -(`permission_prompt`- / `idle_prompt`-Benachrichtigungen). - -## Installation - -**Einzeiler (empfohlen):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**Aus dem Quellcode:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` - -## v2-Frontend-Entwicklung - -Die v2-React-App befindet sich in `frontend/` und wird unter `/v2` -bereitgestellt, wenn der Flask-Server mit aktiviertem v2 gestartet wird. - -Verwende während der Entwicklung zwei Terminals: - -```bash -# Terminal 1: Flask-API/-Server auf :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## Funktioniert mit 23 Agenten-Runtimes -```bash -# Terminal 2: Vite-Dev-Server auf :5173 -cd frontend -nvm use -npm ci -npm run dev -``` +**Kostenlos in der Open-Source-App:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -Öffne `http://localhost:5173/v2/`. Vite leitet `/api`-Anfragen an -`http://localhost:8900` weiter, sodass die React-App ohne zusätzliches -CORS-Setup mit dem lokalen Flask-Server sprechen kann. +**Im kostenpflichtigen Plan:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -Um das Bundle zu erstellen, das mit dem Python-Paket ausgeliefert wird: - -```bash -cd frontend -npm run build -``` +Jede Runtime erhält dasselbe Dashboard. Führe mehrere gleichzeitig aus, und der Umschalter +in der Kopfzeile richtet jeden Tab neu auf eine davon aus. -Das Produktions-Bundle wird nach `clawmetry/static/v2/dist/` geschrieben. +Hast du deinen eigenen Agenten mit einem SDK gebaut? Der Interceptor erfasst auch dessen LLM-Aufrufe. +Siehe [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -## Runtime-/Agent-Kompatibilität +## Was du bekommst -ClawMetry beobachtet viele KI-Agent-Runtimes, nicht nur OpenClaw. Jede Nicht-OpenClaw-Runtime bringt einen eigenen Reader-Adapter mit, der ihr natives Sitzungsformat in die einheitlichen Datenformen von ClawMetry übersetzt; der Daemon nimmt sie in denselben DuckDB-Speicher + Cloud-Snapshot auf, versehen mit der Runtime-Kennzeichnung, und der Session-Replay-Tab zeigt einen **Runtime-Umschalter**, sobald mehr als eine Runtime vorhanden ist. Siehe [`docs/compatibility.md`](docs/compatibility.md) für die vollständige Matrix + eine Anleitung zum Hinzufügen von Runtimes, und [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) für die Einführung in die OpenClaw-Familie. +- **Sitzungen & Transkripte**: was jeder Agent getan hat, Zug um Zug, mit Wiedergabe +- **Kosten & Tokens**: pro Runtime, Modell, Sitzung und Tag, mit Anomalie-Kennzeichnung +- **Flow**: Live-Diagramm der Nachrichten, die durch Kanäle, Modelle und Tools fließen +- **Brain**: der Strom der Reasoning- und Tool-Aufruf-Ereignisse in Echtzeit +- **Memory & Skills**: die Dateien und Skills, die jede Runtime tatsächlich geladen hat +- **Health & Logs**: Speicherplatz, Arbeitsspeicher, Fehlerraten, Rate-Limits, Live-Log-Stream +- **Alerts**: Budgetgrenzen, Fehlerspitzen, Agent-offline, weitergeleitet an Slack, Discord, PagerDuty, Telegram, E-Mail +- **Approvals**: riskante Tool-Aufrufe pausieren, *bevor* sie ausgeführt werden, und von deinem Handy aus genehmigen ([so geht's](docs/APPROVALS.md)) -Nutzt du [Perplexitys numbat](https://github.com/perplexityai/numbat) Agent-Sicherheitstool? ClawMetry nimmt dessen Befunde und Enforcement-Entscheidungen ohne Zusatzaufwand auf, siehe [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Preise -| Runtime / Agent | Status | Hinweise | +| Plan | Was er abdeckt | Preis | |---|---|---| -| **OpenClaw** | Nativ | Referenz-Runtime, automatisch erkannt | -| **PicoClaw** | Beta-Adapter | Flaches `providers.Message`-JSONL (`~/.picoclaw/workspace/sessions`). Transkripte, Modell, Tool-Aufrufe. | -| **NanoClaw** | Beta-Adapter | SQLite pro Sitzung (`data/v2-sessions`). Transkripte + Nachrichtenzähler. | -| **Hermes** | Beta-Adapter | SQLite `~/.hermes/state.db`. Transkripte, Modell, Tokens/Kosten. | -| **Claude Code** | Beta-Adapter | JSONL `~/.claude/projects/.../.jsonl`. Transkripte, Modell, Tool-Aufrufe + Denkprozess, Token-Nutzung. | -| **Codex** | Beta-Adapter | Rollout-JSONL `~/.codex/sessions/...`. Transkripte, Modell, Tool-Aufrufe, Token-Nutzung. | -| **Cursor** | Beta-Adapter | SQLite `state.vscdb`. Chat-/Composer-Transkripte, Modell. | -| **Aider** | Beta-Adapter | `.aider.chat.history.md` pro Projekt. Transkripte, Modell, Token-Zähler. | -| **Goose** | Beta-Adapter | SQLite `~/.local/share/goose`. Transkripte, Modell, Tool-Aufrufe, Token-Gesamtsummen. | -| **opencode** | Beta-Adapter | SQLite `~/.local/share/opencode`. Transkripte, Modell, Tool-Aufrufe, Tokens + Kosten. | -| **Qwen Code** | Beta-Adapter | JSONL `~/.qwen/projects/.../chats`. Transkripte, Modell, Tool-Aufrufe, Token-Nutzung. | -| **Pi** | Beta-Adapter | JSONL `~/.pi/agent/sessions`. Transkripte, Modell, Tool-Aufrufe, Tokens + Kosten. | -| **Deep Agents** | Beta-Adapter | SQLite `~/.deepagents/.state/sessions.db`. Transkripte, Modell, Tool-Aufrufe, Tokens + Kosten. | -| **n8n** | Beta-Adapter | SQLite `~/.n8n/database.sqlite`. Workflow-Ausführungen, Node-Läufe, AI-Agent-Prompts, Modell + Tokens, sofern n8n sie erfasst. | -| **Antigravity** | Beta-Adapter | Brain-JSONL unter `~/.gemini//brain/`. Konversationen, Tool-Schritte, Denkprozess, Gemini-Token-Aufteilung pro Generierung + Kosten, Verbrauch durch Hintergrundgenerierung. | -| **GitHub Copilot** | Beta-Adapter | Copilot-CLI `events.jsonl` unter `~/.copilot/session-state/` + das `session-store.db`-Nutzungsledger pro Aufruf. Konversationen, Tool-Aufrufe, Modell-Routing, cache-bewusste Token-Aufteilung, vom Anbieter abgerechnete AI-Credit-Kosten. | -| **Grok** | Beta-Adapter | xAI Grok Build CLI (Rust-Binary unter `~/.grok/bin/grok`): globales Ereignisprotokoll `~/.grok/logs/unified.jsonl` + `~/.grok/sessions///{events.jsonl,summary.json}` pro Sitzung. Konversationen, Token-Aufteilung pro Turn, Modell-Routing und die ausgehende Repo-Payload der CLI, bereitgestellt unter `~/.grok/upload_queue/`, damit du sehen kannst, was deinen Rechner verlassen hat. | - -"Beta-Adapter" bedeutet, dass ClawMetry einen Reader für das echte On-Disk-Format dieser Runtime mitbringt, jeweils gebaut und gegen eine echte Installation auf einer echten Maschine verifiziert (siehe `tests/fixtures/runtimes//`). Adapter sind nur lesend; jeder ist ehrlich darüber, was seine Runtime tatsächlich speichert (z. B. schreiben PicoClaw/NanoClaw/Cursor keine Token-Kosten auf die Festplatte). Wenn mehrere Runtimes auf einem Node laufen, grenzt der Runtime-Umschalter die Sitzungsansicht für eine übersichtliche Detailanalyse auf eine ein. - -## Jeden SDK-Agenten verfolgen — Out-Loop-Kostenattribution - -Die oben genannten Runtimes schreiben alle Sitzungen auf die Festplatte. Dein eigener **Produktionsagent** — der, den du mit dem OpenAI Agents SDK, LangChain, dem Vercel AI SDK, LlamaIndex, E2B oder einer einfachen `httpx`-Schleife gebaut hast — tut das nicht. Der zero-config Interceptor von ClawMetry erfasst dessen LLM-Aufrufe (Kosten, Tokens, Latenz, Fehler) trotzdem, indem er `httpx`/`requests` per Monkey-Patching versieht: - -```python -import clawmetry.track # aktiviert den Interceptor -clawmetry.track.set_source("support-agent") # dieses Produkt benennen - -# ...dein Agent läuft wie gewohnt; jeder LLM-Aufruf wird jetzt verfolgt + zugeordnet. -``` - -`set_source()` (oder die Umgebungsvariable `CLAWMETRY_SOURCE=support-agent`) markiert jeden Aufruf mit einer **benannten Quelle**, sodass jedes von dir betriebene Produkt als eigene, kostenmäßig zuordenbare Zeile in der Karte **🔌 Out-loop sources** auf Overview im Dashboard erscheint, mit Aufrufen, Anbietern, Latenz, Fehlerrate pro Agent. Keine Quelle gesetzt? Die Aufrufe werden trotzdem erfasst, die Karte bleibt nur verborgen. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Dies ist dieselbe Datenschicht, die auch die Runtime-Adapter speist (DuckDB → Cloud-Snapshot), sodass Out-loop-Quellen genau wie alles andere mit dem Cloud-Dashboard synchronisiert werden, Ende-zu-Ende-verschlüsselt. - -## OpenTelemetry — anbieterneutral, sende deine Traces überallhin - -ClawMetry spricht **OpenTelemetry** in beide Richtungen, unter Verwendung der **GenAI Semantic Conventions**, sodass deine Agent-Traces niemals an ein einziges Tool gebunden sind. - -**Export** jeder Sitzung — LLM-Aufrufe, Tools, Sub-Agenten, Tokens, Kosten — als OTLP/HTTP-GenAI-Spans an jeden Collector (Datadog, Grafana, Honeycomb oder deinen eigenen OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# äquivalent dazu: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Auth-Header und Poll-Intervall sind optionale Umgebungsvariablen: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # zusätzliche HTTP-Header -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # Sekunden (Standard 60) -``` - -**Ingest** — der eingebaute OTLP-Receiver nimmt Traces, Logs und Metriken von allem anderen unter `/v1/traces`, `/v1/logs` und `/v1/metrics` entgegen. Richte jede mit OpenTelemetry instrumentierte App darauf aus: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON-Traces und -Logs funktionieren mit einem einfachen `pip install clawmetry`, ohne Extras. Protobuf-Ingest (und OTLP/JSON-Metriken) benötigt `pip install clawmetry[otel]`. Eine App, die ihren eigenen `service.name` setzt, erscheint als eigener Agent im Runtime-Umschalter, mit ihren eigenen Kosten und Tokens. - -Du bekommst das zero-config, lokal-first ClawMetry-Dashboard **und** deine Daten in dem Backend, das dein Team bereits nutzt, kein Lock-in, kein zweiter Agent zum Installieren. - -## Konfiguration - -Die meisten Leute brauchen keine Konfiguration. ClawMetry erkennt automatisch deinen Workspace, deine Logs, Sitzungen und Crons. - -Falls du dennoch anpassen musst: - -```bash -clawmetry --port 9000 # Benutzerdefinierter Port (Standard: 8900) -clawmetry --host 127.0.0.1 # Nur an localhost binden -clawmetry --workspace ~/mybot # Benutzerdefinierter Workspace-Pfad -clawmetry --name "Alice" # Dein Name in der Flow-Visualisierung -``` - -Alle Optionen: `clawmetry --help` - -## Unterstützte Kanäle - -ClawMetry zeigt Live-Aktivität für jeden konfigurierten OpenClaw-Kanal. Nur Kanäle, die tatsächlich in deiner `openclaw.json` eingerichtet sind, erscheinen im Flow-Diagramm, nicht konfigurierte werden automatisch ausgeblendet. - -Klicke auf einen beliebigen Kanal-Knoten im Flow, um eine Live-Chat-Bubble-Ansicht mit Zählern für eingehende/ausgehende Nachrichten zu sehen. - -| Kanal | Status | Live-Popup | Hinweise | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Vollständig | ✅ | Nachrichten, Statistiken, Aktualisierung alle 10s | -| 💬 **iMessage** | ✅ Vollständig | ✅ | Liest `~/Library/Messages/chat.db` direkt | -| 💚 **WhatsApp** | ✅ Vollständig | ✅ | Über WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Vollständig | ✅ | Über signal-cli | -| 🟣 **Discord** | ✅ Vollständig | ✅ | Guild- + Kanal-Erkennung | -| 🟪 **Slack** | ✅ Vollständig | ✅ | Workspace- + Kanal-Erkennung | -| 🌐 **Webchat** | ✅ Vollständig | ✅ | Eingebaute Web-UI-Sitzungen | -| 📡 **IRC** | ✅ Vollständig | ✅ | Terminal-artige Bubble-UI | -| 🍏 **BlueBubbles** | ✅ Vollständig | ✅ | iMessage über BlueBubbles-REST-API | -| 🔵 **Google Chat** | ✅ Vollständig | ✅ | Über Chat-API-Webhooks | -| 🟣 **MS Teams** | ✅ Vollständig | ✅ | Über Teams-Bot-Plugin | -| 🔷 **Mattermost** | ✅ Vollständig | ✅ | Selbst gehosteter Team-Chat | -| 🟩 **Matrix** | ✅ Vollständig | ✅ | Dezentral, E2EE-Unterstützung | -| 🟢 **LINE** | ✅ Vollständig | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Vollständig | ✅ | Dezentrale NIP-04-DMs | -| 🟣 **Twitch** | ✅ Vollständig | ✅ | Chat über IRC-Verbindung | -| 🔷 **Feishu/Lark** | ✅ Vollständig | ✅ | WebSocket-Event-Subscription | -| 🔵 **Zalo** | ✅ Vollständig | ✅ | Zalo Bot API | - -> **Automatische Erkennung:** ClawMetry liest deine `~/.openclaw/openclaw.json` und rendert nur die Kanäle, die du tatsächlich konfiguriert hast. Keine manuelle Einrichtung erforderlich. - -## Docker-Deployment - -Möchtest du ClawMetry in einem Container betreiben? Kein Problem! 🐳 - -**Schnellstart mit Docker:** - -```bash -# Das Image bauen -docker build -t clawmetry . - -# Mit Standardeinstellungen ausführen -docker run -p 8900:8900 clawmetry - -# Oder das Datenverzeichnis deines Agenten einbinden (gezeigt: OpenClaws ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker-Compose-Beispiel:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Hinweis:** Wenn du in Docker läufst, binde die Daten- + Log-Verzeichnisse deines Agenten ein (z. B. `~/.openclaw`, `~/.claude`, `~/.codex`), damit ClawMetry dein Setup automatisch erkennen kann. - -## Voraussetzungen - -- Python 3.8+ -- Flask (wird automatisch über pip installiert) -- Eine KI-Agent-Runtime auf demselben Rechner: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok oder QM (oder eingebundene Volumes für Docker) -- Linux oder macOS - -## NemoClaw-/OpenShell-Unterstützung - -ClawMetry erkennt automatisch [NemoClaw](https://github.com/NVIDIA/NemoClaw) — NVIDIAs Enterprise-Sicherheits-Wrapper für OpenClaw, der Agenten in sandboxed OpenShell-Containern ausführt. +| **Free** | OpenClaw + NVIDIA NemoClaw, volles Dashboard, nur lokal | 0 $ | +| **Starter** | Jede andere oben genannte Runtime, Flottenansicht, Cloud-Sync | 9 $ pro Node / Monat | +| **Pro** | Starter + Governance: Approvals, Tool-Risiko-Richtlinien, Evals, Anomalieerkennung, Kostenoptimierer, OTel-Export | 19 $ pro Node / Monat | -In den meisten Fällen ist keine zusätzliche Konfiguration erforderlich. Der Sync-Daemon entdeckt Sitzungsdateien automatisch, egal ob sie auf dem Host in `~/.openclaw/` oder innerhalb eines OpenShell-Containers liegen. +Jahrespläne, Enterprise und die aktuellen Preise findest du unter +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Selbst gehostete Lizenzschlüssel +funktionieren auch ohne Cloud (`clawmetry license`). Die genaue Aufteilung zwischen kostenlos und kostenpflichtig steht +in [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -### So funktioniert es +## Deine Daten bleiben auf deinem Rechner -ClawMetry erkennt NemoClaw auf zwei Arten: +ClawMetry liest lokale Sitzungsdateien und Logs. Nichts verlässt deinen Rechner, es sei denn, +du führst `clawmetry connect` aus. Selbst dann ist der Snapshot Ende-zu-Ende-verschlüsselt +mit einem Schlüssel, der deinen Rechner nie verlässt, und wird in deinem Browser entschlüsselt. -1. **Binärerkennung** — prüft auf die `nemoclaw`-CLI und führt `nemoclaw status` aus, um Sandbox-Informationen zu erhalten -2. **Container-Erkennung** — scannt laufende Docker-Container nach `openshell`-, `nemoclaw`- oder `ghcr.io/nvidia/`-Images und liest Sitzungen dann über Volume-Mounts oder `docker cp` - -Sitzungsdateien, die von NemoClaw-Containern synchronisiert werden, sind im Cloud-Dashboard mit `runtime=nemoclaw` und `container_id`-Metadaten gekennzeichnet, damit du sie auf einen Blick von Standard-OpenClaw-Sitzungen unterscheiden kannst. - -### Empfohlenes Setup: Sync-Daemon auf dem HOST - -Für die beste Erfahrung solltest du den Sync-Daemon von ClawMetry auf der **Host-Maschine** ausführen (nicht innerhalb der Sandbox). So vermeidest du Einschränkungen durch NemoClaws Netzwerkrichtlinien. - -```bash -# Auf dem Host (außerhalb der Sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -Der Sync-Daemon findet automatisch Sitzungen innerhalb aller laufenden OpenShell-Container. - -### Optional: expliziter Sandbox-Name - -Falls die automatische Erkennung nicht funktioniert, verweise ClawMetry auf die richtige Sandbox: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Ausführung innerhalb der Sandbox (fortgeschritten) - -Wenn du den Sync-Daemon **innerhalb** der OpenShell-Sandbox ausführen musst, füge diese Egress-Regel zu deiner NemoClaw-Netzwerkrichtlinie hinzu, damit er die ClawMetry-Ingest-API erreichen kann: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Anwenden mit: +## Installation ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # dann: clawmetry ``` -### Ports und Endpunkte - -| Endpunkt | Port | Protokoll | Erforderlich | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Ja (Sync-Daemon → Cloud) | -| `localhost:8900` | 8900 | HTTP | Ja (lokale Dashboard-UI) | -| Docker-Socket (`/var/run/docker.sock`) | — | Unix-Socket | Für die Erkennung von Container-Sitzungen | - -Der Sync-Daemon macht nur ausgehende HTTPS-Aufrufe an `ingest.clawmetry.com`. Es sind keine eingehenden Ports erforderlich. - ---- - -## Cloud-Deployment - -Siehe den **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** für SSH-Tunnel, Reverse-Proxy und Docker. - -## Testing +Oder der Einzeiler: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -Dieses Projekt wird mit BrowserStack getestet. +Benötigt Python 3.8+ auf macOS, Linux oder Windows sowie mindestens eine Agenten-Runtime auf +demselben Rechner. Docker-Anleitung: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## Dokumentation -## Telemetrie +| | | +|---|---| +| [Runtime-Kompatibilität](docs/compatibility.md) | Was jeder Adapter liest, und wie man eine Runtime hinzufügt | +| [Entitlements](docs/ENTITLEMENTS.md) | Kostenlos vs. kostenpflichtig, Tier-Matrix, Lizenz-CLI | +| [Approvals & Richtlinien](docs/APPROVALS.md) | Gating vor der Ausführung, Risikobewertung, Genehmigung per Handy | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Traces überallhin exportieren, OTLP von überall her einlesen | +| [SDK-Tracking](docs/SDK_TRACKING.md) | Kostenzuordnung für Agenten, die du selbst gebaut hast | +| [Chat-Kanäle](docs/CHANNELS.md) | Die in Flow angezeigten Chat-Adapter | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Sandboxed NVIDIA NemoClaw-Setups | +| [Docker](docs/DOCKER.md) | Image, Compose, Volume-Mounts | +| [Architektur](ARCHITECTURE.md) · [Entwicklung](docs/DEVELOPMENT.md) | Wie es intern funktioniert; Ausführung aus dem Quellcode | +| [Telemetrie](docs/TELEMETRY.md) | Die anonymen Install- und Desktop-Öffnungs-Pings, und wie man sie abschaltet | -ClawMetry sendet anonyme Install-Lifecycle-Pings an -`https://app.clawmetry.com/api/install`: einen `install`-Ping beim -ersten Ausführen der `clawmetry`-CLI auf einer neuen Maschine, einen -`update`-Ping beim ersten Lauf nach einem Upgrade auf eine neue -Version, und einen `onboarded`-Ping, wenn du die Onboarding-Auswahl im -Dashboard abschließt. Wir nutzen das, um echte Installationen zu -zählen (rohe PyPI-Download-Zahlen bestehen zu ~98 % aus Mirrors, CI und -automatischen Update-Neuherunterladungen) und um zu erfahren, welche -Agenten-Frameworks und Versionen tatsächlich im Einsatz sind. +## Screenshots -**Höchstens ein POST pro Lifecycle-Ereignis und Version**, mit folgendem Inhalt: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: Tokens, Sitzungen, Health | **Brain**: Live-Ereignisstrom des Agenten | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: nach Modell und Sitzung | **Approvals**: riskante Tool-Aufrufe absichern | -| Feld | Beispiel | Warum | -|---|---|---| -| `install_id` | zufällige UUID, gespeichert unter `~/.clawmetry/install_id` | Deduplizierung; anonym, bis du explizit Cloud-Sync verbindest (der authentifizierte Daemon-Heartbeat trägt sie dann und verknüpft diese Installation mit deinem Konto) | -| `event` | `install` / `update` / `onboarded` | Neuinstallation vs. Upgrade einer bestehenden | -| `version` | `0.12.167` | welche Versionen im Einsatz sind | -| `os` / `os_version` | `Darwin` / `25.3.0` | Prioritäten bei der Plattformunterstützung | -| `python` | `3.11.15` | Unterstützungsmatrix für Python-Versionen | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | mit welchen Agenten wir uns als Nächstes integrieren sollten | -| `is_ci` / `ci_provider` | `true` / `github_actions` | menschliche Installationen von CI-Rauschen trennen | - -**Was wir NICHT senden**: IP (die Cloud leitet den Ländercode -serverseitig aus der Anfrage ab und verwirft dann die IP), Hostname, -Benutzername, Workspace-Pfad, Dateiinhalte, deinen api_key, deine -E-Mail, irgendetwas PII- oder workspace-spezifisches. Die -Übertragungs-Payload ist einsehbar in -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Opt-out** (jede dieser Optionen deaktiviert es dauerhaft): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # pro Shell -export DO_NOT_TRACK=1 # W3C-übergreifender Standard -touch ~/.clawmetry/notelemetry # dauerhafte Dateimarkierung -``` - -Ein Netzwerkfehler blockiert hier niemals die Ausführung von -`clawmetry` — der Ping läuft fire-and-forget in einem Daemon-Thread mit -einem Timeout von 3 Sekunden. +Mehr, pro Runtime: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Star-Verlauf @@ -441,11 +116,6 @@ einem Timeout von 3 Sekunden. ## Lizenz -MIT - ---- +MIT · Entwickelt von [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Sieh zu, wie dein Agent denkt
- Erstellt von @vivekchand · clawmetry.com · Teil des OpenClaw-Ökosystems -

+ diff --git a/docs/i18n/el/README.md b/docs/i18n/el/README.md index 9db53fc837..3761108a05 100644 --- a/docs/i18n/el/README.md +++ b/docs/i18n/el/README.md @@ -1,17 +1,16 @@ - + > Ελληνικά translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Δες τον πράκτορά σου να σκέφτεται.** Παρατηρησιμότητα σε πραγματικό χρόνο για **23 runtimes AI πρακτόρων**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex και 19 ακόμα. Ένας πίνακας ελέγχου για ολόκληρο τον στόλο πρακτόρων σου. +**Δες τον agent σου να σκέφτεται.** Παρατηρησιμότητα σε πραγματικό χρόνο για **23 runtimes AI agent**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex και 19 ακόμη. Ένα dashboard για ολόκληρο τον στόλο agent σου. > 🌐 **Διάβασέ το στα:** [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/) @@ -21,478 +20,92 @@ pip install clawmetry && clawmetry ``` -Ανοίγει στο **http://localhost:8900** και έχεις τελειώσει. +Ανοίγει στο **http://localhost:8900**. Χωρίς ρυθμίσεις: βρίσκει τα runtimes agent +που ήδη έχεις, τα διαβάζει μόνο για ανάγνωση και δεν αλλάζει τίποτα στον τρόπο που τρέχουν. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## Λειτουργεί με 23 runtimes πρακτόρων - -Το ClawMetry ξεκίνησε ως παρατηρησιμότητα για το OpenClaw, και τώρα μετράει ολόκληρο τον **στόλο πρακτόρων** σου σε έναν πίνακα ελέγχου, ανιχνεύοντας αυτόματα κάθε runtime στο μηχάνημά σου: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -Το OpenClaw και το NemoClaw είναι δωρεάν στην open-source εφαρμογή· τα υπόλοιπα runtimes ενεργοποιούνται με το ClawMetry Cloud ή με άδεια Pro αυτοφιλοξενίας. Άλλαξε runtime από την κεφαλίδα και κάθε καρτέλα, κόστος, tokens, εργαλεία, ίχνη, προσαρμόζεται σε αυτό το runtime. Δες το **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** για τον ακριβή διαχωρισμό δωρεάν/επί πληρωμή, τον πίνακα επιπέδων, τη μορφή του `/api/entitlement`, και το CLI `clawmetry license`. - -## Τι παίρνεις - -- **Flow** — Ζωντανό κινούμενο διάγραμμα που δείχνει τα μηνύματα να ρέουν μέσα από κανάλια, brain, εργαλεία, και πίσω -- **Overview** — Έλεγχοι υγείας, χάρτης δραστηριότητας, μετρήσεις συνεδριών, πληροφορίες μοντέλου -- **Usage** — Παρακολούθηση tokens και κόστους με ανάλυση ανά ημέρα/εβδομάδα/μήνα -- **Sessions** — Ενεργές συνεδρίες πράκτορα με μοντέλο, tokens, τελευταία δραστηριότητα -- **Crons** — Προγραμματισμένες εργασίες με κατάσταση, επόμενη εκτέλεση, διάρκεια -- **Logs** — Ροή logs σε πραγματικό χρόνο με έγχρωμη κωδικοποίηση -- **Memory** — Περιήγηση στα SOUL.md, MEMORY.md, AGENTS.md, ημερήσιες σημειώσεις -- **Transcripts** — Διεπαφή τύπου φούσκας συνομιλίας για ανάγνωση ιστορικού συνεδριών -- **Alerts** — Όρια προϋπολογισμού, σκανδάλες ποσοστού σφαλμάτων, εντοπισμός εκτός σύνδεσης πράκτορα· δρομολόγηση σε Slack, Discord, PagerDuty, Telegram, Email -- **Approvals** — Φραγμός καταστροφικών διαγραφών, force pushes, μεταλλάξεων βάσης δεδομένων, sudo, εγκαταστάσεων πακέτων, κλήσεων δικτύου πίσω από έγκριση με ένα κλικ - -## Στιγμιότυπα οθόνης - -### 🧠 Brain — Ζωντανή ροή συμβάντων πράκτορα -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Χρήση tokens & περίληψη συνεδρίας -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Ροή κλήσεων εργαλείων σε πραγματικό χρόνο -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Ανάλυση κόστους ανά μοντέλο & συνεδρία -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Περιηγητής αρχείων χώρου εργασίας -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Στάση ασφαλείας & αρχείο καταγραφής ελέγχου -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) +## Λειτουργεί με 23 runtimes agent -### 🚨 Alerts — Όρια προϋπολογισμού, σκανδάλες ποσοστού σφαλμάτων, webhooks σε Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +**Δωρεάν στην open source εφαρμογή:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### ✋ Approvals — Φραγμός επικίνδυνων κλήσεων εργαλείων πίσω από χειροκίνητη έγκριση· κανόνες προστασίας βασισμένοι σε πολιτική -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Φραγμός πριν την εκτέλεση για το Claude Code** — μία εντολή εγκαθιστά ένα -PreToolUse hook που θέτει σε παύση τις αντίστοιχες κλήσεις εργαλείων *πριν* -εκτελεστούν και περιμένει την απόφασή σου (ένα άγγιγμα από το τηλέφωνό σου με -ενεργοποιημένες τις [ειδοποιήσεις push μέσω cloud](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 -``` - -Ένα deny φράζει μόνο εκείνη τη μία κλήση εργαλείου, ο πράκτορας διατηρεί τη -συνεδρία του και μπορεί να δοκιμάσει άλλη προσέγγιση. Η έγκριση από το -τηλέφωνό σου παρακάμπτει την ίδια την προτροπή δικαιωμάτων του Claude Code -(έχεις ήδη απαντήσει). Τα εργαλεία που δεν ταιριάζουν κοστίζουν ~40ms και -περνούν στην κανονική ροή δικαιωμάτων του Claude Code. Παίρνεις επίσης -ειδοποίηση push στο τηλέφωνο όταν το ίδιο το 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 -``` +**Σε πληρωμένο πλάνο:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -## Ανάπτυξη v2 Frontend +Κάθε runtime παίρνει το ίδιο dashboard. Τρέξε πολλά ταυτόχρονα και ο επιλογέας +στην κεφαλίδα επαναπροσδιορίζει κάθε καρτέλα σε ένα από αυτά. -Η εφαρμογή React v2 βρίσκεται στο `frontend/` και εξυπηρετείται στο `/v2` όταν -ο διακομιστής Flask ξεκινά με ενεργοποιημένο το v2. +Έφτιαξες τον δικό σου agent με κάποιο SDK; Ο interceptor παρακολουθεί και τις +κλήσεις LLM του. Δες [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -Χρησιμοποίησε δύο τερματικά κατά την ανάπτυξη: - -```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. - -Για να χτίσεις το bundle που συνοδεύει το πακέτο Python: - -```bash -cd frontend -npm run build -``` - -Το bundle παραγωγής γράφεται στο `clawmetry/static/v2/dist/`. - -## Συμβατότητα Runtime / Πράκτορα +## Τι παίρνεις -Το ClawMetry παρατηρεί πολλά runtimes πρακτόρων AI, όχι μόνο το OpenClaw. Κάθε -runtime εκτός OpenClaw διαθέτει έναν αποκλειστικό προσαρμογέα ανάγνωσης που -μεταφράζει τη γηγενή μορφή συνεδρίας του στις ενοποιημένες μορφές του -ClawMetry· ο daemon τα εισάγει στο ίδιο κατάστημα DuckDB + στιγμιότυπο cloud, -με ετικέτα το runtime, και η καρτέλα Session replay εμφανίζει έναν -**επιλογέα runtime** όταν υπάρχει περισσότερο από ένα. Δες το -[`docs/compatibility.md`](docs/compatibility.md) για τον πλήρη πίνακα + -έναν οδηγό για την προσθήκη runtimes, και το -[`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) για την εισαγωγή στην -οικογένεια OpenClaw. +- **Sessions & transcripts**: τι έκανε κάθε agent, γύρο προς γύρο, με replay +- **Κόστος & tokens**: ανά runtime, μοντέλο, session και ημέρα, με σημάνσεις ανωμαλιών +- **Flow**: ζωντανό διάγραμμα μηνυμάτων που κινούνται μέσα από κανάλια, μοντέλα και εργαλεία +- **Brain**: η ροή γεγονότων συλλογισμού και κλήσεων εργαλείων καθώς συμβαίνει +- **Memory & skills**: τα αρχεία και τα skills που φόρτωσε πραγματικά κάθε runtime +- **Υγεία & logs**: δίσκος, μνήμη, ποσοστά σφαλμάτων, όρια ρυθμού, ζωντανή ροή logs +- **Alerts**: όρια budget, αιχμές σφαλμάτων, agent-offline, δρομολογημένα σε Slack, Discord, PagerDuty, Telegram, Email +- **Approvals**: παύση ριψοκίνδυνων κλήσεων εργαλείων *πριν* εκτελεστούν και έγκριση από το κινητό σου ([πώς](docs/APPROVALS.md)) -Τρέχεις το εργαλείο ασφάλειας πρακτόρων [numbat της Perplexity](https://github.com/perplexityai/numbat); Το ClawMetry εισάγει τα ευρήματα και τις αποφάσεις επιβολής του από το κουτί, δες το [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Τιμολόγηση -| Runtime / Πράκτορας | Κατάσταση | Σημειώσεις | +| Πλάνο | Τι καλύπτει | Τιμή | |---|---|---| -| **OpenClaw** | Native | Runtime αναφοράς, ανιχνεύεται αυτόματα | -| **PicoClaw** | Beta προσαρμογέας | Επίπεδο `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`). Transcripts, μοντέλο, κλήσεις εργαλείων. | -| **NanoClaw** | Beta προσαρμογέας | SQLite ανά συνεδρία (`data/v2-sessions`). Transcripts + μετρήσεις μηνυμάτων. | -| **Hermes** | Beta προσαρμογέας | SQLite `~/.hermes/state.db`. Transcripts, μοντέλο, tokens/κόστος. | -| **Claude Code** | Beta προσαρμογέας | JSONL `~/.claude/projects/.../.jsonl`. Transcripts, μοντέλο, κλήσεις εργαλείων + σκέψη, χρήση tokens. | -| **Codex** | Beta προσαρμογέας | Rollout JSONL `~/.codex/sessions/...`. Transcripts, μοντέλο, κλήσεις εργαλείων, χρήση tokens. | -| **Cursor** | Beta προσαρμογέας | SQLite `state.vscdb`. Transcripts chat/composer, μοντέλο. | -| **Aider** | Beta προσαρμογέας | `.aider.chat.history.md` ανά έργο. Transcripts, μοντέλο, μετρήσεις tokens. | -| **Goose** | Beta προσαρμογέας | SQLite `~/.local/share/goose`. Transcripts, μοντέλο, κλήσεις εργαλείων, σύνολα tokens. | -| **opencode** | Beta προσαρμογέας | SQLite `~/.local/share/opencode`. Transcripts, μοντέλο, κλήσεις εργαλείων, tokens + κόστος. | -| **Qwen Code** | Beta προσαρμογέας | JSONL `~/.qwen/projects/.../chats`. Transcripts, μοντέλο, κλήσεις εργαλείων, χρήση tokens. | -| **Pi** | Beta προσαρμογέας | JSONL `~/.pi/agent/sessions`. Transcripts, μοντέλο, κλήσεις εργαλείων, tokens + κόστος. | -| **Deep Agents** | Beta προσαρμογέας | SQLite `~/.deepagents/.state/sessions.db`. Transcripts, μοντέλο, κλήσεις εργαλείων, tokens + κόστος. | -| **n8n** | Beta προσαρμογέας | SQLite `~/.n8n/database.sqlite`. Εκτελέσεις ροών εργασίας, εκτελέσεις κόμβων, προτροπές AI Agent, μοντέλο + tokens όπου το n8n τα καταγράφει. | -| **Antigravity** | Beta προσαρμογέας | Brain JSONL κάτω από `~/.gemini//brain/`. Συνομιλίες, βήματα εργαλείων, σκέψη, διαχωρισμός tokens Gemini ανά παραγωγή + κόστος, κατανάλωση background-generation. | -| **GitHub Copilot** | Beta προσαρμογέας | Copilot CLI `events.jsonl` κάτω από `~/.copilot/session-state/` + το βιβλίο χρήσης ανά κλήση `session-store.db`. Συνομιλίες, κλήσεις εργαλείων, δρομολόγηση μοντέλου, διαχωρισμός tokens με επίγνωση cache, κόστος AI-credit χρεωμένο από τον προμηθευτή. | -| **Grok** | Beta προσαρμογέας | xAI Grok Build CLI (δυαδικό αρχείο Rust κάτω από `~/.grok/bin/grok`): καθολικό αρχείο καταγραφής συμβάντων `~/.grok/logs/unified.jsonl` + ανά συνεδρία `~/.grok/sessions///{events.jsonl,summary.json}`. Συνομιλίες, διαχωρισμός tokens ανά γύρο, δρομολόγηση μοντέλου, και το εξερχόμενο φορτίο repo του CLI, σε στάδιο κάτω από `~/.grok/upload_queue/`, ώστε να βλέπεις τι έφυγε από το μηχάνημά σου. | - -Το "Beta προσαρμογέας" σημαίνει ότι το ClawMetry παρέχει έναν αναγνώστη για -την πραγματική μορφή δίσκου εκείνου του runtime, χτισμένο + επαληθευμένο -έναντι πραγματικής εγκατάστασης σε πραγματικό μηχάνημα (δες -`tests/fixtures/runtimes//`). Οι προσαρμογείς είναι μόνο για ανάγνωση· -καθένας είναι ειλικρινής για το τι πραγματικά αποθηκεύει το runtime του -(π.χ. τα PicoClaw/NanoClaw/Cursor δεν γράφουν κόστος tokens στον δίσκο). Όταν -τρέχουν πολλά runtimes σε έναν κόμβο, ο επιλογέας runtime περιορίζει την -προβολή συνεδριών σε ένα για μια καθαρή εμβάθυνση. - -## Παρακολούθηση οποιουδήποτε πράκτορα SDK — απόδοση κόστους out-loop - -Τα παραπάνω runtimes γράφουν όλα συνεδρίες στον δίσκο. Ο δικός σου -**πράκτορας παραγωγής**, αυτός που έφτιαξες με το OpenAI Agents SDK, το -LangChain, το Vercel AI SDK, το LlamaIndex, το E2B, ή έναν απλό βρόχο -`httpx`, δεν το κάνει. Ο προσαρμογέας χωρίς ρύθμιση του ClawMetry εξακολουθεί -να καταγράφει τις κλήσεις LLM του (κόστος, tokens, καθυστέρηση, σφάλματα) -κάνοντας monkey-patching στα `httpx`/`requests`: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -Το `set_source()` (ή η μεταβλητή περιβάλλοντος `CLAWMETRY_SOURCE=support-agent`) -επισημαίνει κάθε κλήση με μια **επώνυμη πηγή**, ώστε κάθε προϊόν που τρέχεις -να εμφανίζεται ως δική του πρωτοκλασάτη, με δυνατότητα απόδοσης κόστους -γραμμή στην κάρτα **🔌 Πηγές out-loop** του πίνακα ελέγχου στο Overview: -κλήσεις, πάροχοι, καθυστέρηση, ποσοστό σφαλμάτων ανά πράκτορα. Δεν έχει -οριστεί πηγή; Οι κλήσεις εξακολουθούν να παρακολουθούνται, η κάρτα απλώς -παραμένει κρυμμένη. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Αυτό είναι το ίδιο επίπεδο δεδομένων που τροφοδοτούν οι προσαρμογείς runtime -(DuckDB → στιγμιότυπο cloud), οπότε οι πηγές out-loop συγχρονίζονται με τον -πίνακα ελέγχου cloud όπως όλα τα υπόλοιπα, με κρυπτογράφηση από άκρο σε άκρο. - -## OpenTelemetry — ουδέτερο ως προς τον προμηθευτή, στείλε τα ίχνη σου οπουδήποτε - -Το ClawMetry μιλάει **OpenTelemetry** και προς τις δύο κατευθύνσεις, -χρησιμοποιώντας τις **σημασιολογικές συμβάσεις GenAI**, ώστε τα ίχνη του -πράκτορά σου να μην κλειδώνονται ποτέ σε ένα μόνο εργαλείο. - -**Εξαγωγή** κάθε συνεδρίας, κλήσεις LLM, εργαλεία, υπο-πράκτορες, tokens, -κόστος, ως OTLP/HTTP GenAI spans σε οποιονδήποτε συλλέκτη (Datadog, Grafana, -Honeycomb, ή τον δικό σου OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Οι κεφαλίδες πιστοποίησης και το διάστημα ψηφοφορίας είναι προαιρετικές -μεταβλητές περιβάλλοντος: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**Εισαγωγή** — ο ενσωματωμένος δέκτης OTLP δέχεται ίχνη, logs, και μετρήσεις -από οτιδήποτε άλλο στα `/v1/traces`, `/v1/logs`, και `/v1/metrics`. Κατεύθυνε -οποιαδήποτε εφαρμογή με OpenTelemetry instrumentation προς αυτόν: +| **Free** | OpenClaw + NVIDIA NemoClaw, πλήρες dashboard, μόνο τοπικά | $0 | +| **Starter** | Κάθε άλλο runtime παραπάνω, προβολή στόλου, cloud sync | $9 ανά node / μήνα | +| **Pro** | Starter + διακυβέρνηση: approvals, πολιτικές κινδύνου εργαλείων, evals, ανίχνευση ανωμαλιών, βελτιστοποιητής κόστους, εξαγωγή OTel | $19 ανά node / μήνα | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -Τα ίχνη και τα logs OTLP/JSON λειτουργούν με απλό `pip install clawmetry`, -χωρίς extras. Η εισαγωγή Protobuf (και οι μετρήσεις OTLP/JSON) χρειάζονται -`pip install clawmetry[otel]`. Μια εφαρμογή που ορίζει το δικό της -`service.name` εμφανίζεται ως δικός της πράκτορας στον επιλογέα runtime, με -το κόστος και τα tokens της. - -Παίρνεις τον πίνακα ελέγχου ClawMetry χωρίς ρύθμιση, τοπικό-πρώτα, **και** -τα δεδομένα σου σε όποιο backend ήδη τρέχει η ομάδα σου, χωρίς κλείδωμα, -χωρίς δεύτερο πράκτορα για εγκατάσταση. - -## Ρύθμιση - -Οι περισσότεροι δεν χρειάζονται καμία ρύθμιση. Το ClawMetry ανιχνεύει -αυτόματα τον χώρο εργασίας, τα logs, τις συνεδρίες, και τα crons σου. - -Αν χρειάζεσαι προσαρμογή: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -Όλες οι επιλογές: `clawmetry --help` - -## Υποστηριζόμενα κανάλια - -Το ClawMetry δείχνει ζωντανή δραστηριότητα για κάθε κανάλι OpenClaw που έχεις -ρυθμίσει. Μόνο τα κανάλια που είναι πραγματικά ρυθμισμένα στο `openclaw.json` -σου εμφανίζονται στο διάγραμμα Flow, τα μη ρυθμισμένα κρύβονται αυτόματα. - -Κάνε κλικ σε οποιονδήποτε κόμβο καναλιού στο Flow για να δεις μια ζωντανή -προβολή φούσκας συνομιλίας με μετρήσεις εισερχόμενων/εξερχόμενων μηνυμάτων. - -| Κανάλι | Κατάσταση | Ζωντανό Popup | Σημειώσεις | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Πλήρες | ✅ | Μηνύματα, στατιστικά, ανανέωση 10s | -| 💬 **iMessage** | ✅ Πλήρες | ✅ | Διαβάζει απευθείας το `~/Library/Messages/chat.db` | -| 💚 **WhatsApp** | ✅ Πλήρες | ✅ | Μέσω WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Πλήρες | ✅ | Μέσω signal-cli | -| 🟣 **Discord** | ✅ Πλήρες | ✅ | Ανίχνευση guild + καναλιού | -| 🟪 **Slack** | ✅ Πλήρες | ✅ | Ανίχνευση χώρου εργασίας + καναλιού | -| 🌐 **Webchat** | ✅ Πλήρες | ✅ | Ενσωματωμένες συνεδρίες web UI | -| 📡 **IRC** | ✅ Πλήρες | ✅ | UI φούσκας τύπου τερματικού | -| 🍏 **BlueBubbles** | ✅ Πλήρες | ✅ | iMessage μέσω BlueBubbles REST API | -| 🔵 **Google Chat** | ✅ Πλήρες | ✅ | Μέσω webhooks Chat API | -| 🟣 **MS Teams** | ✅ Πλήρες | ✅ | Μέσω πρόσθετου bot Teams | -| 🔷 **Mattermost** | ✅ Πλήρες | ✅ | Αυτοφιλοξενούμενη συνομιλία ομάδας | -| 🟩 **Matrix** | ✅ Πλήρες | ✅ | Αποκεντρωμένο, υποστήριξη E2EE | -| 🟢 **LINE** | ✅ Πλήρες | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Πλήρες | ✅ | Αποκεντρωμένα NIP-04 DMs | -| 🟣 **Twitch** | ✅ Πλήρες | ✅ | Συνομιλία μέσω σύνδεσης IRC | -| 🔷 **Feishu/Lark** | ✅ Πλήρες | ✅ | Συνδρομή συμβάντων WebSocket | -| 🔵 **Zalo** | ✅ Πλήρες | ✅ | Zalo Bot API | - -> **Αυτόματη ανίχνευση:** Το ClawMetry διαβάζει το `~/.openclaw/openclaw.json` -> σου και αποδίδει μόνο τα κανάλια που έχεις πραγματικά ρυθμίσει. Δεν -> απαιτείται χειροκίνητη ρύθμιση. - -## Ανάπτυξη με Docker - -Θέλεις να τρέξεις το ClawMetry σε container; Κανένα πρόβλημα! 🐳 - -**Γρήγορη εκκίνηση με Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Παράδειγμα Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Σημείωση:** Όταν τρέχεις σε Docker, κάνε mount τους καταλόγους δεδομένων -> + logs του πράκτορά σου (π.χ. `~/.openclaw`, `~/.claude`, `~/.codex`) ώστε -> το ClawMetry να μπορεί να ανιχνεύσει αυτόματα τη ρύθμισή σου. - -## Απαιτήσεις - -- Python 3.8+ -- Flask (εγκαθίσταται αυτόματα μέσω pip) -- Ένα runtime πράκτορα AI στο ίδιο μηχάνημα: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, ή QM (ή προσαρτημένοι τόμοι για Docker) -- Linux ή macOS - -## Υποστήριξη NemoClaw / OpenShell - -Το ClawMetry ανιχνεύει αυτόματα το [NemoClaw](https://github.com/NVIDIA/NemoClaw), τον εταιρικό περιτύλιγμα ασφαλείας της NVIDIA για το OpenClaw που τρέχει πράκτορες μέσα σε sandboxed containers OpenShell. - -Δεν χρειάζεται επιπλέον ρύθμιση στις περισσότερες περιπτώσεις. Ο daemon -συγχρονισμού ανακαλύπτει αυτόματα αρχεία συνεδρίας είτε βρίσκονται στο -`~/.openclaw/` στον host είτε μέσα σε ένα container OpenShell. +Τα ετήσια πλάνα, το Enterprise και οι τρέχουσες τιμές βρίσκονται στο +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Τα κλειδιά άδειας +για αυτόνομη φιλοξενία λειτουργούν χωρίς το cloud (`clawmetry license`). Ο +ακριβής διαχωρισμός δωρεάν/πληρωμένου βρίσκεται στο [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -### Πώς λειτουργεί +## Τα δεδομένα σου μένουν στο μηχάνημά σου -Το ClawMetry ανιχνεύει το NemoClaw με δύο τρόπους: +Το ClawMetry διαβάζει τοπικά αρχεία sessions και logs. Τίποτα δεν φεύγει από +το μηχάνημά σου εκτός αν τρέξεις `clawmetry connect`. Ακόμη και τότε, το +snapshot είναι κρυπτογραφημένο από άκρο σε άκρο με ένα κλειδί που δεν φεύγει +ποτέ από το μηχάνημά σου, και αποκρυπτογραφείται στο πρόγραμμα περιήγησής σου. -1. **Ανίχνευση δυαδικού αρχείου** — ελέγχει για το CLI `nemoclaw` και τρέχει - `nemoclaw status` για να πάρει πληροφορίες sandbox -2. **Ανίχνευση container** — σαρώνει τα container Docker που τρέχουν για - εικόνες `openshell`, `nemoclaw`, ή `ghcr.io/nvidia/`, έπειτα διαβάζει τις - συνεδρίες μέσω προσαρτημένων τόμων ή `docker cp` - -Τα αρχεία συνεδρίας που συγχρονίζονται από containers NemoClaw επισημαίνονται -με `runtime=nemoclaw` και μεταδεδομένα `container_id` στον πίνακα ελέγχου -cloud, ώστε να μπορείς να τα ξεχωρίσεις από τυπικές συνεδρίες OpenClaw με μια -ματιά. - -### Προτεινόμενη ρύθμιση: daemon συγχρονισμού στον HOST - -Για την καλύτερη εμπειρία, τρέξε τον daemon συγχρονισμού του ClawMetry στο -**μηχάνημα host** (όχι μέσα στο sandbox). Αυτό αποφεύγει τους περιορισμούς -πολιτικής δικτύου του NemoClaw. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -Ο daemon συγχρονισμού θα βρει αυτόματα συνεδρίες μέσα σε οποιαδήποτε -τρέχοντα containers OpenShell. - -### Προαιρετικό: ρητό όνομα sandbox - -Αν η αυτόματη ανίχνευση δεν λειτουργεί, κατεύθυνε το ClawMetry στο σωστό -sandbox: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Εκτέλεση μέσα στο sandbox (προχωρημένο) - -Αν πρέπει να τρέξεις τον daemon συγχρονισμού **μέσα** στο sandbox OpenShell, -πρόσθεσε αυτόν τον κανόνα εξόδου στην πολιτική δικτύου του NemoClaw ώστε να -μπορεί να φτάσει στο API εισαγωγής του ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Εφάρμοσέ το με: +## Εγκατάσταση ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # μετά: clawmetry ``` -### Θύρες και endpoints - -| Endpoint | Θύρα | Πρωτόκολλο | Απαιτείται | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Ναι (daemon συγχρονισμού → cloud) | -| `localhost:8900` | 8900 | HTTP | Ναι (τοπικό UI πίνακα ελέγχου) | -| Docker socket (`/var/run/docker.sock`) | — | Unix socket | Για ανακάλυψη συνεδριών container | - -Ο daemon συγχρονισμού κάνει μόνο εξερχόμενες κλήσεις HTTPS προς -`ingest.clawmetry.com`. Δεν απαιτούνται εισερχόμενες θύρες. - ---- - -## Ανάπτυξη Cloud - -Δες τον **[Οδηγό Δοκιμών Cloud](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** για SSH tunnels, reverse proxy, και Docker. - -## Δοκιμές +Ή με τη μία εντολή: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -Αυτό το έργο δοκιμάζεται με το BrowserStack. +Χρειάζεται Python 3.8+ σε macOS, Linux ή Windows, και τουλάχιστον ένα runtime +agent στο ίδιο μηχάνημα. Οδηγίες Docker: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## Τεκμηρίωση -## Τηλεμετρία +| | | +|---|---| +| [Συμβατότητα runtime](docs/compatibility.md) | Τι διαβάζει κάθε adapter, και πώς να προσθέσεις ένα runtime | +| [Entitlements](docs/ENTITLEMENTS.md) | Δωρεάν έναντι πληρωμένου, πίνακας επιπέδων, license CLI | +| [Approvals & πολιτικές](docs/APPROVALS.md) | Έλεγχος πριν την εκτέλεση, βαθμολόγηση κινδύνου, εγκρίσεις από κινητό | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Εξαγωγή traces οπουδήποτε, εισαγωγή OTLP από οτιδήποτε | +| [Παρακολούθηση SDK](docs/SDK_TRACKING.md) | Απόδοση κόστους για agents που έφτιαξες μόνος/μόνη σου | +| [Κανάλια συνομιλίας](docs/CHANNELS.md) | Οι adapters συνομιλίας που εμφανίζονται στο Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Ρυθμίσεις sandbox για NVIDIA NemoClaw | +| [Docker](docs/DOCKER.md) | Image, compose, προσαρτήσεις τόμων | +| [Αρχιτεκτονική](ARCHITECTURE.md) · [Ανάπτυξη](docs/DEVELOPMENT.md) | Πώς λειτουργεί εσωτερικά· εκτέλεση από πηγαίο κώδικα | +| [Τηλεμετρία](docs/TELEMETRY.md) | Τα ανώνυμα pings εγκατάστασης και ανοίγματος desktop, και πώς να τα απενεργοποιήσεις | -Το ClawMetry στέλνει ανώνυμα σήματα κύκλου ζωής εγκατάστασης στο -`https://app.clawmetry.com/api/install`: ένα σήμα `install` την πρώτη φορά -που τρέχεις το CLI `clawmetry` σε ένα νέο μηχάνημα, ένα σήμα `update` την -πρώτη εκτέλεση μετά την αναβάθμιση σε νέα έκδοση, και ένα σήμα `onboarded` -όταν ολοκληρώνεις την επιλογή onboarding μέσα στον πίνακα ελέγχου. Το -χρησιμοποιούμε για να μετρήσουμε πραγματικές εγκαταστάσεις (οι ακατέργαστοι -αριθμοί λήψεων PyPI είναι ~98% mirrors, CI, και επανα-λήψεις αυτόματης -ενημέρωσης) και για να μάθουμε ποια πλαίσια πρακτόρων και εκδόσεις είναι -πραγματικά σε χρήση. +## Στιγμιότυπα οθόνης -**Το πολύ ένα POST ανά συμβάν κύκλου ζωής ανά έκδοση**, που περιέχει: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: tokens, sessions, υγεία | **Brain**: ζωντανή ροή γεγονότων agent | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Κόστος**: ανά μοντέλο και session | **Approvals**: έλεγχος ριψοκίνδυνων κλήσεων εργαλείων | -| Πεδίο | Παράδειγμα | Γιατί | -|---|---|---| -| `install_id` | τυχαίο UUID αποθηκευμένο στο `~/.clawmetry/install_id` | αποφυγή διπλοεγγραφών· ανώνυμο μέχρι να συνδέσεις ρητά το Cloud sync (το πιστοποιημένο heartbeat του daemon φέρει τότε το αναγνωριστικό, συνδέοντας αυτή την εγκατάσταση με τον λογαριασμό σου) | -| `event` | `install` / `update` / `onboarded` | νέα εγκατάσταση έναντι αναβάθμισης υπάρχουσας | -| `version` | `0.12.167` | ποιες εκδόσεις είναι σε χρήση | -| `os` / `os_version` | `Darwin` / `25.3.0` | προτεραιότητες υποστήριξης πλατφόρμας | -| `python` | `3.11.15` | πίνακας υποστήριξης εκδόσεων Python | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | με ποιους πράκτορες πρέπει να ενσωματωθούμε στη συνέχεια | -| `is_ci` / `ci_provider` | `true` / `github_actions` | διαχωρισμός ανθρώπινων εγκαταστάσεων από θόρυβο CI | - -**Τι ΔΕΝ στέλνουμε**: IP (το cloud προκύπτει τον κωδικό χώρας -από το αίτημα στην πλευρά του διακομιστή, έπειτα απορρίπτει το IP), -όνομα host, όνομα χρήστη, διαδρομή χώρου εργασίας, περιεχόμενο αρχείων, το -api_key σου, το email σου, οτιδήποτε προσωπικό ή σχετικό με τον χώρο -εργασίας. Το ωφέλιμο φορτίο επικοινωνίας είναι ελέγξιμο στο -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Εξαίρεση** (οποιοδήποτε από αυτά την απενεργοποιεί μόνιμα): +Περισσότερα, ανά runtime: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -Μια αποτυχία δικτύου εδώ δεν εμποδίζει ποτέ την εκτέλεση του `clawmetry`, το -σήμα είναι fire-and-forget σε νήμα daemon με χρονικό όριο 3 δευτερολέπτων. - -## Ιστορικό Αστεριών +## Ιστορικό Star @@ -504,11 +117,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## Άδεια χρήσης -MIT - ---- +MIT · Δημιουργήθηκε από τον/την [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Δες τον πράκτορά σου να σκέφτεται
- Χτισμένο από τον @vivekchand · clawmetry.com · Μέρος του οικοσυστήματος OpenClaw -

+ diff --git a/docs/i18n/es-419/README.md b/docs/i18n/es-419/README.md index d0b7df748a..d8df3fa905 100644 --- a/docs/i18n/es-419/README.md +++ b/docs/i18n/es-419/README.md @@ -1,427 +1,108 @@ - + > Español (LatAm) translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Mira pensar a tu agente.** Observabilidad en tiempo real para **23 runtimes de agentes de IA**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex y 19 más. Un solo dashboard para toda tu flota de agentes. +**Ve pensar a tu agente.** Observabilidad en tiempo real para **23 runtimes de agentes de IA**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex y 19 más. Un solo panel para toda tu flota de agentes. > 🌐 **Lee esto en:** [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) · [más →](docs/i18n/) -Un comando. Cero configuración. Detecta todo automáticamente. +Un solo comando. Cero configuración. Detecta todo automáticamente. ```bash pip install clawmetry && clawmetry ``` -Se abre en **http://localhost:8900** y listo. +Se abre en **http://localhost:8900**. Cero configuración: encuentra los runtimes de agentes +que ya tienes, los lee en modo de solo lectura y no cambia nada de cómo funcionan. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) ## Funciona con 23 runtimes de agentes -ClawMetry comenzó como observabilidad para OpenClaw, y ahora mide **toda tu flota de agentes** en un solo dashboard, detectando automáticamente cada runtime en tu máquina: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw y NemoClaw son gratuitos en la app de código abierto; los demás runtimes se habilitan con ClawMetry Cloud o una licencia Pro autoalojada. Cambia de runtime desde el encabezado y cada pestaña (costo, tokens, herramientas, trazas) se reajusta a ese runtime. Consulta **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** para ver la división exacta entre gratuito y de pago, la matriz de niveles, la forma de `/api/entitlement` y el CLI `clawmetry license`. - -## Qué obtienes - -- **Flow** — Diagrama animado en vivo que muestra los mensajes fluyendo por los canales, el cerebro, las herramientas y de vuelta -- **Overview** — Chequeos de salud, mapa de calor de actividad, conteo de sesiones, info del modelo -- **Usage** — Seguimiento de tokens y costos con desgloses diarios/semanales/mensuales -- **Sessions** — Sesiones de agente activas con modelo, tokens, última actividad -- **Crons** — Trabajos programados con estado, próxima ejecución, duración -- **Logs** — Streaming de logs en tiempo real con código de colores -- **Memory** — Explora SOUL.md, MEMORY.md, AGENTS.md, notas diarias -- **Transcripts** — Interfaz de burbujas de chat para leer los historiales de sesión -- **Alerts** — Topes de presupuesto, disparadores de tasa de error, detección de agente fuera de línea; enruta a Slack, Discord, PagerDuty, Telegram, Email -- **Approvals** — Bloquea eliminaciones destructivas, force pushes, mutaciones de BD, sudo, instalaciones de paquetes y llamadas de red detrás de una aprobación con un solo clic - -## Capturas de pantalla - -### 🧠 Brain — Flujo de eventos del agente en vivo -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Uso de tokens y resumen de sesión -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Feed de llamadas a herramientas en tiempo real -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Desglose de costos por modelo y sesión -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Explorador de archivos del workspace -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Postura de seguridad y registro de auditoría -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — Topes de presupuesto, disparadores de tasa de error, webhooks a Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +**Gratis en la app de código abierto:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### ✋ Approvals — Bloquea llamadas a herramientas riesgosas detrás de una aprobación manual; reglas de protección respaldadas por políticas -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Bloqueo previo a la ejecución para Claude Code** — un solo comando instala un -hook PreToolUse que pausa las llamadas a herramientas coincidentes *antes* de que se ejecuten y espera -tu decisión (un toque desde tu teléfono con -[notificaciones push en la nube](https://app.clawmetry.com/push) habilitadas): - -```bash -clawmetry hooks install # escribe ~/.claude/settings.json (idempotente) -clawmetry hooks status # qué está conectado y cuántas políticas están activas -clawmetry hooks uninstall # elimina solo las entradas de ClawMetry -``` - -Un rechazo bloquea solo esa llamada a herramienta; el agente conserva su sesión y puede -intentar otro enfoque. Aprobar desde tu teléfono evita el propio -prompt de permisos de Claude Code (ya respondiste). Las herramientas sin coincidencia cuestan ~40ms y -caen de vuelta al flujo de permisos normal de Claude Code. También recibes una notificación push en el teléfono cuando el propio Claude Code -está esperando por ti (notificaciones `permission_prompt` / `idle_prompt`). - -## Instalación - -**Un solo comando (recomendado):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**Desde el código fuente:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` +**En un plan pago:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -## Desarrollo del frontend v2 +Cada runtime obtiene el mismo panel. Ejecuta varios a la vez y el selector del +encabezado reenfoca cada pestaña hacia uno de ellos. -La app React v2 vive en `frontend/` y se sirve en `/v2` cuando el servidor -Flask se inicia con v2 habilitado. +¿Construiste tu propio agente con un SDK en lugar de esto? El interceptor también +rastrea sus llamadas a LLM. Consulta [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -Usa dos terminales mientras desarrollas: - -```bash -# Terminal 1: servidor Flask API en :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` - -```bash -# Terminal 2: servidor de desarrollo Vite en :5173 -cd frontend -nvm use -npm ci -npm run dev -``` - -Abre `http://localhost:5173/v2/`. Vite redirige las solicitudes `/api` a -`http://localhost:8900`, de modo que la app React pueda hablar con el servidor Flask local -sin configuración adicional de CORS. - -Para construir el bundle que se distribuye con el paquete de Python: - -```bash -cd frontend -npm run build -``` - -El bundle de producción se escribe en `clawmetry/static/v2/dist/`. - -## Compatibilidad de runtimes / agentes +## Qué obtienes -ClawMetry observa muchos runtimes de agentes de IA, no solo OpenClaw. Cada runtime distinto de OpenClaw incluye un adaptador de lectura dedicado que traduce el formato nativo de sus sesiones a las formas unificadas de ClawMetry; el daemon las ingiere en el mismo almacén DuckDB + snapshot en la nube, etiquetadas con el runtime, y la pestaña de reproducción de sesión muestra un **selector de runtime** cuando hay más de uno presente. Consulta [`docs/compatibility.md`](docs/compatibility.md) para ver la matriz completa y una guía para agregar runtimes, y [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) para la introducción a la familia OpenClaw. +- **Sesiones y transcripciones**: qué hizo cada agente, turno por turno, con repetición +- **Costo y tokens**: por runtime, modelo, sesión y día, con marcas de anomalías +- **Flow**: diagrama en vivo de los mensajes que se mueven entre canales, modelos y herramientas +- **Brain**: el flujo de eventos de razonamiento y llamadas a herramientas en tiempo real +- **Memoria y skills**: los archivos y skills que cada runtime realmente cargó +- **Salud y logs**: disco, memoria, tasas de error, límites de tasa, flujo de logs en vivo +- **Alertas**: topes de presupuesto, picos de errores, agente fuera de línea, enrutadas a Slack, Discord, PagerDuty, Telegram, Email +- **Aprobaciones**: pausa llamadas a herramientas riesgosas *antes* de que se ejecuten y apruébalas desde tu teléfono ([cómo](docs/APPROVALS.md)) -¿Usas la herramienta de seguridad de agentes [numbat de Perplexity](https://github.com/perplexityai/numbat)? ClawMetry ingiere sus hallazgos y decisiones de aplicación de políticas sin configuración adicional; consulta [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Precios -| Runtime / Agente | Estado | Notas | +| Plan | Qué cubre | Precio | |---|---|---| -| **OpenClaw** | Nativo | Runtime de referencia, detectado automáticamente | -| **PicoClaw** | Adaptador beta | JSONL plano `providers.Message` (`~/.picoclaw/workspace/sessions`). Transcripciones, modelo, llamadas a herramientas. | -| **NanoClaw** | Adaptador beta | SQLite por sesión (`data/v2-sessions`). Transcripciones + conteo de mensajes. | -| **Hermes** | Adaptador beta | SQLite `~/.hermes/state.db`. Transcripciones, modelo, tokens/costo. | -| **Claude Code** | Adaptador beta | JSONL `~/.claude/projects/.../.jsonl`. Transcripciones, modelo, llamadas a herramientas + razonamiento, uso de tokens. | -| **Codex** | Adaptador beta | Rollout JSONL `~/.codex/sessions/...`. Transcripciones, modelo, llamadas a herramientas, uso de tokens. | -| **Cursor** | Adaptador beta | SQLite `state.vscdb`. Transcripciones de chat/composer, modelo. | -| **Aider** | Adaptador beta | `.aider.chat.history.md` por proyecto. Transcripciones, modelo, conteo de tokens. | -| **Goose** | Adaptador beta | SQLite `~/.local/share/goose`. Transcripciones, modelo, llamadas a herramientas, totales de tokens. | -| **opencode** | Adaptador beta | SQLite `~/.local/share/opencode`. Transcripciones, modelo, llamadas a herramientas, tokens + costo. | -| **Qwen Code** | Adaptador beta | JSONL `~/.qwen/projects/.../chats`. Transcripciones, modelo, llamadas a herramientas, uso de tokens. | -| **Pi** | Adaptador beta | JSONL `~/.pi/agent/sessions`. Transcripciones, modelo, llamadas a herramientas, tokens + costo. | -| **Deep Agents** | Adaptador beta | SQLite `~/.deepagents/.state/sessions.db`. Transcripciones, modelo, llamadas a herramientas, tokens + costo. | -| **n8n** | Adaptador beta | SQLite `~/.n8n/database.sqlite`. Ejecuciones de workflows, ejecuciones de nodos, prompts del AI Agent, modelo + tokens cuando n8n los registra. | -| **Antigravity** | Adaptador beta | Brain JSONL en `~/.gemini//brain/`. Conversaciones, pasos de herramientas, razonamiento, desglose de tokens de Gemini por generación + costo, consumo de generación en segundo plano. | -| **GitHub Copilot** | Adaptador beta | `events.jsonl` de Copilot CLI en `~/.copilot/session-state/` + el libro de uso por llamada `session-store.db`. Conversaciones, llamadas a herramientas, enrutamiento de modelo, desglose de tokens con caché, costo en créditos de IA facturado por el proveedor. | -| **Grok** | Adaptador beta | xAI Grok Build CLI (binario en Rust en `~/.grok/bin/grok`): registro global de eventos `~/.grok/logs/unified.jsonl` + por sesión `~/.grok/sessions///{events.jsonl,summary.json}`. Conversaciones, desglose de tokens por turno, enrutamiento de modelo, y el payload de repositorio saliente del CLI almacenado en `~/.grok/upload_queue/` para que veas qué salió de tu máquina. | - -"Adaptador beta" significa que ClawMetry incluye un lector para el formato real en disco de ese runtime, cada uno construido y verificado contra una instalación real en una máquina real (ver `tests/fixtures/runtimes//`). Los adaptadores son de solo lectura; cada uno es honesto sobre lo que su runtime realmente almacena (p. ej., PicoClaw/NanoClaw/Cursor no escriben el costo de tokens en disco). Cuando varios runtimes se ejecutan en un mismo nodo, el selector de runtime acota la vista de sesiones a uno solo para un análisis limpio y detallado. - -## Rastrea cualquier agente de SDK: atribución de costos fuera del loop - -Los runtimes anteriores escriben sesiones en disco. Tu propio **agente de producción**, el que construiste con el OpenAI Agents SDK, LangChain, el Vercel AI SDK, LlamaIndex, E2B, o un simple loop con `httpx`, no lo hace. El interceptor sin configuración de ClawMetry igual captura sus llamadas a LLM (costo, tokens, latencia, errores) mediante monkey-patching de `httpx`/`requests`: - -```python -import clawmetry.track # activa el interceptor -clawmetry.track.set_source("support-agent") # nombra este producto - -# ...tu agente se ejecuta con normalidad; cada llamada a LLM ahora se rastrea + atribuye. -``` - -`set_source()` (o la variable de entorno `CLAWMETRY_SOURCE=support-agent`) etiqueta cada llamada con una **fuente nombrada**, de modo que cada producto que ejecutes aparece como su propia línea de primera clase, atribuible por costo, en la tarjeta **🔌 Out-loop sources** del Overview del dashboard: llamadas, proveedores, latencia, tasa de error por agente. ¿No hay fuente configurada? Las llamadas se siguen rastreando; la tarjeta simplemente permanece oculta. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Esta es la misma capa de datos que alimentan los adaptadores de runtime (DuckDB → snapshot en la nube), así que las fuentes fuera del loop se sincronizan con el dashboard en la nube igual que todo lo demás, con cifrado E2E. - -## OpenTelemetry: neutral respecto al proveedor, envía tus trazas a donde quieras - -ClawMetry habla **OpenTelemetry** en ambas direcciones, usando las **convenciones semánticas de GenAI**, de modo que las trazas de tu agente nunca quedan atadas a una sola herramienta. - -**Exporta** cada sesión (llamadas a LLM, herramientas, subagentes, tokens, costo) como spans OTLP/HTTP de GenAI a cualquier colector (Datadog, Grafana, Honeycomb, o tu propio OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalente: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Los encabezados de autenticación y el intervalo de sondeo son variables de entorno opcionales: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # encabezados HTTP adicionales -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # segundos (por defecto 60) -``` - -**Ingesta**: el receptor OTLP incluido acepta trazas, logs y métricas de cualquier otra fuente en `/v1/traces`, `/v1/logs`, y `/v1/metrics`. Apunta cualquier app instrumentada con OpenTelemetry hacia él: +| **Free** | OpenClaw + NVIDIA NemoClaw, panel completo, solo local | $0 | +| **Starter** | Todos los demás runtimes mencionados arriba, vista de flota, sincronización en la nube | $9 por nodo / mes | +| **Pro** | Starter + gobernanza: aprobaciones, políticas de riesgo de herramientas, evaluaciones, detección de anomalías, optimizador de costos, exportación OTel | $19 por nodo / mes | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -Las trazas y logs OTLP/JSON funcionan con un simple `pip install clawmetry`, sin extras. La ingesta de Protobuf (y las métricas OTLP/JSON) requiere `pip install clawmetry[otel]`. Una app que configura su propio `service.name` aparece como su propio agente en el selector de runtime, con su costo y tokens. - -Obtienes el dashboard de ClawMetry sin configuración y local-first, **y** tus datos en el backend que ya usa tu equipo, sin lock-in, sin necesidad de instalar un segundo agente. - -## Configuración - -La mayoría de la gente no necesita ninguna configuración. ClawMetry detecta automáticamente tu workspace, logs, sesiones y crons. - -Si necesitas personalizar: - -```bash -clawmetry --port 9000 # Puerto personalizado (por defecto: 8900) -clawmetry --host 127.0.0.1 # Vincular solo a localhost -clawmetry --workspace ~/mybot # Ruta de workspace personalizada -clawmetry --name "Alice" # Tu nombre en la visualización de Flow -``` - -Todas las opciones: `clawmetry --help` - -## Canales compatibles - -ClawMetry muestra actividad en vivo para cada canal de OpenClaw que tengas configurado. Solo los canales que estén realmente configurados en tu `openclaw.json` aparecen en el diagrama de Flow; los no configurados se ocultan automáticamente. - -Haz clic en cualquier nodo de canal en Flow para ver una vista de burbujas de chat en vivo con conteos de mensajes entrantes/salientes. - -| Canal | Estado | Popup en vivo | Notas | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Completo | ✅ | Mensajes, estadísticas, actualización cada 10s | -| 💬 **iMessage** | ✅ Completo | ✅ | Lee `~/Library/Messages/chat.db` directamente | -| 💚 **WhatsApp** | ✅ Completo | ✅ | Vía WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Completo | ✅ | Vía signal-cli | -| 🟣 **Discord** | ✅ Completo | ✅ | Detección de gremio + canal | -| 🟪 **Slack** | ✅ Completo | ✅ | Detección de workspace + canal | -| 🌐 **Webchat** | ✅ Completo | ✅ | Sesiones de la interfaz web integrada | -| 📡 **IRC** | ✅ Completo | ✅ | Interfaz de burbujas estilo terminal | -| 🍏 **BlueBubbles** | ✅ Completo | ✅ | iMessage vía la API REST de BlueBubbles | -| 🔵 **Google Chat** | ✅ Completo | ✅ | Vía webhooks de la API de Chat | -| 🟣 **MS Teams** | ✅ Completo | ✅ | Vía el plugin de bot de Teams | -| 🔷 **Mattermost** | ✅ Completo | ✅ | Chat de equipo autoalojado | -| 🟩 **Matrix** | ✅ Completo | ✅ | Descentralizado, con soporte E2EE | -| 🟢 **LINE** | ✅ Completo | ✅ | API de mensajería de LINE | -| ⚡ **Nostr** | ✅ Completo | ✅ | DMs descentralizados NIP-04 | -| 🟣 **Twitch** | ✅ Completo | ✅ | Chat vía conexión IRC | -| 🔷 **Feishu/Lark** | ✅ Completo | ✅ | Suscripción a eventos por WebSocket | -| 🔵 **Zalo** | ✅ Completo | ✅ | API de Zalo Bot | - -> **Detección automática:** ClawMetry lee tu `~/.openclaw/openclaw.json` y solo renderiza los canales que realmente hayas configurado. No se requiere configuración manual. - -## Despliegue con Docker - -¿Quieres ejecutar ClawMetry en un contenedor? ¡No hay problema! 🐳 - -**Inicio rápido con Docker:** - -```bash -# Construir la imagen -docker build -t clawmetry . - -# Ejecutar con la configuración predeterminada -docker run -p 8900:8900 clawmetry - -# O montar el directorio de datos de tu agente (se muestra: el ~/.openclaw de OpenClaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Ejemplo de Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Nota:** Al ejecutar en Docker, monta los directorios de datos + logs de tu agente (p. ej., `~/.openclaw`, `~/.claude`, `~/.codex`) para que ClawMetry pueda detectar automáticamente tu configuración. - -## Requisitos - -- Python 3.8+ -- Flask (se instala automáticamente vía pip) -- Un runtime de agente de IA en la misma máquina: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, o QM (o volúmenes montados para Docker) -- Linux o macOS - -## Soporte para NemoClaw / OpenShell - -ClawMetry detecta automáticamente [NemoClaw](https://github.com/NVIDIA/NemoClaw), el envoltorio de seguridad empresarial de NVIDIA para OpenClaw que ejecuta agentes dentro de contenedores OpenShell en sandbox. - -En la mayoría de los casos no se necesita configuración adicional. El daemon de sincronización descubre automáticamente los archivos de sesión, ya sea que estén en `~/.openclaw/` en el host o dentro de un contenedor OpenShell. +Los planes anuales, Enterprise y los precios actuales están en +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Las claves de licencia +autoalojadas funcionan sin la nube (`clawmetry license`). La división exacta entre +gratis y pago está en [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -### Cómo funciona +## Tus datos se quedan en tu máquina -ClawMetry detecta NemoClaw de dos maneras: +ClawMetry lee archivos de sesión y logs locales. Nada sale de tu equipo a menos que +ejecutes `clawmetry connect`. Incluso entonces, el snapshot está cifrado de extremo a +extremo con una clave que nunca sale de tu máquina, y se descifra en tu navegador. -1. **Detección por binario**: verifica la existencia del CLI `nemoclaw` y ejecuta `nemoclaw status` para obtener la info del sandbox -2. **Detección por contenedor**: escanea los contenedores Docker en ejecución en busca de imágenes `openshell`, `nemoclaw`, o `ghcr.io/nvidia/`, y luego lee las sesiones vía montajes de volumen o `docker cp` - -Los archivos de sesión sincronizados desde contenedores NemoClaw se etiquetan con `runtime=nemoclaw` y metadatos de `container_id` en el dashboard en la nube, para que puedas distinguirlos de las sesiones estándar de OpenClaw de un vistazo. - -### Configuración recomendada: daemon de sincronización en el HOST - -Para la mejor experiencia, ejecuta el daemon de sincronización de ClawMetry en la **máquina host** (no dentro del sandbox). Esto evita las restricciones de política de red de NemoClaw. - -```bash -# En el host (fuera del sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -El daemon de sincronización encontrará automáticamente las sesiones dentro de cualquier contenedor OpenShell en ejecución. - -### Opcional: nombre explícito del sandbox - -Si la detección automática no funciona, apunta ClawMetry al sandbox correcto: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Ejecución dentro del sandbox (avanzado) - -Si debes ejecutar el daemon de sincronización **dentro** del sandbox de OpenShell, agrega esta regla de salida a tu política de red de NemoClaw para que pueda llegar a la API de ingesta de ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Aplícala con: +## Instalación ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # luego: clawmetry ``` -### Puertos y endpoints - -| Endpoint | Puerto | Protocolo | Requerido | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Sí (daemon de sincronización → nube) | -| `localhost:8900` | 8900 | HTTP | Sí (interfaz del dashboard local) | -| Socket de Docker (`/var/run/docker.sock`) | — | Socket Unix | Para el descubrimiento de sesiones en contenedores | - -El daemon de sincronización solo realiza llamadas HTTPS salientes a `ingest.clawmetry.com`. No se requieren puertos de entrada. - ---- - -## Despliegue en la nube - -Consulta la **[Guía de pruebas en la nube](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** para túneles SSH, proxy inverso y Docker. - -## Pruebas +O el comando de una línea: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -Este proyecto se prueba con BrowserStack. +Requiere Python 3.8+ en macOS, Linux o Windows, y al menos un runtime de agente en +la misma máquina. Instrucciones de Docker: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## Documentación -## Telemetría +| | | +|---|---| +| [Compatibilidad de runtimes](docs/compatibility.md) | Qué lee cada adaptador, y cómo agregar un runtime | +| [Entitlements](docs/ENTITLEMENTS.md) | Gratis vs. pago, matriz de niveles, CLI de licencias | +| [Aprobaciones y políticas](docs/APPROVALS.md) | Bloqueo previo a la ejecución, puntuación de riesgo, aprobaciones desde el teléfono | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Exporta trazas a cualquier lugar, ingiere OTLP desde cualquier fuente | +| [Seguimiento de SDK](docs/SDK_TRACKING.md) | Atribución de costos para agentes que construiste tú mismo | +| [Canales de chat](docs/CHANNELS.md) | Los adaptadores de chat que se muestran en Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Configuraciones de NVIDIA NemoClaw en sandbox | +| [Docker](docs/DOCKER.md) | Imagen, compose, montajes de volúmenes | +| [Arquitectura](ARCHITECTURE.md) · [Desarrollo](docs/DEVELOPMENT.md) | Cómo funciona por dentro; cómo ejecutarlo desde el código fuente | +| [Telemetría](docs/TELEMETRY.md) | Los pings anónimos de instalación y apertura de escritorio, y cómo desactivarlos | -ClawMetry envía pings anónimos del ciclo de vida de la instalación a -`https://app.clawmetry.com/api/install`: un ping de `install` la primera -vez que ejecutas el CLI `clawmetry` en una máquina nueva, un ping de `update` -la primera ejecución tras actualizar a una versión nueva, y un ping de `onboarded` -cuando completas la elección de onboarding dentro del dashboard. Usamos esto -para contar instalaciones reales (las cifras crudas de descargas de PyPI son ~98% mirrors, CI, -y redescargas de auto-actualización) y para saber qué frameworks y versiones de agentes -están realmente en uso. +## Capturas de pantalla -**Como máximo un POST por evento de ciclo de vida por versión**, que contiene: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: tokens, sesiones, salud | **Brain**: flujo de eventos del agente en vivo | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: por modelo y sesión | **Approvals**: bloquea llamadas a herramientas riesgosas | -| Campo | Ejemplo | Por qué | -|---|---|---| -| `install_id` | UUID aleatorio almacenado en `~/.clawmetry/install_id` | deduplicación; anónimo hasta que conectas explícitamente la sincronización en la nube (el heartbeat autenticado del daemon entonces lo transporta, vinculando esta instalación a tu cuenta) | -| `event` | `install` / `update` / `onboarded` | instalación nueva vs. actualización de una existente | -| `version` | `0.12.167` | qué versiones están en uso | -| `os` / `os_version` | `Darwin` / `25.3.0` | prioridades de soporte de plataforma | -| `python` | `3.11.15` | matriz de soporte de versiones de Python | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | con qué agentes deberíamos integrarnos a continuación | -| `is_ci` / `ci_provider` | `true` / `github_actions` | separar instalaciones humanas del ruido de CI | - -**Qué NO enviamos**: IP (la nube deriva el código de país del lado del servidor -a partir de la solicitud, y luego descarta la IP), nombre de host, nombre de usuario, ruta del -workspace, contenido de archivos, tu api_key, tu correo electrónico, nada de PII ni -específico del workspace. El payload en tránsito es auditable en -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Cómo optar por no participar** (cualquiera de estas la deshabilita permanentemente): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # por shell -export DO_NOT_TRACK=1 # estándar W3C entre herramientas -touch ~/.clawmetry/notelemetry # marcador de archivo persistente -``` - -Un fallo de red aquí nunca bloquea la ejecución de `clawmetry`; el -ping es fire-and-forget en un hilo del daemon con un timeout de 3 s. +Más, por runtime: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Historial de estrellas @@ -435,11 +116,6 @@ ping es fire-and-forget en un hilo del daemon con un timeout de 3 s. ## Licencia -MIT - ---- +MIT · Creado por [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Mira pensar a tu agente
- Creado por @vivekchand · clawmetry.com · Parte del ecosistema OpenClaw -

+ diff --git a/docs/i18n/es/README.md b/docs/i18n/es/README.md index ad105fca25..6e17570a86 100644 --- a/docs/i18n/es/README.md +++ b/docs/i18n/es/README.md @@ -1,428 +1,107 @@ - + > Español translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Observa cómo piensa tu agente.** Observabilidad en tiempo real para **23 runtimes de agentes de IA**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex y 19 más. Un solo panel para toda tu flota de agentes. +**Observa el pensamiento de tu agente.** Observabilidad en tiempo real para **23 runtimes de agentes de IA**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex y 19 más. Un solo panel para toda tu flota de agentes. -> 🌐 **Lee esto en:** [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) · [más →](docs/i18n/) +> 🌐 **Léelo en:** [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) · [más →](docs/i18n/) -Un solo comando. Cero configuración. Detecta todo automáticamente. +Un comando. Cero configuración. Detecta todo automáticamente. ```bash pip install clawmetry && clawmetry ``` -Se abre en **http://localhost:8900** y listo. +Se abre en **http://localhost:8900**. Cero configuración: encuentra los runtimes de agentes que ya tienes, los lee en modo de solo lectura y no cambia nada de cómo funcionan. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) ## Funciona con 23 runtimes de agentes -ClawMetry comenzó como observabilidad para OpenClaw, y ahora mide **toda tu flota de agentes** en un solo panel, detectando automáticamente cada runtime en tu máquina: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw y NemoClaw son gratuitos en la aplicación de código abierto; los demás runtimes se activan con ClawMetry Cloud o una licencia Pro autoalojada. Cambia de runtime desde el encabezado y cada pestaña, costo, tokens, herramientas, trazas, se reajusta a ese runtime. Consulta **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** para la división exacta entre gratuito y de pago, la matriz de niveles, la forma de `/api/entitlement` y la CLI `clawmetry license`. - -## Qué obtienes - -- **Flow**: Diagrama animado en vivo que muestra los mensajes fluyendo a través de canales, cerebro, herramientas y de vuelta -- **Overview**: Chequeos de salud, mapa de calor de actividad, conteo de sesiones, información del modelo -- **Usage**: Seguimiento de tokens y costos con desgloses diarios/semanales/mensuales -- **Sessions**: Sesiones activas del agente con modelo, tokens, última actividad -- **Crons**: Tareas programadas con estado, próxima ejecución, duración -- **Logs**: Transmisión de logs en tiempo real con código de colores -- **Memory**: Explora SOUL.md, MEMORY.md, AGENTS.md, notas diarias -- **Transcripts**: Interfaz de burbujas de chat para leer historiales de sesiones -- **Alerts**: Límites de presupuesto, disparadores por tasa de error, detección de agente desconectado; enruta a Slack, Discord, PagerDuty, Telegram, Email -- **Approvals**: Bloquea eliminaciones destructivas, force pushes, mutaciones de base de datos, sudo, instalaciones de paquetes, llamadas de red detrás de una autorización de un solo clic - -## Capturas de pantalla - -### 🧠 Brain — Flujo de eventos en vivo del agente -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Uso de tokens y resumen de sesiones -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Feed de llamadas a herramientas en tiempo real -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Desglose de costos por modelo y sesión -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Explorador de archivos del espacio de trabajo -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Postura y registro de auditoría -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — Límites de presupuesto, disparadores por tasa de error, webhooks a Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +**Gratis en la app de código abierto:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### ✋ Approvals — Bloquea llamadas de herramientas riesgosas detrás de una autorización manual; reglas de protección respaldadas por políticas -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Bloqueo previo a la ejecución para Claude Code**: un comando instala -un hook PreToolUse que pausa las llamadas a herramientas coincidentes *antes* de que se ejecuten y espera -tu decisión (con un toque desde tu teléfono si tienes activadas las -[notificaciones push en la nube](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 -``` - -Una denegación bloquea solo esa llamada a herramienta; el agente conserva su sesión y puede -intentar otro enfoque. Aprobar desde tu teléfono omite el propio aviso de -permiso de Claude Code (ya respondiste). Las herramientas no coincidentes cuestan ~40ms y -pasan al flujo normal de permisos de Claude Code. También recibes una notificación push en tu teléfono cuando -Claude Code mismo está esperando tu respuesta (notificaciones `permission_prompt` / -`idle_prompt`). - -## Instalación - -**Comando único (recomendado):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**Desde el código fuente:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` +**En un plan de pago:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -## Desarrollo del frontend v2 +Cada runtime obtiene el mismo panel. Ejecuta varios a la vez y el selector del encabezado +reenfoca cada pestaña a uno de ellos. -La aplicación React v2 vive en `frontend/` y se sirve en `/v2` cuando el -servidor Flask se inicia con v2 habilitado. +¿Construiste tu propio agente con un SDK en lugar de usar un runtime? El interceptor también +rastrea sus llamadas al LLM. Consulta [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -Usa dos terminales durante el desarrollo: - -```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 -``` - -Abre `http://localhost:5173/v2/`. Vite redirige las solicitudes `/api` a -`http://localhost:8900`, para que la aplicación React pueda comunicarse con el servidor Flask local -sin configuración adicional de CORS. - -Para compilar el paquete que se distribuye con el paquete de Python: - -```bash -cd frontend -npm run build -``` - -El paquete de producción se escribe en `clawmetry/static/v2/dist/`. - -## Compatibilidad de runtimes / agentes +## Qué obtienes -ClawMetry observa muchos runtimes de agentes de IA, no solo OpenClaw. Cada runtime que no es OpenClaw incluye un adaptador de lectura dedicado que traduce el formato nativo de sus sesiones a las formas unificadas de ClawMetry; el daemon los ingiere en el mismo almacén DuckDB + instantánea en la nube, etiquetados con el runtime, y la pestaña de repetición de sesión muestra un **selector de runtime** cuando hay más de uno presente. Consulta [`docs/compatibility.md`](docs/compatibility.md) para la matriz completa y una guía para agregar runtimes, y [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) para la introducción a la familia OpenClaw. +- **Sesiones y transcripciones**: qué hizo cada agente, turno por turno, con repetición +- **Costo y tokens**: por runtime, modelo, sesión y día, con indicadores de anomalías +- **Flow**: diagrama en vivo de mensajes que se mueven entre canales, modelos y herramientas +- **Brain**: el flujo de eventos de razonamiento y llamadas a herramientas a medida que ocurre +- **Memoria y skills**: los archivos y skills que cada runtime realmente cargó +- **Salud y logs**: disco, memoria, tasas de error, límites de tasa, flujo de logs en vivo +- **Alertas**: límites de presupuesto, picos de errores, agente fuera de línea, enrutadas a Slack, Discord, PagerDuty, Telegram, Email +- **Approvals**: pausa llamadas a herramientas riesgosas *antes* de que se ejecuten y apruébalas desde tu teléfono ([cómo](docs/APPROVALS.md)) -¿Ejecutas la herramienta de seguridad de agentes [numbat de Perplexity](https://github.com/perplexityai/numbat)? ClawMetry ingiere sus hallazgos y decisiones de aplicación sin configuración adicional; consulta [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Precios -| Runtime / Agente | Estado | Notas | +| Plan | Qué cubre | Precio | |---|---|---| -| **OpenClaw** | Nativo | Runtime de referencia, detectado automáticamente | -| **PicoClaw** | Adaptador beta | JSONL plano `providers.Message` (`~/.picoclaw/workspace/sessions`). Transcripciones, modelo, llamadas a herramientas. | -| **NanoClaw** | Adaptador beta | SQLite por sesión (`data/v2-sessions`). Transcripciones + conteo de mensajes. | -| **Hermes** | Adaptador beta | SQLite `~/.hermes/state.db`. Transcripciones, modelo, tokens/costo. | -| **Claude Code** | Adaptador beta | JSONL `~/.claude/projects/.../.jsonl`. Transcripciones, modelo, llamadas a herramientas + razonamiento, uso de tokens. | -| **Codex** | Adaptador beta | Rollout JSONL `~/.codex/sessions/...`. Transcripciones, modelo, llamadas a herramientas, uso de tokens. | -| **Cursor** | Adaptador beta | SQLite `state.vscdb`. Transcripciones de chat/composer, modelo. | -| **Aider** | Adaptador beta | `.aider.chat.history.md` por proyecto. Transcripciones, modelo, conteo de tokens. | -| **Goose** | Adaptador beta | SQLite `~/.local/share/goose`. Transcripciones, modelo, llamadas a herramientas, totales de tokens. | -| **opencode** | Adaptador beta | SQLite `~/.local/share/opencode`. Transcripciones, modelo, llamadas a herramientas, tokens + costo. | -| **Qwen Code** | Adaptador beta | JSONL `~/.qwen/projects/.../chats`. Transcripciones, modelo, llamadas a herramientas, uso de tokens. | -| **Pi** | Adaptador beta | JSONL `~/.pi/agent/sessions`. Transcripciones, modelo, llamadas a herramientas, tokens + costo. | -| **Deep Agents** | Adaptador beta | SQLite `~/.deepagents/.state/sessions.db`. Transcripciones, modelo, llamadas a herramientas, tokens + costo. | -| **n8n** | Adaptador beta | SQLite `~/.n8n/database.sqlite`. Ejecuciones de flujo de trabajo, ejecuciones de nodos, prompts de AI Agent, modelo + tokens cuando n8n los registra. | -| **Antigravity** | Adaptador beta | Brain JSONL en `~/.gemini//brain/`. Conversaciones, pasos de herramientas, razonamiento, división de tokens de Gemini por generación + costo, consumo de generación en segundo plano. | -| **GitHub Copilot** | Adaptador beta | Copilot CLI `events.jsonl` en `~/.copilot/session-state/` + el libro de uso por llamada `session-store.db`. Conversaciones, llamadas a herramientas, enrutamiento de modelo, división de tokens con caché, costo facturado por el proveedor en créditos de IA. | -| **Grok** | Adaptador beta | xAI Grok Build CLI (binario en Rust en `~/.grok/bin/grok`): registro global de eventos `~/.grok/logs/unified.jsonl` + por sesión `~/.grok/sessions///{events.jsonl,summary.json}`. Conversaciones, división de tokens por turno, enrutamiento de modelo, y el payload de repositorio saliente de la CLI almacenado en `~/.grok/upload_queue/` para que puedas ver qué salió de tu máquina. | - -"Adaptador beta" significa que ClawMetry incluye un lector para el formato real en disco de ese runtime, cada uno construido y verificado contra una instalación real en una máquina real (consulta `tests/fixtures/runtimes//`). Los adaptadores son de solo lectura; cada uno es honesto sobre lo que su runtime realmente almacena (por ejemplo, PicoClaw/NanoClaw/Cursor no escriben el costo de tokens en disco). Cuando varios runtimes se ejecutan en un mismo nodo, el selector de runtime limita la vista de sesiones a uno para un análisis detallado y limpio. - -## Rastrea cualquier agente SDK — atribución de costos fuera del bucle - -Los runtimes anteriores escriben todos sus sesiones en disco. Tu propio **agente de producción**, el que construiste sobre el OpenAI Agents SDK, LangChain, el Vercel AI SDK, LlamaIndex, E2B, o un bucle simple con `httpx`, no lo hace. El interceptor sin configuración de ClawMetry igualmente captura sus llamadas a LLM (costo, tokens, latencia, errores) mediante monkey-patching a `httpx`/`requests`: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (o la variable de entorno `CLAWMETRY_SOURCE=support-agent`) etiqueta cada llamada con una **fuente con nombre**, de modo que cada producto que ejecutas aparece como su propia línea independiente y atribuible por costo en la tarjeta **🔌 Fuentes fuera del bucle** del panel Overview: llamadas, proveedores, latencia, tasa de error por agente. ¿No configuraste una fuente? Las llamadas se siguen rastreando; la tarjeta simplemente permanece oculta. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Esta es la misma capa de datos que alimentan los adaptadores de runtime (DuckDB → instantánea en la nube), así que las fuentes fuera del bucle se sincronizan con el panel en la nube igual que todo lo demás, cifradas de extremo a extremo. - -## OpenTelemetry — neutral respecto al proveedor, envía tus trazas a donde quieras - -ClawMetry habla **OpenTelemetry** en ambas direcciones, usando las **convenciones semánticas de GenAI**, para que las trazas de tu agente nunca queden atadas a una sola herramienta. - -**Exporta** cada sesión (llamadas a LLM, herramientas, subagentes, tokens, costo) como spans GenAI de OTLP/HTTP a cualquier colector (Datadog, Grafana, Honeycomb, o tu propio OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Los encabezados de autenticación y el intervalo de sondeo son variables de entorno opcionales: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**Ingiere**: el receptor OTLP integrado acepta trazas, logs y métricas de cualquier otra fuente en `/v1/traces`, `/v1/logs` y `/v1/metrics`. Apunta cualquier aplicación instrumentada con OpenTelemetry hacia él: +| **Free** | OpenClaw + NVIDIA NemoClaw, panel completo, solo local | $0 | +| **Starter** | Todos los demás runtimes anteriores, vista de flota, sincronización en la nube | $9 por nodo / mes | +| **Pro** | Starter + gobernanza: approvals, políticas de riesgo de herramientas, evals, detección de anomalías, optimizador de costos, exportación OTel | $19 por nodo / mes | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -Las trazas y logs de OTLP/JSON funcionan con un simple `pip install clawmetry`, sin extras. La ingesta de Protobuf (y las métricas de OTLP/JSON) necesita `pip install clawmetry[otel]`. Una aplicación que define su propio `service.name` aparece como su propio agente en el selector de runtime, con su costo y tokens. - -Obtienes el panel de ClawMetry sin configuración y local primero, **y** tus datos en el backend que ya use tu equipo, sin bloqueos, sin necesidad de instalar un segundo agente. - -## Configuración - -La mayoría de las personas no necesita ninguna configuración. ClawMetry detecta automáticamente tu espacio de trabajo, logs, sesiones y crons. - -Si necesitas personalizar: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -Todas las opciones: `clawmetry --help` - -## Canales compatibles - -ClawMetry muestra actividad en vivo para cada canal de OpenClaw que tengas configurado. Solo los canales que están realmente configurados en tu `openclaw.json` aparecen en el diagrama de Flow; los no configurados se ocultan automáticamente. - -Haz clic en cualquier nodo de canal en Flow para ver una vista de burbujas de chat en vivo con conteos de mensajes entrantes/salientes. - -| Canal | Estado | Popup en vivo | Notas | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Completo | ✅ | Mensajes, estadísticas, actualización cada 10s | -| 💬 **iMessage** | ✅ Completo | ✅ | Lee `~/Library/Messages/chat.db` directamente | -| 💚 **WhatsApp** | ✅ Completo | ✅ | Vía WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Completo | ✅ | Vía signal-cli | -| 🟣 **Discord** | ✅ Completo | ✅ | Detección de guild + canal | -| 🟪 **Slack** | ✅ Completo | ✅ | Detección de workspace + canal | -| 🌐 **Webchat** | ✅ Completo | ✅ | Sesiones de la interfaz web integrada | -| 📡 **IRC** | ✅ Completo | ✅ | Interfaz de burbujas estilo terminal | -| 🍏 **BlueBubbles** | ✅ Completo | ✅ | iMessage vía la API REST de BlueBubbles | -| 🔵 **Google Chat** | ✅ Completo | ✅ | Vía webhooks de Chat API | -| 🟣 **MS Teams** | ✅ Completo | ✅ | Vía el plugin de bot de Teams | -| 🔷 **Mattermost** | ✅ Completo | ✅ | Chat de equipo autoalojado | -| 🟩 **Matrix** | ✅ Completo | ✅ | Descentralizado, soporte E2EE | -| 🟢 **LINE** | ✅ Completo | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Completo | ✅ | DMs descentralizados NIP-04 | -| 🟣 **Twitch** | ✅ Completo | ✅ | Chat vía conexión IRC | -| 🔷 **Feishu/Lark** | ✅ Completo | ✅ | Suscripción de eventos por WebSocket | -| 🔵 **Zalo** | ✅ Completo | ✅ | Zalo Bot API | - -> **Detección automática:** ClawMetry lee tu `~/.openclaw/openclaw.json` y solo renderiza los canales que realmente has configurado. No se requiere configuración manual. - -## Despliegue con Docker - -¿Quieres ejecutar ClawMetry en un contenedor? ¡Sin problema! 🐳 - -**Inicio rápido con Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Ejemplo de Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Nota:** Al ejecutar en Docker, monta los directorios de datos + logs de tu agente (por ejemplo, `~/.openclaw`, `~/.claude`, `~/.codex`) para que ClawMetry pueda detectar tu configuración automáticamente. - -## Requisitos - -- Python 3.8+ -- Flask (instalado automáticamente vía pip) -- Un runtime de agente de IA en la misma máquina: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, o QM (o volúmenes montados para Docker) -- Linux o macOS - -## Soporte para NemoClaw / OpenShell - -ClawMetry detecta automáticamente [NemoClaw](https://github.com/NVIDIA/NemoClaw), el envoltorio de seguridad empresarial de NVIDIA para OpenClaw que ejecuta agentes dentro de contenedores OpenShell en sandbox. - -En la mayoría de los casos no se necesita configuración adicional. El daemon de sincronización descubre automáticamente los archivos de sesión, ya sea que estén en `~/.openclaw/` en el host o dentro de un contenedor OpenShell. +Los planes anuales, Enterprise y las cifras actuales están en +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Las claves de licencia autoalojadas +funcionan sin la nube (`clawmetry license`). La división exacta entre gratis y de pago está +en [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -### Cómo funciona +## Tus datos permanecen en tu máquina -ClawMetry detecta NemoClaw de dos maneras: +ClawMetry lee archivos de sesión y logs locales. Nada sale de tu equipo a menos que +ejecutes `clawmetry connect`. Incluso entonces, la instantánea está cifrada de extremo a extremo +con una clave que nunca sale de tu máquina, y se descifra en tu navegador. -1. **Detección de binario**: verifica la CLI `nemoclaw` y ejecuta `nemoclaw status` para obtener información del sandbox -2. **Detección de contenedor**: escanea los contenedores Docker en ejecución en busca de imágenes `openshell`, `nemoclaw` o `ghcr.io/nvidia/`, y luego lee las sesiones vía volúmenes montados o `docker cp` - -Los archivos de sesión sincronizados desde contenedores NemoClaw se etiquetan con `runtime=nemoclaw` y metadatos `container_id` en el panel en la nube, para que puedas distinguirlos de las sesiones estándar de OpenClaw de un vistazo. - -### Configuración recomendada: daemon de sincronización en el HOST - -Para la mejor experiencia, ejecuta el daemon de sincronización de ClawMetry en la **máquina host** (no dentro del sandbox). Esto evita las restricciones de la política de red de NemoClaw. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -El daemon de sincronización encontrará automáticamente las sesiones dentro de cualquier contenedor OpenShell en ejecución. - -### Opcional: nombre explícito del sandbox - -Si la detección automática no funciona, apunta ClawMetry al sandbox correcto: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Ejecutar dentro del sandbox (avanzado) - -Si debes ejecutar el daemon de sincronización **dentro** del sandbox de OpenShell, agrega esta regla de salida a tu política de red de NemoClaw para que pueda alcanzar la API de ingesta de ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Aplica con: +## Instalación ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # luego: clawmetry ``` -### Puertos y endpoints - -| Endpoint | Puerto | Protocolo | Requerido | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Sí (daemon de sincronización → nube) | -| `localhost:8900` | 8900 | HTTP | Sí (interfaz del panel local) | -| Socket de Docker (`/var/run/docker.sock`) | — | Socket Unix | Para descubrimiento de sesiones en contenedores | - -El daemon de sincronización solo realiza llamadas HTTPS salientes a `ingest.clawmetry.com`. No se requieren puertos de entrada. - ---- - -## Despliegue en la nube - -Consulta la **[Guía de pruebas en la nube](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** para túneles SSH, proxy inverso y Docker. - -## Pruebas +O el comando de una línea: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -Este proyecto se prueba con BrowserStack. +Requiere Python 3.8+ en macOS, Linux o Windows, y al menos un runtime de agente en +la misma máquina. Instrucciones de Docker: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## Documentación -## Telemetría +| | | +|---|---| +| [Compatibilidad de runtimes](docs/compatibility.md) | Qué lee cada adaptador, y cómo añadir un runtime | +| [Entitlements](docs/ENTITLEMENTS.md) | Gratis vs. de pago, matriz de niveles, CLI de licencia | +| [Approvals y políticas](docs/APPROVALS.md) | Control previo a la ejecución, puntuación de riesgo, aprobaciones desde el teléfono | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Exporta trazas a cualquier lugar, ingiere OTLP desde cualquier fuente | +| [Seguimiento con SDK](docs/SDK_TRACKING.md) | Atribución de costos para agentes que construiste tú mismo | +| [Canales de chat](docs/CHANNELS.md) | Los adaptadores de chat que se muestran en Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Configuraciones de NVIDIA NemoClaw en sandbox | +| [Docker](docs/DOCKER.md) | Imagen, compose, montajes de volúmenes | +| [Arquitectura](ARCHITECTURE.md) · [Desarrollo](docs/DEVELOPMENT.md) | Cómo funciona por dentro; ejecución desde el código fuente | +| [Telemetría](docs/TELEMETRY.md) | Los pings anónimos de instalación y apertura de escritorio, y cómo desactivarlos | -ClawMetry envía pings anónimos del ciclo de vida de la instalación a -`https://app.clawmetry.com/api/install`: un ping de `install` la primera -vez que ejecutas la CLI de `clawmetry` en una máquina nueva, un ping de `update` -en la primera ejecución tras actualizar a una nueva versión, y un ping de `onboarded` -cuando completas la elección de incorporación dentro del panel. Usamos esto -para contar instalaciones reales (las cifras de descargas en PyPI son ~98% mirrors, CI, -y redescargas de actualización automática) y para saber qué frameworks de agentes y -versiones están realmente en uso. +## Capturas de pantalla -**Como máximo un POST por evento de ciclo de vida y por versión**, que contiene: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: tokens, sesiones, salud | **Brain**: flujo de eventos del agente en vivo | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: por modelo y sesión | **Approvals**: control de llamadas a herramientas riesgosas | -| Campo | Ejemplo | Por qué | -|---|---|---| -| `install_id` | UUID aleatorio almacenado en `~/.clawmetry/install_id` | deduplicación; anónimo hasta que conectes explícitamente la sincronización con Cloud (el heartbeat autenticado del daemon lleva entonces este dato, vinculando esta instalación con tu cuenta) | -| `event` | `install` / `update` / `onboarded` | instalación nueva vs actualización de una existente | -| `version` | `0.12.167` | qué versiones están en uso | -| `os` / `os_version` | `Darwin` / `25.3.0` | prioridades de soporte de plataforma | -| `python` | `3.11.15` | matriz de soporte de versiones de Python | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | con qué agentes deberíamos integrarnos a continuación | -| `is_ci` / `ci_provider` | `true` / `github_actions` | separar instalaciones humanas del ruido de CI | - -**Lo que NO enviamos**: IP (la nube deriva el código de país del lado del servidor -a partir de la solicitud, y luego descarta la IP), nombre de host, nombre de usuario, ruta del -espacio de trabajo, contenido de archivos, tu api_key, tu correo electrónico, nada que sea PII o -específico del espacio de trabajo. El payload en tránsito es auditable en -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Optar por no participar** (cualquiera de estas opciones lo desactiva permanentemente): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -Un fallo de red aquí nunca bloquea la ejecución de `clawmetry`; el -ping es de disparar y olvidar en un hilo del daemon con un tiempo de espera de 3 s. +Más, por runtime: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Historial de estrellas @@ -436,11 +115,6 @@ ping es de disparar y olvidar en un hilo del daemon con un tiempo de espera de 3 ## Licencia -MIT - ---- +MIT · Creado por [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Observa cómo piensa tu agente
- Creado por @vivekchand · clawmetry.com · Parte del ecosistema OpenClaw -

+ diff --git a/docs/i18n/fa/README.md b/docs/i18n/fa/README.md index 906f8bc387..3bdddb59f9 100644 --- a/docs/i18n/fa/README.md +++ b/docs/i18n/fa/README.md @@ -1,424 +1,105 @@ - + > فارسی translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**تفکر ایجنت خود را ببینید.** رصدپذیری بلادرنگ برای **۲۰ ران‌تایم ایجنت هوش مصنوعی**: [OpenClaw](https://github.com/openclaw/openclaw)، [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)، Claude Code، OpenAI Codex و ۱۶ مورد دیگر. یک داشبورد برای کل ناوگان ایجنت‌های شما. +**فکر کردن ایجنت خود را ببینید.** رصد بلادرنگ برای **۲۳ محیط اجرای ایجنت هوش مصنوعی**: [OpenClaw](https://github.com/openclaw/openclaw)، [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)، Claude Code، OpenAI Codex و ۱۹ مورد دیگر. یک داشبورد برای کل ناوگان ایجنت‌های شما. -> 🌐 **این را به زبان‌های دیگر بخوانید:** [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/) +> 🌐 **این را به این زبان‌ها بخوانید:** [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** باز می‌شود و کارتان تمام است. +در **http://localhost:8900** باز می‌شود. بدون پیکربندی: محیط‌های اجرای ایجنتی که از قبل دارید را پیدا می‌کند، آن‌ها را فقط برای خواندن می‌خواند، و هیچ چیزی را در نحوه اجرای آن‌ها تغییر نمی‌دهد. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## با ۲۰ ران‌تایم ایجنت کار می‌کند - -ClawMetry به‌عنوان ابزار رصدپذیری برای OpenClaw شروع شد و اکنون **کل ناوگان ایجنت‌های شما** را در یک داشبورد اندازه‌گیری می‌کند و هر ران‌تایم را روی دستگاه شما به‌طور خودکار تشخیص می‌دهد: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw و NemoClaw در اپلیکیشن متن‌باز رایگان هستند؛ سایر ران‌تایم‌ها با ClawMetry Cloud یا لایسنس Pro خوداستقرار فعال می‌شوند. ران‌تایم‌ها را از هدر تغییر دهید و هر تب، هزینه، توکن‌ها، ابزارها، ترِیس‌ها، دوباره روی همان ران‌تایم متمرکز می‌شود. برای تقسیم دقیق رایگان/پولی، ماتریس سطوح، ساختار `/api/entitlement`، و رابط خط فرمان `clawmetry license`، به **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** مراجعه کنید. - -## چه چیزی به دست می‌آورید - -- **Flow** — نمودار متحرک زنده که نشان می‌دهد پیام‌ها چگونه از کانال‌ها، مغز (brain)، ابزارها و بازگشت عبور می‌کنند -- **Overview** — بررسی سلامت، نقشه حرارتی فعالیت، شمار نشست‌ها، اطلاعات مدل -- **Usage** — پیگیری توکن و هزینه با تفکیک روزانه/هفتگی/ماهانه -- **Sessions** — نشست‌های فعال ایجنت به همراه مدل، توکن‌ها، آخرین فعالیت -- **Crons** — کارهای زمان‌بندی‌شده به همراه وضعیت، اجرای بعدی، مدت زمان -- **Logs** — پخش زنده لاگ‌ها با رنگ‌بندی -- **Memory** — مرور SOUL.md، MEMORY.md، AGENTS.md، یادداشت‌های روزانه -- **Transcripts** — رابط کاربری حباب‌گفتگو برای خواندن تاریخچه نشست‌ها -- **Alerts** — سقف بودجه، محرک‌های نرخ خطا، تشخیص آفلاین‌بودن ایجنت؛ مسیریابی به Slack، Discord، PagerDuty، Telegram، Email -- **Approvals** — قرار دادن حذف‌های مخرب، force pushها، تغییرات پایگاه‌داده، sudo، نصب بسته‌ها، فراخوانی‌های شبکه پشت یک تأیید تک‌کلیکی - -## اسکرین‌شات‌ها - -### 🧠 Brain — جریان زنده رویدادهای ایجنت -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — خلاصه مصرف توکن و نشست‌ها -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — فید بلادرنگ فراخوانی ابزارها -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — تفکیک هزینه بر اساس مدل و نشست -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — مرورگر فایل‌های فضای کاری -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — وضعیت امنیتی و گزارش ممیزی -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — سقف بودجه، محرک‌های نرخ خطا، وب‌هوک‌ها به Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +## با ۲۳ محیط اجرای ایجنت کار می‌کند -### ✋ Approvals — قرار دادن فراخوانی‌های پرریسک ابزار پشت تأیید دستی؛ قوانین حفاظتی مبتنی بر خط‌مشی -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) +**رایگان در برنامه متن‌باز:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -**مسدودسازی پیش از اجرا برای Claude Code** — یک دستور، هوک PreToolUse را نصب می‌کند -که فراخوانی‌های ابزار منطبق را *پیش از* اجرا متوقف کرده و منتظر تصمیم شما می‌ماند -(با فعال‌بودن [اعلان‌های فشاری ابری](https://app.clawmetry.com/push)، فقط یک لمس از گوشی‌تان کافی است): +**در طرح پولی:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -```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 -را نادیده می‌گیرد (چون شما قبلاً پاسخ داده‌اید). ابزارهای نامنطبق حدود ۴۰ میلی‌ثانیه هزینه دارند -و به جریان مجوز عادی 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) +ایجنت خودتان را روی یک SDK ساخته‌اید؟ رهگیر (interceptor) فراخوانی‌های LLM آن را هم ردیابی می‌کند. به [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md) مراجعه کنید. -اپلیکیشن React نسخه ۲ در `frontend/` قرار دارد و وقتی سرور Flask با فعال‌بودن v2 -اجرا شود، در مسیر `/v2` سرو می‌شود. +## چه چیزی دریافت می‌کنید -هنگام توسعه از دو ترمینال استفاده کنید: +- **جلسات و رونوشت‌ها**: هر ایجنت چه کاری انجام داده، نوبت به نوبت، با قابلیت پخش مجدد +- **هزینه و توکن‌ها**: به تفکیک محیط اجرا، مدل، جلسه و روز، همراه با پرچم‌های ناهنجاری +- **Flow**: نمودار زنده جابه‌جایی پیام‌ها میان کانال‌ها، مدل‌ها و ابزارها +- **Brain**: جریان رویدادهای استدلال و فراخوانی ابزار، لحظه به لحظه +- **حافظه و مهارت‌ها**: فایل‌ها و مهارت‌هایی که هر محیط اجرا واقعاً بارگذاری کرده است +- **سلامت و لاگ‌ها**: دیسک، حافظه، نرخ خطا، محدودیت نرخ، جریان زنده لاگ +- **هشدارها**: سقف بودجه، جهش خطا، آفلاین شدن ایجنت، ارسال به Slack، Discord، PagerDuty، Telegram، ایمیل +- **تأییدیه‌ها (Approvals)**: توقف فراخوانی‌های ابزار پرریسک *پیش از* اجرا و تأیید از گوشی خود ([چگونه](docs/APPROVALS.md)) -```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 می‌تواند بدون تنظیمات -اضافی CORS با سرور محلی Flask ارتباط برقرار کند. - -برای ساخت باندلی که همراه بسته پایتون ارسال می‌شود: - -```bash -cd frontend -npm run build -``` - -باندل نهایی در مسیر `clawmetry/static/v2/dist/` نوشته می‌شود. - -## سازگاری ران‌تایم / ایجنت - -ClawMetry بسیاری از ران‌تایم‌های ایجنت هوش مصنوعی را رصد می‌کند، نه فقط OpenClaw. هر ران‌تایم غیر از OpenClaw یک آداپتور خواننده اختصاصی دارد که فرمت نشست بومی آن را به شکل‌های یکپارچه ClawMetry ترجمه می‌کند؛ دیمن (daemon) آن‌ها را با برچسب ران‌تایم به همان مخزن DuckDB و اسنپ‌شات ابری وارد می‌کند، و تب بازپخش نشست وقتی بیش از یک ران‌تایم حضور داشته باشد یک **سوئیچر ران‌تایم** نشان می‌دهد. برای ماتریس کامل + راهنمای افزودن ران‌تایم‌ها به [`docs/compatibility.md`](docs/compatibility.md) و برای مقدمه خانواده OpenClaw به [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) مراجعه کنید. - -آیا ابزار امنیت ایجنت [numbat از پرپلکسیتی](https://github.com/perplexityai/numbat) را اجرا می‌کنید؟ ClawMetry یافته‌ها و تصمیمات اجرایی آن را بدون نیاز به تنظیمات اضافی وارد می‌کند؛ به [`docs/NUMBAT.md`](docs/NUMBAT.md) مراجعه کنید. - -| ران‌تایم / ایجنت | وضعیت | یادداشت‌ها | +| طرح | شامل چه چیزی می‌شود | قیمت | |---|---|---| -| **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`. اجراهای گردش‌کار، اجرای نودها، پرامپت‌های AI Agent، مدل + توکن‌ها در جایی که n8n آن‌ها را ثبت می‌کند. | -| **Antigravity** | آداپتور بتا | Brain JSONL زیر `~/.gemini//brain/`. مکالمات، مراحل ابزار، تفکر، تفکیک توکن Gemini به‌ازای هر تولید + هزینه، مصرف تولید در پس‌زمینه. | -| **GitHub Copilot** | آداپتور بتا | Copilot CLI `events.jsonl` زیر `~/.copilot/session-state/` + دفتر مصرف به‌ازای هر فراخوانی `session-store.db`. مکالمات، فراخوانی ابزار، مسیریابی مدل، تفکیک توکن آگاه از کش، هزینه اعتبار هوش مصنوعی صورت‌حساب‌شده توسط فروشنده. | -| **Grok** | آداپتور بتا | xAI Grok Build CLI (باینری Rust زیر `~/.grok/bin/grok`): گزارش رویداد سراسری `~/.grok/logs/unified.jsonl` + `~/.grok/sessions///{events.jsonl,summary.json}` به‌ازای هر نشست. مکالمات، تفکیک توکن به‌ازای هر نوبت، مسیریابی مدل، و محموله خروجی مخزن CLI که در `~/.grok/upload_queue/` قرار می‌گیرد تا ببینید چه چیزی از دستگاه شما خارج شده است. | - -"آداپتور بتا" به این معناست که ClawMetry یک خواننده برای فرمت واقعی روی‌دیسک آن ران‌تایم ارائه می‌دهد که هر کدام روی یک نصب واقعی روی یک دستگاه واقعی ساخته و تأیید شده‌اند (به `tests/fixtures/runtimes//` مراجعه کنید). آداپتورها فقط‌خواندنی هستند؛ هرکدام درباره آنچه واقعاً ران‌تایمش ذخیره می‌کند صادق است (مثلاً PicoClaw/NanoClaw/Cursor هزینه توکن را روی دیسک نمی‌نویسند). وقتی چند ران‌تایم روی یک نود اجرا می‌شوند، سوئیچر ران‌تایم نمای نشست‌ها را برای بررسی دقیق به یکی محدود می‌کند. - -## پیگیری هر ایجنت SDK — انتساب هزینه خارج‌از‌حلقه - -همه ران‌تایم‌های بالا نشست‌ها را روی دیسک می‌نویسند. **ایجنت تولیدی** شما، همان که با OpenAI Agents SDK، LangChain، Vercel AI SDK، LlamaIndex، E2B، یا یک حلقه ساده `httpx` ساخته‌اید، این کار را نمی‌کند. رهگیر بدون‌پیکربندی ClawMetry همچنان با پچ‌زدن مانکی‌پچ `httpx`/`requests` فراخوانی‌های LLM آن (هزینه، توکن‌ها، تأخیر، خطاها) را ثبت می‌کند: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (یا متغیر محیطی `CLAWMETRY_SOURCE=support-agent`) هر فراخوانی را با یک **منبع نام‌گذاری‌شده** برچسب می‌زند، بنابراین هر محصولی که اجرا می‌کنید به‌عنوان یک خط درجه‌یک و قابل‌انتساب هزینه در کارت **🔌 منابع خارج‌از‌حلقه** داشبورد در تب Overview ظاهر می‌شود؛ فراخوانی‌ها، ارائه‌دهندگان، تأخیر، نرخ خطا به‌ازای هر ایجنت. منبعی تنظیم نشده؟ فراخوانی‌ها همچنان پیگیری می‌شوند؛ فقط کارت پنهان می‌ماند. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -این همان لایه داده‌ای است که آداپتورهای ران‌تایم آن را تغذیه می‌کنند (DuckDB ← اسنپ‌شات ابری)، بنابراین منابع خارج‌از‌حلقه هم مانند بقیه اطلاعات، رمزنگاری‌شده سرتاسر، به داشبورد ابری همگام می‌شوند. - -## OpenTelemetry — بدون وابستگی به فروشنده، ترِیس‌های خود را به هر جا بفرستید - -ClawMetry با استفاده از **قراردادهای معنایی GenAI**، در هر دو جهت با **OpenTelemetry** صحبت می‌کند، بنابراین ترِیس‌های ایجنت شما هرگز به یک ابزار قفل نمی‌شوند. - -**صادرات** هر نشست، فراخوانی‌های LLM، ابزارها، زیرایجنت‌ها، توکن‌ها، هزینه، به‌صورت اسپن‌های OTLP/HTTP GenAI به هر کالکتوری (Datadog، Grafana، Honeycomb، یا کالکتور OTel خودتان): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -هدرهای احراز هویت و بازه نظرسنجی، متغیرهای محیطی اختیاری هستند: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**دریافت** — گیرنده داخلی OTLP، ترِیس‌ها، لاگ‌ها و متریک‌ها را از هر منبع دیگری در `/v1/traces`، `/v1/logs`، و `/v1/metrics` می‌پذیرد. هر برنامه دارای ابزارگذاری OpenTelemetry را به آن اشاره دهید: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -ترِیس‌ها و لاگ‌های OTLP/JSON روی یک `pip install clawmetry` ساده کار می‌کنند، بدون افزونه. دریافت Protobuf (و متریک‌های OTLP/JSON) به `pip install clawmetry[otel]` نیاز دارد. برنامه‌ای که `service.name` خودش را تنظیم کند، به‌عنوان ایجنت مستقل خودش در سوئیچر ران‌تایم، همراه با هزینه و توکن‌های خود، ظاهر می‌شود. - -هم داشبورد بدون‌پیکربندی و محلی‌محور ClawMetry را دارید **و هم** داده‌های خود را در هر بک‌اندی که تیم شما از قبل اجرا می‌کند، بدون قفل‌شدن، بدون نیاز به نصب ایجنت دوم. - -## پیکربندی - -بیشتر افراد به هیچ پیکربندی نیاز ندارند. ClawMetry فضای کاری، لاگ‌ها، نشست‌ها و کرون‌های شما را به‌طور خودکار تشخیص می‌دهد. - -اگر نیاز به شخصی‌سازی دارید: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -همه گزینه‌ها: `clawmetry --help` - -## کانال‌های پشتیبانی‌شده - -ClawMetry فعالیت زنده هر کانال OpenClaw که پیکربندی کرده‌اید را نشان می‌دهد. فقط کانال‌هایی که واقعاً در `openclaw.json` شما تنظیم شده‌اند در نمودار Flow ظاهر می‌شوند؛ کانال‌های پیکربندی‌نشده به‌طور خودکار پنهان می‌شوند. - -روی هر گره کانال در Flow کلیک کنید تا نمای زنده حباب‌گفتگو همراه با شمار پیام‌های ورودی/خروجی را ببینید. - -| کانال | وضعیت | پاپ‌آپ زنده | یادداشت‌ها | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ کامل | ✅ | پیام‌ها، آمار، بازخوانی هر ۱۰ ثانیه | -| 💬 **iMessage** | ✅ کامل | ✅ | مستقیماً `~/Library/Messages/chat.db` را می‌خواند | -| 💚 **WhatsApp** | ✅ کامل | ✅ | از طریق WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ کامل | ✅ | از طریق signal-cli | -| 🟣 **Discord** | ✅ کامل | ✅ | تشخیص گیلد + کانال | -| 🟪 **Slack** | ✅ کامل | ✅ | تشخیص فضای کاری + کانال | -| 🌐 **Webchat** | ✅ کامل | ✅ | نشست‌های رابط کاربری وب داخلی | -| 📡 **IRC** | ✅ کامل | ✅ | رابط کاربری حباب به سبک ترمینال | -| 🍏 **BlueBubbles** | ✅ کامل | ✅ | iMessage از طریق BlueBubbles REST API | -| 🔵 **Google Chat** | ✅ کامل | ✅ | از طریق وب‌هوک‌های Chat API | -| 🟣 **MS Teams** | ✅ کامل | ✅ | از طریق افزونه بات Teams | -| 🔷 **Mattermost** | ✅ کامل | ✅ | چت تیمی خوداستقرار | -| 🟩 **Matrix** | ✅ کامل | ✅ | غیرمتمرکز، پشتیبانی E2EE | -| 🟢 **LINE** | ✅ کامل | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ کامل | ✅ | پیام مستقیم غیرمتمرکز NIP-04 | -| 🟣 **Twitch** | ✅ کامل | ✅ | چت از طریق اتصال IRC | -| 🔷 **Feishu/Lark** | ✅ کامل | ✅ | اشتراک رویداد WebSocket | -| 🔵 **Zalo** | ✅ کامل | ✅ | Zalo Bot API | - -> **تشخیص خودکار:** ClawMetry فایل `~/.openclaw/openclaw.json` شما را می‌خواند و فقط کانال‌هایی که واقعاً پیکربندی کرده‌اید را رندر می‌کند. نیازی به تنظیم دستی نیست. - -## استقرار با Docker - -می‌خواهید ClawMetry را در یک کانتینر اجرا کنید؟ مشکلی نیست! 🐳 - -**شروع سریع با Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**نمونه Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **نکته:** هنگام اجرا در Docker، دایرکتوری‌های داده + لاگ ایجنت خود (مثلاً `~/.openclaw`، `~/.claude`، `~/.codex`) را مانت کنید تا ClawMetry بتواند تنظیمات شما را به‌طور خودکار تشخیص دهد. - -## پیش‌نیازها - -- Python 3.8+ -- Flask (به‌طور خودکار از طریق pip نصب می‌شود) -- یک ران‌تایم ایجنت هوش مصنوعی روی همان دستگاه: OpenClaw، NVIDIA NemoClaw، Claude Code، Codex، Cursor، Goose، Hermes، opencode، Qwen Code، Aider، NanoClaw، PicoClaw، Pi، Deep Agents، n8n، Antigravity، GitHub Copilot، Grok، یا QM (یا حجم‌های مانت‌شده برای Docker) -- Linux یا macOS - -## پشتیبانی NemoClaw / OpenShell - -ClawMetry به‌طور خودکار [NemoClaw](https://github.com/NVIDIA/NemoClaw) را تشخیص می‌دهد؛ پوشش امنیتی سازمانی NVIDIA برای OpenClaw که ایجنت‌ها را درون کانتینرهای ایزوله‌شده OpenShell اجرا می‌کند. - -در بیشتر موارد نیازی به پیکربندی اضافی نیست. دیمن همگام‌سازی به‌طور خودکار فایل‌های نشست را کشف می‌کند، چه در `~/.openclaw/` روی میزبان باشند و چه درون یک کانتینر OpenShell. - -### چگونه کار می‌کند +| **رایگان** | OpenClaw + NVIDIA NemoClaw، داشبورد کامل، فقط محلی | ۰ دلار | +| **Starter** | تمام محیط‌های اجرای دیگر بالا، نمای ناوگان، همگام‌سازی ابری | ۹ دلار برای هر گره در ماه | +| **Pro** | Starter + حاکمیت: تأییدیه‌ها، سیاست‌های ریسک ابزار، ارزیابی‌ها، تشخیص ناهنجاری، بهینه‌ساز هزینه، خروجی OTel | ۱۹ دلار برای هر گره در ماه | -ClawMetry از دو راه NemoClaw را تشخیص می‌دهد: +طرح‌های سالانه، Enterprise و ارقام فعلی در +**[clawmetry.com/pricing](https://clawmetry.com/pricing)** موجود است. کلیدهای مجوز میزبانی‌شده روی سیستم شخصی +بدون نیاز به ابر کار می‌کنند (`clawmetry license`). تفکیک دقیق رایگان/پولی +در [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) آمده است. -1. **تشخیص باینری** — بررسی وجود CLI با نام `nemoclaw` و اجرای `nemoclaw status` برای دریافت اطلاعات سندباکس -2. **تشخیص کانتینر** — اسکن کانتینرهای در حال اجرای Docker برای یافتن تصاویر `openshell`، `nemoclaw`، یا `ghcr.io/nvidia/`، سپس خواندن نشست‌ها از طریق مانت حجم یا `docker cp` +## داده‌های شما روی دستگاه شما می‌ماند -فایل‌های نشست همگام‌شده از کانتینرهای NemoClaw با متادیتای `runtime=nemoclaw` و `container_id` در داشبورد ابری برچسب‌گذاری می‌شوند تا بتوانید آن‌ها را در نگاه اول از نشست‌های استاندارد OpenClaw تشخیص دهید. +ClawMetry فایل‌های جلسه و لاگ‌های محلی را می‌خواند. تا زمانی که +`clawmetry connect` را اجرا نکنید، چیزی از دستگاه شما خارج نمی‌شود. حتی در آن صورت هم، تصویر لحظه‌ای (snapshot) با رمزنگاری سرتاسر (end-to-end) +با کلیدی که هرگز از دستگاه شما خارج نمی‌شود رمزگذاری شده، و در مرورگر شما رمزگشایی می‌شود. -### تنظیمات پیشنهادی: دیمن همگام‌سازی روی HOST - -برای بهترین تجربه، دیمن همگام‌سازی ClawMetry را روی **دستگاه میزبان** (نه درون سندباکس) اجرا کنید. این کار محدودیت‌های خط‌مشی شبکه NemoClaw را دور می‌زند. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -دیمن همگام‌سازی به‌طور خودکار نشست‌ها را درون هر کانتینر OpenShell در حال اجرا پیدا می‌کند. - -### اختیاری: نام سندباکس صریح - -اگر تشخیص خودکار کار نکرد، ClawMetry را به سندباکس درست هدایت کنید: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### اجرا درون سندباکس (پیشرفته) - -اگر باید دیمن همگام‌سازی را **درون** سندباکس OpenShell اجرا کنید، این قانون خروج (egress) را به خط‌مشی شبکه NemoClaw خود اضافه کنید تا بتواند به API دریافت ClawMetry دسترسی پیدا کند: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -اعمال با: +## نصب ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # سپس: clawmetry ``` -### پورت‌ها و نقاط پایانی +یا دستور یک‌خطی: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -| نقطه پایانی | پورت | پروتکل | ضروری | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | بله (دیمن همگام‌سازی ← ابر) | -| `localhost:8900` | 8900 | HTTP | بله (رابط کاربری داشبورد محلی) | -| Docker socket (`/var/run/docker.sock`) | — | Unix socket | برای کشف نشست کانتینر | +به Python 3.8+ روی macOS، Linux یا Windows نیاز دارد، و حداقل یک محیط اجرای ایجنت روی +همان دستگاه. راهنمای Docker: [docs/DOCKER.md](docs/DOCKER.md). -دیمن همگام‌سازی فقط تماس‌های HTTPS خروجی به `ingest.clawmetry.com` برقرار می‌کند. هیچ پورت ورودی لازم نیست. +## مستندات ---- +| | | +|---|---| +| [سازگاری محیط‌های اجرا](docs/compatibility.md) | هر آداپتور چه چیزی می‌خواند، و چگونه یک محیط اجرا اضافه کنیم | +| [مجوزها (Entitlements)](docs/ENTITLEMENTS.md) | رایگان در برابر پولی، جدول سطوح، CLI مجوز | +| [تأییدیه‌ها و سیاست‌ها](docs/APPROVALS.md) | دروازه‌بانی پیش از اجرا، امتیازدهی ریسک، تأیید از گوشی | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | صادرات ردگیری‌ها (traces) به هر جا، دریافت OTLP از هر منبع | +| [ردگیری SDK](docs/SDK_TRACKING.md) | انتساب هزینه برای ایجنت‌هایی که خودتان ساخته‌اید | +| [کانال‌های چت](docs/CHANNELS.md) | آداپتورهای چتی که در Flow نمایش داده می‌شوند | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | راه‌اندازی‌های ایزوله‌شده NVIDIA NemoClaw | +| [Docker](docs/DOCKER.md) | ایمیج، compose، اتصال حجم‌ها | +| [معماری](ARCHITECTURE.md) · [توسعه](docs/DEVELOPMENT.md) | نحوه عملکرد داخلی؛ اجرا از سورس | +| [تله‌متری](docs/TELEMETRY.md) | پینگ‌های ناشناس نصب و باز شدن دسکتاپ، و نحوه خاموش کردن آن‌ها | -## استقرار ابری - -برای تونل‌های SSH، پروکسی معکوس، و Docker به **[راهنمای تست ابری](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** مراجعه کنید. - -## آزمایش - -این پروژه با BrowserStack آزمایش می‌شود. - -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) - -## تله‌متری - -ClawMetry پینگ‌های ناشناس چرخه‌عمر نصب را به -`https://app.clawmetry.com/api/install` ارسال می‌کند: یک پینگ `install` در اولین باری -که CLI با نام `clawmetry` را روی دستگاه جدید اجرا می‌کنید، یک پینگ `update` در اولین -اجرا پس از ارتقا به نسخه جدید، و یک پینگ `onboarded` هنگام تکمیل انتخاب راه‌اندازی اولیه -درون داشبورد. از این برای شمارش نصب‌های واقعی استفاده می‌کنیم (اعداد خام دانلود از PyPI -حدود ۹۸٪ مربوط به میرورها، CI، و دانلود مجدد به‌روزرسانی خودکار هستند) و برای یادگیری -اینکه کدام چارچوب‌ها و نسخه‌های ایجنت واقعاً در حال استفاده هستند. - -**حداکثر یک POST به‌ازای هر رویداد چرخه‌عمر به‌ازای هر نسخه**، شامل: - -| فیلد | نمونه | چرا | -|---|---|---| -| `install_id` | UUID تصادفی ذخیره‌شده در `~/.clawmetry/install_id` | جلوگیری از تکرار؛ ناشناس تا زمانی که صراحتاً همگام‌سازی Cloud را متصل کنید (سپس ضربان قلب دیمن احرازهویت‌شده آن را حمل می‌کند و این نصب را به حساب شما پیوند می‌دهد) | -| `event` | `install` / `update` / `onboarded` | نصب تازه در برابر ارتقای یک نصب موجود | -| `version` | `0.12.167` | اینکه چه نسخه‌هایی در حال استفاده هستند | -| `os` / `os_version` | `Darwin` / `25.3.0` | اولویت‌های پشتیبانی پلتفرم | -| `python` | `3.11.15` | ماتریس پشتیبانی نسخه پایتون | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | با کدام ایجنت‌ها بعداً باید یکپارچه شویم | -| `is_ci` / `ci_provider` | `true` / `github_actions` | جداسازی نصب‌های انسانی از نویز CI | +## اسکرین‌شات‌ها -**چیزی که ارسال نمی‌کنیم**: IP (سرور ابری کد کشور را سمت‌سرور از درخواست استخراج می‌کند -و سپس IP را دور می‌ریزد)، نام میزبان، نام کاربری، مسیر فضای کاری، محتوای فایل، کلید API شما، -ایمیل شما، هرگونه اطلاعات شخصی یا مختص فضای کاری. محموله سیم قابل ممیزی است در -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: توکن‌ها، جلسات، سلامت | **Brain**: جریان زنده رویدادهای ایجنت | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **هزینه**: به تفکیک مدل و جلسه | **تأییدیه‌ها**: دروازه‌بانی فراخوانی‌های ابزار پرریسک | -**انصراف** (هر یک از این موارد به‌طور دائمی آن را غیرفعال می‌کند): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -خرابی شبکه در اینجا هرگز اجرای `clawmetry` را مسدود نمی‌کند؛ پینگ روی یک ریسه دیمن -با مهلت ۳ ثانیه‌ای و به‌صورت شلیک‌و‌فراموش ارسال می‌شود. +بیشتر، به تفکیک محیط اجرا: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## تاریخچه ستاره‌ها @@ -432,11 +113,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## مجوز -MIT - ---- +MIT · ساخته شده توسط [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 تفکر ایجنت خود را ببینید
- ساخته‌شده توسط @vivekchand · clawmetry.com · بخشی از اکوسیستم OpenClaw -

+ diff --git a/docs/i18n/fil/README.md b/docs/i18n/fil/README.md index e96ebae72d..b77f259f4b 100644 --- a/docs/i18n/fil/README.md +++ b/docs/i18n/fil/README.md @@ -1,428 +1,105 @@ - + > Filipino translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Tignan mo ang iniisip ng iyong agent.** Real-time observability para sa **23 AI agent runtimes**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex at 16 pa. Isang dashboard para sa buong agent fleet mo. +**Tingnan kung paano nag-iisip ang iyong agent.** Real-time na observability para sa **23 AI agent runtimes**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex at 19 pa. Isang dashboard para sa buong agent fleet mo. -> 🌐 **Basahin ito sa:** [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) · [more →](docs/i18n/) +> 🌐 **Basahin ito sa:** [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) · [marami pa →](docs/i18n/) -Isang command lang. Zero config. Awtomatikong nade-detect ang lahat. +Isang command lang. Walang kailangang i-configure. Awtomatikong nade-detect ang lahat. ```bash pip install clawmetry && clawmetry ``` -Bubukas sa **http://localhost:8900** at tapos ka na. +Bubukas sa **http://localhost:8900**. Walang setup na kailangan: hahanapin nito ang mga agent runtime na mayroon ka na, babasahin ang mga ito nang read only, at walang babaguhin sa kung paano ang mga ito tumatakbo. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) ## Gumagana sa 23 agent runtimes -Nagsimula ang ClawMetry bilang observability para sa OpenClaw, at ngayon sinusukat nito ang **buong agent fleet mo** sa isang dashboard, na awtomatikong nade-detect ang bawat runtime sa makina mo: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -Libre ang OpenClaw at NemoClaw sa open-source app; ang ibang runtimes ay bubukas gamit ang ClawMetry Cloud o self-hosted na Pro license. Lumipat ng runtime mula sa header at ang bawat tab — cost, tokens, tools, traces — ay mare-re-scope sa runtime na iyon. Tingnan ang **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** para sa eksaktong free/paid split, tier matrix, `/api/entitlement` shape, at ang `clawmetry license` CLI. - -## Ano ang Makukuha Mo - -- **Flow** — Live na animated diagram na nagpapakita ng daloy ng mensahe sa channels, brain, tools, at pabalik -- **Overview** — Health checks, activity heatmap, bilang ng sessions, impormasyon ng model -- **Usage** — Pagsubaybay sa token at cost na may daily/weekly/monthly breakdown -- **Sessions** — Aktibong agent sessions kasama ang model, tokens, huling aktibidad -- **Crons** — Naka-iskedyul na jobs kasama ang status, next run, tagal -- **Logs** — Color-coded real-time log streaming -- **Memory** — I-browse ang SOUL.md, MEMORY.md, AGENTS.md, daily notes -- **Transcripts** — Chat-bubble UI para sa pagbasa ng kasaysayan ng sessions -- **Alerts** — Budget caps, error-rate triggers, agent-offline detection; nagru-route sa Slack, Discord, PagerDuty, Telegram, Email -- **Approvals** — Harangan ang mga destructive delete, force push, DB mutation, sudo, package install, network call sa likod ng one-click na sign-off - -## Mga Screenshot - -### 🧠 Brain — Live na agent event stream -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Token usage at buod ng session -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Real-time na tool call feed -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Cost breakdown ayon sa model at session -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) +**Libre sa open source app:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### 🧬 Memory — Workspace file browser -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) +**Sa bayad na plano:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -### 🔐 Security — Postura at audit log -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) +Bawat runtime ay may parehong dashboard. Magpatakbo ng ilan nang sabay at ang switcher sa header ay muling itatakda ang saklaw ng bawat tab sa isa sa mga ito. -### 🚨 Alerts — Budget caps, error-rate triggers, webhooks papunta sa Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +Gumawa ka ba ng sarili mong agent gamit ang isang SDK sa halip? Sinusubaybayan din ng interceptor ang mga LLM call nito. Tingnan ang [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -### ✋ Approvals — Harangan ang mapanganib na tool calls sa likod ng manual sign-off; policy-backed na mga protection rule -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Pre-execution blocking para sa Claude Code** — isang command lang ang mag-i-install ng -PreToolUse hook na nagpapa-pause sa mga tumutugmang tool call *bago* ito tumakbo at naghihintay -sa desisyon mo (isang tap lang mula sa telepono mo kung naka-enable ang -[cloud push notifications](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 -``` +## Ano ang makukuha mo -Ang deny ay hinaharangan lang ang isang tool call na iyon — mananatili ang session ng agent at -maaari itong sumubok ng ibang paraan. Ang pag-apruba sa telepono mo ay nilalaktawan ang sariling -permission prompt ng Claude Code (sinagot mo na ito). Ang mga hindi tumutugmang tool ay -nagkakahalaga lamang ng ~40ms at bumabalik sa normal na permission flow ng Claude Code. Makakatanggap -ka rin ng push sa telepono kapag hinihintay ka mismo ng Claude Code (`permission_prompt` / -`idle_prompt` na mga notification). +- **Mga session at transcript**: kung ano ang ginawa ng bawat agent, turn by turn, na may replay +- **Gastos at token**: kada runtime, model, session, at araw, may mga anomaly flag +- **Flow**: live na diagram ng mga mensaheng dumadaan sa mga channel, model, at tool +- **Brain**: ang reasoning at tool-call event stream habang nangyayari ito +- **Memory at skills**: ang mga file at skill na talagang na-load ng bawat runtime +- **Health at logs**: disk, memory, error rate, rate limit, live log stream +- **Alerts**: budget caps, error spikes, agent-offline, iruruta sa Slack, Discord, PagerDuty, Telegram, Email +- **Approvals**: i-pause ang mapanganib na tool call *bago* ito tumakbo at i-approve mula sa iyong telepono ([paano](docs/APPROVALS.md)) -## I-install - -**One-liner (inirerekomenda):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**Mula sa source:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` - -## v2 Frontend Development - -Ang v2 React app ay nasa `frontend/` at nagsi-serve sa `/v2` kapag inilunsad ang Flask -server nang naka-enable ang v2. - -Gumamit ng dalawang terminal habang nagde-develop: - -```bash -# Terminal 1: Flask API/server on :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## Presyo -```bash -# Terminal 2: Vite dev server on :5173 -cd frontend -nvm use -npm ci -npm run dev -``` - -Buksan ang `http://localhost:5173/v2/`. Ipinapasa ng Vite ang mga `/api` request papunta sa -`http://localhost:8900`, kaya makakausap ng React app ang lokal na Flask server nang -walang karagdagang CORS setup. - -Para buuin ang bundle na sinasama sa Python package: - -```bash -cd frontend -npm run build -``` - -Isinusulat ang production bundle sa `clawmetry/static/v2/dist/`. - -## Runtime / Agent Compatibility - -Nagmamasid ang ClawMetry sa maraming AI-agent runtime, hindi lang OpenClaw. Bawat non-OpenClaw runtime ay may dedikadong reader adapter na nagsasalin ng native session format nito papunta sa unified shapes ng ClawMetry; ini-ingest ito ng daemon sa parehong DuckDB store + cloud snapshot, na naka-tag ng runtime, at ipinapakita ng Session replay tab ang **runtime switcher** kapag may higit sa isang naroroon. Tingnan ang [`docs/compatibility.md`](docs/compatibility.md) para sa buong matrix + gabay sa pagdagdag ng runtimes, at ang [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) para sa OpenClaw-family primer. - -Pinapatakbo ang [Perplexity's numbat](https://github.com/perplexityai/numbat) agent-security tool? Ini-ingest ng ClawMetry ang mga natuklasan at desisyon sa pagpapatupad nito nang out-of-the-box — tingnan ang [`docs/NUMBAT.md`](docs/NUMBAT.md). - -| Runtime / Agent | Status | Mga Tala | +| Plano | Ano ang saklaw nito | Presyo | |---|---|---| -| **OpenClaw** | Native | Reference runtime, awtomatikong nade-detect | -| **PicoClaw** | Beta adapter | Flat `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`). Transcripts, model, tool calls. | -| **NanoClaw** | Beta adapter | Per-session SQLite (`data/v2-sessions`). Transcripts + bilang ng mensahe. | -| **Hermes** | Beta adapter | SQLite `~/.hermes/state.db`. Transcripts, model, tokens/cost. | -| **Claude Code** | Beta adapter | JSONL `~/.claude/projects/.../.jsonl`. Transcripts, model, tool calls + thinking, token usage. | -| **Codex** | Beta adapter | Rollout JSONL `~/.codex/sessions/...`. Transcripts, model, tool calls, token usage. | -| **Cursor** | Beta adapter | SQLite `state.vscdb`. Chat/composer transcripts, model. | -| **Aider** | Beta adapter | `.aider.chat.history.md` bawat project. Transcripts, model, token counts. | -| **Goose** | Beta adapter | SQLite `~/.local/share/goose`. Transcripts, model, tool calls, token totals. | -| **opencode** | Beta adapter | SQLite `~/.local/share/opencode`. Transcripts, model, tool calls, tokens + cost. | -| **Qwen Code** | Beta adapter | JSONL `~/.qwen/projects/.../chats`. Transcripts, model, tool calls, token usage. | -| **Pi** | Beta adapter | JSONL `~/.pi/agent/sessions`. Transcripts, model, tool calls, tokens + cost. | -| **Deep Agents** | Beta adapter | SQLite `~/.deepagents/.state/sessions.db`. Transcripts, model, tool calls, tokens + cost. | -| **n8n** | Beta adapter | SQLite `~/.n8n/database.sqlite`. Mga workflow execution, node run, AI Agent prompts, model + tokens kung saan ito naitala ng n8n. | -| **Antigravity** | Beta adapter | Brain JSONL sa ilalim ng `~/.gemini//brain/`. Mga usapan, tool steps, thinking, per-generation na Gemini token split + cost, background-generation burn. | -| **GitHub Copilot** | Beta adapter | Copilot CLI `events.jsonl` sa ilalim ng `~/.copilot/session-state/` + ang `session-store.db` per-call usage ledger. Mga usapan, tool calls, model routing, cache-aware token split, vendor-billed AI-credit cost. | -| **Grok** | Beta adapter | xAI Grok Build CLI (Rust binary sa `~/.grok/bin/grok`): global event log `~/.grok/logs/unified.jsonl` + per-session `~/.grok/sessions///{events.jsonl,summary.json}`. Mga usapan, per-turn token split, model routing, at ang outbound repo payload ng CLI na naka-stage sa `~/.grok/upload_queue/` para makita mo kung ano ang lumabas sa makina mo. | - -Ang ibig sabihin ng "Beta adapter" ay may reader ang ClawMetry para sa aktwal na on-disk na format ng runtime na iyon, na bawat isa ay binuo + na-verify laban sa totoong install sa totoong makina (tingnan ang `tests/fixtures/runtimes//`). Ang mga adapter ay read-only; tapat ang bawat isa tungkol sa aktwal na iniimbak ng runtime nito (hal. hindi isinusulat ng PicoClaw/NanoClaw/Cursor ang token cost sa disk). Kapag maraming runtime ang tumatakbo sa isang node, ang runtime switcher ay nagsi-scope sa sessions view papunta sa isa para sa malinis na deep-dive. - -## Subaybayan ang anumang SDK agent — out-loop cost attribution - -Ang mga runtime sa itaas ay lahat nagsusulat ng sessions sa disk. Ang sarili mong **production agent** — yung binuo mo sa OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, o simpleng `httpx` loop — ay hindi. Nakukuha pa rin ng zero-config interceptor ng ClawMetry ang mga LLM call nito (cost, tokens, latency, errors) sa pamamagitan ng monkey-patching sa `httpx`/`requests`: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -Ang `set_source()` (o ang `CLAWMETRY_SOURCE=support-agent` env var) ay nagta-tag sa bawat call ng **pinangalanang source**, kaya bawat produktong pinapatakbo mo ay lalabas bilang sarili nitong first-class, cost-attributable na linya sa **🔌 Out-loop sources** card ng dashboard sa Overview — calls, providers, latency, error rate bawat agent. Walang naka-set na source? Nasusubaybayan pa rin ang mga call; nananatili lang tagong nakatago ang card. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Ito ang parehong data layer na pinapakain ng runtime adapters (DuckDB → cloud snapshot), kaya nagsi-sync sa cloud dashboard ang out-loop sources tulad ng lahat ng iba pa, E2E-encrypted. - -## OpenTelemetry — vendor-neutral, ipadala ang traces mo kahit saan - -Nagsasalita ang ClawMetry ng **OpenTelemetry** sa parehong direksyon, gamit ang **GenAI semantic conventions**, kaya hindi kailanman naka-lock ang agent traces mo sa isang tool lang. - -**I-export** ang bawat session — LLM calls, tools, sub-agents, tokens, cost — bilang OTLP/HTTP GenAI spans papunta sa anumang collector (Datadog, Grafana, Honeycomb, o sarili mong OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Opsyonal na env vars ang auth headers at poll interval: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**I-ingest** — tinatanggap ng built-in na OTLP receiver ang traces, logs, at metrics mula sa kahit ano pa sa `/v1/traces`, `/v1/logs`, at `/v1/metrics`. Itutok ang anumang OpenTelemetry-instrumented na app dito: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` +| **Libre** | OpenClaw + NVIDIA NemoClaw, buong dashboard, local lang | $0 | +| **Starter** | Lahat ng ibang runtime sa itaas, fleet view, cloud sync | $9 kada node / buwan | +| **Pro** | Starter + governance: approvals, tool-risk policies, evals, anomaly detection, cost optimizer, OTel export | $19 kada node / buwan | -Gumagana ang OTLP/JSON traces at logs sa plain `pip install clawmetry`, walang extras. Kailangan ng Protobuf ingest (at OTLP/JSON metrics) ng `pip install clawmetry[otel]`. Ang app na nagtatakda ng sarili nitong `service.name` ay lalabas bilang sarili nitong agent sa runtime switcher, kasama ang cost at tokens nito. +Ang mga taunang plano, Enterprise, at ang kasalukuyang mga numero ay nasa +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Gumagana ang self-hosted license +keys kahit walang cloud (`clawmetry license`). Ang eksaktong hating libre/bayad ay nasa +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -Makukuha mo ang zero-config, local-first na ClawMetry dashboard **at** ang data mo sa kahit anong backend na ginagamit na ng team mo — walang lock-in, walang pangalawang agent na iinstallin. +## Nananatili sa iyong makina ang iyong data -## Configuration +Binabasa ng ClawMetry ang mga lokal na session file at log. Walang lalabas sa iyong makina maliban kung +patatakbuhin mo ang `clawmetry connect`. Kahit noon, ang snapshot ay end-to-end encrypted +gamit ang isang key na hindi kailanman aalis sa iyong makina, at de-decrypt sa iyong browser. -Karamihan sa mga tao ay hindi nangangailangan ng anumang config. Awtomatikong nade-detect ng ClawMetry ang workspace, logs, sessions, at crons mo. - -Kung kailangan mo talagang i-customize: +## Pag-install ```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization +pip install clawmetry # tapos: clawmetry ``` -Lahat ng opsyon: `clawmetry --help` - -## Mga Suportadong Channel - -Ipinapakita ng ClawMetry ang live na aktibidad para sa bawat OpenClaw channel na na-configure mo. Ang mga channel lang na aktwal na naka-set up sa `openclaw.json` mo ang lalabas sa Flow diagram — ang mga hindi na-configure ay awtomatikong nakatago. - -I-click ang anumang channel node sa Flow para makita ang live na chat bubble view kasama ang bilang ng papasok/palabas na mensahe. - -| Channel | Status | Live Popup | Mga Tala | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Full | ✅ | Mensahe, stats, 10s refresh | -| 💬 **iMessage** | ✅ Full | ✅ | Direktang binabasa ang `~/Library/Messages/chat.db` | -| 💚 **WhatsApp** | ✅ Full | ✅ | Sa pamamagitan ng WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Full | ✅ | Sa pamamagitan ng signal-cli | -| 🟣 **Discord** | ✅ Full | ✅ | Guild + channel detection | -| 🟪 **Slack** | ✅ Full | ✅ | Workspace + channel detection | -| 🌐 **Webchat** | ✅ Full | ✅ | Built-in na web UI sessions | -| 📡 **IRC** | ✅ Full | ✅ | Terminal-style na bubble UI | -| 🍏 **BlueBubbles** | ✅ Full | ✅ | iMessage sa pamamagitan ng BlueBubbles REST API | -| 🔵 **Google Chat** | ✅ Full | ✅ | Sa pamamagitan ng Chat API webhooks | -| 🟣 **MS Teams** | ✅ Full | ✅ | Sa pamamagitan ng Teams bot plugin | -| 🔷 **Mattermost** | ✅ Full | ✅ | Self-hosted na team chat | -| 🟩 **Matrix** | ✅ Full | ✅ | Decentralized, may suportang E2EE | -| 🟢 **LINE** | ✅ Full | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Full | ✅ | Decentralized NIP-04 DMs | -| 🟣 **Twitch** | ✅ Full | ✅ | Chat sa pamamagitan ng IRC connection | -| 🔷 **Feishu/Lark** | ✅ Full | ✅ | WebSocket event subscription | -| 🔵 **Zalo** | ✅ Full | ✅ | Zalo Bot API | - -> **Auto-detection:** Binabasa ng ClawMetry ang `~/.openclaw/openclaw.json` mo at ini-render lang ang mga channel na aktwal mong na-configure. Walang kinakailangang manual setup. +O ang one-liner: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -## Docker Deployment +Kailangan ng Python 3.8+ sa macOS, Linux, o Windows, at kahit isang agent runtime sa +parehong makina. Mga tagubilin para sa Docker: [docs/DOCKER.md](docs/DOCKER.md). -Gusto mong patakbuhin ang ClawMetry sa isang container? Walang problema! 🐳 - -**Quick start gamit ang Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose na halimbawa:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Tala:** Kapag pinapatakbo sa Docker, i-mount ang data + log directories ng agent mo (hal. `~/.openclaw`, `~/.claude`, `~/.codex`) para ma-auto-detect ng ClawMetry ang setup mo. - -## Mga Kinakailangan - -- Python 3.8+ -- Flask (awtomatikong naiinstall via pip) -- AI agent runtime sa parehong makina: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, o QM (o naka-mount na volumes para sa Docker) -- Linux o macOS - -## Suporta para sa NemoClaw / OpenShell - -Awtomatikong dine-detect ng ClawMetry ang [NemoClaw](https://github.com/NVIDIA/NemoClaw) — ang enterprise security wrapper ng NVIDIA para sa OpenClaw na nagpapatakbo ng mga agent sa loob ng sandboxed na OpenShell containers. - -Walang karagdagang configuration na kinakailangan sa karamihan ng kaso. Awtomatikong tinutuklas ng sync daemon ang session files, nasa `~/.openclaw/` man ito sa host o sa loob ng OpenShell container. - -### Paano ito gumagana - -Dine-detect ng ClawMetry ang NemoClaw sa dalawang paraan: - -1. **Binary detection** — sinusuri ang `nemoclaw` CLI at pinapatakbo ang `nemoclaw status` para makuha ang impormasyon ng sandbox -2. **Container detection** — sinusuri ang mga tumatakbong Docker container para sa `openshell`, `nemoclaw`, o `ghcr.io/nvidia/` na mga image, pagkatapos ay binabasa ang sessions sa pamamagitan ng volume mounts o `docker cp` - -Ang mga session file na naka-sync mula sa NemoClaw containers ay naka-tag ng `runtime=nemoclaw` at `container_id` na metadata sa cloud dashboard, kaya madali mong makikilala ang mga ito bukod sa standard na OpenClaw sessions. - -### Inirerekomendang setup: sync daemon sa HOST - -Para sa pinakamagandang karanasan, patakbuhin ang sync daemon ng ClawMetry sa **host machine** (hindi sa loob ng sandbox). Naiiwasan nito ang mga paghihigpit sa network policy ng NemoClaw. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` +## Dokumentasyon -Awtomatikong hahanapin ng sync daemon ang mga session sa loob ng anumang tumatakbong OpenShell containers. +| | | +|---|---| +| [Runtime compatibility](docs/compatibility.md) | Ano ang binabasa ng bawat adapter, at paano magdagdag ng runtime | +| [Entitlements](docs/ENTITLEMENTS.md) | Libre kumpara sa bayad, tier matrix, license CLI | +| [Approvals at policies](docs/APPROVALS.md) | Pre-execution gating, risk scoring, phone approvals | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | I-export ang mga trace kahit saan, mag-ingest ng OTLP mula sa kahit ano | +| [SDK tracking](docs/SDK_TRACKING.md) | Cost attribution para sa mga agent na ginawa mo mismo | +| [Chat channels](docs/CHANNELS.md) | Ang mga chat adapter na ipinapakita sa Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Sandboxed na setup ng NVIDIA NemoClaw | +| [Docker](docs/DOCKER.md) | Image, compose, volume mounts | +| [Architecture](ARCHITECTURE.md) · [Development](docs/DEVELOPMENT.md) | Kung paano ito gumagana sa loob; pagpapatakbo mula sa source | +| [Telemetry](docs/TELEMETRY.md) | Ang anonymous install at desktop-open pings, at kung paano i-off ang mga ito | -### Opsyonal: explicit na pangalan ng sandbox - -Kung hindi gumana ang auto-detection, ituro ang ClawMetry sa tamang sandbox: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Pagpapatakbo sa loob ng sandbox (advanced) - -Kung kailangan mong patakbuhin ang sync daemon sa **loob** ng OpenShell sandbox, idagdag ang egress rule na ito sa network policy ng NemoClaw mo para maabot nito ang ingest API ng ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -I-apply gamit ang: - -```bash -nemoclaw policy apply --file nemoclaw-policy.yaml -``` - -### Mga Port at endpoint - -| Endpoint | Port | Protocol | Kinakailangan | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Oo (sync daemon → cloud) | -| `localhost:8900` | 8900 | HTTP | Oo (local dashboard UI) | -| Docker socket (`/var/run/docker.sock`) | — | Unix socket | Para sa container session discovery | - -Ang sync daemon lang ay gumagawa ng outbound HTTPS calls papunta sa `ingest.clawmetry.com`. Walang kinakailangang inbound ports. - ---- - -## Cloud Deployment - -Tingnan ang **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** para sa SSH tunnels, reverse proxy, at Docker. - -## Testing - -Ang project na ito ay sinusubok gamit ang BrowserStack. - -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) - -## Telemetry - -Nagpapadala ang ClawMetry ng anonymous na install-lifecycle pings sa -`https://app.clawmetry.com/api/install`: isang `install` ping sa unang -pagkakataong patakbuhin mo ang `clawmetry` CLI sa bagong makina, isang `update` ping -sa unang run pagkatapos mag-upgrade sa bagong version, at isang `onboarded` -ping kapag natapos mo ang in-dashboard onboarding choice. Ginagamit namin ito -para bilangin ang totoong installs (ang raw na PyPI download numbers ay ~98% mirrors, CI, -at auto-update re-downloads) at para malaman kung aling mga agent framework at -versions ang aktwal na ginagamit. +## Mga Screenshot -**Pinakamarami isang POST bawat lifecycle event bawat version**, na naglalaman ng: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: mga token, session, health | **Brain**: live na event stream ng agent | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: ayon sa model at session | **Approvals**: i-gate ang mapanganib na tool call | -| Field | Halimbawa | Bakit | -|---|---|---| -| `install_id` | random UUID na naka-imbak sa `~/.clawmetry/install_id` | dedup; anonymous hanggang direkta mong ikonekta ang Cloud sync (ang authenticated daemon heartbeat na sana ang magdadala nito, na nag-uugnay ng install na ito sa account mo) | -| `event` | `install` / `update` / `onboarded` | bagong install kumpara sa upgrade ng umiiral na | -| `version` | `0.12.167` | kung anong mga version ang ginagamit | -| `os` / `os_version` | `Darwin` / `25.3.0` | mga prayoridad sa suporta ng platform | -| `python` | `3.11.15` | Python version support matrix | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | aling mga agent ang dapat naming i-integrate susunod | -| `is_ci` / `ci_provider` | `true` / `github_actions` | paghihiwalayin ang human installs sa CI noise | - -**Ano ang HINDI namin ipinapadala**: IP (kinukuha ng cloud ang country code -server-side mula sa request, pagkatapos ay itinatapon ang IP), hostname, username, workspace -path, file contents, ang api_key mo, ang email mo, anumang PII o -workspace-specific na impormasyon. Ang wire payload ay auditable sa -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Mag-opt out** (alinman sa mga ito ay permanenteng nag-disable nito): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -Hindi kailanman hinaharangan ng pagkabigo ng network dito ang pagpapatakbo ng -`clawmetry` — ang ping ay fire-and-forget sa isang daemon thread na may 3 s timeout. +Marami pa, kada runtime: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Star History @@ -436,11 +113,6 @@ Hindi kailanman hinaharangan ng pagkabigo ng network dito ang pagpapatakbo ng ## Lisensya -MIT - ---- +MIT · Ginawa ni [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Tignan mo ang iniisip ng iyong agent
- Ginawa ni @vivekchand · clawmetry.com · Bahagi ng OpenClaw ecosystem -

+ diff --git a/docs/i18n/fr/README.md b/docs/i18n/fr/README.md index 9fbe7c48eb..409c2c2fb4 100644 --- a/docs/i18n/fr/README.md +++ b/docs/i18n/fr/README.md @@ -1,11 +1,10 @@ - + > Français translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) @@ -13,416 +12,97 @@ **Voyez votre agent réfléchir.** Observabilité en temps réel pour **23 runtimes d'agents IA** : [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex et 19 autres. Un seul tableau de bord pour toute votre flotte d'agents. -> 🌐 **Lisez ceci en :** [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) · [plus →](docs/i18n/) +> 🌐 **Lire ceci en :** [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) · [plus →](docs/i18n/) -Une commande. Aucune configuration. Tout est détecté automatiquement. +Une seule commande. Zéro configuration. Détection automatique de tout. ```bash pip install clawmetry && clawmetry ``` -S'ouvre sur **http://localhost:8900** et c'est terminé. +S'ouvre sur **http://localhost:8900**. Zéro configuration : il trouve les runtimes d'agents +que vous avez déjà, les lit en lecture seule, et ne change rien à leur fonctionnement. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) ## Compatible avec 23 runtimes d'agents -ClawMetry a démarré comme un outil d'observabilité pour OpenClaw, et mesure désormais **toute votre flotte d'agents** dans un seul tableau de bord, en détectant automatiquement chaque runtime présent sur votre machine : - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw et NemoClaw sont gratuits dans l'application open-source ; les autres runtimes s'activent avec ClawMetry Cloud ou une licence Pro auto-hébergée. Changez de runtime depuis l'en-tête et chaque onglet, coût, tokens, outils, traces, se recalibre sur ce runtime. Consultez **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** pour la répartition exacte gratuit/payant, la matrice des niveaux, la forme de `/api/entitlement`, et la CLI `clawmetry license`. - -## Ce que vous obtenez - -- **Flow** — Diagramme animé en direct montrant les messages circuler à travers les canaux, le cerveau, les outils, et retour -- **Overview** — Contrôles de santé, carte de chaleur d'activité, nombre de sessions, informations sur le modèle -- **Usage** — Suivi des tokens et des coûts avec répartitions quotidiennes/hebdomadaires/mensuelles -- **Sessions** — Sessions d'agent actives avec modèle, tokens, dernière activité -- **Crons** — Tâches planifiées avec statut, prochaine exécution, durée -- **Logs** — Diffusion de journaux en temps réel avec code couleur -- **Memory** — Parcourir SOUL.md, MEMORY.md, AGENTS.md, notes quotidiennes -- **Transcripts** — Interface en bulles de discussion pour lire l'historique des sessions -- **Alerts** — Plafonds budgétaires, déclencheurs de taux d'erreur, détection d'agent hors ligne ; routage vers Slack, Discord, PagerDuty, Telegram, Email -- **Approvals** — Bloquer les suppressions destructrices, les force push, les mutations de base de données, sudo, les installations de paquets, les appels réseau derrière une validation en un clic - -## Captures d'écran - -### 🧠 Brain — Flux d'événements de l'agent en direct -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Usage des tokens et résumé de session -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Flux en temps réel des appels d'outils -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Répartition des coûts par modèle et session -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Navigateur de fichiers de l'espace de travail -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Posture et journal d'audit -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — Plafonds budgétaires, déclencheurs de taux d'erreur, webhooks vers Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +**Gratuit dans l'application open source :** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### ✋ Approvals — Bloquer les appels d'outils risqués derrière une validation manuelle ; règles de protection basées sur des politiques -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Blocage avant exécution pour Claude Code** — une commande installe un -hook PreToolUse qui met en pause les appels d'outils correspondants *avant* qu'ils ne s'exécutent et attend -votre décision (un tap depuis votre téléphone avec les -[notifications push cloud](https://app.clawmetry.com/push) activées) : - -```bash -clawmetry hooks install # écrit ~/.claude/settings.json (idempotent) -clawmetry hooks status # ce qui est câblé + combien de politiques sont actives -clawmetry hooks uninstall # supprime uniquement les entrées de ClawMetry -``` - -Un refus bloque uniquement cet appel d'outil précis, l'agent conserve sa session et peut -essayer une autre approche. Approuver depuis votre téléphone saute l'invite de -permission propre à Claude Code (vous avez déjà répondu). Les outils non correspondants coûtent environ 40 ms et -retombent dans le flux de permission normal de Claude Code. Vous recevez aussi une notification push sur votre téléphone quand Claude Code lui-même -attend une réponse de votre part (notifications `permission_prompt` / -`idle_prompt`). - -## Installation - -**En une ligne (recommandé) :** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip :** -```bash -pip install clawmetry -clawmetry -``` - -**Depuis les sources :** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` +**Sur un plan payant :** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -## Développement du frontend v2 +Chaque runtime obtient le même tableau de bord. Exécutez-en plusieurs en même temps et le +sélecteur dans l'en-tête recentre chaque onglet sur l'un d'eux. -L'application React v2 se trouve dans `frontend/` et est servie sur `/v2` lorsque le -serveur Flask est démarré avec v2 activé. +Vous avez créé votre propre agent avec un SDK au lieu d'utiliser un runtime existant ? L'intercepteur suit aussi +ses appels LLM. Voir [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -Utilisez deux terminaux pendant le développement : - -```bash -# Terminal 1 : API/serveur Flask sur :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` - -```bash -# Terminal 2 : serveur de développement Vite sur :5173 -cd frontend -nvm use -npm ci -npm run dev -``` - -Ouvrez `http://localhost:5173/v2/`. Vite fait suivre les requêtes `/api` vers -`http://localhost:8900`, de sorte que l'application React puisse communiquer avec le serveur Flask local -sans configuration CORS supplémentaire. - -Pour construire le bundle livré avec le paquet Python : - -```bash -cd frontend -npm run build -``` - -Le bundle de production est écrit dans `clawmetry/static/v2/dist/`. - -## Compatibilité runtime / agent +## Ce que vous obtenez -ClawMetry observe de nombreux runtimes d'agents IA, pas seulement OpenClaw. Chaque runtime autre qu'OpenClaw dispose d'un adaptateur de lecture dédié qui traduit son format de session natif dans les formes unifiées de ClawMetry ; le démon les ingère dans le même magasin DuckDB + snapshot cloud, étiquetés avec le runtime, et l'onglet de relecture de session affiche un **sélecteur de runtime** lorsque plusieurs sont présents. Voir [`docs/compatibility.md`](docs/compatibility.md) pour la matrice complète + un guide d'ajout de runtimes, et [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) pour l'introduction à la famille OpenClaw. +- **Sessions et transcriptions** : ce que chaque agent a fait, tour par tour, avec relecture +- **Coûts et tokens** : par runtime, modèle, session et jour, avec signalement des anomalies +- **Flow** : diagramme en direct des messages circulant à travers les canaux, les modèles et les outils +- **Brain** : le flux d'événements de raisonnement et d'appels d'outils en temps réel +- **Mémoire et compétences** : les fichiers et compétences réellement chargés par chaque runtime +- **Santé et logs** : disque, mémoire, taux d'erreur, limites de débit, flux de logs en direct +- **Alertes** : plafonds budgétaires, pics d'erreurs, agent hors ligne, routées vers Slack, Discord, PagerDuty, Telegram, Email +- **Approbations** : mettez en pause les appels d'outils risqués *avant* leur exécution et approuvez depuis votre téléphone ([comment](docs/APPROVALS.md)) -Vous utilisez [numbat de Perplexity](https://github.com/perplexityai/numbat), l'outil de sécurité pour agents ? ClawMetry ingère ses résultats et décisions d'application dès la sortie de la boîte, voir [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Tarification -| Runtime / Agent | Statut | Notes | +| Plan | Ce qui est couvert | Prix | |---|---|---| -| **OpenClaw** | Natif | Runtime de référence, détecté automatiquement | -| **PicoClaw** | Adaptateur bêta | JSONL plat `providers.Message` (`~/.picoclaw/workspace/sessions`). Transcriptions, modèle, appels d'outils. | -| **NanoClaw** | Adaptateur bêta | SQLite par session (`data/v2-sessions`). Transcriptions + nombre de messages. | -| **Hermes** | Adaptateur bêta | SQLite `~/.hermes/state.db`. Transcriptions, modèle, tokens/coût. | -| **Claude Code** | Adaptateur bêta | JSONL `~/.claude/projects/.../.jsonl`. Transcriptions, modèle, appels d'outils + réflexion, usage de tokens. | -| **Codex** | Adaptateur bêta | Rollout JSONL `~/.codex/sessions/...`. Transcriptions, modèle, appels d'outils, usage de tokens. | -| **Cursor** | Adaptateur bêta | SQLite `state.vscdb`. Transcriptions chat/composer, modèle. | -| **Aider** | Adaptateur bêta | `.aider.chat.history.md` par projet. Transcriptions, modèle, comptage de tokens. | -| **Goose** | Adaptateur bêta | SQLite `~/.local/share/goose`. Transcriptions, modèle, appels d'outils, totaux de tokens. | -| **opencode** | Adaptateur bêta | SQLite `~/.local/share/opencode`. Transcriptions, modèle, appels d'outils, tokens + coût. | -| **Qwen Code** | Adaptateur bêta | JSONL `~/.qwen/projects/.../chats`. Transcriptions, modèle, appels d'outils, usage de tokens. | -| **Pi** | Adaptateur bêta | JSONL `~/.pi/agent/sessions`. Transcriptions, modèle, appels d'outils, tokens + coût. | -| **Deep Agents** | Adaptateur bêta | SQLite `~/.deepagents/.state/sessions.db`. Transcriptions, modèle, appels d'outils, tokens + coût. | -| **n8n** | Adaptateur bêta | SQLite `~/.n8n/database.sqlite`. Exécutions de workflow, exécutions de nœuds, prompts AI Agent, modèle + tokens lorsque n8n les enregistre. | -| **Antigravity** | Adaptateur bêta | Brain JSONL sous `~/.gemini//brain/`. Conversations, étapes d'outils, réflexion, répartition des tokens Gemini par génération + coût, consommation de génération en arrière-plan. | -| **GitHub Copilot** | Adaptateur bêta | `events.jsonl` de Copilot CLI sous `~/.copilot/session-state/` + le registre d'usage par appel `session-store.db`. Conversations, appels d'outils, routage de modèle, répartition des tokens tenant compte du cache, coût en crédits IA facturés par le fournisseur. | -| **Grok** | Adaptateur bêta | xAI Grok Build CLI (binaire Rust sous `~/.grok/bin/grok`) : journal d'événements global `~/.grok/logs/unified.jsonl` + par session `~/.grok/sessions///{events.jsonl,summary.json}`. Conversations, répartition des tokens par tour, routage de modèle, et la charge utile du dépôt sortante de la CLI mise en attente sous `~/.grok/upload_queue/` pour que vous puissiez voir ce qui a quitté votre machine. | - -« Adaptateur bêta » signifie que ClawMetry fournit un lecteur pour le format sur disque réel de ce runtime, chacun construit et vérifié sur une installation réelle sur une machine réelle (voir `tests/fixtures/runtimes//`). Les adaptateurs sont en lecture seule ; chacun est transparent sur ce que son runtime stocke réellement (par ex. PicoClaw/NanoClaw/Cursor n'écrivent pas le coût des tokens sur disque). Lorsque plusieurs runtimes s'exécutent sur un même nœud, le sélecteur de runtime limite la vue des sessions à un seul pour une analyse approfondie propre. - -## Suivre n'importe quel agent SDK — attribution des coûts hors boucle - -Les runtimes ci-dessus écrivent tous les sessions sur disque. Votre propre **agent de production**, celui que vous avez construit sur le SDK OpenAI Agents, LangChain, le SDK Vercel AI, LlamaIndex, E2B, ou une simple boucle `httpx`, ne le fait pas. L'intercepteur zéro-configuration de ClawMetry capture quand même ses appels LLM (coût, tokens, latence, erreurs) en patchant dynamiquement `httpx`/`requests` : - -```python -import clawmetry.track # active l'intercepteur -clawmetry.track.set_source("support-agent") # nomme ce produit - -# ...votre agent s'exécute normalement ; chaque appel LLM est désormais suivi + attribué. -``` - -`set_source()` (ou la variable d'environnement `CLAWMETRY_SOURCE=support-agent`) étiquette chaque appel avec une **source nommée**, de sorte que chaque produit que vous exécutez apparaît comme sa propre ligne de premier ordre, attribuable en coût, dans la carte **🔌 Sources hors boucle** du tableau de bord sur Overview, appels, fournisseurs, latence, taux d'erreur par agent. Aucune source définie ? Les appels sont quand même suivis ; la carte reste simplement cachée. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -C'est la même couche de données que celle alimentée par les adaptateurs de runtime (DuckDB → snapshot cloud), donc les sources hors boucle se synchronisent avec le tableau de bord cloud comme tout le reste, chiffré de bout en bout. - -## OpenTelemetry — neutre vis-à-vis des fournisseurs, envoyez vos traces n'importe où - -ClawMetry parle **OpenTelemetry** dans les deux sens, en utilisant les **conventions sémantiques GenAI**, de sorte que les traces de votre agent ne sont jamais enfermées dans un seul outil. - -**Exportez** chaque session, appels LLM, outils, sous-agents, tokens, coût, sous forme de spans GenAI OTLP/HTTP vers n'importe quel collecteur (Datadog, Grafana, Honeycomb, ou votre propre collecteur OTel) : - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# de manière équivalente : -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Les en-têtes d'authentification et l'intervalle d'interrogation sont des variables d'environnement optionnelles : - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # en-têtes HTTP supplémentaires -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # secondes (par défaut 60) -``` - -**Ingérez** — le récepteur OTLP intégré accepte les traces, journaux et métriques de n'importe quoi d'autre sur `/v1/traces`, `/v1/logs`, et `/v1/metrics`. Pointez n'importe quelle application instrumentée avec OpenTelemetry vers lui : +| **Gratuit** | OpenClaw + NVIDIA NemoClaw, tableau de bord complet, local uniquement | 0 $ | +| **Starter** | Tous les autres runtimes ci-dessus, vue flotte, synchronisation cloud | 9 $ par nœud / mois | +| **Pro** | Starter + gouvernance : approbations, politiques de risque des outils, évaluations, détection d'anomalies, optimiseur de coûts, export OTel | 19 $ par nœud / mois | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -L'ingestion de traces et journaux OTLP/JSON fonctionne avec un simple `pip install clawmetry`, sans extras. L'ingestion Protobuf (et les métriques OTLP/JSON) nécessite `pip install clawmetry[otel]`. Une application qui définit son propre `service.name` apparaît comme son propre agent dans le sélecteur de runtime, avec son coût et ses tokens. - -Vous obtenez le tableau de bord ClawMetry zéro-configuration, local d'abord, **et** vos données dans le backend que votre équipe utilise déjà, sans enfermement propriétaire, sans second agent à installer. - -## Configuration - -La plupart des gens n'ont besoin d'aucune configuration. ClawMetry détecte automatiquement votre espace de travail, vos journaux, vos sessions et vos crons. - -Si vous avez besoin de personnaliser : - -```bash -clawmetry --port 9000 # Port personnalisé (par défaut : 8900) -clawmetry --host 127.0.0.1 # Se lier uniquement à localhost -clawmetry --workspace ~/mybot # Chemin d'espace de travail personnalisé -clawmetry --name "Alice" # Votre nom dans la visualisation Flow -``` - -Toutes les options : `clawmetry --help` - -## Canaux pris en charge - -ClawMetry affiche l'activité en direct pour chaque canal OpenClaw que vous avez configuré. Seuls les canaux réellement configurés dans votre `openclaw.json` apparaissent dans le diagramme Flow, les canaux non configurés sont automatiquement masqués. - -Cliquez sur n'importe quel nœud de canal dans le Flow pour voir une vue en bulles de discussion en direct avec le nombre de messages entrants/sortants. - -| Canal | Statut | Popup en direct | Notes | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Complet | ✅ | Messages, statistiques, rafraîchissement toutes les 10 s | -| 💬 **iMessage** | ✅ Complet | ✅ | Lit directement `~/Library/Messages/chat.db` | -| 💚 **WhatsApp** | ✅ Complet | ✅ | Via WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Complet | ✅ | Via signal-cli | -| 🟣 **Discord** | ✅ Complet | ✅ | Détection de guilde + canal | -| 🟪 **Slack** | ✅ Complet | ✅ | Détection d'espace de travail + canal | -| 🌐 **Webchat** | ✅ Complet | ✅ | Sessions d'interface web intégrée | -| 📡 **IRC** | ✅ Complet | ✅ | Interface en bulles de style terminal | -| 🍏 **BlueBubbles** | ✅ Complet | ✅ | iMessage via l'API REST BlueBubbles | -| 🔵 **Google Chat** | ✅ Complet | ✅ | Via les webhooks de l'API Chat | -| 🟣 **MS Teams** | ✅ Complet | ✅ | Via le plugin bot Teams | -| 🔷 **Mattermost** | ✅ Complet | ✅ | Chat d'équipe auto-hébergé | -| 🟩 **Matrix** | ✅ Complet | ✅ | Décentralisé, support E2EE | -| 🟢 **LINE** | ✅ Complet | ✅ | API de messagerie LINE | -| ⚡ **Nostr** | ✅ Complet | ✅ | DM décentralisés NIP-04 | -| 🟣 **Twitch** | ✅ Complet | ✅ | Chat via connexion IRC | -| 🔷 **Feishu/Lark** | ✅ Complet | ✅ | Abonnement aux événements WebSocket | -| 🔵 **Zalo** | ✅ Complet | ✅ | API Zalo Bot | - -> **Détection automatique :** ClawMetry lit votre `~/.openclaw/openclaw.json` et n'affiche que les canaux que vous avez réellement configurés. Aucune configuration manuelle requise. - -## Déploiement Docker - -Vous voulez exécuter ClawMetry dans un conteneur ? Aucun problème ! 🐳 - -**Démarrage rapide avec Docker :** - -```bash -# Construire l'image -docker build -t clawmetry . - -# Exécuter avec les paramètres par défaut -docker run -p 8900:8900 clawmetry - -# Ou monter le répertoire de données de votre agent (illustré : le ~/.openclaw d'OpenClaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Exemple Docker Compose :** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Remarque :** Lors de l'exécution dans Docker, montez les répertoires de données + journaux de votre agent (par ex. `~/.openclaw`, `~/.claude`, `~/.codex`) afin que ClawMetry puisse détecter automatiquement votre configuration. - -## Prérequis - -- Python 3.8+ -- Flask (installé automatiquement via pip) -- Un runtime d'agent IA sur la même machine : OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, ou QM (ou des volumes montés pour Docker) -- Linux ou macOS - -## Support NemoClaw / OpenShell - -ClawMetry détecte automatiquement [NemoClaw](https://github.com/NVIDIA/NemoClaw), l'enveloppe de sécurité d'entreprise de NVIDIA pour OpenClaw qui exécute les agents dans des conteneurs OpenShell sandboxés. - -Aucune configuration supplémentaire n'est nécessaire dans la plupart des cas. Le démon de synchronisation découvre automatiquement les fichiers de session qu'ils se trouvent sur `~/.openclaw/` sur l'hôte ou à l'intérieur d'un conteneur OpenShell. +Les plans annuels, Enterprise et les tarifs actuels se trouvent sur +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Les clés de licence auto-hébergées +fonctionnent sans le cloud (`clawmetry license`). La répartition exacte gratuit/payant est +détaillée dans [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -### Fonctionnement +## Vos données restent sur votre machine -ClawMetry détecte NemoClaw de deux façons : +ClawMetry lit les fichiers de session et les logs locaux. Rien ne quitte votre machine sauf si +vous exécutez `clawmetry connect`. Et même dans ce cas, l'instantané est chiffré de bout en bout +avec une clé qui ne quitte jamais votre machine, et déchiffré dans votre navigateur. -1. **Détection de binaire** — vérifie la présence de la CLI `nemoclaw` et exécute `nemoclaw status` pour obtenir les informations sur le sandbox -2. **Détection de conteneur** — scanne les conteneurs Docker en cours d'exécution à la recherche des images `openshell`, `nemoclaw`, ou `ghcr.io/nvidia/`, puis lit les sessions via des montages de volumes ou `docker cp` - -Les fichiers de session synchronisés depuis les conteneurs NemoClaw sont étiquetés avec `runtime=nemoclaw` et les métadonnées `container_id` dans le tableau de bord cloud, afin que vous puissiez les distinguer des sessions OpenClaw standard d'un coup d'œil. - -### Configuration recommandée : démon de synchronisation sur l'HÔTE - -Pour la meilleure expérience, exécutez le démon de synchronisation de ClawMetry sur la **machine hôte** (pas à l'intérieur du sandbox). Cela évite les restrictions de politique réseau de NemoClaw. - -```bash -# Sur l'hôte (en dehors du sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -Le démon de synchronisation trouvera automatiquement les sessions à l'intérieur de tout conteneur OpenShell en cours d'exécution. - -### Optionnel : nom de sandbox explicite - -Si la détection automatique ne fonctionne pas, indiquez à ClawMetry le bon sandbox : - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Exécution à l'intérieur du sandbox (avancé) - -Si vous devez exécuter le démon de synchronisation **à l'intérieur** du sandbox OpenShell, ajoutez cette règle de sortie à votre politique réseau NemoClaw afin qu'il puisse atteindre l'API d'ingestion de ClawMetry : - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Appliquez avec : +## Installation ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # puis : clawmetry ``` -### Ports et points de terminaison - -| Point de terminaison | Port | Protocole | Requis | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Oui (démon de synchronisation → cloud) | -| `localhost:8900` | 8900 | HTTP | Oui (interface du tableau de bord local) | -| Socket Docker (`/var/run/docker.sock`) | — | Socket Unix | Pour la découverte de session dans les conteneurs | - -Le démon de synchronisation effectue uniquement des appels HTTPS sortants vers `ingest.clawmetry.com`. Aucun port entrant n'est requis. - ---- - -## Déploiement Cloud - -Consultez le **[Guide de test Cloud](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** pour les tunnels SSH, le proxy inverse, et Docker. - -## Tests +Ou la commande en une ligne : `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -Ce projet est testé avec BrowserStack. +Nécessite Python 3.8+ sur macOS, Linux ou Windows, et au moins un runtime d'agent sur +la même machine. Instructions Docker : [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## Documentation -## Télémétrie +| | | +|---|---| +| [Compatibilité des runtimes](docs/compatibility.md) | Ce que lit chaque adaptateur, et comment ajouter un runtime | +| [Entitlements](docs/ENTITLEMENTS.md) | Gratuit vs payant, matrice des niveaux, CLI de licence | +| [Approbations et politiques](docs/APPROVALS.md) | Contrôle pré-exécution, notation des risques, approbations par téléphone | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Exportez des traces n'importe où, ingérez OTLP depuis n'importe quoi | +| [Suivi SDK](docs/SDK_TRACKING.md) | Attribution des coûts pour les agents que vous avez créés vous-même | +| [Canaux de chat](docs/CHANNELS.md) | Les adaptateurs de chat affichés dans Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Configurations NVIDIA NemoClaw en bac à sable | +| [Docker](docs/DOCKER.md) | Image, compose, montages de volumes | +| [Architecture](ARCHITECTURE.md) · [Développement](docs/DEVELOPMENT.md) | Fonctionnement interne ; exécution depuis les sources | +| [Télémétrie](docs/TELEMETRY.md) | Les pings anonymes d'installation et d'ouverture de l'application, et comment les désactiver | -ClawMetry envoie des pings anonymes de cycle de vie d'installation à -`https://app.clawmetry.com/api/install` : un ping `install` la première -fois que vous exécutez la CLI `clawmetry` sur une nouvelle machine, un ping `update` -lors de la première exécution après une mise à niveau vers une nouvelle version, et un ping `onboarded` -lorsque vous terminez le choix d'intégration dans le tableau de bord. Nous utilisons cela -pour compter les installations réelles (les chiffres bruts de téléchargement PyPI sont environ 98 % des miroirs, de la CI, -et des re-téléchargements de mise à jour automatique) et pour savoir quels frameworks d'agents et -quelles versions sont réellement utilisés. +## Captures d'écran -**Au plus un POST par événement de cycle de vie par version**, contenant : +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview** : tokens, sessions, santé | **Brain** : flux d'événements de l'agent en direct | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Coût** : par modèle et par session | **Approbations** : contrôle des appels d'outils risqués | -| Champ | Exemple | Pourquoi | -|---|---|---| -| `install_id` | UUID aléatoire stocké dans `~/.clawmetry/install_id` | déduplication ; anonyme jusqu'à ce que vous connectiez explicitement la synchronisation Cloud (le battement de cœur authentifié du démon transporte alors cet identifiant, reliant cette installation à votre compte) | -| `event` | `install` / `update` / `onboarded` | nouvelle installation vs mise à niveau d'une existante | -| `version` | `0.12.167` | quelles versions sont en circulation | -| `os` / `os_version` | `Darwin` / `25.3.0` | priorités de support de plateforme | -| `python` | `3.11.15` | matrice de support des versions Python | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | quels agents nous devrions intégrer ensuite | -| `is_ci` / `ci_provider` | `true` / `github_actions` | séparer les installations humaines du bruit CI | - -**Ce que nous n'envoyons PAS** : IP (le cloud dérive le code pays côté serveur -à partir de la requête, puis rejette l'IP), le nom d'hôte, le nom d'utilisateur, le chemin de l'espace de travail, -le contenu des fichiers, votre api_key, votre email, tout élément identifiable ou -spécifique à l'espace de travail. La charge utile réseau peut être auditée dans -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Se désinscrire** (l'une de ces méthodes la désactive de manière permanente) : - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # par shell -export DO_NOT_TRACK=1 # norme W3C inter-outils -touch ~/.clawmetry/notelemetry # marqueur de fichier persistant -``` - -Un échec réseau ici ne bloque jamais l'exécution de `clawmetry`, le -ping est envoyé sans attente de réponse sur un thread démon avec un délai d'expiration de 3 s. +Plus de captures, par runtime : [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Historique des étoiles @@ -436,11 +116,6 @@ ping est envoyé sans attente de réponse sur un thread démon avec un délai d' ## Licence -MIT - ---- +MIT · Créé par [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Voyez votre agent réfléchir
- Créé par @vivekchand · clawmetry.com · Fait partie de l'écosystème OpenClaw -

+ diff --git a/docs/i18n/gu/README.md b/docs/i18n/gu/README.md index 6a60985346..b1f20ba266 100644 --- a/docs/i18n/gu/README.md +++ b/docs/i18n/gu/README.md @@ -1,430 +1,104 @@ - + > ગુજરાતી translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**તમારા એજન્ટને વિચારતું જુઓ.** **20 AI એજન્ટ રનટાઇમ્સ** માટે રિયલ-ટાઇમ ઓબ્ઝર્વેબિલિટી: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex અને બીજા 16. તમારા આખા એજન્ટ ફ્લીટ માટે એક જ ડેશબોર્ડ. +**તમારા એજન્ટને વિચારતું જુઓ.** **23 AI એજન્ટ રનટાઇમ્સ** માટે રીઅલ-ટાઇમ ઓબ્ઝર્વેબિલિટી: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex અને બીજા 19. તમારા આખા એજન્ટ ફ્લીટ માટે એક જ ડેશબોર્ડ. -> 🌐 **આ ભાષામાં વાંચો:** [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/) +> 🌐 **આ આમાં વાંચો:** [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** પર ખૂલે છે અને તમારું કામ પૂરું. +**http://localhost:8900** પર ખૂલે છે. શૂન્ય કન્ફિગ: તમારી પાસે પહેલેથી જ જે એજન્ટ રનટાઇમ્સ છે તેને તે શોધી કાઢે છે, તેમને ફક્ત-વાંચન (read-only) રીતે વાંચે છે, અને તેઓ કેવી રીતે ચાલે છે તેમાં કંઈ પણ બદલતું નથી. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 20 એજન્ટ રનટાઇમ્સ સાથે કામ કરે છે - -ClawMetry એ OpenClaw માટેની ઓબ્ઝર્વેબિલિટી તરીકે શરૂ થયું, અને હવે તે એક જ ડેશબોર્ડમાં તમારા **આખા એજન્ટ ફ્લીટ**ને મીટર કરે છે, તમારા મશીન પર દરેક રનટાઇમને ઓટો-ડિટેક્ટ કરીને: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw અને NemoClaw ઓપન-સોર્સ એપમાં મફત છે; બાકીના રનટાઇમ્સ ClawMetry Cloud અથવા સેલ્ફ-હોસ્ટેડ Pro લાયસન્સ સાથે સક્રિય થાય છે. હેડરમાંથી રનટાઇમ સ્વિચ કરો અને દરેક ટૅબ, કોસ્ટ, ટોકન્સ, ટૂલ્સ, ટ્રેસ, તે રનટાઇમ પ્રમાણે ફરીથી સ્કોપ થાય છે. ચોક્કસ ફ્રી/પેઇડ સ્પ્લિટ, ટાયર મેટ્રિક્સ, `/api/entitlement` શેપ, અને `clawmetry license` CLI માટે **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** જુઓ. - -## તમને શું મળે છે - -- **Flow** — ચેનલો, બ્રેઇન, ટૂલ્સ અને પાછા થઈને પસાર થતા મેસેજ બતાવતું લાઇવ એનિમેટેડ ડાયાગ્રામ -- **Overview** — હેલ્થ ચેક્સ, એક્ટિવિટી હીટમેપ, સેશન કાઉન્ટ્સ, મોડલ માહિતી -- **Usage** — દૈનિક/સાપ્તાહિક/માસિક બ્રેકડાઉન સાથે ટોકન અને કોસ્ટ ટ્રેકિંગ -- **Sessions** — મોડલ, ટોકન્સ, છેલ્લી પ્રવૃત્તિ સાથે સક્રિય એજન્ટ સેશન્સ -- **Crons** — સ્ટેટસ, આગામી રન, ડ્યુરેશન સાથે શેડ્યુલ કરેલી જોબ્સ -- **Logs** — કલર-કોડેડ રિયલ-ટાઇમ લોગ સ્ટ્રીમિંગ -- **Memory** — SOUL.md, MEMORY.md, AGENTS.md, દૈનિક નોંધો બ્રાઉઝ કરો -- **Transcripts** — સેશન હિસ્ટ્રી વાંચવા માટે ચેટ-બબલ UI -- **Alerts** — બજેટ કેપ્સ, એરર-રેટ ટ્રિગર્સ, એજન્ટ-ઑફલાઇન ડિટેક્શન; Slack, Discord, PagerDuty, Telegram, Email પર રૂટ કરે છે -- **Approvals** — વિનાશક ડિલીટ્સ, ફોર્સ પુશ, DB મ્યુટેશન્સ, sudo, પેકેજ ઇન્સ્ટોલ્સ, નેટવર્ક કૉલ્સને એક-ક્લિક સાઇન-ઑફ પાછળ ગેટ કરો - -## સ્ક્રીનશોટ્સ - -### 🧠 Brain — લાઇવ એજન્ટ ઇવેન્ટ સ્ટ્રીમ -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — ટોકન વપરાશ અને સેશન સારાંશ -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — રિયલ-ટાઇમ ટૂલ કૉલ ફીડ -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — મોડલ અને સેશન પ્રમાણે કોસ્ટ બ્રેકડાઉન -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — વર્કસ્પેસ ફાઇલ બ્રાઉઝર -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — પોસ્ચર અને ઓડિટ લોગ -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) +## 23 એજન્ટ રનટાઇમ્સ સાથે કામ કરે છે -### 🚨 Alerts — બજેટ કેપ્સ, એરર-રેટ ટ્રિગર્સ, Slack / Discord / PagerDuty / Email માટે વેબહૂક્સ -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +**ઓપન સોર્સ એપમાં મફત:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### ✋ Approvals — જોખમી ટૂલ કૉલ્સને મેન્યુઅલ સાઇન-ઑફ પાછળ ગેટ કરો; પોલિસી-બેક્ડ પ્રોટેક્શન નિયમો -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Claude Code માટે પ્રી-એક્ઝિક્યુશન બ્લોકિંગ** — એક કમાન્ડ એક PreToolUse -હૂક ઇન્સ્ટોલ કરે છે જે મેચ થતા ટૂલ કૉલ્સને તે *ચાલે તે પહેલાં* થોભાવે છે અને -તમારા નિર્ણયની રાહ જુએ છે ([cloud push notifications](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 ના -પોતાના પરમિશન પ્રોમ્પ્ટને સ્કિપ કરે છે (તમે પહેલેથી જ જવાબ આપી દીધો છે). -અનમેચ્ડ ટૂલ્સનો ખર્ચ ~40ms છે અને તે 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 -``` +**પેઇડ પ્લાન પર:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -## v2 ફ્રન્ટએન્ડ ડેવલપમેન્ટ +દરેક રનટાઇમને એ જ ડેશબોર્ડ મળે છે. એકસાથે અનેક ચલાવો અને હેડર સ્વિચર દરેક ટેબને તેમાંથી કોઈ એક પર ફરીથી સ્કોપ કરે છે. -v2 React એપ `frontend/` માં રહે છે અને Flask સર્વર v2 સક્રિય રાખીને -શરૂ કરવામાં આવે ત્યારે `/v2` પર સર્વ થાય છે. +તમારો પોતાનો એજન્ટ SDK પર બનાવ્યો છે? ઇન્ટરસેપ્ટર તેના LLM કૉલ્સ પણ ટ્રેક કરે છે. જુઓ [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -ડેવલપ કરતી વખતે બે ટર્મિનલનો ઉપયોગ કરો: - -```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 એપ વધારાના CORS -સેટઅપ વગર લોકલ Flask સર્વર સાથે વાત કરી શકે. - -Python પેકેજ સાથે શિપ થતું બંડલ બિલ્ડ કરવા માટે: - -```bash -cd frontend -npm run build -``` - -પ્રોડક્શન બંડલ `clawmetry/static/v2/dist/` માં લખાય છે. - -## રનટાઇમ / એજન્ટ કમ્પેટિબિલિટી +## તમને શું મળે છે -ClawMetry ફક્ત OpenClaw જ નહીં, ઘણા AI-એજન્ટ રનટાઇમ્સનું નિરીક્ષણ કરે છે. દરેક નોન-OpenClaw રનટાઇમ એક ડેડિકેટેડ રીડર એડેપ્ટર શિપ કરે છે જે તેના નેટિવ સેશન ફોર્મેટને ClawMetry ના યુનિફાઇડ શેપ્સમાં ટ્રાન્સલેટ કરે છે; ડિમન તેમને એ જ DuckDB સ્ટોર + ક્લાઉડ સ્નેપશોટમાં ઇન્જેસ્ટ કરે છે, રનટાઇમ સાથે ટૅગ કરીને, અને Session replay ટૅબ એકથી વધુ રનટાઇમ હાજર હોય ત્યારે **રનટાઇમ સ્વિચર** બતાવે છે. સંપૂર્ણ મેટ્રિક્સ + રનટાઇમ્સ ઉમેરવાની ગાઇડ માટે [`docs/compatibility.md`](docs/compatibility.md) જુઓ, અને OpenClaw-ફેમિલી પ્રાઇમર માટે [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) જુઓ. +- **સેશન્સ અને ટ્રાન્સ્ક્રિપ્ટ્સ**: દરેક એજન્ટે શું કર્યું, ટર્ન-બાય-ટર્ન, રિપ્લે સાથે +- **ખર્ચ અને ટોકન્સ**: રનટાઇમ, મોડલ, સેશન અને દિવસ પ્રમાણે, વિસંગતતા ફ્લેગ્સ સાથે +- **ફ્લો**: ચેનલ્સ, મોડલ્સ અને ટૂલ્સ મારફતે વહેતા મેસેજનું લાઇવ ડાયાગ્રામ +- **બ્રેઇન**: રિઝનિંગ અને ટૂલ-કૉલ ઇવેન્ટ સ્ટ્રીમ જેમ જેમ થાય તેમ +- **મેમરી અને સ્કિલ્સ**: દરેક રનટાઇમે ખરેખર લોડ કરેલી ફાઇલો અને સ્કિલ્સ +- **હેલ્થ અને લોગ્સ**: ડિસ્ક, મેમરી, એરર રેટ્સ, રેટ લિમિટ્સ, લાઇવ લોગ સ્ટ્રીમ +- **એલર્ટ્સ**: બજેટ કેપ્સ, એરર સ્પાઇક્સ, એજન્ટ-ઓફલાઇન, Slack, Discord, PagerDuty, Telegram, Email પર રૂટ થયેલ +- **એપ્રૂવલ્સ**: જોખમી ટૂલ કૉલ્સને ચાલે *તે પહેલાં* થોભાવો અને તમારા ફોનથી મંજૂર કરો ([કેવી રીતે](docs/APPROVALS.md)) -[Perplexity નું numbat](https://github.com/perplexityai/numbat) એજન્ટ-સિક્યુરિટી ટૂલ ચલાવો છો? ClawMetry તેના તારણો અને એન્ફોર્સમેન્ટ નિર્ણયોને આઉટ ઓફ ધ બોક્સ ઇન્જેસ્ટ કરે છે — [`docs/NUMBAT.md`](docs/NUMBAT.md) જુઓ. +## ભાવ -| Runtime / Agent | Status | Notes | +| પ્લાન | શું આવરી લે છે | કિંમત | |---|---|---| -| **OpenClaw** | Native | રેફરન્સ રનટાઇમ, ઓટો-ડિટેક્ટેડ | -| **PicoClaw** | Beta adapter | Flat `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`). ટ્રાન્સક્રિપ્ટ્સ, મોડલ, ટૂલ કૉલ્સ. | -| **NanoClaw** | Beta adapter | પ્રતિ-સેશન SQLite (`data/v2-sessions`). ટ્રાન્સક્રિપ્ટ્સ + મેસેજ કાઉન્ટ્સ. | -| **Hermes** | Beta adapter | SQLite `~/.hermes/state.db`. ટ્રાન્સક્રિપ્ટ્સ, મોડલ, ટોકન્સ/કોસ્ટ. | -| **Claude Code** | Beta adapter | JSONL `~/.claude/projects/.../.jsonl`. ટ્રાન્સક્રિપ્ટ્સ, મોડલ, ટૂલ કૉલ્સ + થિન્કિંગ, ટોકન વપરાશ. | -| **Codex** | Beta adapter | Rollout JSONL `~/.codex/sessions/...`. ટ્રાન્સક્રિપ્ટ્સ, મોડલ, ટૂલ કૉલ્સ, ટોકન વપરાશ. | -| **Cursor** | Beta adapter | SQLite `state.vscdb`. ચેટ/કમ્પોઝર ટ્રાન્સક્રિપ્ટ્સ, મોડલ. | -| **Aider** | Beta adapter | પ્રતિ-પ્રોજેક્ટ `.aider.chat.history.md`. ટ્રાન્સક્રિપ્ટ્સ, મોડલ, ટોકન કાઉન્ટ્સ. | -| **Goose** | Beta adapter | SQLite `~/.local/share/goose`. ટ્રાન્સક્રિપ્ટ્સ, મોડલ, ટૂલ કૉલ્સ, ટોકન ટોટલ્સ. | -| **opencode** | Beta adapter | SQLite `~/.local/share/opencode`. ટ્રાન્સક્રિપ્ટ્સ, મોડલ, ટૂલ કૉલ્સ, ટોકન્સ + કોસ્ટ. | -| **Qwen Code** | Beta adapter | JSONL `~/.qwen/projects/.../chats`. ટ્રાન્સક્રિપ્ટ્સ, મોડલ, ટૂલ કૉલ્સ, ટોકન વપરાશ. | -| **Pi** | Beta adapter | JSONL `~/.pi/agent/sessions`. ટ્રાન્સક્રિપ્ટ્સ, મોડલ, ટૂલ કૉલ્સ, ટોકન્સ + કોસ્ટ. | -| **Deep Agents** | Beta adapter | SQLite `~/.deepagents/.state/sessions.db`. ટ્રાન્સક્રિપ્ટ્સ, મોડલ, ટૂલ કૉલ્સ, ટોકન્સ + કોસ્ટ. | -| **n8n** | Beta adapter | SQLite `~/.n8n/database.sqlite`. વર્કફ્લો એક્ઝિક્યુશન્સ, નોડ રન્સ, AI Agent પ્રોમ્પ્ટ્સ, n8n જ્યાં રેકોર્ડ કરે ત્યાં મોડલ + ટોકન્સ. | -| **Antigravity** | Beta adapter | `~/.gemini//brain/` હેઠળ Brain JSONL. વાતચીતો, ટૂલ સ્ટેપ્સ, થિન્કિંગ, પ્રતિ-જનરેશન Gemini ટોકન સ્પ્લિટ + કોસ્ટ, બેકગ્રાઉન્ડ-જનરેશન બર્ન. | -| **GitHub Copilot** | Beta adapter | `~/.copilot/session-state/` હેઠળ Copilot CLI `events.jsonl` + `session-store.db` પ્રતિ-કૉલ વપરાશ લેજર. વાતચીતો, ટૂલ કૉલ્સ, મોડલ રાઉટિંગ, કેશ-અવેર ટોકન સ્પ્લિટ, વેન્ડર-બિલ્ડ AI-ક્રેડિટ કોસ્ટ. | -| **Grok** | Beta adapter | xAI Grok Build CLI (`~/.grok/bin/grok` હેઠળ Rust બાઇનરી): ગ્લોબલ ઇવેન્ટ લોગ `~/.grok/logs/unified.jsonl` + પ્રતિ-સેશન `~/.grok/sessions///{events.jsonl,summary.json}`. વાતચીતો, પ્રતિ-ટર્ન ટોકન સ્પ્લિટ, મોડલ રાઉટિંગ, અને CLI નું આઉટબાઉન્ડ રિપો પેલોડ `~/.grok/upload_queue/` હેઠળ સ્ટેજ કરેલું જેથી તમારા મશીનમાંથી શું બહાર ગયું તે તમે જોઈ શકો. | - -"Beta adapter" નો અર્થ છે કે ClawMetry તે રનટાઇમના વાસ્તવિક ડિસ્ક-પર ફોર્મેટ માટે એક રીડર શિપ કરે છે, દરેક વાસ્તવિક મશીન પરના વાસ્તવિક ઇન્સ્ટોલ સામે બિલ્ડ + વેરિફાય કરેલ (જુઓ `tests/fixtures/runtimes//`). એડેપ્ટર્સ રીડ-ઓન્લી છે; દરેક તેના રનટાઇમ ખરેખર શું સ્ટોર કરે છે તે વિશે પ્રામાણિક છે (દા.ત. PicoClaw/NanoClaw/Cursor ડિસ્ક પર ટોકન કોસ્ટ લખતા નથી). જ્યારે એક નોડ પર ઘણા રનટાઇમ્સ ચાલે ત્યારે, રનટાઇમ સ્વિચર સ્વચ્છ ડીપ-ડાઇવ માટે સેશન્સ વ્યુને એક પર સ્કોપ કરે છે. - -## કોઈપણ SDK એજન્ટને ટ્રેક કરો — આઉટ-લૂપ કોસ્ટ એટ્રિબ્યુશન - -ઉપરના રનટાઇમ્સ બધા સેશન્સ ડિસ્ક પર લખે છે. તમારો પોતાનો **પ્રોડક્શન એજન્ટ** — જે તમે OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, અથવા સાદા `httpx` લૂપ પર બનાવ્યો છે — તે લખતો નથી. ClawMetry નું ઝીરો-કન્ફિગ ઇન્ટરસેપ્ટર `httpx`/`requests` ને મંકી-પેચ કરીને તેના LLM કૉલ્સ (કોસ્ટ, ટોકન્સ, લેટન્સી, એરર્સ) હજુ પણ કેપ્ચર કરે છે: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (અથવા `CLAWMETRY_SOURCE=support-agent` એન્વ વેરિયેબલ) દરેક કૉલને એક **નામાંકિત સોર્સ** સાથે ટૅગ કરે છે, જેથી તમે ચલાવો છો તે દરેક પ્રોડક્ટ ડેશબોર્ડના Overview પરના **🔌 Out-loop sources** કાર્ડમાં પોતાની ફર્સ્ટ-ક્લાસ, કોસ્ટ-એટ્રિબ્યુટેબલ લાઇન તરીકે દેખાય — પ્રતિ એજન્ટ કૉલ્સ, પ્રોવાઇડર્સ, લેટન્સી, એરર રેટ. કોઈ સોર્સ સેટ ન કર્યો? કૉલ્સ હજુ પણ ટ્રેક થાય છે; ફક્ત કાર્ડ છુપાયેલું રહે છે. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -આ એ જ ડેટા લેયર છે જે રનટાઇમ એડેપ્ટર્સ ફીડ કરે છે (DuckDB → ક્લાઉડ સ્નેપશોટ), તેથી આઉટ-લૂપ સોર્સિસ બાકીની બધી વસ્તુની જેમ જ ક્લાઉડ ડેશબોર્ડ સાથે સિંક થાય છે, E2E-એન્ક્રિપ્ટેડ. - -## OpenTelemetry — વેન્ડર-ન્યુટ્રલ, તમારા ટ્રેસ ગમે ત્યાં મોકલો - -ClawMetry બંને દિશામાં **OpenTelemetry** બોલે છે, **GenAI સિમેન્ટિક કન્વેન્શન્સ** વાપરીને, જેથી તમારા એજન્ટ ટ્રેસ ક્યારેય એક જ ટૂલમાં લૉક ન થાય. - -**એક્સપોર્ટ** — દરેક સેશન, LLM કૉલ્સ, ટૂલ્સ, સબ-એજન્ટ્સ, ટોકન્સ, કોસ્ટ, ને OTLP/HTTP GenAI સ્પાન્સ તરીકે કોઈપણ કલેક્ટર (Datadog, Grafana, Honeycomb, અથવા તમારો પોતાનો OTel Collector) પર: - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -ઓથ હેડર્સ અને પોલ ઇન્ટરવલ વૈકલ્પિક એન્વ વેરિયેબલ્સ છે: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**ઇન્જેસ્ટ** — બિલ્ટ-ઇન OTLP રિસીવર `/v1/traces`, `/v1/logs`, અને `/v1/metrics` પર બીજા ગમે તેમાંથી ટ્રેસ, લોગ્સ, અને મેટ્રિક્સ સ્વીકારે છે. કોઈપણ OpenTelemetry-ઇન્સ્ટ્રુમેન્ટેડ એપને તેના તરફ પોઇન્ટ કરો: +| **Free** | OpenClaw + NVIDIA NemoClaw, સંપૂર્ણ ડેશબોર્ડ, ફક્ત લોકલ | $0 | +| **Starter** | ઉપરના બાકીના તમામ રનટાઇમ્સ, ફ્લીટ વ્યૂ, ક્લાઉડ સિંક | $9 પ્રતિ નોડ / મહિનો | +| **Pro** | Starter + ગવર્નન્સ: એપ્રૂવલ્સ, ટૂલ-રિસ્ક પોલિસીઝ, ઇવલ્સ, વિસંગતતા શોધ, ખર્ચ ઓપ્ટિમાઇઝર, OTel એક્સપોર્ટ | $19 પ્રતિ નોડ / મહિનો | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON ટ્રેસ અને લોગ્સ સાદા `pip install clawmetry` પર કામ કરે છે, કોઈ એક્સ્ટ્રા વગર. Protobuf ઇન્જેસ્ટ (અને OTLP/JSON મેટ્રિક્સ) માટે `pip install clawmetry[otel]` જોઈએ. જે એપ પોતાનું `service.name` સેટ કરે છે તે રનટાઇમ સ્વિચરમાં પોતાના એજન્ટ તરીકે, પોતાની કોસ્ટ અને ટોકન્સ સાથે દેખાય છે. - -તમને ઝીરો-કન્ફિગ, લોકલ-ફર્સ્ટ ClawMetry ડેશબોર્ડ **અને** તમારી ટીમ પહેલેથી ચલાવે છે તે કોઈપણ બેકએન્ડમાં તમારો ડેટા મળે છે — કોઈ લોક-ઇન નહીં, ઇન્સ્ટોલ કરવા માટે બીજો એજન્ટ નહીં. - -## કન્ફિગરેશન - -મોટાભાગના લોકોને કોઈ કન્ફિગની જરૂર નથી. ClawMetry તમારો વર્કસ્પેસ, લોગ્સ, સેશન્સ, અને ક્રોન્સ ઓટો-ડિટેક્ટ કરે છે. - -જો તમારે કસ્ટમાઇઝ કરવાની જરૂર હોય તો: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -બધા વિકલ્પો: `clawmetry --help` - -## સપોર્ટેડ ચેનલ્સ - -તમે કન્ફિગર કરેલ દરેક OpenClaw ચેનલ માટે ClawMetry લાઇવ પ્રવૃત્તિ બતાવે છે. ફક્ત તમારા `openclaw.json` માં ખરેખર સેટ અપ કરેલી ચેનલ્સ જ Flow ડાયાગ્રામમાં દેખાય છે — કન્ફિગર ન કરેલી ચેનલ્સ આપોઆપ છુપાવવામાં આવે છે. - -Flow માં કોઈપણ ચેનલ નોડ પર ક્લિક કરો ઇનકમિંગ/આઉટગોઇંગ મેસેજ કાઉન્ટ્સ સાથે લાઇવ ચેટ બબલ વ્યુ જોવા માટે. - -| Channel | Status | Live Popup | Notes | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Full | ✅ | મેસેજ, સ્ટેટ્સ, 10s રિફ્રેશ | -| 💬 **iMessage** | ✅ Full | ✅ | `~/Library/Messages/chat.db` સીધું વાંચે છે | -| 💚 **WhatsApp** | ✅ Full | ✅ | WhatsApp Web (Baileys) દ્વારા | -| 🔵 **Signal** | ✅ Full | ✅ | signal-cli દ્વારા | -| 🟣 **Discord** | ✅ Full | ✅ | Guild + channel ડિટેક્શન | -| 🟪 **Slack** | ✅ Full | ✅ | Workspace + channel ડિટેક્શન | -| 🌐 **Webchat** | ✅ Full | ✅ | બિલ્ટ-ઇન વેબ UI સેશન્સ | -| 📡 **IRC** | ✅ Full | ✅ | ટર્મિનલ-સ્ટાઇલ બબલ UI | -| 🍏 **BlueBubbles** | ✅ Full | ✅ | BlueBubbles REST API દ્વારા iMessage | -| 🔵 **Google Chat** | ✅ Full | ✅ | Chat API વેબહૂક્સ દ્વારા | -| 🟣 **MS Teams** | ✅ Full | ✅ | Teams bot પ્લગઇન દ્વારા | -| 🔷 **Mattermost** | ✅ Full | ✅ | સેલ્ફ-હોસ્ટેડ ટીમ ચેટ | -| 🟩 **Matrix** | ✅ Full | ✅ | ડિસેન્ટ્રલાઇઝ્ડ, E2EE સપોર્ટ | -| 🟢 **LINE** | ✅ Full | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Full | ✅ | ડિસેન્ટ્રલાઇઝ્ડ NIP-04 DMs | -| 🟣 **Twitch** | ✅ Full | ✅ | IRC કનેક્શન દ્વારા ચેટ | -| 🔷 **Feishu/Lark** | ✅ Full | ✅ | WebSocket ઇવેન્ટ સબસ્ક્રિપ્શન | -| 🔵 **Zalo** | ✅ Full | ✅ | Zalo Bot API | - -> **ઓટો-ડિટેક્શન:** ClawMetry તમારો `~/.openclaw/openclaw.json` વાંચે છે અને ફક્ત તમે ખરેખર કન્ફિગર કરેલી ચેનલ્સ જ રેન્ડર કરે છે. કોઈ મેન્યુઅલ સેટઅપ જરૂરી નથી. - -## Docker ડિપ્લોયમેન્ટ - -ClawMetry ને કન્ટેનરમાં ચલાવવા માંગો છો? કોઈ સમસ્યા નથી! 🐳 - -**Docker સાથે ઝડપી શરૂઆત:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose ઉદાહરણ:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **નોંધ:** Docker માં ચલાવતી વખતે, તમારા એજન્ટની ડેટા + લોગ ડિરેક્ટરીઓ (દા.ત. `~/.openclaw`, `~/.claude`, `~/.codex`) માઉન્ટ કરો જેથી ClawMetry તમારું સેટઅપ ઓટો-ડિટેક્ટ કરી શકે. - -## જરૂરિયાતો - -- Python 3.8+ -- Flask (pip દ્વારા આપોઆપ ઇન્સ્ટોલ થાય છે) -- એ જ મશીન પર એક AI એજન્ટ રનટાઇમ: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, અથવા QM (અથવા Docker માટે માઉન્ટેડ વોલ્યુમ્સ) -- Linux અથવા macOS - -## NemoClaw / OpenShell સપોર્ટ - -ClawMetry આપોઆપ [NemoClaw](https://github.com/NVIDIA/NemoClaw) ને ડિટેક્ટ કરે છે — NVIDIA નું એન્ટરપ્રાઇઝ સિક્યુરિટી રેપર જે OpenClaw માટે છે અને એજન્ટ્સને સેન્ડબોક્સ કરેલા OpenShell કન્ટેનર્સની અંદર ચલાવે છે. - -મોટાભાગના કિસ્સાઓમાં કોઈ વધારાના કન્ફિગરેશનની જરૂર નથી. સિંક ડિમન સેશન ફાઇલ્સ ઓટો-ડિસ્કવર કરે છે, ભલે તે હોસ્ટ પર `~/.openclaw/` માં હોય કે OpenShell કન્ટેનરની અંદર. +વાર્ષિક પ્લાન, એન્ટરપ્રાઇઝ અને હાલના આંકડા +**[clawmetry.com/pricing](https://clawmetry.com/pricing)** પર છે. સેલ્ફ-હોસ્ટેડ લાયસન્સ +કીઝ ક્લાઉડ વગર કામ કરે છે (`clawmetry license`). ચોક્કસ ફ્રી/પેઇડ વિભાજન +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) માં છે. -### તે કેવી રીતે કામ કરે છે +## તમારો ડેટા તમારા મશીન પર જ રહે છે -ClawMetry બે રીતે NemoClaw ને ડિટેક્ટ કરે છે: +ClawMetry લોકલ સેશન ફાઇલો અને લોગ્સ વાંચે છે. જ્યાં સુધી તમે `clawmetry connect` ચલાવો નહીં ત્યાં સુધી કંઈ પણ તમારા બોક્સમાંથી બહાર જતું નથી. તે પછી પણ સ્નેપશોટ એન્ડ-ટુ-એન્ડ એન્ક્રિપ્ટેડ હોય છે એવી કીથી જે ક્યારેય તમારા મશીનમાંથી બહાર જતી નથી, અને તમારા બ્રાઉઝરમાં ડિક્રિપ્ટ થાય છે. -1. **બાઇનરી ડિટેક્શન** — `nemoclaw` CLI માટે તપાસ કરે છે અને સેન્ડબોક્સ માહિતી મેળવવા `nemoclaw status` ચલાવે છે -2. **કન્ટેનર ડિટેક્શન** — `openshell`, `nemoclaw`, અથવા `ghcr.io/nvidia/` ઇમેજ માટે ચાલી રહેલા Docker કન્ટેનર્સ સ્કેન કરે છે, પછી વોલ્યુમ માઉન્ટ્સ અથવા `docker cp` દ્વારા સેશન્સ વાંચે છે - -NemoClaw કન્ટેનર્સમાંથી સિંક કરેલી સેશન ફાઇલ્સને ક્લાઉડ ડેશબોર્ડમાં `runtime=nemoclaw` અને `container_id` મેટાડેટા સાથે ટૅગ કરવામાં આવે છે, જેથી તમે તેમને સ્ટાન્ડર્ડ OpenClaw સેશન્સથી એક નજરમાં અલગ પાડી શકો. - -### ભલામણ કરેલ સેટઅપ: HOST પર સિંક ડિમન - -શ્રેષ્ઠ અનુભવ માટે, ClawMetry ના સિંક ડિમનને **હોસ્ટ મશીન** પર ચલાવો (સેન્ડબોક્સની અંદર નહીં). આ NemoClaw ના નેટવર્ક પોલિસી પ્રતિબંધોને ટાળે છે. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -સિંક ડિમન આપોઆપ કોઈપણ ચાલી રહેલા OpenShell કન્ટેનર્સની અંદર સેશન્સ શોધી કાઢશે. - -### વૈકલ્પિક: સ્પષ્ટ સેન્ડબોક્સ નામ - -જો ઓટો-ડિટેક્શન કામ ન કરે, તો ClawMetry ને યોગ્ય સેન્ડબોક્સ તરફ પોઇન્ટ કરો: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### સેન્ડબોક્સની અંદર ચલાવવું (એડવાન્સ્ડ) - -જો તમારે સિંક ડિમનને OpenShell સેન્ડબોક્સની **અંદર** ચલાવવો જ પડે, તો તમારી NemoClaw નેટવર્ક પોલિસીમાં આ એગ્રેસ નિયમ ઉમેરો જેથી તે ClawMetry ingest API સુધી પહોંચી શકે: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -આ સાથે લાગુ કરો: +## ઇન્સ્ટોલ ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # પછી: clawmetry ``` -### પોર્ટ્સ અને એન્ડપોઇન્ટ્સ - -| Endpoint | Port | Protocol | Required | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | હા (સિંક ડિમન → ક્લાઉડ) | -| `localhost:8900` | 8900 | HTTP | હા (લોકલ ડેશબોર્ડ UI) | -| Docker socket (`/var/run/docker.sock`) | — | Unix socket | કન્ટેનર સેશન ડિસ્કવરી માટે | - -સિંક ડિમન ફક્ત `ingest.clawmetry.com` પર જ આઉટબાઉન્ડ HTTPS કૉલ્સ કરે છે. કોઈ ઇનબાઉન્ડ પોર્ટ્સ જરૂરી નથી. - ---- - -## ક્લાઉડ ડિપ્લોયમેન્ટ - -SSH ટનલ્સ, રિવર્સ પ્રોક્સી, અને Docker માટે **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** જુઓ. - -## ટેસ્ટિંગ +અથવા વન-લાઇનર: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -આ પ્રોજેક્ટ BrowserStack સાથે ટેસ્ટ કરવામાં આવે છે. +macOS, Linux અથવા Windows પર Python 3.8+ જોઈએ, અને એ જ મશીન પર ઓછામાં ઓછું એક એજન્ટ રનટાઇમ. Docker સૂચનાઓ: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## દસ્તાવેજો -## ટેલિમેટ્રી +| | | +|---|---| +| [રનટાઇમ સુસંગતતા](docs/compatibility.md) | દરેક એડેપ્ટર શું વાંચે છે, અને રનટાઇમ કેવી રીતે ઉમેરવું | +| [એન્ટાઇટલમેન્ટ્સ](docs/ENTITLEMENTS.md) | મફત વિ પેઇડ, ટિયર મેટ્રિક્સ, લાયસન્સ CLI | +| [એપ્રૂવલ્સ અને પોલિસીઝ](docs/APPROVALS.md) | પ્રી-એક્ઝિક્યુશન ગેટિંગ, રિસ્ક સ્કોરિંગ, ફોન એપ્રૂવલ્સ | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | ટ્રેસ ગમે ત્યાં એક્સપોર્ટ કરો, ગમે ત્યાંથી OTLP ઇનજેસ્ટ કરો | +| [SDK ટ્રેકિંગ](docs/SDK_TRACKING.md) | તમે જાતે બનાવેલા એજન્ટ્સ માટે ખર્ચ એટ્રિબ્યુશન | +| [ચેટ ચેનલ્સ](docs/CHANNELS.md) | Flow માં દેખાતા ચેટ એડેપ્ટર્સ | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | સેન્ડબોક્સ્ડ NVIDIA NemoClaw સેટઅપ્સ | +| [Docker](docs/DOCKER.md) | ઇમેજ, કંપોઝ, વોલ્યુમ માઉન્ટ્સ | +| [આર્કિટેક્ચર](ARCHITECTURE.md) · [ડેવલપમેન્ટ](docs/DEVELOPMENT.md) | અંદરથી તે કેવી રીતે કામ કરે છે; સોર્સમાંથી ચલાવવું | +| [ટેલિમેટ્રી](docs/TELEMETRY.md) | અનામી ઇન્સ્ટોલ અને ડેસ્કટોપ-ઓપન પિંગ્સ, અને તેમને કેવી રીતે બંધ કરવા | -ClawMetry `https://app.clawmetry.com/api/install` પર અનામી -ઇન્સ્ટોલ-લાઇફસાઇકલ પિંગ મોકલે છે: નવા મશીન પર `clawmetry` CLI પ્રથમ -વખત ચલાવો ત્યારે એક `install` પિંગ, નવા વર્ઝન પર અપગ્રેડ કર્યા પછીના -પ્રથમ રનમાં એક `update` પિંગ, અને ડેશબોર્ડની અંદરની ઓનબોર્ડિંગ પસંદગી -પૂર્ણ કરો ત્યારે એક `onboarded` પિંગ. અમે આનો ઉપયોગ વાસ્તવિક ઇન્સ્ટોલ્સ -ગણવા માટે કરીએ છીએ (કાચા PyPI ડાઉનલોડ નંબર્સ ~98% મિરર્સ, CI, અને -ઓટો-અપડેટ ફરીથી-ડાઉનલોડ છે) અને એ જાણવા માટે કે કયા એજન્ટ ફ્રેમવર્ક્સ -અને વર્ઝન્સ ખરેખર ઉપયોગમાં છે. +## સ્ક્રીનશોટ્સ -**દરેક વર્ઝન દીઠ, દરેક લાઇફસાઇકલ ઇવેન્ટ માટે વધુમાં વધુ એક POST**, જેમાં આ સમાયેલું છે: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: ટોકન્સ, સેશન્સ, હેલ્થ | **Brain**: લાઇવ એજન્ટ ઇવેન્ટ સ્ટ્રીમ | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: મોડલ અને સેશન પ્રમાણે | **Approvals**: જોખમી ટૂલ કૉલ્સને ગેટ કરો | -| Field | Example | Why | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id` પર સંગ્રહિત રેન્ડમ UUID | ડિડુપ; તમે સ્પષ્ટપણે Cloud sync કનેક્ટ ન કરો ત્યાં સુધી અનામી (ત્યારબાદ ઓથેન્ટિકેટેડ ડિમન હાર્ટબીટ તેને વહન કરે છે, આ ઇન્સ્ટોલને તમારા એકાઉન્ટ સાથે લિંક કરે છે) | -| `event` | `install` / `update` / `onboarded` | નવું ઇન્સ્ટોલ કે વર્તમાનનું અપગ્રેડ | -| `version` | `0.12.167` | કયા વર્ઝન્સ ઉપયોગમાં છે | -| `os` / `os_version` | `Darwin` / `25.3.0` | પ્લેટફોર્મ સપોર્ટ પ્રાયોરિટીઝ | -| `python` | `3.11.15` | Python વર્ઝન સપોર્ટ મેટ્રિક્સ | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | આગળ કયા એજન્ટ્સ સાથે અમારે ઇન્ટિગ્રેટ કરવું જોઈએ | -| `is_ci` / `ci_provider` | `true` / `github_actions` | માનવ ઇન્સ્ટોલ્સને CI નોઇઝથી અલગ કરો | - -**અમે શું નથી મોકલતા**: IP (ક્લાઉડ સર્વર-સાઇડ પર રિક્વેસ્ટમાંથી -દેશ કોડ મેળવે છે, પછી IP કાઢી નાખે છે), હોસ્ટનેમ, યુઝરનેમ, વર્કસ્પેસ -પાથ, ફાઇલ કન્ટેન્ટ, તમારી api_key, તમારો ઇમેલ, કંઈપણ PII અથવા -વર્કસ્પેસ-સ્પેસિફિક. વાયર પેલોડ -[`clawmetry/telemetry.py`](clawmetry/telemetry.py) માં ઓડિટ કરી શકાય તેવો છે. - -**ઓપ્ટ આઉટ** (આમાંથી કોઈ એક તેને કાયમ માટે નિષ્ક્રિય કરે છે): +વધુ, રનટાઇમ પ્રમાણે: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -અહીં નેટવર્ક નિષ્ફળતા ક્યારેય `clawmetry` ને ચાલવાથી અટકાવતી નથી — -પિંગ ડિમન થ્રેડ પર 3 સેકન્ડ ટાઇમઆઉટ સાથે ફાયર-એન્ડ-ફર્ગેટ છે. - -## Star History +## સ્ટાર ઇતિહાસ @@ -434,13 +108,8 @@ touch ~/.clawmetry/notelemetry # persistent file marker -## License - -MIT +## લાયસન્સ ---- +MIT · [@vivekchand](https://github.com/vivekchand) દ્વારા બનાવવામાં આવ્યું · [clawmetry.com](https://clawmetry.com) -

- 🦞 તમારા એજન્ટને વિચારતું જુઓ
- @vivekchand દ્વારા બનાવેલ · clawmetry.com · OpenClaw ઇકોસિસ્ટમનો ભાગ -

+ diff --git a/docs/i18n/he/README.md b/docs/i18n/he/README.md index ba71a055ea..fd718891d1 100644 --- a/docs/i18n/he/README.md +++ b/docs/i18n/he/README.md @@ -1,430 +1,105 @@ - + > עברית translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**ראה את הסוכן שלך חושב.** תצפיתיות בזמן אמת עבור **20 סביבות ריצה של סוכני AI**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex ועוד 16 נוספות. לוח בקרה אחד לכל צי הסוכנים שלך. +**ראו את הסוכן שלכם חושב.** תצפית בזמן אמת עבור **23 סביבות ריצה של סוכני AI**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex ועוד 19 נוספות. לוח מחוונים אחד לכל צי הסוכנים שלכם. -> 🌐 **קרא זאת ב:** [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/) +> 🌐 **קראו את זה ב:** [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** וזהו, סיימת. +נפתח בכתובת **http://localhost:8900**. אפס הגדרות: הוא מוצא את סביבות הריצה של הסוכנים שכבר מותקנות אצלכם, קורא אותן בקריאה בלבד, ולא משנה דבר באופן שבו הן פועלות. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## עובד עם 20 סביבות ריצה של סוכנים - -ClawMetry החל כתצפיתיות עבור OpenClaw, וכעת מודד את **כל צי הסוכנים שלך** בלוח בקרה אחד, ומזהה אוטומטית כל סביבת ריצה במחשב שלך: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -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 — זרם אירועי סוכן חי -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — שימוש בטוקנים וסיכום הפעלות -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — הזנת קריאות כלים בזמן אמת -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — פירוט עלויות לפי מודל והפעלה -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — דפדפן קבצי סביבת עבודה -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — מצב אבטחה ויומן ביקורת -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — תקרות תקציב, מפעילי שיעור שגיאות, webhooks ל-Slack / Discord / PagerDuty / אימייל -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +## עובד עם 23 סביבות ריצה של סוכנים -### ✋ Approvals — חוסם קריאות כלים מסוכנות מאחורי אישור ידני; כללי הגנה מבוססי מדיניות -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**חסימה לפני ביצוע עבור Claude Code** — פקודה אחת מתקינה -hook מסוג 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 עצמו -(כבר ענית). כלים שלא הותאמו עולים כ־40ms ו -עוברים לזרימת ההרשאות הרגילה של 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 -``` +**חינם באפליקציית הקוד הפתוח:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -## פיתוח Frontend גרסה 2 +**בתוכנית בתשלום:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -אפליקציית ה-React של גרסה 2 נמצאת ב-`frontend/` ומוגשת בכתובת `/v2` כאשר -שרת Flask מופעל עם גרסה 2 מאופשרת. +כל סביבת ריצה מקבלת את אותו לוח המחוונים. הריצו כמה מהן במקביל, ומחליף התצוגה שבכותרת ישנה את ההיקף של כל לשונית לאחת מהן. -השתמש בשני מסופים בזמן הפיתוח: +בניתם את הסוכן שלכם בעצמכם על גבי SDK? המיירט (interceptor) עוקב גם אחרי קריאות ה-LLM שלו. ראו [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -```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 נוספות. - -כדי לבנות את החבילה (bundle) שמסופקת עם חבילת Python: - -```bash -cd frontend -npm run build -``` - -חבילת הייצור נכתבת אל `clawmetry/static/v2/dist/`. - -## תאימות סביבות ריצה / סוכנים +## מה מקבלים -ClawMetry צופה בסביבות ריצה רבות של סוכני AI, לא רק ב-OpenClaw. כל סביבת ריצה שאינה OpenClaw מגיעה עם מתאם קורא (reader adapter) ייעודי שמתרגם את פורמט ההפעלה המקורי שלה לצורות המאוחדות של ClawMetry; הדימון מטמיע אותן לאותו מאגר DuckDB + תמונת מצב ענן (snapshot), מתויגות עם סביבת הריצה, ולשונית שידור ההפעלה (Session replay) מציגה **מחליף סביבת ריצה** כאשר יותר מאחת קיימת. ראה [`docs/compatibility.md`](docs/compatibility.md) למטריצה המלאה + מדריך להוספת סביבות ריצה, ו-[`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) למבוא למשפחת OpenClaw. +- **מפגשים (Sessions) ותמלולים**: מה כל סוכן עשה, תור אחר תור, עם שידור חוזר (replay) +- **עלות וטוקנים**: לפי סביבת ריצה, מודל, מפגש ויום, עם דגלי חריגה +- **Flow**: תרשים חי של הודעות הזורמות דרך ערוצים, מודלים וכלים +- **Brain**: זרם אירועי החשיבה וקריאות הכלים בזמן אמת +- **זיכרון וכישורים**: הקבצים והכישורים שכל סביבת ריצה בפועל טענה +- **בריאות ולוגים**: דיסק, זיכרון, שיעורי שגיאות, מגבלות קצב, זרם לוגים חי +- **התראות**: תקרות תקציב, קפיצות שגיאות, סוכן לא מחובר, מנותבות ל-Slack, Discord, PagerDuty, Telegram, אימייל +- **אישורים**: השהו קריאות כלים מסוכנות *לפני* שהן רצות ואשרו מהטלפון שלכם ([איך](docs/APPROVALS.md)) -מריץ את כלי אבטחת הסוכנים [numbat של Perplexity](https://github.com/perplexityai/numbat)? ClawMetry מטמיע את הממצאים וההחלטות האכיפה שלו ישר מהקופסה, ראה [`docs/NUMBAT.md`](docs/NUMBAT.md). +## תמחור -| סביבת ריצה / סוכן | סטטוס | הערות | +| תוכנית | מה היא כוללת | מחיר | |---|---|---| -| **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`. ריצות זרימות עבודה, ריצות צמתים, פרומפטים של AI Agent, מודל + טוקנים היכן ש-n8n מתעד אותם. | -| **Antigravity** | מתאם בטא | Brain JSONL תחת `~/.gemini//brain/`. שיחות, שלבי כלים, חשיבה, פיצול טוקני Gemini לכל יצירה + עלות, צריכת יצירה ברקע. | -| **GitHub Copilot** | מתאם בטא | ‏Copilot CLI ‏`events.jsonl` תחת `~/.copilot/session-state/` + פנקס השימוש לכל קריאה `session-store.db`. שיחות, קריאות כלים, ניתוב מודלים, פיצול טוקנים מודע-מטמון, עלות אשראי AI מחויבת ספק. | -| **Grok** | מתאם בטא | ‏xAI Grok Build CLI (בינארי Rust תחת `~/.grok/bin/grok`): יומן אירועים גלובלי `~/.grok/logs/unified.jsonl` + לכל הפעלה `~/.grok/sessions///{events.jsonl,summary.json}`. שיחות, פיצול טוקנים לכל תור, ניתוב מודלים, ומטען המאגר היוצא של ה-CLI המאוחסן תחת `~/.grok/upload_queue/` כך שאתה יכול לראות מה יצא מהמחשב שלך. | - -"מתאם בטא" פירושו ש-ClawMetry מספק קורא לפורמט הדיסק האמיתי של סביבת הריצה, כל אחד נבנה + אומת מול התקנה אמיתית על מכונה אמיתית (ראה `tests/fixtures/runtimes//`). המתאמים הם לקריאה בלבד; כל אחד מדויק לגבי מה שסביבת הריצה שלו באמת מאחסנת (למשל PicoClaw/NanoClaw/Cursor לא כותבים עלות טוקנים לדיסק). כאשר מספר סביבות ריצה פועלות על צומת אחד, מחליף סביבת הריצה ממקד את תצוגת ההפעלות לאחת לצלילה נקייה. - -## מעקב אחר כל סוכן SDK — ייחוס עלות מחוץ ללולאה - -סביבות הריצה שלמעלה כולן כותבות הפעלות לדיסק. הסוכן שלך בייצור — זה שבנית על OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, או לולאת `httpx` פשוטה — לא. המיירט ללא הגדרות של ClawMetry עדיין לוכד את קריאות ה-LLM שלו (עלות, טוקנים, זמן תגובה, שגיאות) באמצעות monkey-patching ל-`httpx`/`requests`: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product -``` -``` - -# ...הסוכן שלך רץ כרגיל; כל קריאת LLM נלכדת + מיוחסת כעת. -``` - -`set_source()` (או משתנה הסביבה `CLAWMETRY_SOURCE=support-agent`) מתייג כל קריאה עם **מקור בעל שם**, כך שכל מוצר שאתה מריץ מופיע כשורה עצמאית ובעלת ייחוס עלות משלו בכרטיס **🔌 מקורות מחוץ ללולאה** של הלוח בלשונית Overview, קריאות, ספקים, זמן תגובה, שיעור שגיאות לכל סוכן. לא הוגדר מקור? הקריאות עדיין נעקבות, הכרטיס פשוט נשאר מוסתר. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -זוהי אותה שכבת נתונים שמזינים מתאמי סביבת הריצה (DuckDB ← תמונת מצב ענן), כך שמקורות מחוץ ללולאה מסתנכרנים ללוח הענן בדיוק כמו כל השאר, מוצפנים מקצה לקצה. - -## OpenTelemetry — ניטרלי ספק, שלח את המעקבים שלך לכל מקום - -ClawMetry דובר **OpenTelemetry** בשני הכיוונים, תוך שימוש ב**מוסכמות סמנטיות GenAI**, כך שמעקבי הסוכן שלך לעולם לא נעולים לכלי אחד. +| **Free** | OpenClaw + NVIDIA NemoClaw, לוח מחוונים מלא, מקומי בלבד | $0 | +| **Starter** | כל סביבת ריצה נוספת מהרשימה למעלה, תצוגת צי, סנכרון ענן | $9 לצומת / חודש | +| **Pro** | Starter + ממשל: אישורים, מדיניות סיכון כלים, הערכות (evals), זיהוי חריגות, מייעל עלויות, ייצוא OTel | $19 לצומת / חודש | -**ייצוא** של כל הפעלה, קריאות LLM, כלים, תת-סוכנים, טוקנים, עלות, כ-spans מסוג GenAI תחת OTLP/HTTP לכל אספן (Datadog, Grafana, Honeycomb, או ה-OTel Collector שלך): +תוכניות שנתיות, Enterprise והמספרים העדכניים נמצאים ב־ +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. מפתחות רישיון בהתקנה עצמית +פועלים ללא הענן (`clawmetry license`). החלוקה המדויקת בין חינמי לבתשלום נמצאת +ב־[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -כותרות אימות ומרווח הבדיקה הם משתני סביבה אופציונליים: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` +## הנתונים שלכם נשארים במחשב שלכם -**ייבוא** — קולט ה-OTLP המובנה מקבל מעקבים, יומנים ומדדים מכל דבר אחר בכתובות `/v1/traces`, `/v1/logs` ו-`/v1/metrics`. הפנה כל אפליקציה עם מכשור OpenTelemetry אליו: +ClawMetry קורא קבצי מפגש ולוגים מקומיים. שום דבר לא עוזב את המחשב שלכם אלא אם כן +תריצו `clawmetry connect`. גם אז, התמונה (snapshot) מוצפנת מקצה לקצה +עם מפתח שלעולם לא עוזב את המחשב שלכם, ומפוענחת בדפדפן שלכם. -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -מעקבי ויומני OTLP/JSON עובדים על `pip install clawmetry` פשוט, ללא תוספות. ייבוא Protobuf (ומדדי OTLP/JSON) דורש `pip install clawmetry[otel]`. אפליקציה שמגדירה `service.name` משלה מופיעה כסוכן עצמאי משלה במחליף סביבת הריצה, עם העלות והטוקנים שלה. - -אתה מקבל את לוח הבקרה של ClawMetry ללא הגדרות, מקומי-תחילה **וגם** את הנתונים שלך בכל backend שהצוות שלך כבר מריץ, ללא נעילה, ללא סוכן שני להתקין. - -## הגדרות - -רוב האנשים לא צריכים הגדרות כלל. ClawMetry מזהה אוטומטית את סביבת העבודה, היומנים, ההפעלות וה-crons שלך. - -אם אתה כן צריך להתאים אישית: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -כל האפשרויות: `clawmetry --help` - -## ערוצים נתמכים - -ClawMetry מציג פעילות חיה עבור כל ערוץ OpenClaw שהגדרת. רק ערוצים שבאמת מוגדרים ב-`openclaw.json` שלך מופיעים בתרשים Flow, ערוצים לא מוגדרים מוסתרים אוטומטית. - -לחץ על כל צומת ערוץ ב-Flow כדי לראות תצוגת בועות צ'אט חיה עם ספירת הודעות נכנסות/יוצאות. - -| ערוץ | סטטוס | חלונית קופצת חיה | הערות | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ מלא | ✅ | הודעות, סטטיסטיקות, רענון כל 10 שניות | -| 💬 **iMessage** | ✅ מלא | ✅ | קורא ישירות מ-`~/Library/Messages/chat.db` | -| 💚 **WhatsApp** | ✅ מלא | ✅ | דרך WhatsApp Web ‏(Baileys) | -| 🔵 **Signal** | ✅ מלא | ✅ | דרך signal-cli | -| 🟣 **Discord** | ✅ מלא | ✅ | זיהוי גילדה + ערוץ | -| 🟪 **Slack** | ✅ מלא | ✅ | זיהוי סביבת עבודה + ערוץ | -| 🌐 **Webchat** | ✅ מלא | ✅ | הפעלות ממשק אינטרנט מובנה | -| 📡 **IRC** | ✅ מלא | ✅ | ממשק בועות בסגנון טרמינל | -| 🍏 **BlueBubbles** | ✅ מלא | ✅ | iMessage דרך ה-API של BlueBubbles REST | -| 🔵 **Google Chat** | ✅ מלא | ✅ | דרך webhooks של Chat API | -| 🟣 **MS Teams** | ✅ מלא | ✅ | דרך תוסף בוט Teams | -| 🔷 **Mattermost** | ✅ מלא | ✅ | צ'אט צוות בהתקנה עצמית | -| 🟩 **Matrix** | ✅ מלא | ✅ | מבוזר, תמיכת E2EE | -| 🟢 **LINE** | ✅ מלא | ✅ | ‏LINE Messaging API | -| ⚡ **Nostr** | ✅ מלא | ✅ | הודעות פרטיות מבוזרות NIP-04 | -| 🟣 **Twitch** | ✅ מלא | ✅ | צ'אט דרך חיבור IRC | -| 🔷 **Feishu/Lark** | ✅ מלא | ✅ | הרשמת אירועי WebSocket | -| 🔵 **Zalo** | ✅ מלא | ✅ | ‏Zalo Bot API | - -> **זיהוי אוטומטי:** ClawMetry קורא את `~/.openclaw/openclaw.json` שלך ומציג רק את הערוצים שהגדרת בפועל. אין צורך בהגדרה ידנית. - -## פריסת Docker - -רוצה להריץ את ClawMetry בקונטיינר? אין בעיה! 🐳 - -**התחלה מהירה עם Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**דוגמת Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **הערה:** בעת הרצה ב-Docker, הרכב את תיקיות הנתונים + היומנים של הסוכן שלך (למשל `~/.openclaw`, `~/.claude`, `~/.codex`) כך ש-ClawMetry יוכל לזהות את ההגדרה שלך אוטומטית. - -## דרישות - -- Python 3.8+‎ -- Flask (מותקן אוטומטית דרך pip) -- סביבת ריצה של סוכן AI על אותו מחשב: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, או QM (או כרכי דיסק (volumes) מוצמדים עבור Docker) -- Linux או macOS - -## תמיכה ב-NemoClaw / OpenShell - -ClawMetry מזהה אוטומטית את [NemoClaw](https://github.com/NVIDIA/NemoClaw), עטיפת האבטחה הארגונית של NVIDIA עבור OpenClaw שמריצה סוכנים בתוך קונטיינרי OpenShell מבודדים (sandboxed). - -ברוב המקרים לא נדרשת הגדרה נוספת. דימון הסנכרון מגלה אוטומטית קבצי הפעלה בין אם הם ממוקמים ב-`~/.openclaw/` על המארח או בתוך קונטיינר OpenShell. - -### איך זה עובד - -ClawMetry מזהה NemoClaw בשתי דרכים: - -1. **זיהוי בינארי** — בודק אם קיים ה-CLI של `nemoclaw` ומריץ `nemoclaw status` כדי לקבל מידע על ה-sandbox -2. **זיהוי קונטיינר** — סורק קונטיינרי Docker פעילים בחיפוש אחר תמונות `openshell`, `nemoclaw`, או `ghcr.io/nvidia/`, ואז קורא הפעלות דרך הרכבות כרך או `docker cp` - -קבצי הפעלה שסונכרנו מקונטיינרי NemoClaw מתויגים עם `runtime=nemoclaw` ומטא-נתוני `container_id` בלוח הענן, כך שתוכל להבחין ביניהם לבין הפעלות OpenClaw רגילות במבט חטוף. - -### הגדרה מומלצת: דימון הסנכרון על ה-HOST - -לחוויה הטובה ביותר, הרץ את דימון הסנכרון של ClawMetry על **מכונת המארח** (לא בתוך ה-sandbox). כך נמנעים ממגבלות מדיניות הרשת של NemoClaw. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -דימון הסנכרון ימצא אוטומטית הפעלות בתוך כל קונטיינר OpenShell פעיל. - -### אופציונלי: שם sandbox מפורש - -אם הזיהוי האוטומטי לא עובד, הפנה את ClawMetry ל-sandbox הנכון: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### הרצה בתוך ה-sandbox (מתקדם) - -אם עליך להריץ את דימון הסנכרון **בתוך** ה-sandbox של OpenShell, הוסף את כלל היציאה (egress) הזה למדיניות הרשת של NemoClaw כדי שיוכל להגיע ל-API הקליטה של ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -החל עם: +## התקנה ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # ואז: clawmetry ``` -### יציאות ונקודות קצה - -| נקודת קצה | יציאה | פרוטוקול | נדרש | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | כן (דימון הסנכרון ← ענן) | -| `localhost:8900` | 8900 | HTTP | כן (ממשק לוח הבקרה המקומי) | -| שקע Docker (`/var/run/docker.sock`) | — | Unix socket | לגילוי הפעלות בקונטיינר | - -דימון הסנכרון מבצע רק קריאות HTTPS יוצאות אל `ingest.clawmetry.com`. לא נדרשות יציאות נכנסות. - ---- - -## פריסת ענן - -ראה את **[מדריך בדיקת הענן](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** עבור מנהרות SSH, פרוקסי הפוך, ו-Docker. +או בשורת פקודה אחת: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -## בדיקות +דורש Python 3.8+ במערכת macOS, Linux או Windows, ולפחות סביבת ריצה אחת של סוכן על +אותו מחשב. הוראות Docker: [docs/DOCKER.md](docs/DOCKER.md). -הפרויקט הזה נבדק עם BrowserStack. +## תיעוד -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +| | | +|---|---| +| [תאימות סביבות ריצה](docs/compatibility.md) | מה כל מתאם קורא, וכיצד להוסיף סביבת ריצה | +| [הרשאות (Entitlements)](docs/ENTITLEMENTS.md) | חינמי מול בתשלום, מטריצת דרגות, CLI לרישיון | +| [אישורים ומדיניות](docs/APPROVALS.md) | חסימה טרם ביצוע, ניקוד סיכון, אישורים מהטלפון | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | ייצוא traces לכל מקום, קליטת OTLP מכל מקור | +| [מעקב SDK](docs/SDK_TRACKING.md) | ייחוס עלויות עבור סוכנים שבניתם בעצמכם | +| [ערוצי צ'אט](docs/CHANNELS.md) | מתאמי הצ'אט המוצגים ב-Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | הגדרות NVIDIA NemoClaw בארגז חול (sandboxed) | +| [Docker](docs/DOCKER.md) | תמונה, compose, הצמדות נפח (volume mounts) | +| [ארכיטקטורה](ARCHITECTURE.md) · [פיתוח](docs/DEVELOPMENT.md) | איך זה עובד מבפנים; הרצה מהמקור | +| [טלמטריה](docs/TELEMETRY.md) | פינגי ההתקנה האנונימיים ופתיחת שולחן העבודה, וכיצד לכבות אותם | -## טלמטריה - -ClawMetry שולח פינגים אנונימיים של מחזור חיי ההתקנה אל -`https://app.clawmetry.com/api/install`: פינג `install` אחד בפעם הראשונה -שאתה מריץ את ה-CLI של `clawmetry` על מכונה חדשה, פינג `update` אחד -בהרצה הראשונה לאחר שדרוג לגרסה חדשה, ופינג `onboarded` אחד -כשאתה משלים את בחירת ההצטרפות בלוח הבקרה. אנחנו משתמשים בזה -כדי לספור התקנות אמיתיות (מספרי ההורדות הגולמיים מ-PyPI הם כ-98% מראות, CI, -והורדות חוזרות של עדכון אוטומטי) וכדי ללמוד אילו מסגרות סוכנים -וגרסאות באמת נמצאות בשטח. - -**לכל היותר POST אחד לכל אירוע מחזור חיים לכל גרסה**, המכיל: - -| שדה | דוגמה | למה | -|---|---|---| -| `install_id` | UUID אקראי שמאוחסן ב-`~/.clawmetry/install_id` | מניעת כפילויות; אנונימי עד שאתה מחבר במפורש סנכרון ענן (פעימת הלב המאומתת של הדימון אז נושאת אותו, ומקשרת את ההתקנה הזו לחשבון שלך) | -| `event` | `install` / `update` / `onboarded` | התקנה חדשה לעומת שדרוג של קיימת | -| `version` | `0.12.167` | אילו גרסאות נמצאות בשטח | -| `os` / `os_version` | `Darwin` / `25.3.0` | סדרי עדיפות תמיכת פלטפורמה | -| `python` | `3.11.15` | מטריצת תמיכת גרסאות Python | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | עם אילו סוכנים כדאי לנו להשתלב הבא | -| `is_ci` / `ci_provider` | `true` / `github_actions` | הפרדת התקנות אנושיות מרעש CI | - -**מה שאנחנו לא שולחים**: כתובת IP (הענן גוזר את קוד המדינה בצד השרת -מהבקשה, ואז משליך את כתובת ה-IP), שם מארח, שם משתמש, נתיב סביבת עבודה, -תוכן קבצים, מפתח ה-API שלך, האימייל שלך, כל דבר שהוא מזהה אישית או -ספציפי לסביבת עבודה. מטען הרשת (wire payload) ניתן לביקורת ב- -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**לבטל השתתפות** (כל אחת מהאפשרויות הבאות תבטל זאת לצמיתות): +## צילומי מסך -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: טוקנים, מפגשים, בריאות | **Brain**: זרם אירועי הסוכן החי | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **עלות**: לפי מודל ומפגש | **אישורים**: חסימת קריאות כלים מסוכנות | -כשל רשת כאן לעולם לא חוסם את `clawmetry` מלרוץ, הפינג -הוא ירי-ושכח (fire-and-forget) ב-thread נפרד עם timeout של 3 שניות. +עוד, לפי סביבת ריצה: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## היסטוריית כוכבים @@ -438,11 +113,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## רישיון -MIT - ---- +MIT · נבנה על ידי [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 ראה את הסוכן שלך חושב
- נבנה על ידי @vivekchand · clawmetry.com · חלק מהמערכת האקולוגית של OpenClaw -

+ diff --git a/docs/i18n/hi/README.md b/docs/i18n/hi/README.md index 5e0a1ae40f..697441feef 100644 --- a/docs/i18n/hi/README.md +++ b/docs/i18n/hi/README.md @@ -1,430 +1,110 @@ - + > हिन्दी translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**अपने एजेंट को सोचते हुए देखें।** **20 AI एजेंट रनटाइम** के लिए रीयल-टाइम ऑब्ज़र्वेबिलिटी: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex और 16 और। आपके पूरे एजेंट फ़्लीट के लिए एक ही डैशबोर्ड। +**अपने एजेंट को सोचते हुए देखें।** **23 AI एजेंट रनटाइम** के लिए रीयल-टाइम ऑब्ज़र्वेबिलिटी: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex और 19 अन्य। आपके पूरे एजेंट फ़्लीट के लिए एक ही डैशबोर्ड। > 🌐 **इसे इन भाषाओं में पढ़ें:** [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** पर खुलता है और बस, हो गया। +यह **http://localhost:8900** पर खुलता है। शून्य कॉन्फ़िगरेशन: यह उन एजेंट रनटाइम को ढूंढ लेता है जो आपके पास पहले से हैं, उन्हें केवल-पढ़ने (read-only) के तौर पर पढ़ता है, और वे कैसे चलते हैं उसमें कुछ नहीं बदलता। ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 20 एजेंट रनटाइम के साथ काम करता है - -ClawMetry की शुरुआत OpenClaw के लिए ऑब्ज़र्वेबिलिटी के रूप में हुई थी, और अब यह एक ही डैशबोर्ड में आपके **पूरे एजेंट फ़्लीट** को मीटर करता है, आपकी मशीन पर हर रनटाइम को अपने आप पहचानते हुए: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw और NemoClaw ओपन-सोर्स ऐप में मुफ़्त हैं; बाकी रनटाइम ClawMetry Cloud या सेल्फ़-होस्टेड Pro लाइसेंस के साथ सक्रिय होते हैं। हेडर से रनटाइम बदलें और हर टैब — कॉस्ट, टोकन, टूल्स, ट्रेसेस — उस रनटाइम पर फिर से स्कोप हो जाता है। सटीक फ़्री/पेड बंटवारे, टियर मैट्रिक्स, `/api/entitlement` शेप, और `clawmetry license` CLI के लिए **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** देखें। - -## आपको क्या मिलता है - -- **Flow** — चैनलों, ब्रेन, टूल्स से होकर बहते और वापस लौटते संदेशों को दिखाने वाला लाइव एनिमेटेड डायग्राम -- **Overview** — हेल्थ चेक, एक्टिविटी हीटमैप, सेशन काउंट, मॉडल जानकारी -- **Usage** — डेली/वीकली/मंथली ब्रेकडाउन के साथ टोकन और कॉस्ट ट्रैकिंग -- **Sessions** — मॉडल, टोकन, अंतिम एक्टिविटी के साथ सक्रिय एजेंट सेशन -- **Crons** — स्टेटस, अगला रन, अवधि के साथ शेड्यूल्ड जॉब्स -- **Logs** — कलर-कोडेड रीयल-टाइम लॉग स्ट्रीमिंग -- **Memory** — SOUL.md, MEMORY.md, AGENTS.md, डेली नोट्स ब्राउज़ करें -- **Transcripts** — सेशन हिस्ट्री पढ़ने के लिए चैट-बबल UI -- **Alerts** — बजट कैप, एरर-रेट ट्रिगर, एजेंट-ऑफ़लाइन डिटेक्शन; Slack, Discord, PagerDuty, Telegram, Email पर रूट होता है -- **Approvals** — विनाशकारी डिलीट, फ़ोर्स पुश, DB म्यूटेशन, sudo, पैकेज इंस्टॉल, नेटवर्क कॉल को एक-क्लिक साइन-ऑफ़ के पीछे गेट करें - -## स्क्रीनशॉट्स - -### 🧠 Brain — लाइव एजेंट इवेंट स्ट्रीम -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — टोकन उपयोग और सेशन सारांश -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — रीयल-टाइम टूल कॉल फ़ीड -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — मॉडल और सेशन के अनुसार कॉस्ट ब्रेकडाउन -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — वर्कस्पेस फ़ाइल ब्राउज़र -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — पोस्चर और ऑडिट लॉग -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — बजट कैप, एरर-रेट ट्रिगर, Slack / Discord / PagerDuty / Email को वेबहुक्स -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — जोखिम भरे टूल कॉल्स को मैन्युअल साइन-ऑफ़ के पीछे गेट करें; पॉलिसी-समर्थित सुरक्षा नियम -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**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 -``` - -एक deny सिर्फ़ उसी एक टूल कॉल को ब्लॉक करता है — एजेंट अपना सेशन बनाए रखता है और -कोई और तरीक़ा आज़मा सकता है। अपने फ़ोन पर अप्रूव करना Claude Code के अपने -परमिशन प्रॉम्प्ट को स्किप कर देता है (आप पहले ही जवाब दे चुके हैं)। बिना मिलान वाले टूल्स -की लागत ~40ms होती है और वे 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 फ़्रंटएंड डेवलपमेंट - -v2 React ऐप `frontend/` में रहता है और `/v2` पर सर्व होता है जब Flask -सर्वर को v2 सक्षम करके शुरू किया जाता है। - -डेवलपमेंट के दौरान दो टर्मिनल इस्तेमाल करें: - -```bash -# Terminal 1: Flask API/server on :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## 23 एजेंट रनटाइम के साथ काम करता है -```bash -# Terminal 2: Vite dev server on :5173 -cd frontend -nvm use -npm ci -npm run dev -``` +**ओपन सोर्स ऐप में मुफ़्त:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -`http://localhost:5173/v2/` खोलें। Vite `/api` रिक्वेस्ट्स को -`http://localhost:8900` पर प्रॉक्सी करता है, ताकि React ऐप बिना अतिरिक्त -CORS सेटअप के लोकल Flask सर्वर से बात कर सके। +**पेड प्लान पर:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -Python पैकेज के साथ शिप होने वाला बंडल बनाने के लिए: - -```bash -cd frontend -npm run build -``` +हर रनटाइम को एक जैसा डैशबोर्ड मिलता है। एक साथ कई रनटाइम चलाएँ और हेडर का +स्विचर हर टैब को उनमें से किसी एक पर फिर से स्कोप कर देता है। -प्रोडक्शन बंडल `clawmetry/static/v2/dist/` में लिखा जाता है। +अपना खुद का एजेंट किसी SDK पर बनाया है? इंटरसेप्टर उसकी LLM कॉल्स को भी +ट्रैक करता है। देखें [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md)। -## रनटाइम / एजेंट संगतता +## आपको क्या मिलता है -ClawMetry केवल OpenClaw ही नहीं, बल्कि कई AI-एजेंट रनटाइम को ऑब्ज़र्व करता है। हर गैर-OpenClaw रनटाइम एक समर्पित रीडर एडाप्टर शिप करता है जो उसके नेटिव सेशन फ़ॉर्मैट को ClawMetry के यूनिफ़ाइड शेप्स में बदलता है; डेमन इन्हें उसी DuckDB स्टोर + क्लाउड स्नैपशॉट में इनजेस्ट करता है, रनटाइम के साथ टैग किया हुआ, और जब एक से अधिक रनटाइम मौजूद हों तो Session replay टैब में एक **रनटाइम स्विचर** दिखता है। पूरे मैट्रिक्स + रनटाइम जोड़ने की गाइड के लिए [`docs/compatibility.md`](docs/compatibility.md) देखें, और OpenClaw-फ़ैमिली प्राइमर के लिए [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) देखें। +- **सेशन और ट्रांसक्रिप्ट**: हर एजेंट ने क्या किया, बारी-बारी से, रीप्ले के साथ +- **लागत और टोकन**: रनटाइम, मॉडल, सेशन और दिन के अनुसार, एनोमली फ़्लैग के साथ +- **फ़्लो**: चैनल, मॉडल और टूल्स के बीच चल रहे मैसेज का लाइव डायग्राम +- **ब्रेन**: तर्क और टूल-कॉल इवेंट स्ट्रीम, ठीक जैसे-जैसे यह हो रहा है +- **मेमोरी और स्किल्स**: वे फ़ाइलें और स्किल्स जो हर रनटाइम ने वास्तव में लोड कीं +- **हेल्थ और लॉग्स**: डिस्क, मेमोरी, एरर रेट, रेट लिमिट, लाइव लॉग स्ट्रीम +- **अलर्ट**: बजट कैप, एरर स्पाइक, एजेंट-ऑफ़लाइन, Slack, Discord, PagerDuty, Telegram, Email को रूट किए गए +- **अप्रूवल**: जोखिम भरी टूल कॉल्स को चलने *से पहले* रोकें और अपने फ़ोन से अप्रूव करें ([कैसे](docs/APPROVALS.md)) -[Perplexity का numbat](https://github.com/perplexityai/numbat) एजेंट-सिक्योरिटी टूल चला रहे हैं? ClawMetry इसकी फ़ाइंडिंग्स और एनफ़ोर्समेंट डिसीज़न्स को बिना किसी अतिरिक्त सेटअप के इनजेस्ट करता है — देखें [`docs/NUMBAT.md`](docs/NUMBAT.md)। +## मूल्य निर्धारण -| रनटाइम / एजेंट | स्टेटस | नोट्स | +| प्लान | यह क्या कवर करता है | कीमत | |---|---|---| -| **OpenClaw** | Native | संदर्भ रनटाइम, अपने आप पहचाना जाता है | -| **PicoClaw** | Beta adapter | फ़्लैट `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`)। ट्रांसक्रिप्ट्स, मॉडल, टूल कॉल्स। | -| **NanoClaw** | Beta adapter | प्रति-सेशन SQLite (`data/v2-sessions`)। ट्रांसक्रिप्ट्स + संदेश गिनती। | -| **Hermes** | Beta adapter | SQLite `~/.hermes/state.db`। ट्रांसक्रिप्ट्स, मॉडल, टोकन/कॉस्ट। | -| **Claude Code** | Beta adapter | JSONL `~/.claude/projects/.../.jsonl`। ट्रांसक्रिप्ट्स, मॉडल, टूल कॉल्स + थिंकिंग, टोकन उपयोग। | -| **Codex** | Beta adapter | Rollout JSONL `~/.codex/sessions/...`। ट्रांसक्रिप्ट्स, मॉडल, टूल कॉल्स, टोकन उपयोग। | -| **Cursor** | Beta adapter | SQLite `state.vscdb`। चैट/कंपोज़र ट्रांसक्रिप्ट्स, मॉडल। | -| **Aider** | Beta adapter | प्रति-प्रोजेक्ट `.aider.chat.history.md`। ट्रांसक्रिप्ट्स, मॉडल, टोकन गिनती। | -| **Goose** | Beta adapter | SQLite `~/.local/share/goose`। ट्रांसक्रिप्ट्स, मॉडल, टूल कॉल्स, टोकन योग। | -| **opencode** | Beta adapter | SQLite `~/.local/share/opencode`। ट्रांसक्रिप्ट्स, मॉडल, टूल कॉल्स, टोकन + कॉस्ट। | -| **Qwen Code** | Beta adapter | JSONL `~/.qwen/projects/.../chats`। ट्रांसक्रिप्ट्स, मॉडल, टूल कॉल्स, टोकन उपयोग। | -| **Pi** | Beta adapter | JSONL `~/.pi/agent/sessions`। ट्रांसक्रिप्ट्स, मॉडल, टूल कॉल्स, टोकन + कॉस्ट। | -| **Deep Agents** | Beta adapter | SQLite `~/.deepagents/.state/sessions.db`। ट्रांसक्रिप्ट्स, मॉडल, टूल कॉल्स, टोकन + कॉस्ट। | -| **n8n** | Beta adapter | SQLite `~/.n8n/database.sqlite`। वर्कफ़्लो एग्ज़ीक्यूशन, नोड रन, AI Agent प्रॉम्प्ट्स, जहाँ n8n रिकॉर्ड करता है वहाँ मॉडल + टोकन। | -| **Antigravity** | Beta adapter | `~/.gemini//brain/` के अंतर्गत ब्रेन JSONL। बातचीत, टूल स्टेप्स, थिंकिंग, प्रति-जनरेशन Gemini टोकन विभाजन + कॉस्ट, बैकग्राउंड-जनरेशन बर्न। | -| **GitHub Copilot** | Beta adapter | `~/.copilot/session-state/` के अंतर्गत Copilot CLI `events.jsonl` + प्रति-कॉल उपयोग लेजर `session-store.db`। बातचीत, टूल कॉल्स, मॉडल रूटिंग, कैश-अवेयर टोकन विभाजन, वेंडर-बिल्ड AI-क्रेडिट कॉस्ट। | -| **Grok** | Beta adapter | xAI Grok Build CLI (`~/.grok/bin/grok` के अंतर्गत Rust बाइनरी): ग्लोबल इवेंट लॉग `~/.grok/logs/unified.jsonl` + प्रति-सेशन `~/.grok/sessions///{events.jsonl,summary.json}`। बातचीत, प्रति-टर्न टोकन विभाजन, मॉडल रूटिंग, और CLI का आउटबाउंड रीपो पेलोड जो `~/.grok/upload_queue/` में स्टेज होता है ताकि आप देख सकें कि आपकी मशीन से क्या बाहर गया। | - -"Beta adapter" का मतलब है कि ClawMetry उस रनटाइम के असल ऑन-डिस्क फ़ॉर्मैट के लिए एक रीडर शिप करता है, हर एक को असल मशीन पर असल इंस्टॉल के ख़िलाफ़ बनाया और सत्यापित किया गया है (देखें `tests/fixtures/runtimes//`)। एडाप्टर रीड-ओनली हैं; हर एक इस बारे में ईमानदार है कि उसका रनटाइम असल में क्या स्टोर करता है (उदाहरण के लिए PicoClaw/NanoClaw/Cursor डिस्क पर टोकन कॉस्ट नहीं लिखते)। जब एक नोड पर कई रनटाइम चल रहे हों, तो रनटाइम स्विचर एक साफ़ डीप-डाइव के लिए सेशन व्यू को एक ही रनटाइम पर स्कोप कर देता है। - -## किसी भी SDK एजेंट को ट्रैक करें — आउट-लूप कॉस्ट अट्रिब्यूशन - -ऊपर बताए गए सभी रनटाइम सेशन को डिस्क पर लिखते हैं। आपका अपना **प्रोडक्शन एजेंट** — वह जो आपने OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, या एक साधारण `httpx` लूप पर बनाया है — ऐसा नहीं करता। ClawMetry का ज़ीरो-कॉन्फ़िग इंटरसेप्टर फिर भी `httpx`/`requests` को मंकी-पैच करके इसके LLM कॉल्स (कॉस्ट, टोकन, लेटेंसी, एरर) कैप्चर कर लेता है: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (या `CLAWMETRY_SOURCE=support-agent` एनवायरनमेंट वेरिएबल) हर कॉल को एक **नामित सोर्स** से टैग करता है, ताकि आपके द्वारा चलाया जाने वाला हर प्रोडक्ट डैशबोर्ड के Overview पर मौजूद **🔌 आउट-लूप सोर्स** कार्ड में अपनी ख़ुद की, प्रथम-श्रेणी की, कॉस्ट-अट्रिब्यूटेबल लाइन के रूप में दिखे — प्रति-एजेंट कॉल्स, प्रोवाइडर, लेटेंसी, एरर रेट। कोई सोर्स सेट नहीं किया? कॉल्स फिर भी ट्रैक होती हैं; बस कार्ड छिपा रहता है। - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -यह वही डेटा लेयर है जो रनटाइम एडाप्टर्स को फ़ीड करती है (DuckDB → क्लाउड स्नैपशॉट), इसलिए आउट-लूप सोर्स बाक़ी सब चीज़ों की तरह ही, E2E-एन्क्रिप्टेड रूप में क्लाउड डैशबोर्ड से सिंक होते हैं। - -## OpenTelemetry — वेंडर-न्यूट्रल, अपने ट्रेस कहीं भी भेजें - -ClawMetry दोनों दिशाओं में **OpenTelemetry** बोलता है, **GenAI सिमैंटिक कन्वेंशन्स** का उपयोग करते हुए, ताकि आपके एजेंट ट्रेस कभी भी किसी एक टूल में लॉक-इन न हों। - -हर सेशन — LLM कॉल्स, टूल्स, सब-एजेंट्स, टोकन, कॉस्ट — को किसी भी कलेक्टर (Datadog, Grafana, Honeycomb, या आपका अपना OTel Collector) में OTLP/HTTP GenAI स्पैन के रूप में **एक्सपोर्ट** करें: - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -ऑथ हेडर और पोल इंटरवल वैकल्पिक एनवायरनमेंट वेरिएबल हैं: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**इनजेस्ट** — बिल्ट-इन OTLP रिसीवर `/v1/traces`, `/v1/logs`, और `/v1/metrics` पर किसी भी अन्य स्रोत से ट्रेस, लॉग, और मेट्रिक्स स्वीकार करता है। किसी भी OpenTelemetry-इंस्ट्रुमेंटेड ऐप को इसकी ओर पॉइंट करें: +| **Free** | OpenClaw + NVIDIA NemoClaw, पूरा डैशबोर्ड, केवल लोकल | $0 | +| **Starter** | ऊपर बताया हर दूसरा रनटाइम, फ़्लीट व्यू, क्लाउड सिंक | $9 प्रति नोड / महीना | +| **Pro** | Starter + गवर्नेंस: अप्रूवल, टूल-रिस्क पॉलिसी, इवैल्स, एनोमली डिटेक्शन, कॉस्ट ऑप्टिमाइज़र, OTel एक्सपोर्ट | $19 प्रति नोड / महीना | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON ट्रेस और लॉग एक सामान्य `pip install clawmetry` पर बिना किसी एक्स्ट्रा के काम करते हैं। Protobuf इनजेस्ट (और OTLP/JSON मेट्रिक्स) के लिए `pip install clawmetry[otel]` चाहिए। जो ऐप अपना ख़ुद का `service.name` सेट करता है वह रनटाइम स्विचर में अपने ख़ुद के एजेंट के रूप में, अपने कॉस्ट और टोकन के साथ दिखता है। - -आपको ज़ीरो-कॉन्फ़िग, लोकल-फ़र्स्ट ClawMetry डैशबोर्ड **और** आपकी टीम जो भी बैकएंड पहले से चलाती है उसमें आपका डेटा **दोनों** मिलते हैं — कोई लॉक-इन नहीं, कोई दूसरा एजेंट इंस्टॉल करने की ज़रूरत नहीं। - -## कॉन्फ़िगरेशन - -ज़्यादातर लोगों को किसी कॉन्फ़िगरेशन की ज़रूरत नहीं पड़ती। ClawMetry आपके वर्कस्पेस, लॉग, सेशन, और cron को अपने आप पहचान लेता है। - -अगर आपको कस्टमाइज़ करने की ज़रूरत है: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -सभी विकल्प: `clawmetry --help` - -## समर्थित चैनल - -ClawMetry आपके द्वारा कॉन्फ़िगर किए गए हर OpenClaw चैनल के लिए लाइव एक्टिविटी दिखाता है। सिर्फ़ वही चैनल जो आपके `openclaw.json` में असल में सेट अप हैं वे Flow डायग्राम में दिखते हैं — जो कॉन्फ़िगर नहीं हैं वे अपने आप छिपे रहते हैं। - -Flow में किसी भी चैनल नोड पर क्लिक करने पर आने वाले/जाने वाले संदेशों की गिनती के साथ एक लाइव चैट बबल व्यू दिखता है। - -| चैनल | स्टेटस | लाइव पॉपअप | नोट्स | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Full | ✅ | संदेश, आँकड़े, 10s रिफ़्रेश | -| 💬 **iMessage** | ✅ Full | ✅ | सीधे `~/Library/Messages/chat.db` पढ़ता है | -| 💚 **WhatsApp** | ✅ Full | ✅ | WhatsApp Web (Baileys) के ज़रिए | -| 🔵 **Signal** | ✅ Full | ✅ | signal-cli के ज़रिए | -| 🟣 **Discord** | ✅ Full | ✅ | गिल्ड + चैनल डिटेक्शन | -| 🟪 **Slack** | ✅ Full | ✅ | वर्कस्पेस + चैनल डिटेक्शन | -| 🌐 **Webchat** | ✅ Full | ✅ | बिल्ट-इन वेब UI सेशन | -| 📡 **IRC** | ✅ Full | ✅ | टर्मिनल-स्टाइल बबल UI | -| 🍏 **BlueBubbles** | ✅ Full | ✅ | BlueBubbles REST API के ज़रिए iMessage | -| 🔵 **Google Chat** | ✅ Full | ✅ | Chat API वेबहुक्स के ज़रिए | -| 🟣 **MS Teams** | ✅ Full | ✅ | Teams बॉट प्लगइन के ज़रिए | -| 🔷 **Mattermost** | ✅ Full | ✅ | सेल्फ़-होस्टेड टीम चैट | -| 🟩 **Matrix** | ✅ Full | ✅ | डीसेंट्रलाइज़्ड, E2EE समर्थन | -| 🟢 **LINE** | ✅ Full | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Full | ✅ | डीसेंट्रलाइज़्ड NIP-04 DM | -| 🟣 **Twitch** | ✅ Full | ✅ | IRC कनेक्शन के ज़रिए चैट | -| 🔷 **Feishu/Lark** | ✅ Full | ✅ | WebSocket इवेंट सब्सक्रिप्शन | -| 🔵 **Zalo** | ✅ Full | ✅ | Zalo Bot API | - -> **ऑटो-डिटेक्शन:** ClawMetry आपकी `~/.openclaw/openclaw.json` पढ़ता है और सिर्फ़ वही चैनल रेंडर करता है जो आपने असल में कॉन्फ़िगर किए हैं। किसी मैनुअल सेटअप की ज़रूरत नहीं। - -## Docker डिप्लॉयमेंट - -ClawMetry को कंटेनर में चलाना चाहते हैं? कोई बात नहीं! 🐳 - -**Docker के साथ क्विक स्टार्ट:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose उदाहरण:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **नोट:** Docker में चलाते समय, अपने एजेंट की डेटा + लॉग डायरेक्टरी माउंट करें (जैसे `~/.openclaw`, `~/.claude`, `~/.codex`) ताकि ClawMetry आपके सेटअप को अपने आप पहचान सके। - -## आवश्यकताएँ - -- Python 3.8+ -- Flask (pip के ज़रिए अपने आप इंस्टॉल हो जाता है) -- उसी मशीन पर एक AI एजेंट रनटाइम: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, या QM (या Docker के लिए माउंटेड वॉल्यूम) -- Linux या macOS - -## NemoClaw / OpenShell समर्थन - -ClawMetry [NemoClaw](https://github.com/NVIDIA/NemoClaw) को अपने आप पहचान लेता है — यह OpenClaw के लिए NVIDIA का एंटरप्राइज़ सिक्योरिटी रैपर है जो एजेंट्स को सैंडबॉक्स्ड OpenShell कंटेनरों के अंदर चलाता है। +वार्षिक प्लान, Enterprise और मौजूदा आंकड़े यहाँ मिलेंगे: +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**। सेल्फ़-होस्टेड लाइसेंस +कुंजियाँ क्लाउड के बिना भी काम करती हैं (`clawmetry license`)। मुफ़्त/पेड का सटीक +बँटवारा [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) में है। -ज़्यादातर मामलों में किसी अतिरिक्त कॉन्फ़िगरेशन की ज़रूरत नहीं है। सिंक डेमन सेशन फ़ाइलों को अपने आप खोज लेता है, चाहे वे होस्ट पर `~/.openclaw/` में हों या किसी OpenShell कंटेनर के अंदर। +## आपका डेटा आपकी मशीन पर ही रहता है -### यह कैसे काम करता है +ClawMetry लोकल सेशन फ़ाइलें और लॉग पढ़ता है। जब तक आप `clawmetry connect` +नहीं चलाते, तब तक आपके बॉक्स से कुछ भी बाहर नहीं जाता। तब भी स्नैपशॉट +एंड-टू-एंड एन्क्रिप्टेड होता है, ऐसी कुंजी के साथ जो कभी आपकी मशीन नहीं छोड़ती, +और आपके ब्राउज़र में डिक्रिप्ट होता है। -ClawMetry दो तरीक़ों से NemoClaw का पता लगाता है: - -1. **बाइनरी डिटेक्शन** — `nemoclaw` CLI की जाँच करता है और सैंडबॉक्स जानकारी पाने के लिए `nemoclaw status` चलाता है -2. **कंटेनर डिटेक्शन** — `openshell`, `nemoclaw`, या `ghcr.io/nvidia/` इमेज के लिए चल रहे Docker कंटेनरों को स्कैन करता है, फिर वॉल्यूम माउंट या `docker cp` के ज़रिए सेशन पढ़ता है - -NemoClaw कंटेनरों से सिंक की गई सेशन फ़ाइलें क्लाउड डैशबोर्ड में `runtime=nemoclaw` और `container_id` मेटाडेटा से टैग होती हैं, ताकि आप एक नज़र में उन्हें मानक OpenClaw सेशन से अलग बता सकें। - -### अनुशंसित सेटअप: होस्ट पर सिंक डेमन - -सबसे अच्छे अनुभव के लिए, ClawMetry के सिंक डेमन को **होस्ट मशीन** पर चलाएँ (सैंडबॉक्स के अंदर नहीं)। इससे NemoClaw नेटवर्क पॉलिसी प्रतिबंध नहीं आते। - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -सिंक डेमन किसी भी चल रहे OpenShell कंटेनर के अंदर सेशन को अपने आप खोज लेगा। - -### वैकल्पिक: स्पष्ट सैंडबॉक्स नाम - -अगर ऑटो-डिटेक्शन काम नहीं करता, तो ClawMetry को सही सैंडबॉक्स की ओर पॉइंट करें: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### सैंडबॉक्स के अंदर चलाना (एडवांस्ड) - -अगर आपको सिंक डेमन को OpenShell सैंडबॉक्स के **अंदर** चलाना ही है, तो अपनी NemoClaw नेटवर्क पॉलिसी में यह ईग्रेस नियम जोड़ें ताकि यह ClawMetry इनजेस्ट API तक पहुँच सके: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -लागू करें: +## इंस्टॉल करें ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # फिर: clawmetry ``` -### पोर्ट और एंडपॉइंट - -| एंडपॉइंट | पोर्ट | प्रोटोकॉल | ज़रूरी | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | हाँ (सिंक डेमन → क्लाउड) | -| `localhost:8900` | 8900 | HTTP | हाँ (लोकल डैशबोर्ड UI) | -| Docker सॉकेट (`/var/run/docker.sock`) | — | Unix सॉकेट | कंटेनर सेशन डिस्कवरी के लिए | +या यह वन-लाइनर: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -सिंक डेमन केवल `ingest.clawmetry.com` को आउटबाउंड HTTPS कॉल करता है। किसी इनबाउंड पोर्ट की ज़रूरत नहीं है। +macOS, Linux या Windows पर Python 3.8+ चाहिए, और उसी मशीन पर कम से कम एक +एजेंट रनटाइम। Docker निर्देश: [docs/DOCKER.md](docs/DOCKER.md)। ---- +## दस्तावेज़ -## Cloud डिप्लॉयमेंट +| | | +|---|---| +| [Runtime compatibility](docs/compatibility.md) | हर अडैप्टर क्या पढ़ता है, और रनटाइम कैसे जोड़ें | +| [Entitlements](docs/ENTITLEMENTS.md) | मुफ़्त बनाम पेड, टियर मैट्रिक्स, लाइसेंस CLI | +| [Approvals & policies](docs/APPROVALS.md) | प्री-एक्ज़ीक्यूशन गेटिंग, रिस्क स्कोरिंग, फ़ोन अप्रूवल | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | कहीं भी ट्रेस एक्सपोर्ट करें, किसी से भी OTLP इनजेस्ट करें | +| [SDK tracking](docs/SDK_TRACKING.md) | आपके खुद बनाए एजेंट के लिए लागत अट्रीब्यूशन | +| [Chat channels](docs/CHANNELS.md) | Flow में दिखने वाले चैट अडैप्टर | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | सैंडबॉक्स्ड NVIDIA NemoClaw सेटअप | +| [Docker](docs/DOCKER.md) | इमेज, कंपोज़, वॉल्यूम माउंट | +| [Architecture](ARCHITECTURE.md) · [Development](docs/DEVELOPMENT.md) | अंदर यह कैसे काम करता है; सोर्स से चलाना | +| [Telemetry](docs/TELEMETRY.md) | गुमनाम इंस्टॉल और डेस्कटॉप-ओपन पिंग्स, और उन्हें कैसे बंद करें | -SSH टनल, रिवर्स प्रॉक्सी, और Docker के लिए **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** देखें। +## स्क्रीनशॉट -## टेस्टिंग +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: टोकन, सेशन, हेल्थ | **Brain**: लाइव एजेंट इवेंट स्ट्रीम | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: मॉडल और सेशन के अनुसार | **Approvals**: जोखिम भरी टूल कॉल्स को गेट करें | -यह प्रोजेक्ट BrowserStack के साथ टेस्ट किया जाता है। +हर रनटाइम के लिए और भी: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md)। -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) - -## टेलीमेट्री - -ClawMetry `https://app.clawmetry.com/api/install` पर गुमनाम -इंस्टॉल-लाइफ़साइकिल पिंग भेजता है: नई मशीन पर पहली बार `clawmetry` -CLI चलाने पर एक `install` पिंग, किसी नए वर्ज़न में अपग्रेड करने के बाद -पहले रन पर एक `update` पिंग, और जब आप इन-डैशबोर्ड ऑनबोर्डिंग चुनाव -पूरा करते हैं तब एक `onboarded` पिंग। हम इसका उपयोग असल इंस्टॉल्स -गिनने के लिए करते हैं (कच्चे PyPI डाउनलोड नंबर ~98% मिरर, CI, और -ऑटो-अपडेट री-डाउनलोड होते हैं) और यह जानने के लिए कि असल में कौन-से -एजेंट फ़्रेमवर्क और वर्ज़न इस्तेमाल में हैं। - -**प्रति लाइफ़साइकिल इवेंट प्रति वर्ज़न अधिकतम एक POST**, जिसमें शामिल है: - -| फ़ील्ड | उदाहरण | क्यों | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id` पर स्टोर की गई रैंडम UUID | डीडुप; जब तक आप स्पष्ट रूप से Cloud sync कनेक्ट नहीं करते तब तक गुमनाम (उसके बाद ऑथेंटिकेटेड डेमन हार्टबीट इसे साथ ले जाता है, इस इंस्टॉल को आपके अकाउंट से जोड़ते हुए) | -| `event` | `install` / `update` / `onboarded` | नया इंस्टॉल बनाम मौजूदा का अपग्रेड | -| `version` | `0.12.167` | कौन-से वर्ज़न इस्तेमाल में हैं | -| `os` / `os_version` | `Darwin` / `25.3.0` | प्लेटफ़ॉर्म समर्थन प्राथमिकताएँ | -| `python` | `3.11.15` | Python वर्ज़न समर्थन मैट्रिक्स | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | आगे हमें किन एजेंट्स के साथ इंटीग्रेट करना चाहिए | -| `is_ci` / `ci_provider` | `true` / `github_actions` | इंसानी इंस्टॉल्स को CI शोर से अलग करना | - -**हम क्या नहीं भेजते**: IP (क्लाउड सर्वर-साइड पर रिक्वेस्ट से देश कोड -निकालता है, फिर IP को छोड़ देता है), होस्टनेम, यूज़रनेम, वर्कस्पेस पाथ, -फ़ाइल कंटेंट, आपकी api_key, आपका ईमेल, कुछ भी PII या वर्कस्पेस-विशिष्ट। -वायर पेलोड [`clawmetry/telemetry.py`](clawmetry/telemetry.py) में -ऑडिट के लिए उपलब्ध है। - -**ऑप्ट आउट करें** (इनमें से कोई भी एक इसे स्थायी रूप से बंद कर देता है): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -यहाँ नेटवर्क विफलता कभी भी `clawmetry` को चलने से नहीं रोकती — यह पिंग -डेमन थ्रेड पर 3s टाइमआउट के साथ फ़ायर-एंड-फ़ॉरगेट है। - -## स्टार हिस्ट्री +## Star History @@ -436,11 +116,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## लाइसेंस -MIT - ---- +MIT · [@vivekchand](https://github.com/vivekchand) द्वारा बनाया गया · [clawmetry.com](https://clawmetry.com) -

- 🦞 अपने एजेंट को सोचते हुए देखें
- निर्मित @vivekchand द्वारा · clawmetry.com · OpenClaw ईकोसिस्टम का हिस्सा -

+ diff --git a/docs/i18n/id/README.md b/docs/i18n/id/README.md index 394e3d8b73..b581e32090 100644 --- a/docs/i18n/id/README.md +++ b/docs/i18n/id/README.md @@ -1,17 +1,16 @@ - + > Bahasa Indonesia translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Lihat agen Anda berpikir.** Observabilitas real-time untuk **20 runtime agen AI**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex & 16 lainnya. Satu dashboard untuk seluruh armada agen Anda. +**Lihat pemikiran agen Anda.** Observabilitas real-time untuk **23 runtime agen AI**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex & 19 lainnya. Satu dashboard untuk seluruh armada agen Anda. > 🌐 **Baca dalam bahasa lain:** [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) · [lainnya →](docs/i18n/) @@ -21,408 +20,89 @@ Satu perintah. Tanpa konfigurasi. Mendeteksi semuanya secara otomatis. pip install clawmetry && clawmetry ``` -Terbuka di **http://localhost:8900** dan Anda selesai. +Terbuka di **http://localhost:8900**. Tanpa konfigurasi: aplikasi ini menemukan +runtime agen yang sudah Anda miliki, membacanya secara read-only, dan tidak mengubah apa pun tentang cara kerjanya. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## Bekerja dengan 20 runtime agen - -ClawMetry dimulai sebagai observabilitas untuk OpenClaw, dan kini memantau **seluruh armada agen** Anda dalam satu dashboard, mendeteksi setiap runtime di mesin Anda secara otomatis: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw dan NemoClaw gratis di aplikasi open-source; runtime lainnya aktif dengan ClawMetry Cloud atau lisensi Pro self-hosted. Beralih runtime dari header dan setiap tab, biaya, token, tools, trace, akan menyesuaikan ruang lingkupnya ke runtime tersebut. Lihat **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** untuk pembagian gratis/berbayar yang persis, matriks tier, bentuk `/api/entitlement`, dan CLI `clawmetry license`. - -## Apa yang Anda Dapatkan - -- **Flow** — Diagram animasi live yang menunjukkan pesan mengalir melalui channel, brain, tools, dan kembali -- **Overview** — Pemeriksaan kesehatan, heatmap aktivitas, jumlah sesi, info model -- **Usage** — Pelacakan token dan biaya dengan rincian harian/mingguan/bulanan -- **Sessions** — Sesi agen aktif dengan model, token, aktivitas terakhir -- **Crons** — Pekerjaan terjadwal dengan status, run berikutnya, durasi -- **Logs** — Streaming log real-time dengan kode warna -- **Memory** — Jelajahi SOUL.md, MEMORY.md, AGENTS.md, catatan harian -- **Transcripts** — UI chat-bubble untuk membaca riwayat sesi -- **Alerts** — Batas anggaran, pemicu tingkat error, deteksi agen offline; diarahkan ke Slack, Discord, PagerDuty, Telegram, Email -- **Approvals** — Menahan penghapusan destruktif, force push, mutasi DB, sudo, instalasi paket, panggilan jaringan di balik persetujuan satu klik - -## Tangkapan Layar +## Bekerja dengan 23 runtime agen -### 🧠 Brain — Aliran event agen langsung -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) +**Gratis di aplikasi open source:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### 📊 Overview — Penggunaan token & ringkasan sesi -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) +**Pada paket berbayar:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -### ⚡ Flow — Feed panggilan tool real-time -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) +Setiap runtime mendapat dashboard yang sama. Jalankan beberapa sekaligus dan +pengalih di header akan mengarahkan ulang setiap tab ke salah satunya. -### 💰 Tokens — Rincian biaya per model & sesi -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) +Membuat agen Anda sendiri dengan sebuah SDK? Interceptor juga melacak panggilan LLM-nya. +Lihat [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -### 🧬 Memory — Penjelajah file workspace -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) +## Apa yang Anda dapatkan -### 🔐 Security — Postur & log audit -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) +- **Sesi & transkrip**: apa yang dilakukan setiap agen, giliran demi giliran, dengan replay +- **Biaya & token**: per runtime, model, sesi dan hari, dengan penanda anomali +- **Flow**: diagram langsung dari pesan yang bergerak melalui channel, model dan tool +- **Brain**: aliran peristiwa penalaran dan pemanggilan tool saat terjadi +- **Memory & skills**: file dan skill yang benar-benar dimuat oleh setiap runtime +- **Health & logs**: disk, memori, tingkat error, batas laju, aliran log langsung +- **Alerts**: batas anggaran, lonjakan error, agen-offline, diarahkan ke Slack, Discord, PagerDuty, Telegram, Email +- **Approvals**: jeda pemanggilan tool berisiko *sebelum* dijalankan dan setujui dari ponsel Anda ([caranya](docs/APPROVALS.md)) -### 🚨 Alerts — Batas anggaran, pemicu tingkat error, webhook ke Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — Menahan panggilan tool berisiko di balik persetujuan manual; aturan proteksi berbasis kebijakan -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Pemblokiran pra-eksekusi untuk Claude Code** — satu perintah menginstal -hook PreToolUse yang menjeda panggilan tool yang cocok *sebelum* dijalankan dan menunggu -keputusan Anda (satu ketukan dari ponsel Anda dengan -[notifikasi push cloud](https://app.clawmetry.com/push) diaktifkan): - -```bash -clawmetry hooks install # menulis ~/.claude/settings.json (idempotent) -clawmetry hooks status # apa yang terpasang + berapa banyak kebijakan yang aktif -clawmetry hooks uninstall # menghapus hanya entri milik ClawMetry -``` - -Sebuah deny hanya memblokir satu panggilan tool itu saja, agen tetap mempertahankan sesinya dan dapat -mencoba pendekatan lain. Menyetujui dari ponsel Anda melewati prompt izin milik Claude Code -sendiri (Anda sudah menjawabnya). Tool yang tidak cocok hanya memakan waktu ~40ms dan -diteruskan ke alur izin normal Claude Code. Anda juga mendapat push ke ponsel saat -Claude Code sendiri sedang menunggu Anda (notifikasi `permission_prompt` / -`idle_prompt`). - -## Instalasi - -**One-liner (direkomendasikan):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**Dari sumber:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` - -## Pengembangan Frontend v2 - -Aplikasi React v2 berada di `frontend/` dan disajikan di `/v2` ketika -server Flask dijalankan dengan v2 diaktifkan. - -Gunakan dua terminal saat mengembangkan: - -```bash -# Terminal 1: Flask API/server di :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## Harga -```bash -# Terminal 2: Server dev Vite di :5173 -cd frontend -nvm use -npm ci -npm run dev -``` - -Buka `http://localhost:5173/v2/`. Vite mem-proxy permintaan `/api` ke -`http://localhost:8900`, sehingga aplikasi React dapat berkomunikasi dengan server Flask lokal -tanpa pengaturan CORS tambahan. - -Untuk membangun bundle yang dikirim bersama paket Python: - -```bash -cd frontend -npm run build -``` - -Bundle produksi ditulis ke `clawmetry/static/v2/dist/`. - -## Kompatibilitas Runtime / Agen - -ClawMetry mengamati banyak runtime agen AI, tidak hanya OpenClaw. Setiap runtime non-OpenClaw menyediakan adapter pembaca khusus yang menerjemahkan format sesi asli miliknya ke dalam bentuk terpadu ClawMetry; daemon menyerapnya ke dalam penyimpanan DuckDB + snapshot cloud yang sama, ditandai dengan runtime-nya, dan tab Session replay menampilkan **runtime switcher** ketika lebih dari satu hadir. Lihat [`docs/compatibility.md`](docs/compatibility.md) untuk matriks lengkap + panduan menambahkan runtime, dan [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) untuk pengantar keluarga OpenClaw. - -Menjalankan tool keamanan agen [numbat milik Perplexity](https://github.com/perplexityai/numbat)? ClawMetry menyerap temuan dan keputusan penegakannya langsung tanpa konfigurasi tambahan, lihat [`docs/NUMBAT.md`](docs/NUMBAT.md). - -| Runtime / Agen | Status | Catatan | +| Paket | Yang dicakup | Harga | |---|---|---| -| **OpenClaw** | Native | Runtime referensi, terdeteksi otomatis | -| **PicoClaw** | Adapter beta | JSONL `providers.Message` datar (`~/.picoclaw/workspace/sessions`). Transcript, model, panggilan tool. | -| **NanoClaw** | Adapter beta | SQLite per-sesi (`data/v2-sessions`). Transcript + jumlah pesan. | -| **Hermes** | Adapter beta | SQLite `~/.hermes/state.db`. Transcript, model, token/biaya. | -| **Claude Code** | Adapter beta | JSONL `~/.claude/projects/.../.jsonl`. Transcript, model, panggilan tool + thinking, penggunaan token. | -| **Codex** | Adapter beta | Rollout JSONL `~/.codex/sessions/...`. Transcript, model, panggilan tool, penggunaan token. | -| **Cursor** | Adapter beta | SQLite `state.vscdb`. Transcript chat/composer, model. | -| **Aider** | Adapter beta | `.aider.chat.history.md` per proyek. Transcript, model, jumlah token. | -| **Goose** | Adapter beta | SQLite `~/.local/share/goose`. Transcript, model, panggilan tool, total token. | -| **opencode** | Adapter beta | SQLite `~/.local/share/opencode`. Transcript, model, panggilan tool, token + biaya. | -| **Qwen Code** | Adapter beta | JSONL `~/.qwen/projects/.../chats`. Transcript, model, panggilan tool, penggunaan token. | -| **Pi** | Adapter beta | JSONL `~/.pi/agent/sessions`. Transcript, model, panggilan tool, token + biaya. | -| **Deep Agents** | Adapter beta | SQLite `~/.deepagents/.state/sessions.db`. Transcript, model, panggilan tool, token + biaya. | -| **n8n** | Adapter beta | SQLite `~/.n8n/database.sqlite`. Eksekusi workflow, run node, prompt AI Agent, model + token bila dicatat oleh n8n. | -| **Antigravity** | Adapter beta | Brain JSONL di bawah `~/.gemini//brain/`. Percakapan, langkah tool, thinking, rincian token Gemini per generasi + biaya, konsumsi generasi latar belakang. | -| **GitHub Copilot** | Adapter beta | Copilot CLI `events.jsonl` di bawah `~/.copilot/session-state/` + buku besar penggunaan per panggilan `session-store.db`. Percakapan, panggilan tool, routing model, rincian token yang sadar cache, biaya kredit AI yang ditagih vendor. | -| **Grok** | Adapter beta | xAI Grok Build CLI (biner Rust di bawah `~/.grok/bin/grok`): log event global `~/.grok/logs/unified.jsonl` + per-sesi `~/.grok/sessions///{events.jsonl,summary.json}`. Percakapan, rincian token per giliran, routing model, dan payload repo keluar milik CLI yang di-staging di `~/.grok/upload_queue/` sehingga Anda bisa melihat apa yang meninggalkan mesin Anda. | - -"Adapter beta" berarti ClawMetry menyediakan pembaca untuk format asli di disk milik runtime tersebut, masing-masing dibangun + diverifikasi terhadap instalasi nyata di mesin nyata (lihat `tests/fixtures/runtimes//`). Adapter bersifat read-only; masing-masing jujur tentang apa yang sebenarnya disimpan oleh runtime-nya (misalnya PicoClaw/NanoClaw/Cursor tidak menulis biaya token ke disk). Ketika beberapa runtime berjalan pada satu node, runtime switcher membatasi tampilan sesi ke satu runtime untuk deep-dive yang bersih. - -## Melacak agen SDK apa pun — atribusi biaya out-loop - -Runtime-runtime di atas semuanya menulis sesi ke disk. **Agen produksi** Anda sendiri, yang Anda bangun di atas OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, atau loop `httpx` biasa, tidak melakukannya. Interceptor tanpa konfigurasi milik ClawMetry tetap menangkap panggilan LLM-nya (biaya, token, latensi, error) dengan monkey-patching `httpx`/`requests`: - -```python -import clawmetry.track # aktifkan interceptor -clawmetry.track.set_source("support-agent") # beri nama produk ini - -# ...agen Anda berjalan seperti biasa; setiap panggilan LLM kini dilacak + diatribusikan. -``` - -`set_source()` (atau variabel env `CLAWMETRY_SOURCE=support-agent`) menandai setiap panggilan dengan **sumber bernama**, sehingga setiap produk yang Anda jalankan muncul sebagai baris tersendiri yang dapat diatribusikan biayanya di kartu **🔌 Out-loop sources** pada Overview di dashboard, panggilan, provider, latensi, tingkat error per agen. Tidak ada sumber yang diatur? Panggilannya tetap dilacak; kartunya saja yang tetap tersembunyi. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Ini adalah lapisan data yang sama yang memberi makan adapter runtime (DuckDB → snapshot cloud), sehingga sumber out-loop disinkronkan ke dashboard cloud sama seperti hal lainnya, dienkripsi E2E. - -## OpenTelemetry — netral vendor, kirim trace Anda ke mana saja - -ClawMetry berbicara **OpenTelemetry** dalam dua arah, menggunakan **konvensi semantik GenAI**, sehingga trace agen Anda tidak pernah terkunci pada satu tool. - -**Ekspor** setiap sesi, panggilan LLM, tools, sub-agent, token, biaya, sebagai span OTLP/HTTP GenAI ke collector mana pun (Datadog, Grafana, Honeycomb, atau OTel Collector Anda sendiri): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# setara dengan: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Header autentikasi dan interval polling bersifat opsional melalui variabel env: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # header HTTP tambahan -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # detik (default 60) -``` - -**Serap** — receiver OTLP bawaan menerima trace, log, dan metrik dari apa pun lainnya di `/v1/traces`, `/v1/logs`, dan `/v1/metrics`. Arahkan aplikasi berinstrumentasi OpenTelemetry mana pun ke sana: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -Trace dan log OTLP/JSON berfungsi pada `pip install clawmetry` biasa, tanpa ekstra. Serapan Protobuf (dan metrik OTLP/JSON) membutuhkan `pip install clawmetry[otel]`. Aplikasi yang mengatur `service.name`-nya sendiri akan muncul sebagai agennya sendiri di runtime switcher, lengkap dengan biaya dan tokennya. - -Anda mendapatkan dashboard ClawMetry yang tanpa konfigurasi dan local-first, **dan** data Anda di backend apa pun yang sudah digunakan tim Anda, tanpa lock-in, tanpa agen kedua yang perlu diinstal. - -## Konfigurasi - -Sebagian besar orang tidak memerlukan konfigurasi apa pun. ClawMetry mendeteksi workspace, log, sesi, dan cron Anda secara otomatis. - -Jika Anda memang perlu menyesuaikan: - -```bash -clawmetry --port 9000 # Port kustom (default: 8900) -clawmetry --host 127.0.0.1 # Bind hanya ke localhost -clawmetry --workspace ~/mybot # Path workspace kustom -clawmetry --name "Alice" # Nama Anda dalam visualisasi Flow -``` - -Semua opsi: `clawmetry --help` - -## Channel yang Didukung - -ClawMetry menampilkan aktivitas langsung untuk setiap channel OpenClaw yang Anda konfigurasikan. Hanya channel yang benar-benar diatur di `openclaw.json` Anda yang muncul di diagram Flow, yang belum dikonfigurasi otomatis disembunyikan. - -Klik node channel mana pun di Flow untuk melihat tampilan chat bubble langsung dengan jumlah pesan masuk/keluar. - -| Channel | Status | Popup Langsung | Catatan | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Penuh | ✅ | Pesan, statistik, refresh 10 detik | -| 💬 **iMessage** | ✅ Penuh | ✅ | Membaca `~/Library/Messages/chat.db` langsung | -| 💚 **WhatsApp** | ✅ Penuh | ✅ | Via WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Penuh | ✅ | Via signal-cli | -| 🟣 **Discord** | ✅ Penuh | ✅ | Deteksi guild + channel | -| 🟪 **Slack** | ✅ Penuh | ✅ | Deteksi workspace + channel | -| 🌐 **Webchat** | ✅ Penuh | ✅ | Sesi UI web bawaan | -| 📡 **IRC** | ✅ Penuh | ✅ | UI bubble bergaya terminal | -| 🍏 **BlueBubbles** | ✅ Penuh | ✅ | iMessage via REST API BlueBubbles | -| 🔵 **Google Chat** | ✅ Penuh | ✅ | Via webhook Chat API | -| 🟣 **MS Teams** | ✅ Penuh | ✅ | Via plugin bot Teams | -| 🔷 **Mattermost** | ✅ Penuh | ✅ | Chat tim self-hosted | -| 🟩 **Matrix** | ✅ Penuh | ✅ | Terdesentralisasi, dukungan E2EE | -| 🟢 **LINE** | ✅ Penuh | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Penuh | ✅ | DM NIP-04 terdesentralisasi | -| 🟣 **Twitch** | ✅ Penuh | ✅ | Chat via koneksi IRC | -| 🔷 **Feishu/Lark** | ✅ Penuh | ✅ | Langganan event WebSocket | -| 🔵 **Zalo** | ✅ Penuh | ✅ | Zalo Bot API | - -> **Deteksi otomatis:** ClawMetry membaca `~/.openclaw/openclaw.json` Anda dan hanya merender channel yang benar-benar Anda konfigurasikan. Tidak diperlukan pengaturan manual. - -## Deployment Docker - -Ingin menjalankan ClawMetry dalam container? Tidak masalah! 🐳 - -**Mulai cepat dengan Docker:** - -```bash -# Bangun image -docker build -t clawmetry . - -# Jalankan dengan pengaturan default -docker run -p 8900:8900 clawmetry - -# Atau mount direktori data agen Anda (ditampilkan: ~/.openclaw milik OpenClaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Contoh Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Catatan:** Saat menjalankan di Docker, mount direktori data + log agen Anda (misalnya `~/.openclaw`, `~/.claude`, `~/.codex`) sehingga ClawMetry dapat mendeteksi pengaturan Anda secara otomatis. - -## Persyaratan - -- Python 3.8+ -- Flask (terinstal otomatis via pip) -- Runtime agen AI di mesin yang sama: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, atau QM (atau volume yang di-mount untuk Docker) -- Linux atau macOS - -## Dukungan NemoClaw / OpenShell - -ClawMetry secara otomatis mendeteksi [NemoClaw](https://github.com/NVIDIA/NemoClaw), wrapper keamanan enterprise milik NVIDIA untuk OpenClaw yang menjalankan agen di dalam container OpenShell yang di-sandbox. +| **Gratis** | OpenClaw + NVIDIA NemoClaw, dashboard lengkap, hanya lokal | $0 | +| **Starter** | Semua runtime lain di atas, tampilan armada, sinkronisasi cloud | $9 per node / bulan | +| **Pro** | Starter + tata kelola: approvals, kebijakan risiko tool, evaluasi, deteksi anomali, pengoptimal biaya, ekspor OTel | $19 per node / bulan | -Tidak diperlukan konfigurasi tambahan dalam sebagian besar kasus. Daemon sync secara otomatis menemukan file sesi baik yang berada di `~/.openclaw/` pada host maupun di dalam container OpenShell. +Paket tahunan, Enterprise dan angka terbaru ada di +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Kunci lisensi self-hosted +bekerja tanpa cloud (`clawmetry license`). Pembagian gratis/berbayar yang tepat ada +di [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -### Cara kerjanya +## Data Anda tetap di mesin Anda -ClawMetry mendeteksi NemoClaw dengan dua cara: +ClawMetry membaca file sesi dan log lokal. Tidak ada yang keluar dari perangkat Anda kecuali +Anda menjalankan `clawmetry connect`. Bahkan saat itu terjadi, snapshot dienkripsi end-to-end +dengan kunci yang tidak pernah meninggalkan mesin Anda, dan didekripsi di browser Anda. -1. **Deteksi biner** — memeriksa CLI `nemoclaw` dan menjalankan `nemoclaw status` untuk mendapatkan info sandbox -2. **Deteksi container** — memindai container Docker yang berjalan untuk image `openshell`, `nemoclaw`, atau `ghcr.io/nvidia/`, lalu membaca sesi via volume mount atau `docker cp` - -File sesi yang disinkronkan dari container NemoClaw ditandai dengan `runtime=nemoclaw` dan metadata `container_id` di dashboard cloud, sehingga Anda dapat membedakannya dari sesi OpenClaw standar sekilas. - -### Pengaturan yang direkomendasikan: daemon sync di HOST - -Untuk pengalaman terbaik, jalankan daemon sync ClawMetry di **mesin host** (bukan di dalam sandbox). Ini menghindari batasan kebijakan jaringan NemoClaw. - -```bash -# Di host (di luar sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -Daemon sync akan secara otomatis menemukan sesi di dalam container OpenShell mana pun yang sedang berjalan. - -### Opsional: nama sandbox eksplisit - -Jika deteksi otomatis tidak berfungsi, arahkan ClawMetry ke sandbox yang benar: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Menjalankan di dalam sandbox (lanjutan) - -Jika Anda harus menjalankan daemon sync **di dalam** sandbox OpenShell, tambahkan aturan egress ini ke kebijakan jaringan NemoClaw Anda agar dapat menjangkau API ingest ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Terapkan dengan: +## Instalasi ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # lalu: clawmetry ``` -### Port dan endpoint - -| Endpoint | Port | Protokol | Diperlukan | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Ya (daemon sync → cloud) | -| `localhost:8900` | 8900 | HTTP | Ya (UI dashboard lokal) | -| Socket Docker (`/var/run/docker.sock`) | — | Unix socket | Untuk penemuan sesi container | - -Daemon sync hanya melakukan panggilan HTTPS keluar ke `ingest.clawmetry.com`. Tidak ada port masuk yang diperlukan. - ---- - -## Deployment Cloud - -Lihat **[Panduan Pengujian Cloud](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** untuk SSH tunnel, reverse proxy, dan Docker. +Atau perintah satu baris: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -## Pengujian +Membutuhkan Python 3.8+ di macOS, Linux atau Windows, dan setidaknya satu runtime agen di +mesin yang sama. Instruksi Docker: [docs/DOCKER.md](docs/DOCKER.md). -Proyek ini diuji dengan BrowserStack. +## Dokumentasi -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +| | | +|---|---| +| [Kompatibilitas runtime](docs/compatibility.md) | Apa yang dibaca setiap adapter, dan cara menambahkan runtime | +| [Entitlements](docs/ENTITLEMENTS.md) | Gratis vs berbayar, matriks tingkat, license CLI | +| [Approvals & policies](docs/APPROVALS.md) | Pengendalian pra-eksekusi, penilaian risiko, persetujuan lewat ponsel | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Ekspor trace ke mana saja, ingest OTLP dari mana saja | +| [SDK tracking](docs/SDK_TRACKING.md) | Atribusi biaya untuk agen yang Anda bangun sendiri | +| [Chat channels](docs/CHANNELS.md) | Adapter chat yang ditampilkan di Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Setup NVIDIA NemoClaw yang tersandbox | +| [Docker](docs/DOCKER.md) | Image, compose, volume mount | +| [Architecture](ARCHITECTURE.md) · [Development](docs/DEVELOPMENT.md) | Cara kerjanya di dalam; menjalankan dari source | +| [Telemetry](docs/TELEMETRY.md) | Ping instalasi dan pembukaan desktop yang anonim, dan cara mematikannya | -## Telemetri +## Tangkapan layar -ClawMetry mengirim ping anonim siklus hidup instalasi ke -`https://app.clawmetry.com/api/install`: satu ping `install` saat pertama kali -Anda menjalankan CLI `clawmetry` di mesin baru, satu ping `update` -pada run pertama setelah upgrade ke versi baru, dan satu ping `onboarded` -saat Anda menyelesaikan pilihan onboarding di dalam dashboard. Kami menggunakan ini -untuk menghitung instalasi nyata (angka unduhan mentah PyPI ~98% adalah mirror, CI, -dan unduhan ulang auto-update) dan untuk mempelajari kerangka kerja serta versi -agen mana yang benar-benar digunakan di dunia nyata. +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: token, sesi, kesehatan | **Brain**: aliran peristiwa agen secara langsung | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: berdasarkan model dan sesi | **Approvals**: menjaga pemanggilan tool berisiko | -**Paling banyak satu POST per event siklus hidup per versi**, berisi: - -| Field | Contoh | Alasan | -|---|---|---| -| `install_id` | UUID acak yang disimpan di `~/.clawmetry/install_id` | dedup; anonim hingga Anda secara eksplisit menghubungkan Cloud sync (heartbeat daemon yang terautentikasi kemudian membawanya, menautkan instalasi ini ke akun Anda) | -| `event` | `install` / `update` / `onboarded` | instalasi baru vs upgrade dari yang sudah ada | -| `version` | `0.12.167` | versi apa saja yang sedang digunakan | -| `os` / `os_version` | `Darwin` / `25.3.0` | prioritas dukungan platform | -| `python` | `3.11.15` | matriks dukungan versi Python | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | agen mana yang harus kami integrasikan berikutnya | -| `is_ci` / `ci_provider` | `true` / `github_actions` | memisahkan instalasi manusia dari noise CI | - -**Apa yang TIDAK kami kirim**: IP (cloud menurunkan kode negara secara server-side -dari permintaan, lalu membuang IP-nya), hostname, username, path workspace, -isi file, api_key Anda, email Anda, apa pun yang bersifat PII atau -spesifik workspace. Payload jaringan dapat diaudit di -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Nonaktifkan** (salah satu dari ini menonaktifkannya secara permanen): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # standar lintas-tool W3C -touch ~/.clawmetry/notelemetry # penanda file permanen -``` - -Kegagalan jaringan di sini tidak akan pernah memblokir `clawmetry` agar tetap berjalan, ping -bersifat fire-and-forget pada thread daemon dengan timeout 3 detik. +Lebih banyak, per runtime: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Riwayat Star @@ -436,11 +116,6 @@ bersifat fire-and-forget pada thread daemon dengan timeout 3 detik. ## Lisensi -MIT - ---- +MIT · Dibuat oleh [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Lihat agen Anda berpikir
- Dibuat oleh @vivekchand · clawmetry.com · Bagian dari ekosistem OpenClaw -

+ diff --git a/docs/i18n/it/README.md b/docs/i18n/it/README.md index a64f980b84..d6676123f9 100644 --- a/docs/i18n/it/README.md +++ b/docs/i18n/it/README.md @@ -1,17 +1,16 @@ - + > Italiano translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Guarda il tuo agente pensare.** Osservabilità in tempo reale per **20 runtime di agenti AI**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex e altri 16. Un'unica dashboard per l'intera flotta di agenti. +**Guarda il tuo agente pensare.** Osservabilità in tempo reale per **23 runtime di agenti AI**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex e altri 19. Un'unica dashboard per l'intera flotta di agenti. > 🌐 **Leggi questo in:** [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) · [altre →](docs/i18n/) @@ -21,407 +20,92 @@ Un comando. Zero configurazione. Rileva tutto automaticamente. pip install clawmetry && clawmetry ``` -Si apre su **http://localhost:8900** ed è fatta. +Si apre su **http://localhost:8900**. Zero configurazione: trova i runtime di agenti +che già possiedi, li legge in sola lettura e non cambia nulla nel loro funzionamento. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## Funziona con 20 runtime di agenti - -ClawMetry è nato come strumento di osservabilità per OpenClaw, e ora misura l'**intera flotta di agenti** in un'unica dashboard, rilevando automaticamente ogni runtime presente sulla tua macchina: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw e NemoClaw sono gratuiti nell'app open source; gli altri runtime si attivano con ClawMetry Cloud o con una licenza Pro self-hosted. Cambia runtime dall'intestazione e ogni scheda, costi, token, strumenti, tracce, si riadatta a quel runtime. Consulta **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** per la ripartizione esatta gratuita/a pagamento, la matrice dei livelli, la struttura di `/api/entitlement` e la CLI `clawmetry license`. - -## Cosa ottieni - -- **Flow** — Diagramma animato dal vivo che mostra i messaggi che scorrono attraverso canali, brain, strumenti e ritorno -- **Overview** — Controlli di stato, mappa di calore dell'attività, conteggio sessioni, informazioni sul modello -- **Usage** — Monitoraggio di token e costi con suddivisioni giornaliere/settimanali/mensili -- **Sessions** — Sessioni agente attive con modello, token, ultima attività -- **Crons** — Job pianificati con stato, prossima esecuzione, durata -- **Logs** — Streaming di log in tempo reale a colori -- **Memory** — Sfoglia SOUL.md, MEMORY.md, AGENTS.md, note giornaliere -- **Transcripts** — Interfaccia a fumetti di chat per leggere lo storico delle sessioni -- **Alerts** — Limiti di budget, trigger su tasso di errore, rilevamento agente offline; instrada verso Slack, Discord, PagerDuty, Telegram, Email -- **Approvals** — Blocca eliminazioni distruttive, force push, mutazioni di database, sudo, installazioni di pacchetti, chiamate di rete dietro un'approvazione con un solo clic - -## Screenshot - -### 🧠 Brain — Flusso di eventi dell'agente dal vivo -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Utilizzo dei token e riepilogo sessioni -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Feed delle chiamate agli strumenti in tempo reale -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Ripartizione dei costi per modello e sessione -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Browser dei file dello spazio di lavoro -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Postura di sicurezza e registro di audit -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — Limiti di budget, trigger su tasso di errore, webhook verso Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — Blocca le chiamate agli strumenti rischiose dietro approvazione manuale; regole di protezione basate su policy -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Blocco pre-esecuzione per Claude Code** — un comando installa un -hook PreToolUse che mette in pausa le chiamate agli strumenti corrispondenti *prima* che vengano eseguite e attende -la tua decisione (un tocco dal telefono con le -[notifiche push cloud](https://app.clawmetry.com/push) attivate): - -```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 -``` - -Un rifiuto blocca solo quella singola chiamata allo strumento, l'agente mantiene la sua sessione e può -provare un altro approccio. Approvare dal telefono salta il prompt di -autorizzazione nativo di Claude Code (hai già risposto). Gli strumenti non corrispondenti costano circa 40ms e -ricadono nel normale flusso di autorizzazione di Claude Code. Ricevi anche una notifica push sul telefono quando Claude Code stesso è in attesa di una tua decisione (notifiche -`permission_prompt` / `idle_prompt`). - -## Installazione - -**Comando singolo (consigliato):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**Dal sorgente:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` - -## Sviluppo del frontend v2 - -L'app React v2 risiede in `frontend/` ed è servita su `/v2` quando il -server Flask viene avviato con v2 abilitato. - -Usa due terminali durante lo sviluppo: - -```bash -# Terminal 1: Flask API/server on :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## Funziona con 23 runtime di agenti -```bash -# Terminal 2: Vite dev server on :5173 -cd frontend -nvm use -npm ci -npm run dev -``` +**Gratis nell'app open source:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -Apri `http://localhost:5173/v2/`. Vite instrada le richieste `/api` verso -`http://localhost:8900`, così l'app React può comunicare con il server Flask locale -senza bisogno di configurazioni CORS aggiuntive. +**Su un piano a pagamento:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -Per compilare il bundle distribuito con il pacchetto Python: - -```bash -cd frontend -npm run build -``` +Ogni runtime ottiene la stessa dashboard. Esegui più runtime contemporaneamente e il +selettore nell'intestazione riporta l'ambito di ogni scheda a uno di essi. -Il bundle di produzione viene scritto in `clawmetry/static/v2/dist/`. +Hai creato il tuo agente su un SDK anziché usarne uno esistente? L'interceptor traccia +anche le sue chiamate LLM. Vedi [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -## Compatibilità di runtime / agenti +## Cosa ottieni -ClawMetry osserva molti runtime di agenti AI, non solo OpenClaw. Ogni runtime diverso da OpenClaw dispone di un adattatore di lettura dedicato che traduce il suo formato nativo di sessione nelle forme unificate di ClawMetry; il daemon li ingerisce nello stesso archivio DuckDB + snapshot cloud, taggati con il runtime, e la scheda Session replay mostra un **selettore di runtime** quando ne è presente più di uno. Consulta [`docs/compatibility.md`](docs/compatibility.md) per la matrice completa e una guida per aggiungere runtime, e [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) per un'introduzione alla famiglia OpenClaw. +- **Sessioni e trascrizioni**: cosa ha fatto ogni agente, turno per turno, con replay +- **Costi e token**: per runtime, modello, sessione e giorno, con segnalazioni di anomalie +- **Flow**: diagramma in tempo reale dei messaggi che si muovono tra canali, modelli e strumenti +- **Brain**: il flusso di eventi di ragionamento e chiamate a strumenti mentre accade +- **Memoria e skill**: i file e le skill effettivamente caricati da ogni runtime +- **Salute e log**: disco, memoria, tassi di errore, limiti di velocità, flusso di log in diretta +- **Alert**: limiti di budget, picchi di errore, agente offline, instradati a Slack, Discord, PagerDuty, Telegram, Email +- **Approvazioni**: metti in pausa le chiamate a strumenti rischiose *prima* che vengano eseguite e approvale dal tuo telefono ([come](docs/APPROVALS.md)) -Usi lo strumento di sicurezza per agenti [numbat di Perplexity](https://github.com/perplexityai/numbat)? ClawMetry ne ingerisce i risultati e le decisioni di enforcement pronte all'uso, vedi [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Prezzi -| Runtime / Agente | Stato | Note | +| Piano | Cosa copre | Prezzo | |---|---|---| -| **OpenClaw** | Nativo | Runtime di riferimento, rilevato automaticamente | -| **PicoClaw** | Adattatore beta | JSONL flat `providers.Message` (`~/.picoclaw/workspace/sessions`). Transcript, modello, chiamate agli strumenti. | -| **NanoClaw** | Adattatore beta | SQLite per sessione (`data/v2-sessions`). Transcript + conteggio messaggi. | -| **Hermes** | Adattatore beta | SQLite `~/.hermes/state.db`. Transcript, modello, token/costo. | -| **Claude Code** | Adattatore beta | JSONL `~/.claude/projects/.../.jsonl`. Transcript, modello, chiamate agli strumenti + thinking, utilizzo dei token. | -| **Codex** | Adattatore beta | Rollout JSONL `~/.codex/sessions/...`. Transcript, modello, chiamate agli strumenti, utilizzo dei token. | -| **Cursor** | Adattatore beta | SQLite `state.vscdb`. Transcript di chat/composer, modello. | -| **Aider** | Adattatore beta | `.aider.chat.history.md` per progetto. Transcript, modello, conteggi dei token. | -| **Goose** | Adattatore beta | SQLite `~/.local/share/goose`. Transcript, modello, chiamate agli strumenti, totali dei token. | -| **opencode** | Adattatore beta | SQLite `~/.local/share/opencode`. Transcript, modello, chiamate agli strumenti, token + costo. | -| **Qwen Code** | Adattatore beta | JSONL `~/.qwen/projects/.../chats`. Transcript, modello, chiamate agli strumenti, utilizzo dei token. | -| **Pi** | Adattatore beta | JSONL `~/.pi/agent/sessions`. Transcript, modello, chiamate agli strumenti, token + costo. | -| **Deep Agents** | Adattatore beta | SQLite `~/.deepagents/.state/sessions.db`. Transcript, modello, chiamate agli strumenti, token + costo. | -| **n8n** | Adattatore beta | SQLite `~/.n8n/database.sqlite`. Esecuzioni di workflow, esecuzioni dei nodi, prompt AI Agent, modello + token dove n8n li registra. | -| **Antigravity** | Adattatore beta | Brain JSONL sotto `~/.gemini//brain/`. Conversazioni, passaggi degli strumenti, thinking, suddivisione dei token Gemini per generazione + costo, consumo delle generazioni in background. | -| **GitHub Copilot** | Adattatore beta | `events.jsonl` della Copilot CLI sotto `~/.copilot/session-state/` + il registro di utilizzo per chiamata `session-store.db`. Conversazioni, chiamate agli strumenti, instradamento del modello, suddivisione dei token con consapevolezza della cache, costo in crediti AI fatturato dal vendor. | -| **Grok** | Adattatore beta | xAI Grok Build CLI (binario Rust sotto `~/.grok/bin/grok`): log eventi globale `~/.grok/logs/unified.jsonl` + `~/.grok/sessions///{events.jsonl,summary.json}` per sessione. Conversazioni, suddivisione dei token per turno, instradamento del modello, e il payload in uscita del repo inviato dalla CLI e messo in coda sotto `~/.grok/upload_queue/` così puoi vedere cosa è uscito dalla tua macchina. | - -"Adattatore beta" significa che ClawMetry distribuisce un lettore per il formato reale su disco di quel runtime, ciascuno costruito e verificato su un'installazione reale su una macchina reale (vedi `tests/fixtures/runtimes//`). Gli adattatori sono di sola lettura; ognuno è onesto su cosa il suo runtime effettivamente memorizza (ad es. PicoClaw/NanoClaw/Cursor non scrivono il costo dei token su disco). Quando più runtime girano su un nodo, il selettore di runtime limita la vista delle sessioni a uno solo per un approfondimento pulito. - -## Traccia qualsiasi agente SDK — attribuzione dei costi out-loop - -I runtime sopra elencati scrivono tutti le sessioni su disco. Il tuo **agente di produzione** personale, quello costruito su OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, o un semplice ciclo `httpx`, non lo fa. L'interceptor a configurazione zero di ClawMetry cattura comunque le sue chiamate LLM (costo, token, latenza, errori) tramite monkey-patching di `httpx`/`requests`: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (o la variabile d'ambiente `CLAWMETRY_SOURCE=support-agent`) etichetta ogni chiamata con una **sorgente nominata**, così ogni prodotto che esegui appare come una propria linea di prim'ordine, attribuibile per costo, nella scheda **🔌 Out-loop sources** della dashboard su Overview, chiamate, provider, latenza, tasso di errore per agente. Nessuna sorgente impostata? Le chiamate vengono comunque tracciate, la scheda rimane semplicemente nascosta. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Questo è lo stesso livello di dati alimentato dagli adattatori di runtime (DuckDB → snapshot cloud), quindi le sorgenti out-loop si sincronizzano con la dashboard cloud come tutto il resto, con crittografia E2E. - -## OpenTelemetry — neutrale rispetto al vendor, invia le tue tracce ovunque - -ClawMetry parla **OpenTelemetry** in entrambe le direzioni, usando le **convenzioni semantiche GenAI**, così le tracce del tuo agente non sono mai vincolate a un solo strumento. - -**Esporta** ogni sessione, chiamate LLM, strumenti, sub-agenti, token, costo, come span GenAI OTLP/HTTP verso qualsiasi collector (Datadog, Grafana, Honeycomb, o il tuo OTel Collector personale): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Gli header di autenticazione e l'intervallo di polling sono variabili d'ambiente opzionali: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**Ingest** — il receiver OTLP integrato accetta tracce, log e metriche da qualsiasi altra fonte su `/v1/traces`, `/v1/logs` e `/v1/metrics`. Punta qualsiasi app strumentata con OpenTelemetry verso di esso: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -Le tracce e i log OTLP/JSON funzionano su un semplice `pip install clawmetry`, senza extra. L'ingest Protobuf (e le metriche OTLP/JSON) richiede `pip install clawmetry[otel]`. Un'app che imposta il proprio `service.name` appare come un proprio agente nel selettore di runtime, con il suo costo e i suoi token. - -Ottieni la dashboard ClawMetry a configurazione zero e local-first **e** i tuoi dati nel backend che il tuo team già usa, senza vincoli, senza un secondo agente da installare. - -## Configurazione - -La maggior parte delle persone non ha bisogno di alcuna configurazione. ClawMetry rileva automaticamente il tuo spazio di lavoro, i log, le sessioni e i cron. - -Se devi personalizzare: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -Tutte le opzioni: `clawmetry --help` - -## Canali supportati - -ClawMetry mostra l'attività dal vivo per ogni canale OpenClaw che hai configurato. Solo i canali effettivamente configurati nel tuo `openclaw.json` appaiono nel diagramma Flow, quelli non configurati vengono nascosti automaticamente. - -Clicca su qualsiasi nodo canale nel Flow per vedere una vista dal vivo a fumetti di chat con conteggi dei messaggi in entrata/uscita. - -| Canale | Stato | Popup dal vivo | Note | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Completo | ✅ | Messaggi, statistiche, aggiornamento ogni 10s | -| 💬 **iMessage** | ✅ Completo | ✅ | Legge direttamente `~/Library/Messages/chat.db` | -| 💚 **WhatsApp** | ✅ Completo | ✅ | Tramite WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Completo | ✅ | Tramite signal-cli | -| 🟣 **Discord** | ✅ Completo | ✅ | Rilevamento guild + canale | -| 🟪 **Slack** | ✅ Completo | ✅ | Rilevamento workspace + canale | -| 🌐 **Webchat** | ✅ Completo | ✅ | Sessioni dell'interfaccia web integrata | -| 📡 **IRC** | ✅ Completo | ✅ | Interfaccia a fumetti in stile terminale | -| 🍏 **BlueBubbles** | ✅ Completo | ✅ | iMessage tramite BlueBubbles REST API | -| 🔵 **Google Chat** | ✅ Completo | ✅ | Tramite webhook Chat API | -| 🟣 **MS Teams** | ✅ Completo | ✅ | Tramite plugin bot Teams | -| 🔷 **Mattermost** | ✅ Completo | ✅ | Chat di team self-hosted | -| 🟩 **Matrix** | ✅ Completo | ✅ | Decentralizzato, supporto E2EE | -| 🟢 **LINE** | ✅ Completo | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Completo | ✅ | DM decentralizzati NIP-04 | -| 🟣 **Twitch** | ✅ Completo | ✅ | Chat tramite connessione IRC | -| 🔷 **Feishu/Lark** | ✅ Completo | ✅ | Sottoscrizione eventi WebSocket | -| 🔵 **Zalo** | ✅ Completo | ✅ | Zalo Bot API | - -> **Rilevamento automatico:** ClawMetry legge il tuo `~/.openclaw/openclaw.json` e visualizza solo i canali che hai effettivamente configurato. Nessuna configurazione manuale richiesta. - -## Distribuzione con Docker - -Vuoi eseguire ClawMetry in un container? Nessun problema! 🐳 - -**Avvio rapido con Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Esempio di Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Nota:** Quando esegui in Docker, monta le directory di dati + log del tuo agente (ad es. `~/.openclaw`, `~/.claude`, `~/.codex`) così ClawMetry può rilevare automaticamente la tua configurazione. - -## Requisiti - -- Python 3.8+ -- Flask (installato automaticamente tramite pip) -- Un runtime di agente AI sulla stessa macchina: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, o QM (oppure volumi montati per Docker) -- Linux o macOS - -## Supporto NemoClaw / OpenShell - -ClawMetry rileva automaticamente [NemoClaw](https://github.com/NVIDIA/NemoClaw), il wrapper di sicurezza enterprise di NVIDIA per OpenClaw che esegue gli agenti all'interno di container OpenShell sandboxati. - -Nella maggior parte dei casi non è necessaria alcuna configurazione aggiuntiva. Il daemon di sincronizzazione scopre automaticamente i file di sessione, sia che si trovino in `~/.openclaw/` sull'host sia all'interno di un container OpenShell. +| **Free** | OpenClaw + NVIDIA NemoClaw, dashboard completa, solo locale | $0 | +| **Starter** | Tutti gli altri runtime sopra elencati, vista flotta, sincronizzazione cloud | $9 per nodo / mese | +| **Pro** | Starter + governance: approvazioni, policy sul rischio degli strumenti, valutazioni, rilevamento anomalie, ottimizzatore dei costi, esportazione OTel | $19 per nodo / mese | -### Come funziona +I piani annuali, Enterprise e le cifre attuali sono disponibili su +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Le chiavi di licenza +self-hosted funzionano senza il cloud (`clawmetry license`). La suddivisione esatta +tra gratuito e a pagamento è in [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -ClawMetry rileva NemoClaw in due modi: +## I tuoi dati restano sul tuo computer -1. **Rilevamento del binario** — verifica la presenza della CLI `nemoclaw` ed esegue `nemoclaw status` per ottenere informazioni sulla sandbox -2. **Rilevamento del container** — analizza i container Docker in esecuzione alla ricerca di immagini `openshell`, `nemoclaw`, o `ghcr.io/nvidia/`, poi legge le sessioni tramite volumi montati o `docker cp` +ClawMetry legge i file di sessione e i log locali. Nulla lascia la tua macchina a meno +che tu non esegua `clawmetry connect`. Anche in quel caso, lo snapshot è crittografato +end-to-end con una chiave che non lascia mai la tua macchina, e viene decrittografato +nel tuo browser. -I file di sessione sincronizzati dai container NemoClaw sono taggati con metadati `runtime=nemoclaw` e `container_id` nella dashboard cloud, così puoi distinguerli a colpo d'occhio dalle sessioni OpenClaw standard. - -### Configurazione consigliata: daemon di sincronizzazione sull'HOST - -Per la migliore esperienza, esegui il daemon di sincronizzazione di ClawMetry sulla **macchina host** (non all'interno della sandbox). Questo evita le restrizioni della policy di rete di NemoClaw. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -Il daemon di sincronizzazione troverà automaticamente le sessioni all'interno di qualsiasi container OpenShell in esecuzione. - -### Opzionale: nome esplicito della sandbox - -Se il rilevamento automatico non funziona, indirizza ClawMetry verso la sandbox corretta: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Esecuzione all'interno della sandbox (avanzato) - -Se devi eseguire il daemon di sincronizzazione **all'interno** della sandbox OpenShell, aggiungi questa regola di egress alla tua policy di rete NemoClaw così può raggiungere l'API di ingest di ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Applica con: +## Installazione ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # poi: clawmetry ``` -### Porte ed endpoint - -| Endpoint | Porta | Protocollo | Richiesto | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Sì (daemon di sincronizzazione → cloud) | -| `localhost:8900` | 8900 | HTTP | Sì (interfaccia dashboard locale) | -| Socket Docker (`/var/run/docker.sock`) | — | Socket Unix | Per il rilevamento delle sessioni nei container | - -Il daemon di sincronizzazione effettua solo chiamate HTTPS in uscita verso `ingest.clawmetry.com`. Nessuna porta in ingresso è richiesta. - ---- - -## Distribuzione Cloud - -Consulta la **[Guida ai test Cloud](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** per tunnel SSH, reverse proxy e Docker. - -## Test - -Questo progetto è testato con BrowserStack. +Oppure il comando singolo: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +Richiede Python 3.8+ su macOS, Linux o Windows, e almeno un runtime di agente sulla +stessa macchina. Istruzioni Docker: [docs/DOCKER.md](docs/DOCKER.md). -## Telemetria +## Documentazione -ClawMetry invia ping anonimi sul ciclo di vita dell'installazione a -`https://app.clawmetry.com/api/install`: un ping `install` la prima -volta che esegui la CLI `clawmetry` su una nuova macchina, un ping `update` -alla prima esecuzione dopo l'aggiornamento a una nuova versione, e un ping `onboarded` -quando completi la scelta di onboarding nella dashboard. Usiamo questo -per contare le installazioni reali (i numeri grezzi di download da PyPI sono per circa il 98% mirror, CI -e ridownload da auto-aggiornamento) e per capire quali framework di agenti e -versioni sono realmente diffusi. +| | | +|---|---| +| [Compatibilità runtime](docs/compatibility.md) | Cosa legge ogni adattatore, e come aggiungere un runtime | +| [Entitlement](docs/ENTITLEMENTS.md) | Gratis vs a pagamento, matrice dei livelli, CLI delle licenze | +| [Approvazioni e policy](docs/APPROVALS.md) | Controllo pre-esecuzione, valutazione del rischio, approvazioni da telefono | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Esporta le tracce ovunque, importa OTLP da qualsiasi fonte | +| [Tracciamento SDK](docs/SDK_TRACKING.md) | Attribuzione dei costi per gli agenti che hai creato tu stesso | +| [Canali di chat](docs/CHANNELS.md) | Gli adattatori di chat mostrati in Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Configurazioni sandbox di NVIDIA NemoClaw | +| [Docker](docs/DOCKER.md) | Immagine, compose, mount dei volumi | +| [Architettura](ARCHITECTURE.md) · [Sviluppo](docs/DEVELOPMENT.md) | Come funziona internamente; esecuzione dal sorgente | +| [Telemetria](docs/TELEMETRY.md) | I ping anonimi di installazione e apertura desktop, e come disattivarli | -**Al massimo una POST per evento del ciclo di vita per versione**, contenente: - -| Campo | Esempio | Perché | -|---|---|---| -| `install_id` | UUID casuale memorizzato in `~/.clawmetry/install_id` | deduplicazione; anonimo finché non colleghi esplicitamente la sincronizzazione Cloud (il battito cardiaco autenticato del daemon porta poi con sé questo dato, collegando questa installazione al tuo account) | -| `event` | `install` / `update` / `onboarded` | installazione nuova rispetto ad aggiornamento di una esistente | -| `version` | `0.12.167` | quali versioni sono in circolazione | -| `os` / `os_version` | `Darwin` / `25.3.0` | priorità di supporto per piattaforma | -| `python` | `3.11.15` | matrice di supporto delle versioni Python | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | con quali agenti dovremmo integrarci successivamente | -| `is_ci` / `ci_provider` | `true` / `github_actions` | separa le installazioni umane dal rumore del CI | - -**Cosa NON inviamo**: IP (il cloud deriva il codice del paese lato server -dalla richiesta, poi scarta l'IP), hostname, nome utente, percorso dello spazio di lavoro, contenuto dei file, la tua api_key, la tua email, nulla di personale o specifico dello spazio di lavoro. Il payload sulla rete è verificabile in -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Disattivazione** (una qualsiasi di queste la disabilita permanentemente): +## Screenshot -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: token, sessioni, salute | **Brain**: flusso di eventi dell'agente in diretta | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Costi**: per modello e sessione | **Approvazioni**: filtra le chiamate a strumenti rischiose | -Un errore di rete qui non blocca mai l'esecuzione di `clawmetry`: il -ping è "fire-and-forget" su un thread daemon con un timeout di 3s. +Altri, per runtime: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). -## Cronologia delle Star +## Cronologia delle stelle @@ -433,11 +117,6 @@ ping è "fire-and-forget" su un thread daemon con un timeout di 3s. ## Licenza -MIT - ---- +MIT · Realizzato da [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Guarda il tuo agente pensare
- Creato da @vivekchand · clawmetry.com · Parte dell'ecosistema OpenClaw -

+ diff --git a/docs/i18n/ja/README.md b/docs/i18n/ja/README.md index 8aab7886d2..1316bca49a 100644 --- a/docs/i18n/ja/README.md +++ b/docs/i18n/ja/README.md @@ -1,405 +1,106 @@ - + > 日本語 translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**エージェントの思考を見える化。** **20種類のAIエージェントランタイム**に対応したリアルタイム可観測性: [OpenClaw](https://github.com/openclaw/openclaw)、[NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)、Claude Code、OpenAI Codex、その他16種類。エージェント群全体を1つのダッシュボードで。 +**エージェントの思考を可視化。** **23種類のAIエージェントランタイム**に対応したリアルタイム観測ダッシュボード: [OpenClaw](https://github.com/openclaw/openclaw)、[NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)、Claude Code、OpenAI Codex、他19種。エージェントフリート全体を1つのダッシュボードで。 -> 🌐 **他言語で読む:** [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/) +> 🌐 **他の言語で読む:** [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/) -コマンド一つ。設定不要。すべて自動検出。 +1つのコマンド。設定不要。すべて自動検出。 ```bash pip install clawmetry && clawmetry ``` -**http://localhost:8900** で開けば、それで完了です。 +**http://localhost:8900** で起動します。設定は不要です。すでにお使いのエージェントランタイムを自動的に見つけ出し、読み取り専用でアクセスし、動作には一切手を加えません。 ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 20種類のエージェントランタイムに対応 - -ClawMetryはOpenClaw向けの可観測性ツールとして始まり、今では**エージェント群全体**を1つのダッシュボードで計測し、マシン上の各ランタイムを自動検出します。 - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClawとNemoClawはオープンソース版アプリで無料利用でき、その他のランタイムはClawMetry Cloudまたはセルフホスト版のProライセンスで利用可能になります。ヘッダーからランタイムを切り替えると、コスト・トークン・ツール・トレースなど各タブがそのランタイムの範囲に再スコープされます。正確な無料/有料の区分、ティア比較表、`/api/entitlement`の形式、`clawmetry license` CLIについては**[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)**を参照してください。 - -## 提供される機能 - -- **Flow** — チャンネル、ブレイン、ツールを流れるメッセージをリアルタイムのアニメーション図で表示 -- **Overview** — ヘルスチェック、アクティビティのヒートマップ、セッション数、モデル情報 -- **Usage** — 日次/週次/月次の内訳付きトークン・コスト追跡 -- **Sessions** — モデル、トークン、最終アクティビティを含むアクティブなエージェントセッション -- **Crons** — ステータス、次回実行、実行時間を含むスケジュールジョブ -- **Logs** — 色分けされたリアルタイムログストリーミング -- **Memory** — SOUL.md、MEMORY.md、AGENTS.md、デイリーノートの閲覧 -- **Transcripts** — セッション履歴を読むためのチャットバブルUI -- **Alerts** — 予算上限、エラー率トリガー、エージェントオフライン検知。Slack、Discord、PagerDuty、Telegram、Emailへのルーティング -- **Approvals** — 破壊的な削除、force push、DB変更、sudo、パッケージインストール、ネットワーク呼び出しをワンクリック承認の背後でゲート - -## スクリーンショット - -### 🧠 Brain — ライブエージェントイベントストリーム -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — トークン使用量とセッションサマリー -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — リアルタイムツールコールフィード -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — モデル・セッション別のコスト内訳 -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — ワークスペースファイルブラウザ -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — セキュリティ体制と監査ログ -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — 予算上限、エラー率トリガー、Slack / Discord / PagerDuty / Emailへのwebhook -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +## 23種類のエージェントランタイムに対応 -### ✋ Approvals — リスクのあるツールコールを手動承認の背後でゲート。ポリシーに基づく保護ルール -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) +**オープンソース版で無料:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -**Claude Codeの実行前ブロッキング** — 1つのコマンドで、該当するツールコールを実行*前*に一時停止し、あなたの判断を待つPreToolUseフックがインストールされます([クラウドのプッシュ通知](https://app.clawmetry.com/push)を有効にすればスマートフォンからワンタップで対応可能): +**有料プラン:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -```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 -``` - -拒否(deny)はその1つのツールコールのみをブロックします。エージェントはセッションを維持したまま別のアプローチを試すことができます。スマートフォンでの承認はClaude Code自体の権限プロンプトをスキップします(すでに回答済みのため)。マッチしないツールは約40msのコストで、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フロントエンド開発 +SDKを使って独自のエージェントを構築していますか?インターセプターがそのLLM呼び出しも追跡します。詳しくは[docs/SDK_TRACKING.md](docs/SDK_TRACKING.md)をご覧ください。 -v2 Reactアプリは`frontend/`にあり、v2を有効にしてFlaskサーバーを起動すると`/v2`で配信されます。 +## できること -開発中はターミナルを2つ使用します。 +- **セッションとトランスクリプト**: 各エージェントが何をしたかをターンごとに、リプレイ付きで確認 +- **コストとトークン**: ランタイム、モデル、セッション、日単位で集計し、異常検知フラグ付き +- **フロー**: チャンネル、モデル、ツールを行き交うメッセージのリアルタイム図解 +- **ブレイン**: 発生した瞬間の推論とツール呼び出しのイベントストリーム +- **メモリとスキル**: 各ランタイムが実際に読み込んだファイルとスキル +- **ヘルスとログ**: ディスク、メモリ、エラー率、レート制限、ライブログストリーム +- **アラート**: 予算上限、エラー急増、エージェントオフラインを検知し、Slack、Discord、PagerDuty、Telegram、Emailへ通知 +- **承認**: リスクのあるツール呼び出しを実行*前*に一時停止し、スマートフォンから承認([詳細](docs/APPROVALS.md)) -```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アプリは追加のCORS設定なしでローカルのFlaskサーバーと通信できます。 - -Pythonパッケージに同梱するバンドルをビルドするには: - -```bash -cd frontend -npm run build -``` - -本番用バンドルは`clawmetry/static/v2/dist/`に書き出されます。 - -## ランタイム/エージェントの互換性 - -ClawMetryはOpenClawだけでなく、多くのAIエージェントランタイムを可観測化します。OpenClaw以外の各ランタイムは、ネイティブのセッション形式をClawMetryの統一形式に変換する専用のリーダーアダプターを備えています。デーモンはこれらを同じDuckDBストア+クラウドスナップショットに取り込み、ランタイムでタグ付けします。Session replayタブは、複数のランタイムが存在する場合に**ランタイム切り替え機能**を表示します。完全な対応表とランタイム追加ガイドについては[`docs/compatibility.md`](docs/compatibility.md)を、OpenClawファミリーの入門については[`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md)を参照してください。 - -[Perplexityのnumbat](https://github.com/perplexityai/numbat)エージェントセキュリティツールを実行していますか?ClawMetryはその検出結果と実施判定をそのまま取り込みます。詳細は[`docs/NUMBAT.md`](docs/NUMBAT.md)を参照してください。 - -| ランタイム/エージェント | ステータス | 備考 | +| プラン | 対象範囲 | 価格 | |---|---|---| -| **OpenClaw** | ネイティブ | リファレンスランタイム、自動検出 | -| **PicoClaw** | ベータアダプター | フラットな`providers.Message`のJSONL(`~/.picoclaw/workspace/sessions`)。トランスクリプト、モデル、ツールコール。 | -| **NanoClaw** | ベータアダプター | セッションごとのSQLite(`data/v2-sessions`)。トランスクリプト+メッセージ数。 | -| **Hermes** | ベータアダプター | SQLite `~/.hermes/state.db`。トランスクリプト、モデル、トークン/コスト。 | -| **Claude Code** | ベータアダプター | JSONL `~/.claude/projects/.../.jsonl`。トランスクリプト、モデル、ツールコール+thinking、トークン使用量。 | -| **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`。ワークフロー実行、ノード実行、AI Agentプロンプト、n8nが記録している場合のモデル+トークン。 | -| **Antigravity** | ベータアダプター | `~/.gemini//brain/`配下のBrain JSONL。会話、ツールステップ、thinking、生成ごとのGeminiトークン分割+コスト、バックグラウンド生成の消費。 | -| **GitHub Copilot** | ベータアダプター | Copilot CLIの`events.jsonl`(`~/.copilot/session-state/`配下)+`session-store.db`(呼び出しごとの使用量台帳)。会話、ツールコール、モデルルーティング、キャッシュを考慮したトークン分割、ベンダー請求のAIクレジットコスト。 | -| **Grok** | ベータアダプター | xAI Grok Build CLI(`~/.grok/bin/grok`配下のRustバイナリ): グローバルイベントログ`~/.grok/logs/unified.jsonl`+セッションごとの`~/.grok/sessions///{events.jsonl,summary.json}`。会話、ターンごとのトークン分割、モデルルーティング、および`~/.grok/upload_queue/`にステージングされるCLIの送信リポジトリペイロード(マシンから何が送信されたかを確認可能)。 | - -「ベータアダプター」とは、ClawMetryがそのランタイムの実際のディスク上フォーマットに対応するリーダーを提供しており、それぞれが実マシンでの実インストールに対してビルド・検証済み(`tests/fixtures/runtimes//`を参照)であることを意味します。アダプターは読み取り専用で、それぞれが自身のランタイムが実際に何をディスクに保存しているかについて正直です(例: PicoClaw/NanoClaw/Cursorはトークンコストをディスクに書き込みません)。1つのノードで複数のランタイムが動作している場合、ランタイム切り替え機能によりセッションビューを1つに絞ってクリーンに深掘りできます。 - -## 任意のSDKエージェントを追跡 — アウトループ・コスト帰属 - -上記のランタイムはいずれもセッションをディスクに書き込みます。あなた自身の**プロダクションエージェント**、つまりOpenAI Agents SDK、LangChain、Vercel AI SDK、LlamaIndex、E2B、あるいは素の`httpx`ループで構築したものは、そうではありません。ClawMetryのゼロ設定インターセプターは、`httpx`/`requests`をモンキーパッチすることで、そうしたエージェントのLLM呼び出し(コスト、トークン、レイテンシ、エラー)を引き続き捕捉します。 - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()`(または`CLAWMETRY_SOURCE=support-agent`環境変数)は各呼び出しに**名前付きソース**をタグ付けするため、実行するすべてのプロダクトがダッシュボードのOverviewにある**🔌 Out-loop sources**カードにファーストクラスかつコスト帰属可能な行として表示されます。エージェントごとの呼び出し数、プロバイダー、レイテンシ、エラー率がわかります。ソースを設定しない場合でも呼び出しは追跡され続けますが、そのカードは非表示のままになります。 - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -これはランタイムアダプターと同じデータ層(DuckDB → クラウドスナップショット)にフィードされるため、アウトループソースも他のデータと同様にE2E暗号化されてクラウドダッシュボードに同期されます。 - -## OpenTelemetry — ベンダーニュートラル、トレースをどこへでも送信 - -ClawMetryは**GenAIセマンティック規約**を用いて双方向で**OpenTelemetry**を話すため、エージェントのトレースが1つのツールにロックインされることはありません。 - -各セッション(LLM呼び出し、ツール、サブエージェント、トークン、コスト)をOTLP/HTTPのGenAIスパンとして、任意のコレクター(Datadog、Grafana、Honeycomb、あるいは自前のOTel Collector)に**エクスポート**: - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -認証ヘッダーとポーリング間隔はオプションの環境変数です。 - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**取り込み** — 組み込みのOTLPレシーバーは、`/v1/traces`、`/v1/logs`、`/v1/metrics`で他の任意のソースからのトレース、ログ、メトリクスを受け付けます。OpenTelemetryで計装された任意のアプリをここに向けてください。 - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSONのトレースとログは、素の`pip install clawmetry`だけで動作し、追加パッケージは不要です。Protobuf取り込み(およびOTLP/JSONメトリクス)には`pip install clawmetry[otel]`が必要です。独自の`service.name`を設定したアプリは、ランタイム切り替え機能上で独自のエージェントとして、そのコストとトークンとともに表示されます。 - -ゼロ設定・ローカルファーストなClawMetryダッシュボードと、チームがすでに運用しているどんなバックエンドにもデータを送れる自由の両方が手に入ります。ロックインなし、第二のエージェントのインストールも不要です。 - -## 設定 - -ほとんどの人には設定は不要です。ClawMetryはワークスペース、ログ、セッション、cronを自動検出します。 - -カスタマイズが必要な場合: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -すべてのオプション: `clawmetry --help` - -## 対応チャンネル - -ClawMetryは設定済みのすべてのOpenClawチャンネルについてライブアクティビティを表示します。`openclaw.json`で実際に設定されているチャンネルのみがFlowダイアグラムに表示され、未設定のチャンネルは自動的に非表示になります。 - -Flow内の任意のチャンネルノードをクリックすると、受信/送信メッセージ数とともにライブのチャットバブルビューが表示されます。 - -| チャンネル | ステータス | ライブポップアップ | 備考 | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ フル対応 | ✅ | メッセージ、統計、10秒更新 | -| 💬 **iMessage** | ✅ フル対応 | ✅ | `~/Library/Messages/chat.db`を直接読み取り | -| 💚 **WhatsApp** | ✅ フル対応 | ✅ | WhatsApp Web(Baileys)経由 | -| 🔵 **Signal** | ✅ フル対応 | ✅ | signal-cli経由 | -| 🟣 **Discord** | ✅ フル対応 | ✅ | ギルド+チャンネル検出 | -| 🟪 **Slack** | ✅ フル対応 | ✅ | ワークスペース+チャンネル検出 | -| 🌐 **Webchat** | ✅ フル対応 | ✅ | 組み込みWeb UIセッション | -| 📡 **IRC** | ✅ フル対応 | ✅ | ターミナル風バブルUI | -| 🍏 **BlueBubbles** | ✅ フル対応 | ✅ | BlueBubbles REST API経由のiMessage | -| 🔵 **Google Chat** | ✅ フル対応 | ✅ | Chat API Webhook経由 | -| 🟣 **MS Teams** | ✅ フル対応 | ✅ | Teamsボットプラグイン経由 | -| 🔷 **Mattermost** | ✅ フル対応 | ✅ | セルフホスト型チームチャット | -| 🟩 **Matrix** | ✅ フル対応 | ✅ | 分散型、E2EE対応 | -| 🟢 **LINE** | ✅ フル対応 | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ フル対応 | ✅ | 分散型NIP-04 DM | -| 🟣 **Twitch** | ✅ フル対応 | ✅ | IRC接続経由のチャット | -| 🔷 **Feishu/Lark** | ✅ フル対応 | ✅ | WebSocketイベントサブスクリプション | -| 🔵 **Zalo** | ✅ フル対応 | ✅ | Zalo Bot API | - -> **自動検出:** ClawMetryは`~/.openclaw/openclaw.json`を読み取り、実際に設定されているチャンネルのみをレンダリングします。手動設定は不要です。 - -## Dockerデプロイ - -コンテナでClawMetryを実行したいですか?問題ありません 🐳 - -**Dockerでのクイックスタート:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Composeの例:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **注意:** Dockerで実行する場合、ClawMetryがセットアップを自動検出できるように、エージェントのデータディレクトリとログディレクトリ(例: `~/.openclaw`、`~/.claude`、`~/.codex`)をマウントしてください。 - -## 動作要件 - -- Python 3.8以上 -- Flask(pip経由で自動インストール) -- 同一マシン上のAIエージェントランタイム: OpenClaw、NVIDIA NemoClaw、Claude Code、Codex、Cursor、Goose、Hermes、opencode、Qwen Code、Aider、NanoClaw、PicoClaw、Pi、Deep Agents、n8n、Antigravity、GitHub Copilot、Grok、またはQM(Dockerの場合はマウントされたボリュームでも可) -- LinuxまたはmacOS - -## NemoClaw / OpenShellサポート - -ClawMetryは[NemoClaw](https://github.com/NVIDIA/NemoClaw)(サンドボックス化されたOpenShellコンテナ内でエージェントを実行する、NVIDIAのエンタープライズ向けOpenClawセキュリティラッパー)を自動的に検出します。 - -ほとんどの場合、追加の設定は不要です。同期デーモンは、セッションファイルがホスト上の`~/.openclaw/`にあるか、OpenShellコンテナ内にあるかに関わらず自動的に検出します。 - -### 動作の仕組み +| **無料** | OpenClaw + NVIDIA NemoClaw、フルダッシュボード、ローカルのみ | $0 | +| **スターター** | 上記以外の全ランタイム、フリートビュー、クラウド同期 | ノードあたり月額$9 | +| **Pro** | スターター + ガバナンス機能: 承認、ツールリスクポリシー、評価、異常検知、コストオプティマイザー、OTelエクスポート | ノードあたり月額$19 | -ClawMetryは2つの方法でNemoClawを検出します。 +年間プラン、Enterprise、最新の料金は +**[clawmetry.com/pricing](https://clawmetry.com/pricing)** をご覧ください。セルフホストのライセンスキー +(`clawmetry license`)はクラウドなしでも動作します。無料/有料の詳細な区分は +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)に記載されています。 -1. **バイナリ検出** — `nemoclaw` CLIの有無を確認し、`nemoclaw status`を実行してサンドボックス情報を取得 -2. **コンテナ検出** — 実行中のDockerコンテナを`openshell`、`nemoclaw`、`ghcr.io/nvidia/`イメージについてスキャンし、ボリュームマウントまたは`docker cp`経由でセッションを読み取り +## データはお使いのマシンに留まります -NemoClawコンテナから同期されたセッションファイルには、クラウドダッシュボード上で`runtime=nemoclaw`と`container_id`メタデータがタグ付けされるため、標準的なOpenClawセッションとひと目で区別できます。 +ClawMetryはローカルのセッションファイルとログを読み取ります。`clawmetry connect` +を実行しない限り、データが外部に送信されることはありません。実行した場合でも、 +スナップショットはお使いのマシンから外に出ない鍵でエンドツーエンド暗号化され、 +ブラウザ側で復号されます。 -### 推奨セットアップ: ホスト上での同期デーモン実行 - -最良の体験のためには、ClawMetryの同期デーモンをサンドボックスの内部ではなく**ホストマシン**上で実行してください。これによりNemoClawのネットワークポリシー制限を回避できます。 - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -同期デーモンは、実行中のOpenShellコンテナ内のセッションを自動的に検出します。 - -### オプション: サンドボックス名の明示指定 - -自動検出が機能しない場合は、ClawMetryに正しいサンドボックスを指定してください。 - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### サンドボックス内での実行(上級者向け) - -同期デーモンをOpenShellサンドボックスの**内部**で実行する必要がある場合は、ClawMetryのingest APIに到達できるように、NemoClawネットワークポリシーに以下のegressルールを追加してください。 - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -適用方法: +## インストール ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # then: clawmetry ``` -### ポートとエンドポイント +またはワンライナー: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -| エンドポイント | ポート | プロトコル | 必須 | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | 必須(同期デーモン → クラウド) | -| `localhost:8900` | 8900 | HTTP | 必須(ローカルダッシュボードUI) | -| Dockerソケット(`/var/run/docker.sock`) | — | Unixソケット | コンテナのセッション検出用 | +macOS、Linux、Windowsで動作するPython 3.8以上、および同じマシン上に少なくとも1つの +エージェントランタイムが必要です。Dockerでの手順は[docs/DOCKER.md](docs/DOCKER.md)をご覧ください。 -同期デーモンは`ingest.clawmetry.com`への送信HTTPS呼び出しのみを行います。受信ポートは不要です。 +## ドキュメント ---- +| | | +|---|---| +| [ランタイム互換性](docs/compatibility.md) | 各アダプターが読み取る内容と、ランタイムの追加方法 | +| [エンタイトルメント](docs/ENTITLEMENTS.md) | 無料版と有料版の違い、ティア一覧、ライセンスCLI | +| [承認とポリシー](docs/APPROVALS.md) | 実行前ゲーティング、リスクスコアリング、スマートフォン承認 | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | どこへでもトレースをエクスポートし、どこからでもOTLPを取り込む | +| [SDKトラッキング](docs/SDK_TRACKING.md) | 自作エージェントのコスト帰属 | +| [チャットチャンネル](docs/CHANNELS.md) | フローに表示されるチャットアダプター | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | サンドボックス化されたNVIDIA NemoClawのセットアップ | +| [Docker](docs/DOCKER.md) | イメージ、compose、ボリュームマウント | +| [アーキテクチャ](ARCHITECTURE.md) · [開発](docs/DEVELOPMENT.md) | 内部の仕組み、ソースからの実行方法 | +| [テレメトリー](docs/TELEMETRY.md) | 匿名のインストール/デスクトップ起動時のping、およびその無効化方法 | -## クラウドデプロイ - -SSHトンネル、リバースプロキシ、Dockerについては**[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)**を参照してください。 - -## テスト - -このプロジェクトはBrowserStackでテストされています。 - -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) - -## テレメトリー - -ClawMetryは、新しいマシンで初めて`clawmetry` CLIを実行した際の`install`ピング1回、新バージョンへのアップグレード後の初回実行時の`update`ピング1回、ダッシュボード内オンボーディングの選択を完了した際の`onboarded`ピング1回という、匿名のインストールライフサイクルのpingを`https://app.clawmetry.com/api/install`に送信します。これは実際のインストール数をカウントするため(生のPyPIダウンロード数の約98%はミラー、CI、自動更新の再ダウンロードです)、そしてどのエージェントフレームワークとバージョンが実際に使われているかを把握するために使用しています。 - -**ライフサイクルイベント・バージョンごとに最大1回のPOST**で、以下を含みます。 - -| フィールド | 例 | 理由 | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id`に保存されるランダムUUID | 重複排除。Cloud syncを明示的に接続するまでは匿名(接続後は認証済みのデーモンハートビートがこれを運び、このインストールをあなたのアカウントに紐付けます) | -| `event` | `install` / `update` / `onboarded` | 新規インストールか既存のアップグレードか | -| `version` | `0.12.167` | どのバージョンが実際に使われているか | -| `os` / `os_version` | `Darwin` / `25.3.0` | プラットフォーム対応の優先順位 | -| `python` | `3.11.15` | Pythonバージョン対応マトリクス | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | 次にどのエージェントと連携すべきか | -| `is_ci` / `ci_provider` | `true` / `github_actions` | 人間によるインストールとCIのノイズを区別 | +## スクリーンショット -**送信しない情報**: IP(クラウドはリクエストからサーバー側で国コードを導出した後、IPを破棄します)、ホスト名、ユーザー名、ワークスペースのパス、ファイル内容、あなたのapi_key、あなたのメールアドレス、その他PIIやワークスペース固有の情報。ワイヤー上のペイロードは[`clawmetry/telemetry.py`](clawmetry/telemetry.py)で監査可能です。 +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **概要**: トークン、セッション、ヘルス | **ブレイン**: ライブエージェントイベントストリーム | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **コスト**: モデル別・セッション別 | **承認**: リスクのあるツール呼び出しをゲート | -**オプトアウト**(以下のいずれか1つで永久に無効化されます): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -ネットワーク障害がこれによって`clawmetry`の実行をブロックすることはありません。このpingはデーモンスレッド上でfire-and-forgetかつタイムアウト3秒です。 +ランタイムごとの詳細: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md)。 ## スター履歴 @@ -413,11 +114,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## ライセンス -MIT - ---- +MIT · Built by [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 エージェントの思考を見える化
- Built by @vivekchand · clawmetry.com · Part of the OpenClaw ecosystem -

+ diff --git a/docs/i18n/kn/README.md b/docs/i18n/kn/README.md index 57400eab6d..a475303d36 100644 --- a/docs/i18n/kn/README.md +++ b/docs/i18n/kn/README.md @@ -1,431 +1,107 @@ - + > ಕನ್ನಡ translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**ನಿಮ್ಮ ಏಜೆಂಟ್ ಆಲೋಚಿಸುವುದನ್ನು ನೋಡಿ.** **20 AI ಏಜೆಂಟ್ ರನ್‌ಟೈಮ್‌ಗಳಿಗೆ** ರಿಯಲ್-ಟೈಮ್ ಅಬ್ಸರ್ವಬಿಲಿಟಿ: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex ಮತ್ತು ಇನ್ನೂ 16. ನಿಮ್ಮ ಇಡೀ ಏಜೆಂಟ್ ಫ್ಲೀಟ್‌ಗೆ ಒಂದು ಡ್ಯಾಶ್‌ಬೋರ್ಡ್. +**ನಿಮ್ಮ ಏಜೆಂಟ್ ಆಲೋಚಿಸುವುದನ್ನು ನೋಡಿ.** **23 AI ಏಜೆಂಟ್ ರನ್‌ಟೈಮ್‌ಗಳಿಗೆ** ರಿಯಲ್-ಟೈಮ್ ಅವಲೋಕನ (observability): [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex ಮತ್ತು ಇನ್ನೂ 19. ನಿಮ್ಮ ಇಡೀ ಏಜೆಂಟ್ ಫ್ಲೀಟ್‌ಗೆ ಒಂದೇ ಡ್ಯಾಶ್‌ಬೋರ್ಡ್. > 🌐 **ಇದನ್ನು ಈ ಭಾಷೆಗಳಲ್ಲಿ ಓದಿ:** [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** ನಲ್ಲಿ ತೆರೆಯುತ್ತದೆ ಮತ್ತು ನೀವು ಮುಗಿಸಿದ್ದೀರಿ. +**http://localhost:8900** ನಲ್ಲಿ ತೆರೆಯುತ್ತದೆ. ಶೂನ್ಯ ಸಂರಚನೆ: ಇದು ನಿಮ್ಮಲ್ಲಿ ಈಗಾಗಲೇ ಇರುವ ಏಜೆಂಟ್ ರನ್‌ಟೈಮ್‌ಗಳನ್ನು ಪತ್ತೆಹಚ್ಚುತ್ತದೆ, ಅವುಗಳನ್ನು ಓದಲು-ಮಾತ್ರ ರೀತಿಯಲ್ಲಿ ಓದುತ್ತದೆ, ಮತ್ತು ಅವು ಹೇಗೆ ಚಲಿಸುತ್ತವೆ ಎಂಬುದರ ಬಗ್ಗೆ ಏನನ್ನೂ ಬದಲಾಯಿಸುವುದಿಲ್ಲ. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 20 ಏಜೆಂಟ್ ರನ್‌ಟೈಮ್‌ಗಳೊಂದಿಗೆ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ - -ClawMetry OpenClaw ಗಾಗಿ ಅಬ್ಸರ್ವಬಿಲಿಟಿಯಾಗಿ ಪ್ರಾರಂಭವಾಯಿತು, ಈಗ ಒಂದೇ ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನಲ್ಲಿ ನಿಮ್ಮ **ಇಡೀ ಏಜೆಂಟ್ ಫ್ಲೀಟ್**ಅನ್ನು ಮೀಟರ್ ಮಾಡುತ್ತದೆ, ನಿಮ್ಮ ಯಂತ್ರದಲ್ಲಿನ ಪ್ರತಿಯೊಂದು ರನ್‌ಟೈಮ್ ಅನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಪತ್ತೆಹಚ್ಚುತ್ತದೆ: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw ಮತ್ತು NemoClaw ಓಪನ್-ಸೋರ್ಸ್ ಆ್ಯಪ್‌ನಲ್ಲಿ ಉಚಿತ; ಇತರ ರನ್‌ಟೈಮ್‌ಗಳು ClawMetry Cloud ಅಥವಾ ಸ್ವಯಂ-ಹೋಸ್ಟೆಡ್ Pro ಲೈಸೆನ್ಸ್‌ನೊಂದಿಗೆ ಬೆಳಗುತ್ತವೆ. ಹೆಡರ್‌ನಿಂದ ರನ್‌ಟೈಮ್‌ಗಳನ್ನು ಬದಲಾಯಿಸಿ ಮತ್ತು ಪ್ರತಿ ಟ್ಯಾಬ್ — ಕಾಸ್ಟ್, ಟೋಕನ್‌ಗಳು, ಟೂಲ್‌ಗಳು, ಟ್ರೇಸ್‌ಗಳು — ಆ ರನ್‌ಟೈಮ್‌ಗೆ ಮರು-ವ್ಯಾಪ್ತಿಗೊಳಿಸುತ್ತದೆ. ನಿಖರವಾದ ಉಚಿತ/ಪಾವತಿ ವಿಭಜನೆ, ಟಯರ್ ಮ್ಯಾಟ್ರಿಕ್ಸ್, `/api/entitlement` ಆಕಾರ, ಮತ್ತು `clawmetry license` CLI ಗಾಗಿ **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** ನೋಡಿ. - -## ನಿಮಗೆ ಏನು ಸಿಗುತ್ತದೆ - -- **Flow** — ಚಾನೆಲ್‌ಗಳು, ಬ್ರೈನ್, ಟೂಲ್‌ಗಳ ಮೂಲಕ ಹರಿಯುವ ಸಂದೇಶಗಳನ್ನು ಮತ್ತು ಹಿಂತಿರುಗುವುದನ್ನು ತೋರಿಸುವ ಲೈವ್ ಆನಿಮೇಟೆಡ್ ಡಯಾಗ್ರಾಮ್ -- **Overview** — ಆರೋಗ್ಯ ಪರೀಕ್ಷೆಗಳು, ಚಟುವಟಿಕೆ ಹೀಟ್‌ಮ್ಯಾಪ್, ಸೆಷನ್ ಎಣಿಕೆಗಳು, ಮಾಡೆಲ್ ಮಾಹಿತಿ -- **Usage** — ದೈನಂದಿನ/ವಾರದ/ಮಾಸಿಕ ವಿಭಜನೆಗಳೊಂದಿಗೆ ಟೋಕನ್ ಮತ್ತು ಕಾಸ್ಟ್ ಟ್ರ್ಯಾಕಿಂಗ್ -- **Sessions** — ಮಾಡೆಲ್, ಟೋಕನ್‌ಗಳು, ಕೊನೆಯ ಚಟುವಟಿಕೆಯೊಂದಿಗೆ ಸಕ್ರಿಯ ಏಜೆಂಟ್ ಸೆಷನ್‌ಗಳು -- **Crons** — ಸ್ಥಿತಿ, ಮುಂದಿನ ರನ್, ಅವಧಿಯೊಂದಿಗೆ ನಿಗದಿತ ಕಾರ್ಯಗಳು -- **Logs** — ಬಣ್ಣ-ಕೋಡೆಡ್ ರಿಯಲ್-ಟೈಮ್ ಲಾಗ್ ಸ್ಟ್ರೀಮಿಂಗ್ -- **Memory** — SOUL.md, MEMORY.md, AGENTS.md, ದೈನಂದಿನ ಟಿಪ್ಪಣಿಗಳನ್ನು ಬ್ರೌಸ್ ಮಾಡಿ -- **Transcripts** — ಸೆಷನ್ ಇತಿಹಾಸಗಳನ್ನು ಓದಲು ಚಾಟ್-ಬಬಲ್ UI -- **Alerts** — ಬಜೆಟ್ ಮಿತಿಗಳು, ದೋಷ-ದರ ಟ್ರಿಗರ್‌ಗಳು, ಏಜೆಂಟ್-ಆಫ್‌ಲೈನ್ ಪತ್ತೆ; Slack, Discord, PagerDuty, Telegram, Email ಗೆ ರೂಟ್ ಮಾಡುತ್ತದೆ -- **Approvals** — ವಿನಾಶಕಾರಿ ಡಿಲೀಟ್‌ಗಳು, ಫೋರ್ಸ್ ಪುಶ್‌ಗಳು, DB ಮ್ಯುಟೇಶನ್‌ಗಳು, sudo, ಪ್ಯಾಕೇಜ್ ಇನ್‌ಸ್ಟಾಲ್‌ಗಳು, ನೆಟ್‌ವರ್ಕ್ ಕರೆಗಳನ್ನು ಒಂದೇ-ಕ್ಲಿಕ್ ಸೈನ್-ಆಫ್‌ ಹಿಂದೆ ಗೇಟ್ ಮಾಡಿ - -## ಸ್ಕ್ರೀನ್‌ಶಾಟ್‌ಗಳು - -### 🧠 Brain — ಲೈವ್ ಏಜೆಂಟ್ ಈವೆಂಟ್ ಸ್ಟ್ರೀಮ್ -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — ಟೋಕನ್ ಬಳಕೆ ಮತ್ತು ಸೆಷನ್ ಸಾರಾಂಶ -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — ರಿಯಲ್-ಟೈಮ್ ಟೂಲ್ ಕಾಲ್ ಫೀಡ್ -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) +## 23 ಏಜೆಂಟ್ ರನ್‌ಟೈಮ್‌ಗಳೊಂದಿಗೆ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ -### 💰 Tokens — ಮಾಡೆಲ್ ಮತ್ತು ಸೆಷನ್ ಪ್ರಕಾರ ಕಾಸ್ಟ್ ವಿಭಜನೆ -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) +**ಓಪನ್ ಸೋರ್ಸ್ ಅಪ್ಲಿಕೇಶನ್‌ನಲ್ಲಿ ಉಚಿತ:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### 🧬 Memory — ವರ್ಕ್‌ಸ್ಪೇಸ್ ಫೈಲ್ ಬ್ರೌಸರ್ -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) +**ಪಾವತಿಸಿದ ಯೋಜನೆಯಲ್ಲಿ:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -### 🔐 Security — ಪೊಸ್ಚರ್ ಮತ್ತು ಆಡಿಟ್ ಲಾಗ್ -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) +ಪ್ರತಿಯೊಂದು ರನ್‌ಟೈಮ್‌ಗೂ ಒಂದೇ ಡ್ಯಾಶ್‌ಬೋರ್ಡ್ ಸಿಗುತ್ತದೆ. ಒಂದೇ ಬಾರಿಗೆ ಹಲವನ್ನು ಚಲಾಯಿಸಿ, ಮತ್ತು ಹೆಡರ್ ಸ್ವಿಚರ್ ಪ್ರತಿ ಟ್ಯಾಬ್ ಅನ್ನೂ ಅವುಗಳಲ್ಲಿ ಒಂದಕ್ಕೆ ಮರುಗುರಿಪಡಿಸುತ್ತದೆ. -### 🚨 Alerts — ಬಜೆಟ್ ಮಿತಿಗಳು, ದೋಷ-ದರ ಟ್ರಿಗರ್‌ಗಳು, Slack / Discord / PagerDuty / Email ಗೆ ವೆಬ್‌ಹುಕ್‌ಗಳು -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +ನಿಮ್ಮದೇ ಆದ ಏಜೆಂಟ್ ಅನ್ನು SDK ಬಳಸಿ ನಿರ್ಮಿಸಿದ್ದೀರಾ? ಇಂಟರ್‌ಸೆಪ್ಟರ್ ಅದರ LLM ಕರೆಗಳನ್ನೂ ಟ್ರ್ಯಾಕ್ ಮಾಡುತ್ತದೆ. [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md) ನೋಡಿ. -### ✋ Approvals — ಅಪಾಯಕಾರಿ ಟೂಲ್ ಕಾಲ್‌ಗಳನ್ನು ಕೈಪಿಡಿ ಸೈನ್-ಆಫ್‌ ಹಿಂದೆ ಗೇಟ್ ಮಾಡಿ; ಪಾಲಿಸಿ-ಬೆಂಬಲಿತ ರಕ್ಷಣಾ ನಿಯಮಗಳು -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**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 ನ ಸ್ವಂತ -ಪರ್ಮಿಷನ್ ಪ್ರಾಂಪ್ಟ್ ಅನ್ನು ಸ್ಕಿಪ್ ಮಾಡುತ್ತದೆ (ನೀವು ಈಗಾಗಲೇ ಉತ್ತರಿಸಿದ್ದೀರಿ). ಹೊಂದಾಣಿಕೆಯಾಗದ ಟೂಲ್‌ಗಳಿಗೆ ~40ms -ವೆಚ್ಚವಾಗುತ್ತದೆ ಮತ್ತು Claude Code ನ ಸಾಮಾನ್ಯ ಪರ್ಮಿಷನ್ ಫ್ಲೋಗೆ ಬೀಳುತ್ತವೆ. Claude Code ಸ್ವತಃ -ನಿಮಗಾಗಿ ಕಾಯುತ್ತಿರುವಾಗಲೂ ನಿಮಗೆ ಫೋನ್ ಪುಶ್ ಸಿಗುತ್ತದೆ (`permission_prompt` / -`idle_prompt` ನೋಟಿಫಿಕೇಶನ್‌ಗಳು). +- **ಸೆಷನ್‌ಗಳು ಮತ್ತು ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್‌ಗಳು**: ಪ್ರತಿ ಏಜೆಂಟ್ ಏನು ಮಾಡಿತು, ಟರ್ನ್ ಬೈ ಟರ್ನ್, ರೀಪ್ಲೇ ಸಹಿತ +- **ವೆಚ್ಚ ಮತ್ತು ಟೋಕನ್‌ಗಳು**: ರನ್‌ಟೈಮ್, ಮಾದರಿ, ಸೆಷನ್ ಮತ್ತು ದಿನದ ಪ್ರಕಾರ, ಅಸಂಗತತೆ ಫ್ಲ್ಯಾಗ್‌ಗಳೊಂದಿಗೆ +- **ಫ್ಲೋ**: ಚಾನೆಲ್‌ಗಳು, ಮಾದರಿಗಳು ಮತ್ತು ಟೂಲ್‌ಗಳ ಮೂಲಕ ಚಲಿಸುವ ಸಂದೇಶಗಳ ಲೈವ್ ರೇಖಾಚಿತ್ರ +- **ಬ್ರೈನ್**: ನಡೆಯುತ್ತಿರುವಂತೆಯೇ ರೀಸನಿಂಗ್ ಮತ್ತು ಟೂಲ್-ಕರೆ ಈವೆಂಟ್ ಸ್ಟ್ರೀಮ್ +- **ಮೆಮೊರಿ ಮತ್ತು ಸ್ಕಿಲ್‌ಗಳು**: ಪ್ರತಿ ರನ್‌ಟೈಮ್ ನಿಜವಾಗಿ ಲೋಡ್ ಮಾಡಿದ ಫೈಲ್‌ಗಳು ಮತ್ತು ಸ್ಕಿಲ್‌ಗಳು +- **ಆರೋಗ್ಯ ಮತ್ತು ಲಾಗ್‌ಗಳು**: ಡಿಸ್ಕ್, ಮೆಮೊರಿ, ದೋಷ ದರಗಳು, ರೇಟ್ ಲಿಮಿಟ್‌ಗಳು, ಲೈವ್ ಲಾಗ್ ಸ್ಟ್ರೀಮ್ +- **ಎಚ್ಚರಿಕೆಗಳು**: ಬಜೆಟ್ ಮಿತಿಗಳು, ದೋಷ ಏರಿಕೆಗಳು, ಏಜೆಂಟ್-ಆಫ್‌ಲೈನ್, Slack, Discord, PagerDuty, Telegram, Email ಗೆ ರೂಟ್ ಮಾಡಲಾಗಿದೆ +- **ಅನುಮೋದನೆಗಳು**: ಅಪಾಯಕಾರಿ ಟೂಲ್ ಕರೆಗಳನ್ನು ಅವು ಚಲಿಸುವ *ಮೊದಲೇ* ನಿಲ್ಲಿಸಿ ಮತ್ತು ನಿಮ್ಮ ಫೋನ್‌ನಿಂದ ಅನುಮೋದಿಸಿ ([ಹೇಗೆ](docs/APPROVALS.md)) -## ಇನ್‌ಸ್ಟಾಲ್ - -**ಒಂದೇ-ಲೈನರ್ (ಶಿಫಾರಸು ಮಾಡಲಾಗಿದೆ):** -```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 ಫ್ರಂಟ್‌ಎಂಡ್ ಅಭಿವೃದ್ಧಿ - -v2 React ಆ್ಯಪ್ `frontend/` ನಲ್ಲಿ ಇರುತ್ತದೆ ಮತ್ತು Flask -ಸರ್ವರ್ ಅನ್ನು v2 ಸಕ್ರಿಯಗೊಳಿಸಿ ಪ್ರಾರಂಭಿಸಿದಾಗ `/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 ಆ್ಯಪ್ ಹೆಚ್ಚುವರಿ CORS -ಸೆಟಪ್ ಇಲ್ಲದೆ ಸ್ಥಳೀಯ Flask ಸರ್ವರ್‌ನೊಂದಿಗೆ ಮಾತನಾಡಬಹುದು. - -Python ಪ್ಯಾಕೇಜ್‌ನೊಂದಿಗೆ ಶಿಪ್ ಆಗುವ ಬಂಡಲ್ ಅನ್ನು ನಿರ್ಮಿಸಲು: - -```bash -cd frontend -npm run build -``` - -ಪ್ರೊಡಕ್ಷನ್ ಬಂಡಲ್ ಅನ್ನು `clawmetry/static/v2/dist/` ಗೆ ಬರೆಯಲಾಗುತ್ತದೆ. - -## ರನ್‌ಟೈಮ್ / ಏಜೆಂಟ್ ಹೊಂದಾಣಿಕೆ - -ClawMetry ಕೇವಲ OpenClaw ಅಷ್ಟೇ ಅಲ್ಲ, ಅನೇಕ AI-ಏಜೆಂಟ್ ರನ್‌ಟೈಮ್‌ಗಳನ್ನು ಗಮನಿಸುತ್ತದೆ. ಪ್ರತಿ OpenClaw-ಅಲ್ಲದ ರನ್‌ಟೈಮ್ ಅದರ ಸ್ಥಳೀಯ ಸೆಷನ್ ಫಾರ್ಮ್ಯಾಟ್ ಅನ್ನು ClawMetry ನ ಏಕೀಕೃತ ಆಕಾರಗಳಿಗೆ ಭಾಷಾಂತರಿಸುವ ಸಮರ್ಪಿತ ರೀಡರ್ ಅಡಾಪ್ಟರ್ ಅನ್ನು ಶಿಪ್ ಮಾಡುತ್ತದೆ; ಡೀಮನ್ ಅವುಗಳನ್ನು ಅದೇ DuckDB ಸ್ಟೋರ್ + ಕ್ಲೌಡ್ ಸ್ನ್ಯಾಪ್‌ಶಾಟ್‌ಗೆ ಇಂಜೆಸ್ಟ್ ಮಾಡುತ್ತದೆ, ರನ್‌ಟೈಮ್‌ನೊಂದಿಗೆ ಟ್ಯಾಗ್ ಮಾಡಲಾಗಿದೆ, ಮತ್ತು ಒಂದಕ್ಕಿಂತ ಹೆಚ್ಚು ಇದ್ದಾಗ Session replay ಟ್ಯಾಬ್ **ರನ್‌ಟೈಮ್ ಸ್ವಿಚರ್** ಅನ್ನು ತೋರಿಸುತ್ತದೆ. ಪೂರ್ಣ ಮ್ಯಾಟ್ರಿಕ್ಸ್ + ರನ್‌ಟೈಮ್‌ಗಳನ್ನು ಸೇರಿಸುವ ಮಾರ್ಗದರ್ಶಿಗಾಗಿ [`docs/compatibility.md`](docs/compatibility.md) ನೋಡಿ, ಮತ್ತು OpenClaw-ಕುಟುಂಬ ಪ್ರೈಮರ್‌ಗಾಗಿ [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) ನೋಡಿ. - -[Perplexity ಯ numbat](https://github.com/perplexityai/numbat) ಏಜೆಂಟ್-ಸೆಕ್ಯುರಿಟಿ ಟೂಲ್ ಅನ್ನು ರನ್ ಮಾಡುತ್ತಿದ್ದೀರಾ? ClawMetry ಅದರ ಶೋಧನೆಗಳು ಮತ್ತು ಜಾರಿ ನಿರ್ಧಾರಗಳನ್ನು ಔಟ್-ಆಫ್-ದಿ-ಬಾಕ್ಸ್ ಇಂಜೆಸ್ಟ್ ಮಾಡುತ್ತದೆ — [`docs/NUMBAT.md`](docs/NUMBAT.md) ನೋಡಿ. - -| ರನ್‌ಟೈಮ್ / ಏಜೆಂಟ್ | ಸ್ಥಿತಿ | ಟಿಪ್ಪಣಿಗಳು | +| ಯೋಜನೆ | ಇದು ಏನನ್ನು ಒಳಗೊಂಡಿದೆ | ಬೆಲೆ | |---|---|---| -| **OpenClaw** | ಸ್ಥಳೀಯ | ಉಲ್ಲೇಖ ರನ್‌ಟೈಮ್, ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಪತ್ತೆಯಾಗಿದೆ | -| **PicoClaw** | ಬೀಟಾ ಅಡಾಪ್ಟರ್ | ಫ್ಲಾಟ್ `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`). ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್‌ಗಳು, ಮಾಡೆಲ್, ಟೂಲ್ ಕಾಲ್‌ಗಳು. | -| **NanoClaw** | ಬೀಟಾ ಅಡಾಪ್ಟರ್ | ಪ್ರತಿ-ಸೆಷನ್ SQLite (`data/v2-sessions`). ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್‌ಗಳು + ಸಂದೇಶ ಎಣಿಕೆಗಳು. | -| **Hermes** | ಬೀಟಾ ಅಡಾಪ್ಟರ್ | SQLite `~/.hermes/state.db`. ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್‌ಗಳು, ಮಾಡೆಲ್, ಟೋಕನ್‌ಗಳು/ಕಾಸ್ಟ್. | -| **Claude Code** | ಬೀಟಾ ಅಡಾಪ್ಟರ್ | JSONL `~/.claude/projects/.../.jsonl`. ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್‌ಗಳು, ಮಾಡೆಲ್, ಟೂಲ್ ಕಾಲ್‌ಗಳು + ಥಿಂಕಿಂಗ್, ಟೋಕನ್ ಬಳಕೆ. | -| **Codex** | ಬೀಟಾ ಅಡಾಪ್ಟರ್ | ರೋಲ್‌ಔಟ್ 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`. ವರ್ಕ್‌ಫ್ಲೋ ಎಕ್ಸಿಕ್ಯೂಶನ್‌ಗಳು, ನೋಡ್ ರನ್‌ಗಳು, AI Agent ಪ್ರಾಂಪ್ಟ್‌ಗಳು, n8n ದಾಖಲಿಸುವಲ್ಲಿ ಮಾಡೆಲ್ + ಟೋಕನ್‌ಗಳು. | -| **Antigravity** | ಬೀಟಾ ಅಡಾಪ್ಟರ್ | `~/.gemini//brain/` ಅಡಿಯಲ್ಲಿ ಬ್ರೈನ್ JSONL. ಸಂಭಾಷಣೆಗಳು, ಟೂಲ್ ಹಂತಗಳು, ಥಿಂಕಿಂಗ್, ಪ್ರತಿ-ಜನರೇಶನ್ Gemini ಟೋಕನ್ ವಿಭಜನೆ + ಕಾಸ್ಟ್, ಬ್ಯಾಕ್‌ಗ್ರೌಂಡ್-ಜನರೇಶನ್ ಬರ್ನ್. | -| **GitHub Copilot** | ಬೀಟಾ ಅಡಾಪ್ಟರ್ | `~/.copilot/session-state/` ಅಡಿಯಲ್ಲಿ Copilot CLI `events.jsonl` + ಪ್ರತಿ-ಕರೆ ಬಳಕೆ ಲೆಡ್ಜರ್ `session-store.db`. ಸಂಭಾಷಣೆಗಳು, ಟೂಲ್ ಕಾಲ್‌ಗಳು, ಮಾಡೆಲ್ ರೂಟಿಂಗ್, ಕ್ಯಾಶ್-ಅರಿವಿನ ಟೋಕನ್ ವಿಭಜನೆ, ವೆಂಡರ್-ಬಿಲ್ ಮಾಡಿದ AI-ಕ್ರೆಡಿಟ್ ಕಾಸ್ಟ್. | -| **Grok** | ಬೀಟಾ ಅಡಾಪ್ಟರ್ | xAI Grok Build CLI (`~/.grok/bin/grok` ಅಡಿಯಲ್ಲಿ Rust ಬೈನರಿ): ಜಾಗತಿಕ ಈವೆಂಟ್ ಲಾಗ್ `~/.grok/logs/unified.jsonl` + ಪ್ರತಿ-ಸೆಷನ್ `~/.grok/sessions///{events.jsonl,summary.json}`. ಸಂಭಾಷಣೆಗಳು, ಪ್ರತಿ-ಟರ್ನ್ ಟೋಕನ್ ವಿಭಜನೆ, ಮಾಡೆಲ್ ರೂಟಿಂಗ್, ಮತ್ತು `~/.grok/upload_queue/` ಅಡಿಯಲ್ಲಿ ಸ್ಟೇಜ್ ಮಾಡಿದ CLI ಯ ಔಟ್‌ಬೌಂಡ್ ರೆಪೊ ಪೇಲೋಡ್ ಇದರಿಂದ ನಿಮ್ಮ ಯಂತ್ರದಿಂದ ಏನು ಹೊರಟಿತು ಎಂಬುದನ್ನು ನೀವು ನೋಡಬಹುದು. | - -"ಬೀಟಾ ಅಡಾಪ್ಟರ್" ಎಂದರೆ ClawMetry ಆ ರನ್‌ಟೈಮ್‌ನ ನಿಜವಾದ ಆನ್-ಡಿಸ್ಕ್ ಫಾರ್ಮ್ಯಾಟ್‌ಗೆ ಒಂದು ರೀಡರ್ ಅನ್ನು ಶಿಪ್ ಮಾಡುತ್ತದೆ, ಪ್ರತಿಯೊಂದನ್ನೂ ನಿಜವಾದ ಯಂತ್ರದಲ್ಲಿನ ನಿಜವಾದ ಇನ್‌ಸ್ಟಾಲ್ ವಿರುದ್ಧ ನಿರ್ಮಿಸಲಾಗಿದೆ + ಪರಿಶೀಲಿಸಲಾಗಿದೆ (`tests/fixtures/runtimes//` ನೋಡಿ). ಅಡಾಪ್ಟರ್‌ಗಳು ಓದಲು-ಮಾತ್ರ; ಪ್ರತಿಯೊಂದೂ ಅದರ ರನ್‌ಟೈಮ್ ವಾಸ್ತವವಾಗಿ ಡಿಸ್ಕ್‌ನಲ್ಲಿ ಏನನ್ನು ಸಂಗ್ರಹಿಸುತ್ತದೆ ಎಂಬುದರ ಬಗ್ಗೆ ಪ್ರಾಮಾಣಿಕವಾಗಿದೆ (ಉದಾ. PicoClaw/NanoClaw/Cursor ಟೋಕನ್ ಕಾಸ್ಟ್ ಅನ್ನು ಡಿಸ್ಕ್‌ಗೆ ಬರೆಯುವುದಿಲ್ಲ). ಒಂದೇ ನೋಡ್‌ನಲ್ಲಿ ಹಲವಾರು ರನ್‌ಟೈಮ್‌ಗಳು ರನ್ ಆದಾಗ, ರನ್‌ಟೈಮ್ ಸ್ವಿಚರ್ ಸ್ಪಷ್ಟವಾದ ಆಳವಾದ-ಡೈವ್‌ಗಾಗಿ ಸೆಷನ್‌ಗಳ ವೀಕ್ಷಣೆಯನ್ನು ಒಂದಕ್ಕೆ ವ್ಯಾಪ್ತಿಗೊಳಿಸುತ್ತದೆ. - -## ಯಾವುದೇ SDK ಏಜೆಂಟ್ ಅನ್ನು ಟ್ರ್ಯಾಕ್ ಮಾಡಿ — ಔಟ್-ಲೂಪ್ ಕಾಸ್ಟ್ ಆಟ್ರಿಬ್ಯೂಶನ್ - -ಮೇಲಿನ ಎಲ್ಲಾ ರನ್‌ಟೈಮ್‌ಗಳು ಸೆಷನ್‌ಗಳನ್ನು ಡಿಸ್ಕ್‌ಗೆ ಬರೆಯುತ್ತವೆ. ನಿಮ್ಮ ಸ್ವಂತ **ಪ್ರೊಡಕ್ಷನ್ ಏಜೆಂಟ್** — ನೀವು OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, ಅಥವಾ ಸರಳ `httpx` ಲೂಪ್‌ನಲ್ಲಿ ನಿರ್ಮಿಸಿದದ್ದು — ಬರೆಯುವುದಿಲ್ಲ. ClawMetry ಯ ಶೂನ್ಯ-ಕಾನ್ಫಿಗ್ ಇಂಟರ್ಸೆಪ್ಟರ್ ಇನ್ನೂ `httpx`/`requests` ಅನ್ನು ಮಂಕಿ-ಪ್ಯಾಚ್ ಮಾಡುವ ಮೂಲಕ ಅದರ LLM ಕರೆಗಳನ್ನು (ಕಾಸ್ಟ್, ಟೋಕನ್‌ಗಳು, ಲೇಟೆನ್ಸಿ, ದೋಷಗಳು) ಸೆರೆಹಿಡಿಯುತ್ತದೆ: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (ಅಥವಾ `CLAWMETRY_SOURCE=support-agent` env ವೇರಿಯಬಲ್) ಪ್ರತಿ ಕರೆಯನ್ನು **ಹೆಸರಿಸಿದ ಮೂಲ**ದೊಂದಿಗೆ ಟ್ಯಾಗ್ ಮಾಡುತ್ತದೆ, ಆದ್ದರಿಂದ ನೀವು ರನ್ ಮಾಡುವ ಪ್ರತಿ ಉತ್ಪನ್ನವು ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನ Overview ನಲ್ಲಿ **🔌 ಔಟ್-ಲೂಪ್ ಮೂಲಗಳು** ಕಾರ್ಡ್‌ನಲ್ಲಿ ತನ್ನದೇ ಆದ ಪ್ರಥಮ-ದರ್ಜೆಯ, ಕಾಸ್ಟ್-ಆಟ್ರಿಬ್ಯೂಟ್ ಮಾಡಬಹುದಾದ ಸಾಲಿನಂತೆ ಗೋಚರಿಸುತ್ತದೆ — ಪ್ರತಿ ಏಜೆಂಟ್‌ಗೆ ಕರೆಗಳು, ಪ್ರೊವೈಡರ್‌ಗಳು, ಲೇಟೆನ್ಸಿ, ದೋಷ ದರ. ಯಾವುದೇ ಮೂಲ ಸೆಟ್ ಮಾಡಿಲ್ಲವೇ? ಕರೆಗಳು ಇನ್ನೂ ಟ್ರ್ಯಾಕ್ ಆಗುತ್ತವೆ; ಕಾರ್ಡ್ ಮಾತ್ರ ಮರೆಯಾಗಿ ಉಳಿಯುತ್ತದೆ. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -ಇದು ರನ್‌ಟೈಮ್ ಅಡಾಪ್ಟರ್‌ಗಳು ಫೀಡ್ ಮಾಡುವ ಅದೇ ಡೇಟಾ ಲೇಯರ್ ಆಗಿದೆ (DuckDB → ಕ್ಲೌಡ್ ಸ್ನ್ಯಾಪ್‌ಶಾಟ್), ಆದ್ದರಿಂದ ಔಟ್-ಲೂಪ್ ಮೂಲಗಳು ಉಳಿದೆಲ್ಲದರಂತೆ ಕ್ಲೌಡ್ ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ಗೆ ಸಿಂಕ್ ಆಗುತ್ತವೆ, E2E-ಎನ್‌ಕ್ರಿಪ್ಟ್ ಆಗಿ. - -## OpenTelemetry — ವೆಂಡರ್-ನ್ಯೂಟ್ರಲ್, ನಿಮ್ಮ ಟ್ರೇಸ್‌ಗಳನ್ನು ಎಲ್ಲಿಗೆ ಬೇಕಾದರೂ ಕಳುಹಿಸಿ - -ClawMetry ಎರಡೂ ದಿಕ್ಕುಗಳಲ್ಲಿ **OpenTelemetry** ಮಾತನಾಡುತ್ತದೆ, **GenAI ಸೆಮ್ಯಾಂಟಿಕ್ ಕನ್ವೆನ್ಶನ್‌ಗಳನ್ನು** ಬಳಸಿ, ಆದ್ದರಿಂದ ನಿಮ್ಮ ಏಜೆಂಟ್ ಟ್ರೇಸ್‌ಗಳು ಎಂದಿಗೂ ಒಂದೇ ಟೂಲ್‌ಗೆ ಲಾಕ್ ಆಗಿರುವುದಿಲ್ಲ. - -ಪ್ರತಿ ಸೆಷನ್ ಅನ್ನು — LLM ಕರೆಗಳು, ಟೂಲ್‌ಗಳು, ಸಬ್-ಏಜೆಂಟ್‌ಗಳು, ಟೋಕನ್‌ಗಳು, ಕಾಸ್ಟ್ — OTLP/HTTP GenAI ಸ್ಪ್ಯಾನ್‌ಗಳಾಗಿ ಯಾವುದೇ ಕಲೆಕ್ಟರ್‌ಗೆ **ಎಕ್ಸ್‌ಪೋರ್ಟ್** ಮಾಡಿ (Datadog, Grafana, Honeycomb, ಅಥವಾ ನಿಮ್ಮ ಸ್ವಂತ OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -ಆಥ್ ಹೆಡರ್‌ಗಳು ಮತ್ತು ಪೋಲ್ ಇಂಟರ್ವಲ್ ಐಚ್ಛಿಕ env ವೇರಿಯಬಲ್‌ಗಳಾಗಿವೆ: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**ಇಂಜೆಸ್ಟ್** — ಅಂತರ್ನಿರ್ಮಿತ OTLP ರಿಸೀವರ್ `/v1/traces`, `/v1/logs`, ಮತ್ತು `/v1/metrics` ನಲ್ಲಿ ಇನ್ನಾವುದೇ ಮೂಲದಿಂದ ಟ್ರೇಸ್‌ಗಳು, ಲಾಗ್‌ಗಳು, ಮತ್ತು ಮೆಟ್ರಿಕ್‌ಗಳನ್ನು ಸ್ವೀಕರಿಸುತ್ತದೆ. ಯಾವುದೇ OpenTelemetry-ಇನ್‌ಸ್ಟ್ರುಮೆಂಟೆಡ್ ಆ್ಯಪ್ ಅನ್ನು ಅದಕ್ಕೆ ತೋರಿಸಿ: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` +| **ಉಚಿತ** | OpenClaw + NVIDIA NemoClaw, ಪೂರ್ಣ ಡ್ಯಾಶ್‌ಬೋರ್ಡ್, ಸ್ಥಳೀಯ ಮಾತ್ರ | $0 | +| **ಸ್ಟಾರ್ಟರ್** | ಮೇಲಿನ ಇತರ ಎಲ್ಲ ರನ್‌ಟೈಮ್‌ಗಳು, ಫ್ಲೀಟ್ ವೀಕ್ಷಣೆ, ಕ್ಲೌಡ್ ಸಿಂಕ್ | ಪ್ರತಿ ನೋಡ್‌ಗೆ ತಿಂಗಳಿಗೆ $9 | +| **Pro** | ಸ್ಟಾರ್ಟರ್ + ಆಡಳಿತ: ಅನುಮೋದನೆಗಳು, ಟೂಲ್-ಅಪಾಯ ನೀತಿಗಳು, ಮೌಲ್ಯಮಾಪನಗಳು, ಅಸಂಗತತೆ ಪತ್ತೆ, ವೆಚ್ಚ ಆಪ್ಟಿಮೈಜರ್, OTel ರಫ್ತು | ಪ್ರತಿ ನೋಡ್‌ಗೆ ತಿಂಗಳಿಗೆ $19 | -OTLP/JSON ಟ್ರೇಸ್‌ಗಳು ಮತ್ತು ಲಾಗ್‌ಗಳು ಸಾದಾ `pip install clawmetry` ನಲ್ಲಿ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆ, ಯಾವುದೇ ಎಕ್ಸ್‌ಟ್ರಾಗಳ ಅಗತ್ಯವಿಲ್ಲ. Protobuf ಇಂಜೆಸ್ಟ್ (ಮತ್ತು OTLP/JSON ಮೆಟ್ರಿಕ್‌ಗಳಿಗೆ) `pip install clawmetry[otel]` ಅಗತ್ಯವಿದೆ. ತನ್ನದೇ `service.name` ಸೆಟ್ ಮಾಡುವ ಆ್ಯಪ್ ಅದರ ಕಾಸ್ಟ್ ಮತ್ತು ಟೋಕನ್‌ಗಳೊಂದಿಗೆ ರನ್‌ಟೈಮ್ ಸ್ವಿಚರ್‌ನಲ್ಲಿ ತನ್ನದೇ ಆದ ಏಜೆಂಟ್‌ ಆಗಿ ಗೋಚರಿಸುತ್ತದೆ. +ವಾರ್ಷಿಕ ಯೋಜನೆಗಳು, Enterprise ಮತ್ತು ಪ್ರಸ್ತುತ ಸಂಖ್ಯೆಗಳು +**[clawmetry.com/pricing](https://clawmetry.com/pricing)** ನಲ್ಲಿ ಲಭ್ಯವಿವೆ. ಸ್ವಯಂ-ಹೋಸ್ಟ್ ಮಾಡಿದ ಲೈಸೆನ್ಸ್ +ಕೀಗಳು ಕ್ಲೌಡ್ ಇಲ್ಲದೆಯೂ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆ (`clawmetry license`). ಉಚಿತ/ಪಾವತಿ ವಿಭಜನೆಯ ನಿಖರ ವಿವರ +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) ನಲ್ಲಿದೆ. -ನಿಮಗೆ ಶೂನ್ಯ-ಕಾನ್ಫಿಗ್, ಲೋಕಲ್-ಫಸ್ಟ್ ClawMetry ಡ್ಯಾಶ್‌ಬೋರ್ಡ್ **ಮತ್ತು** ನಿಮ್ಮ ತಂಡವು ಈಗಾಗಲೇ ರನ್ ಮಾಡುತ್ತಿರುವ ಯಾವುದೇ ಬ್ಯಾಕೆಂಡ್‌ನಲ್ಲಿ ನಿಮ್ಮ ಡೇಟಾ ಸಿಗುತ್ತದೆ — ಯಾವುದೇ ಲಾಕ್-ಇನ್ ಇಲ್ಲ, ಎರಡನೇ ಏಜೆಂಟ್ ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡುವ ಅಗತ್ಯವಿಲ್ಲ. +## ನಿಮ್ಮ ಡೇಟಾ ನಿಮ್ಮ ಯಂತ್ರದಲ್ಲೇ ಇರುತ್ತದೆ -## ಕಾನ್ಫಿಗರೇಶನ್ +ClawMetry ಸ್ಥಳೀಯ ಸೆಷನ್ ಫೈಲ್‌ಗಳು ಮತ್ತು ಲಾಗ್‌ಗಳನ್ನು ಓದುತ್ತದೆ. ನೀವು `clawmetry connect` ಚಲಾಯಿಸದ ಹೊರತು +ಯಾವುದೂ ನಿಮ್ಮ ಯಂತ್ರದಿಂದ ಹೊರಹೋಗುವುದಿಲ್ಲ. ಆಗಲೂ ಸ್ನ್ಯಾಪ್‌ಶಾಟ್ ನಿಮ್ಮ ಯಂತ್ರವನ್ನು ಎಂದಿಗೂ ಬಿಟ್ಟುಹೋಗದ +ಕೀಯೊಂದಿಗೆ ಎಂಡ್-ಟು-ಎಂಡ್ ಎನ್‌ಕ್ರಿಪ್ಟ್ ಆಗಿರುತ್ತದೆ, ಮತ್ತು ನಿಮ್ಮ ಬ್ರೌಸರ್‌ನಲ್ಲಿ ಡಿಕ್ರಿಪ್ಟ್ ಆಗುತ್ತದೆ. -ಹೆಚ್ಚಿನ ಜನರಿಗೆ ಯಾವುದೇ ಕಾನ್ಫಿಗ್ ಅಗತ್ಯವಿಲ್ಲ. ClawMetry ನಿಮ್ಮ ವರ್ಕ್‌ಸ್ಪೇಸ್, ಲಾಗ್‌ಗಳು, ಸೆಷನ್‌ಗಳು, ಮತ್ತು ಕ್ರಾನ್‌ಗಳನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಪತ್ತೆಹಚ್ಚುತ್ತದೆ. - -ನಿಮಗೆ ಕಸ್ಟಮೈಸ್ ಮಾಡುವ ಅಗತ್ಯವಿದ್ದರೆ: +## ಸ್ಥಾಪನೆ ```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization +pip install clawmetry # ನಂತರ: clawmetry ``` -ಎಲ್ಲಾ ಆಯ್ಕೆಗಳು: `clawmetry --help` - -## ಬೆಂಬಲಿತ ಚಾನೆಲ್‌ಗಳು - -ClawMetry ನೀವು ಕಾನ್ಫಿಗರ್ ಮಾಡಿದ ಪ್ರತಿ OpenClaw ಚಾನೆಲ್‌ಗೆ ಲೈವ್ ಚಟುವಟಿಕೆಯನ್ನು ತೋರಿಸುತ್ತದೆ. ನಿಮ್ಮ `openclaw.json` ನಲ್ಲಿ ವಾಸ್ತವವಾಗಿ ಸೆಟಪ್ ಆಗಿರುವ ಚಾನೆಲ್‌ಗಳು ಮಾತ್ರ Flow ಡಯಾಗ್ರಾಮ್‌ನಲ್ಲಿ ಗೋಚರಿಸುತ್ತವೆ — ಕಾನ್ಫಿಗರ್ ಮಾಡದಿರುವವುಗಳನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಮರೆಮಾಡಲಾಗುತ್ತದೆ. - -Flow ನಲ್ಲಿ ಯಾವುದೇ ಚಾನೆಲ್ ನೋಡ್ ಅನ್ನು ಕ್ಲಿಕ್ ಮಾಡಿ ಒಳಬರುವ/ಹೊರಹೋಗುವ ಸಂದೇಶ ಎಣಿಕೆಗಳೊಂದಿಗೆ ಲೈವ್ ಚಾಟ್ ಬಬಲ್ ವೀಕ್ಷಣೆಯನ್ನು ನೋಡಿ. - -| ಚಾನೆಲ್ | ಸ್ಥಿತಿ | ಲೈವ್ ಪಾಪ್‌ಅಪ್ | ಟಿಪ್ಪಣಿಗಳು | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ ಪೂರ್ಣ | ✅ | ಸಂದೇಶಗಳು, ಅಂಕಿಅಂಶಗಳು, 10s ರಿಫ್ರೆಶ್ | -| 💬 **iMessage** | ✅ ಪೂರ್ಣ | ✅ | `~/Library/Messages/chat.db` ಅನ್ನು ನೇರವಾಗಿ ಓದುತ್ತದೆ | -| 💚 **WhatsApp** | ✅ ಪೂರ್ಣ | ✅ | WhatsApp Web (Baileys) ಮೂಲಕ | -| 🔵 **Signal** | ✅ ಪೂರ್ಣ | ✅ | signal-cli ಮೂಲಕ | -| 🟣 **Discord** | ✅ ಪೂರ್ಣ | ✅ | ಗಿಲ್ಡ್ + ಚಾನೆಲ್ ಪತ್ತೆ | -| 🟪 **Slack** | ✅ ಪೂರ್ಣ | ✅ | ವರ್ಕ್‌ಸ್ಪೇಸ್ + ಚಾನೆಲ್ ಪತ್ತೆ | -| 🌐 **Webchat** | ✅ ಪೂರ್ಣ | ✅ | ಅಂತರ್ನಿರ್ಮಿತ ವೆಬ್ UI ಸೆಷನ್‌ಗಳು | -| 📡 **IRC** | ✅ ಪೂರ್ಣ | ✅ | ಟರ್ಮಿನಲ್-ಶೈಲಿಯ ಬಬಲ್ UI | -| 🍏 **BlueBubbles** | ✅ ಪೂರ್ಣ | ✅ | BlueBubbles REST API ಮೂಲಕ iMessage | -| 🔵 **Google Chat** | ✅ ಪೂರ್ಣ | ✅ | Chat API ವೆಬ್‌ಹುಕ್‌ಗಳ ಮೂಲಕ | -| 🟣 **MS Teams** | ✅ ಪೂರ್ಣ | ✅ | Teams ಬಾಟ್ ಪ್ಲಗಿನ್ ಮೂಲಕ | -| 🔷 **Mattermost** | ✅ ಪೂರ್ಣ | ✅ | ಸ್ವಯಂ-ಹೋಸ್ಟೆಡ್ ಟೀಮ್ ಚಾಟ್ | -| 🟩 **Matrix** | ✅ ಪೂರ್ಣ | ✅ | ವಿಕೇಂದ್ರೀಕೃತ, E2EE ಬೆಂಬಲ | -| 🟢 **LINE** | ✅ ಪೂರ್ಣ | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ ಪೂರ್ಣ | ✅ | ವಿಕೇಂದ್ರೀಕೃತ NIP-04 DM ಗಳು | -| 🟣 **Twitch** | ✅ ಪೂರ್ಣ | ✅ | IRC ಸಂಪರ್ಕದ ಮೂಲಕ ಚಾಟ್ | -| 🔷 **Feishu/Lark** | ✅ ಪೂರ್ಣ | ✅ | WebSocket ಈವೆಂಟ್ ಚಂದಾದಾರಿಕೆ | -| 🔵 **Zalo** | ✅ ಪೂರ್ಣ | ✅ | Zalo Bot API | - -> **ಸ್ವಯಂ-ಪತ್ತೆ:** ClawMetry ನಿಮ್ಮ `~/.openclaw/openclaw.json` ಅನ್ನು ಓದುತ್ತದೆ ಮತ್ತು ನೀವು ವಾಸ್ತವವಾಗಿ ಕಾನ್ಫಿಗರ್ ಮಾಡಿದ ಚಾನೆಲ್‌ಗಳನ್ನು ಮಾತ್ರ ರೆಂಡರ್ ಮಾಡುತ್ತದೆ. ಯಾವುದೇ ಕೈಪಿಡಿ ಸೆಟಪ್ ಅಗತ್ಯವಿಲ್ಲ. +ಅಥವಾ ಒಂದೇ-ಸಾಲಿನ ಆದೇಶ: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -## Docker ಡಿಪ್ಲಾಯ್‌ಮೆಂಟ್ +macOS, Linux ಅಥವಾ Windows ನಲ್ಲಿ Python 3.8+ ಮತ್ತು ಅದೇ ಯಂತ್ರದಲ್ಲಿ ಕನಿಷ್ಠ ಒಂದು ಏಜೆಂಟ್ +ರನ್‌ಟೈಮ್ ಬೇಕಾಗುತ್ತದೆ. Docker ಸೂಚನೆಗಳು: [docs/DOCKER.md](docs/DOCKER.md). -ClawMetry ಅನ್ನು ಕಂಟೈನರ್‌ನಲ್ಲಿ ರನ್ ಮಾಡಲು ಬಯಸುತ್ತೀರಾ? ಯಾವುದೇ ಸಮಸ್ಯೆ ಇಲ್ಲ! 🐳 - -**Docker ಜೊತೆಗೆ ತ್ವರಿತ ಪ್ರಾರಂಭ:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose ಉದಾಹರಣೆ:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **ಗಮನಿಸಿ:** Docker ನಲ್ಲಿ ರನ್ ಮಾಡುವಾಗ, ClawMetry ನಿಮ್ಮ ಸೆಟಪ್ ಅನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಪತ್ತೆಹಚ್ಚಲು ಸಾಧ್ಯವಾಗುವಂತೆ ನಿಮ್ಮ ಏಜೆಂಟ್‌ನ ಡೇಟಾ + ಲಾಗ್ ಡೈರೆಕ್ಟರಿಗಳನ್ನು (ಉದಾ. `~/.openclaw`, `~/.claude`, `~/.codex`) ಮೌಂಟ್ ಮಾಡಿ. - -## ಅವಶ್ಯಕತೆಗಳು - -- Python 3.8+ -- Flask (pip ಮೂಲಕ ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಇನ್‌ಸ್ಟಾಲ್ ಆಗುತ್ತದೆ) -- ಅದೇ ಯಂತ್ರದಲ್ಲಿ AI ಏಜೆಂಟ್ ರನ್‌ಟೈಮ್: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, ಅಥವಾ QM (ಅಥವಾ Docker ಗಾಗಿ ಮೌಂಟ್ ಮಾಡಿದ ವಾಲ್ಯೂಮ್‌ಗಳು) -- Linux ಅಥವಾ macOS - -## NemoClaw / OpenShell ಬೆಂಬಲ - -ClawMetry ಸ್ವಯಂಚಾಲಿತವಾಗಿ [NemoClaw](https://github.com/NVIDIA/NemoClaw) ಅನ್ನು ಪತ್ತೆಹಚ್ಚುತ್ತದೆ — ಇದು ಸ್ಯಾಂಡ್‌ಬಾಕ್ಸ್ಡ್ OpenShell ಕಂಟೈನರ್‌ಗಳ ಒಳಗೆ ಏಜೆಂಟ್‌ಗಳನ್ನು ರನ್ ಮಾಡುವ NVIDIA ಯ ಎಂಟರ್‌ಪ್ರೈಸ್ ಸೆಕ್ಯುರಿಟಿ ವ್ರ್ಯಾಪರ್ ಆಗಿದೆ OpenClaw ಗಾಗಿ. - -ಹೆಚ್ಚಿನ ಸಂದರ್ಭಗಳಲ್ಲಿ ಯಾವುದೇ ಹೆಚ್ಚುವರಿ ಕಾನ್ಫಿಗರೇಶನ್ ಅಗತ್ಯವಿಲ್ಲ. ಸಿಂಕ್ ಡೀಮನ್ ಸೆಷನ್ ಫೈಲ್‌ಗಳನ್ನು ಅವು ಹೋಸ್ಟ್‌ನಲ್ಲಿ `~/.openclaw/` ನಲ್ಲಿ ಇರಲಿ ಅಥವಾ OpenShell ಕಂಟೈನರ್‌ನ ಒಳಗೆ ಇರಲಿ, ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಕಂಡುಹಿಡಿಯುತ್ತದೆ. - -### ಇದು ಹೇಗೆ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ - -ClawMetry NemoClaw ಅನ್ನು ಎರಡು ರೀತಿಯಲ್ಲಿ ಪತ್ತೆಹಚ್ಚುತ್ತದೆ: - -1. **ಬೈನರಿ ಪತ್ತೆ** — `nemoclaw` CLI ಅನ್ನು ಪರಿಶೀಲಿಸುತ್ತದೆ ಮತ್ತು ಸ್ಯಾಂಡ್‌ಬಾಕ್ಸ್ ಮಾಹಿತಿ ಪಡೆಯಲು `nemoclaw status` ಅನ್ನು ರನ್ ಮಾಡುತ್ತದೆ -2. **ಕಂಟೈನರ್ ಪತ್ತೆ** — ಚಾಲನೆಯಲ್ಲಿರುವ Docker ಕಂಟೈನರ್‌ಗಳನ್ನು `openshell`, `nemoclaw`, ಅಥವಾ `ghcr.io/nvidia/` ಇಮೇಜ್‌ಗಳಿಗಾಗಿ ಸ್ಕ್ಯಾನ್ ಮಾಡುತ್ತದೆ, ನಂತರ ವಾಲ್ಯೂಮ್ ಮೌಂಟ್‌ಗಳು ಅಥವಾ `docker cp` ಮೂಲಕ ಸೆಷನ್‌ಗಳನ್ನು ಓದುತ್ತದೆ - -NemoClaw ಕಂಟೈನರ್‌ಗಳಿಂದ ಸಿಂಕ್ ಮಾಡಲಾದ ಸೆಷನ್ ಫೈಲ್‌ಗಳನ್ನು ಕ್ಲೌಡ್ ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನಲ್ಲಿ `runtime=nemoclaw` ಮತ್ತು `container_id` ಮೆಟಾಡೇಟಾದೊಂದಿಗೆ ಟ್ಯಾಗ್ ಮಾಡಲಾಗುತ್ತದೆ, ಆದ್ದರಿಂದ ಒಂದೇ ನೋಟದಲ್ಲಿ ನೀವು ಅವುಗಳನ್ನು ಪ್ರಮಾಣಿತ OpenClaw ಸೆಷನ್‌ಗಳಿಂದ ಪ್ರತ್ಯೇಕಿಸಬಹುದು. - -### ಶಿಫಾರಸು ಮಾಡಲಾದ ಸೆಟಪ್: HOST ನಲ್ಲಿ ಸಿಂಕ್ ಡೀಮನ್ - -ಅತ್ಯುತ್ತಮ ಅನುಭವಕ್ಕಾಗಿ, ClawMetry ಯ ಸಿಂಕ್ ಡೀಮನ್ ಅನ್ನು **ಹೋಸ್ಟ್ ಯಂತ್ರ**ದಲ್ಲಿ ರನ್ ಮಾಡಿ (ಸ್ಯಾಂಡ್‌ಬಾಕ್ಸ್‌ನ ಒಳಗೆ ಅಲ್ಲ). ಇದು NemoClaw ನೆಟ್‌ವರ್ಕ್ ಪಾಲಿಸಿ ನಿರ್ಬಂಧಗಳನ್ನು ತಪ್ಪಿಸುತ್ತದೆ. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` +## ಡಾಕ್ಸ್ -ಸಿಂಕ್ ಡೀಮನ್ ಚಾಲನೆಯಲ್ಲಿರುವ ಯಾವುದೇ OpenShell ಕಂಟೈನರ್‌ಗಳ ಒಳಗೆ ಸೆಷನ್‌ಗಳನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಕಂಡುಹಿಡಿಯುತ್ತದೆ. +| | | +|---|---| +| [ರನ್‌ಟೈಮ್ ಹೊಂದಾಣಿಕೆ](docs/compatibility.md) | ಪ್ರತಿ ಅಡಾಪ್ಟರ್ ಏನನ್ನು ಓದುತ್ತದೆ, ಮತ್ತು ರನ್‌ಟೈಮ್ ಅನ್ನು ಹೇಗೆ ಸೇರಿಸುವುದು | +| [Entitlements](docs/ENTITLEMENTS.md) | ಉಚಿತ vs ಪಾವತಿ, ಟಿಯರ್ ಮ್ಯಾಟ್ರಿಕ್ಸ್, ಲೈಸೆನ್ಸ್ CLI | +| [ಅನುಮೋದನೆಗಳು ಮತ್ತು ನೀತಿಗಳು](docs/APPROVALS.md) | ಪೂರ್ವ-ಕಾರ್ಯಗತಗೊಳಿಸುವಿಕೆ ಗೇಟಿಂಗ್, ಅಪಾಯ ಸ್ಕೋರಿಂಗ್, ಫೋನ್ ಅನುಮೋದನೆಗಳು | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | ಎಲ್ಲಿಂದಲಾದರೂ ಟ್ರೇಸ್‌ಗಳನ್ನು ರಫ್ತು ಮಾಡಿ, ಎಲ್ಲಿಂದಲಾದರೂ OTLP ಸೇರ್ಪಡಿಸಿ | +| [SDK ಟ್ರ್ಯಾಕಿಂಗ್](docs/SDK_TRACKING.md) | ನೀವೇ ನಿರ್ಮಿಸಿದ ಏಜೆಂಟ್‌ಗಳಿಗಾಗಿ ವೆಚ್ಚದ ಆರೋಪಣೆ | +| [ಚಾಟ್ ಚಾನೆಲ್‌ಗಳು](docs/CHANNELS.md) | Flow ನಲ್ಲಿ ತೋರಿಸಲಾದ ಚಾಟ್ ಅಡಾಪ್ಟರ್‌ಗಳು | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | ಸ್ಯಾಂಡ್‌ಬಾಕ್ಸ್ ಮಾಡಿದ NVIDIA NemoClaw ಸೆಟಪ್‌ಗಳು | +| [Docker](docs/DOCKER.md) | ಇಮೇಜ್, compose, ವಾಲ್ಯೂಮ್ ಮೌಂಟ್‌ಗಳು | +| [ಆರ್ಕಿಟೆಕ್ಚರ್](ARCHITECTURE.md) · [ಡೆವಲಪ್‌ಮೆಂಟ್](docs/DEVELOPMENT.md) | ಒಳಗೆ ಇದು ಹೇಗೆ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ; ಮೂಲದಿಂದ ಚಲಾಯಿಸುವುದು | +| [ಟೆಲಿಮೆಟ್ರಿ](docs/TELEMETRY.md) | ಅನಾಮಧೇಯ ಸ್ಥಾಪನೆ ಮತ್ತು ಡೆಸ್ಕ್‌ಟಾಪ್-ಓಪನ್ ಪಿಂಗ್‌ಗಳು, ಮತ್ತು ಅವುಗಳನ್ನು ಹೇಗೆ ಆಫ್ ಮಾಡುವುದು | -### ಐಚ್ಛಿಕ: ಸ್ಪಷ್ಟ ಸ್ಯಾಂಡ್‌ಬಾಕ್ಸ್ ಹೆಸರು - -ಸ್ವಯಂ-ಪತ್ತೆ ಕಾರ್ಯನಿರ್ವಹಿಸದಿದ್ದರೆ, ClawMetry ಅನ್ನು ಸರಿಯಾದ ಸ್ಯಾಂಡ್‌ಬಾಕ್ಸ್‌ಗೆ ತೋರಿಸಿ: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### ಸ್ಯಾಂಡ್‌ಬಾಕ್ಸ್ ಒಳಗೆ ರನ್ ಮಾಡುವುದು (ಅಡ್ವಾನ್ಸ್ಡ್) - -ನೀವು ಸಿಂಕ್ ಡೀಮನ್ ಅನ್ನು OpenShell ಸ್ಯಾಂಡ್‌ಬಾಕ್ಸ್‌ನ **ಒಳಗೆ** ರನ್ ಮಾಡಬೇಕಾದರೆ, ಅದು ClawMetry ಇಂಜೆಸ್ಟ್ API ಅನ್ನು ತಲುಪಲು ನಿಮ್ಮ NemoClaw ನೆಟ್‌ವರ್ಕ್ ಪಾಲಿಸಿಗೆ ಈ ಈಗ್ರೆಸ್ ನಿಯಮವನ್ನು ಸೇರಿಸಿ: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -ಇದರೊಂದಿಗೆ ಅನ್ವಯಿಸಿ: - -```bash -nemoclaw policy apply --file nemoclaw-policy.yaml -``` - -### ಪೋರ್ಟ್‌ಗಳು ಮತ್ತು ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳು - -| ಎಂಡ್‌ಪಾಯಿಂಟ್ | ಪೋರ್ಟ್ | ಪ್ರೋಟೋಕಾಲ್ | ಅಗತ್ಯ | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | ಹೌದು (ಸಿಂಕ್ ಡೀಮನ್ → ಕ್ಲೌಡ್) | -| `localhost:8900` | 8900 | HTTP | ಹೌದು (ಸ್ಥಳೀಯ ಡ್ಯಾಶ್‌ಬೋರ್ಡ್ UI) | -| Docker ಸಾಕೆಟ್ (`/var/run/docker.sock`) | — | Unix ಸಾಕೆಟ್ | ಕಂಟೈನರ್ ಸೆಷನ್ ಶೋಧಕ್ಕಾಗಿ | - -ಸಿಂಕ್ ಡೀಮನ್ ಕೇವಲ `ingest.clawmetry.com` ಗೆ ಔಟ್‌ಬೌಂಡ್ HTTPS ಕರೆಗಳನ್ನು ಮಾಡುತ್ತದೆ. ಯಾವುದೇ ಇನ್‌ಬೌಂಡ್ ಪೋರ್ಟ್‌ಗಳ ಅಗತ್ಯವಿಲ್ಲ. - ---- - -## ಕ್ಲೌಡ್ ಡಿಪ್ಲಾಯ್‌ಮೆಂಟ್ - -SSH ಟನಲ್‌ಗಳು, ರಿವರ್ಸ್ ಪ್ರಾಕ್ಸಿ, ಮತ್ತು Docker ಗಾಗಿ **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** ನೋಡಿ. - -## ಟೆಸ್ಟಿಂಗ್ - -ಈ ಪ್ರಾಜೆಕ್ಟ್ ಅನ್ನು BrowserStack ನೊಂದಿಗೆ ಪರೀಕ್ಷಿಸಲಾಗಿದೆ. - -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) - -## ಟೆಲಿಮೆಟ್ರಿ - -ClawMetry `https://app.clawmetry.com/api/install` ಗೆ ಅನಾಮಧೇಯ ಇನ್‌ಸ್ಟಾಲ್-ಜೀವನಚಕ್ರ -ಪಿಂಗ್‌ಗಳನ್ನು ಕಳುಹಿಸುತ್ತದೆ: ಹೊಸ ಯಂತ್ರದಲ್ಲಿ ನೀವು ಮೊದಲ ಬಾರಿಗೆ `clawmetry` CLI -ಅನ್ನು ರನ್ ಮಾಡಿದಾಗ ಒಂದು `install` ಪಿಂಗ್, ಹೊಸ ಆವೃತ್ತಿಗೆ ಅಪ್‌ಗ್ರೇಡ್ ಮಾಡಿದ ನಂತರದ -ಮೊದಲ ರನ್‌ನಲ್ಲಿ ಒಂದು `update` ಪಿಂಗ್, ಮತ್ತು ನೀವು ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನಲ್ಲಿನ ಆನ್‌ಬೋರ್ಡಿಂಗ್ -ಆಯ್ಕೆಯನ್ನು ಪೂರ್ಣಗೊಳಿಸಿದಾಗ ಒಂದು `onboarded` ಪಿಂಗ್. ನಿಜವಾದ ಇನ್‌ಸ್ಟಾಲ್‌ಗಳನ್ನು ಎಣಿಸಲು -ನಾವು ಇದನ್ನು ಬಳಸುತ್ತೇವೆ (ಕಚ್ಚಾ PyPI ಡೌನ್‌ಲೋಡ್ ಸಂಖ್ಯೆಗಳು ~98% ಮಿರರ್‌ಗಳು, CI, -ಮತ್ತು ಆಟೋ-ಅಪ್‌ಡೇಟ್ ಮರು-ಡೌನ್‌ಲೋಡ್‌ಗಳಾಗಿವೆ) ಮತ್ತು ಯಾವ ಏಜೆಂಟ್ ಫ್ರೇಮ್‌ವರ್ಕ್‌ಗಳು ಮತ್ತು -ಆವೃತ್ತಿಗಳು ವಾಸ್ತವವಾಗಿ ಬಳಕೆಯಲ್ಲಿವೆ ಎಂದು ತಿಳಿಯಲು. +## ಸ್ಕ್ರೀನ್‌ಶಾಟ್‌ಗಳು -**ಪ್ರತಿ ಆವೃತ್ತಿಗೆ ಪ್ರತಿ ಜೀವನಚಕ್ರ ಈವೆಂಟ್‌ಗೆ ಗರಿಷ್ಠ ಒಂದು POST**, ಇದರಲ್ಲಿ ಒಳಗೊಂಡಿದೆ: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **ಓವರ್‌ವ್ಯೂ**: ಟೋಕನ್‌ಗಳು, ಸೆಷನ್‌ಗಳು, ಆರೋಗ್ಯ | **ಬ್ರೈನ್**: ಲೈವ್ ಏಜೆಂಟ್ ಈವೆಂಟ್ ಸ್ಟ್ರೀಮ್ | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **ವೆಚ್ಚ**: ಮಾದರಿ ಮತ್ತು ಸೆಷನ್ ಪ್ರಕಾರ | **ಅನುಮೋದನೆಗಳು**: ಅಪಾಯಕಾರಿ ಟೂಲ್ ಕರೆಗಳನ್ನು ಗೇಟ್ ಮಾಡಿ | -| ಫೀಲ್ಡ್ | ಉದಾಹರಣೆ | ಏಕೆ | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id` ನಲ್ಲಿ ಸಂಗ್ರಹಿಸಿದ ಯಾದೃಚ್ಛಿಕ UUID | ಡಿಡುಪ್; ನೀವು ಕ್ಲೌಡ್ ಸಿಂಕ್ ಅನ್ನು ಸ್ಪಷ್ಟವಾಗಿ ಸಂಪರ್ಕಿಸುವವರೆಗೆ ಅನಾಮಧೇಯ (ನಂತರ ದೃಢೀಕೃತ ಡೀಮನ್ ಹಾರ್ಟ್‌ಬೀಟ್ ಅದನ್ನು ಸಾಗಿಸುತ್ತದೆ, ಈ ಇನ್‌ಸ್ಟಾಲ್ ಅನ್ನು ನಿಮ್ಮ ಖಾತೆಗೆ ಲಿಂಕ್ ಮಾಡುತ್ತದೆ) | -| `event` | `install` / `update` / `onboarded` | ಹೊಸ ಇನ್‌ಸ್ಟಾಲ್ ಅಥವಾ ಅಸ್ತಿತ್ವದಲ್ಲಿರುವದನ್ನು ಅಪ್‌ಗ್ರೇಡ್ ಮಾಡುವುದು | -| `version` | `0.12.167` | ಬಳಕೆಯಲ್ಲಿರುವ ಆವೃತ್ತಿಗಳು | -| `os` / `os_version` | `Darwin` / `25.3.0` | ಪ್ಲಾಟ್‌ಫಾರ್ಮ್ ಬೆಂಬಲ ಆದ್ಯತೆಗಳು | -| `python` | `3.11.15` | Python ಆವೃತ್ತಿ ಬೆಂಬಲ ಮ್ಯಾಟ್ರಿಕ್ಸ್ | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | ಮುಂದೆ ನಾವು ಯಾವ ಏಜೆಂಟ್‌ಗಳೊಂದಿಗೆ ಸಂಯೋಜಿಸಬೇಕು | -| `is_ci` / `ci_provider` | `true` / `github_actions` | ಮಾನವ ಇನ್‌ಸ್ಟಾಲ್‌ಗಳನ್ನು CI ಶಬ್ದದಿಂದ ಪ್ರತ್ಯೇಕಿಸುವುದು | - -**ನಾವು ಕಳುಹಿಸದಿರುವುದು**: IP (ಕ್ಲೌಡ್ ಸರ್ವರ್-ಸೈಡ್‌ನಲ್ಲಿ ವಿನಂತಿಯಿಂದ -ದೇಶ ಕೋಡ್ ಅನ್ನು ಪಡೆಯುತ್ತದೆ, ನಂತರ IP ಅನ್ನು ತಿರಸ್ಕರಿಸುತ್ತದೆ), ಹೋಸ್ಟ್‌ಹೆಸರು, ಬಳಕೆದಾರಹೆಸರು, ವರ್ಕ್‌ಸ್ಪೇಸ್ -ಪಥ, ಫೈಲ್ ವಿಷಯಗಳು, ನಿಮ್ಮ api_key, ನಿಮ್ಮ ಇಮೇಲ್, PII ಅಥವಾ -ವರ್ಕ್‌ಸ್ಪೇಸ್-ನಿರ್ದಿಷ್ಟ ಯಾವುದೂ ಇಲ್ಲ. ವೈರ್ ಪೇಲೋಡ್ -[`clawmetry/telemetry.py`](clawmetry/telemetry.py) ನಲ್ಲಿ ಆಡಿಟ್ ಮಾಡಬಹುದಾಗಿದೆ. - -**ಆಪ್ಟ್ ಔಟ್** (ಈ ಯಾವುದಾದರೂ ಒಂದು ಇದನ್ನು ಶಾಶ್ವತವಾಗಿ ನಿಷ್ಕ್ರಿಯಗೊಳಿಸುತ್ತದೆ): +ಪ್ರತಿ ರನ್‌ಟೈಮ್‌ಗೆ ಇನ್ನಷ್ಟು: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -ಇಲ್ಲಿ ನೆಟ್‌ವರ್ಕ್ ವಿಫಲತೆ ಎಂದಿಗೂ `clawmetry` ಅನ್ನು ರನ್ ಆಗುವುದನ್ನು ತಡೆಯುವುದಿಲ್ಲ — ಪಿಂಗ್ -ಡೀಮನ್ ಥ್ರೆಡ್‌ನಲ್ಲಿ 3 ಸೆಕೆಂಡ್ ಟೈಮ್‌ಔಟ್‌ನೊಂದಿಗೆ ಫೈರ್-ಅಂಡ್-ಫಾರ್ಗೆಟ್ ಆಗಿದೆ. - -## ಸ್ಟಾರ್ ಇತಿಹಾಸ +## Star History @@ -435,13 +111,8 @@ touch ~/.clawmetry/notelemetry # persistent file marker -## ಲೈಸೆನ್ಸ್ - -MIT +## ಪರವಾನಗಿ ---- +MIT · ನಿರ್ಮಿಸಿದವರು [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 ನಿಮ್ಮ ಏಜೆಂಟ್ ಆಲೋಚಿಸುವುದನ್ನು ನೋಡಿ
- @vivekchand ಇವರಿಂದ ನಿರ್ಮಿಸಲಾಗಿದೆ · clawmetry.com · OpenClaw ಪರಿಸರ ವ್ಯವಸ್ಥೆಯ ಭಾಗ -

+ diff --git a/docs/i18n/ko/README.md b/docs/i18n/ko/README.md index 5b302f80de..f6061fb6de 100644 --- a/docs/i18n/ko/README.md +++ b/docs/i18n/ko/README.md @@ -1,430 +1,105 @@ - + > 한국어 translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**여러분의 에이전트가 생각하는 모습을 직접 확인하세요.** **20개 AI 에이전트 런타임**을 위한 실시간 관측 도구입니다: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex 외 16개. 전체 에이전트 플릿을 위한 대시보드 하나로 충분합니다. +**당신의 에이전트가 생각하는 모습을 지켜보세요.** **23개 AI 에이전트 런타임**을 위한 실시간 관찰 가능성 도구: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex 및 19개 이상. 전체 에이전트 플릿을 위한 하나의 대시보드. -> 🌐 **다른 언어로 읽기:** [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/) +> 🌐 **다른 언어로 보기:** [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** 에서 바로 열립니다. 이게 전부입니다. +**http://localhost:8900** 에서 열립니다. 설정이 필요 없습니다. 이미 보유하고 있는 에이전트 런타임을 찾아내고, 읽기 전용으로 읽으며, 실행 방식에는 아무런 변경도 가하지 않습니다. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 20개 에이전트 런타임 지원 - -ClawMetry는 OpenClaw를 위한 관측 도구로 시작했지만, 이제는 하나의 대시보드에서 여러분의 **전체 에이전트 플릿**을 계측하며, 여러분의 머신에 있는 각 런타임을 자동으로 감지합니다: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw와 NemoClaw는 오픈소스 앱에서 무료로 제공되며, 나머지 런타임들은 ClawMetry Cloud나 셀프 호스팅 Pro 라이선스를 통해 활성화됩니다. 헤더에서 런타임을 전환하면 비용, 토큰, 도구, 트레이스 등 모든 탭이 해당 런타임 기준으로 다시 범위가 조정됩니다. 정확한 무료/유료 구분, 티어 매트릭스, `/api/entitlement` 형태, `clawmetry license` CLI에 대해서는 **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)**를 참고하세요. - -## 제공 기능 - -- **Flow** — 채널, 브레인, 도구를 거쳐 다시 돌아오는 메시지 흐름을 보여주는 실시간 애니메이션 다이어그램 -- **Overview** — 상태 점검, 활동 히트맵, 세션 수, 모델 정보 -- **Usage** — 일간/주간/월간 세부 내역과 함께 토큰 및 비용 추적 -- **Sessions** — 모델, 토큰, 마지막 활동 시각을 포함한 활성 에이전트 세션 -- **Crons** — 상태, 다음 실행 시각, 소요 시간이 표시되는 예약 작업 -- **Logs** — 색상으로 구분된 실시간 로그 스트리밍 -- **Memory** — SOUL.md, MEMORY.md, AGENTS.md, 일일 노트 탐색 -- **Transcripts** — 세션 기록을 읽기 위한 채팅 버블 UI -- **Alerts** — 예산 한도, 오류율 트리거, 에이전트 오프라인 감지; Slack, Discord, PagerDuty, Telegram, Email로 라우팅 -- **Approvals** — 파괴적인 삭제, 강제 푸시, DB 변경, sudo, 패키지 설치, 네트워크 호출을 원클릭 승인 뒤에 게이트 - -## 스크린샷 - -### 🧠 Brain — 실시간 에이전트 이벤트 스트림 -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — 토큰 사용량 및 세션 요약 -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — 실시간 도구 호출 피드 -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — 모델 및 세션별 비용 세부 내역 -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — 워크스페이스 파일 브라우저 -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — 보안 상태 및 감사 로그 -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — 예산 한도, 오류율 트리거, Slack / Discord / PagerDuty / Email로의 웹훅 -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — 위험한 도구 호출을 수동 승인 뒤에 게이트하는 정책 기반 보호 규칙 -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**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 -``` - -거부(deny)는 해당 도구 호출 하나만 차단합니다. 에이전트는 세션을 유지한 채 -다른 방법을 시도할 수 있습니다. 휴대폰에서 승인하면 Claude Code 자체의 -권한 프롬프트를 건너뜁니다(이미 답변한 것이므로). 매칭되지 않는 도구는 -약 40ms의 비용만 들이고 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 프론트엔드 개발 - -v2 React 앱은 `frontend/`에 있으며, Flask 서버가 v2를 활성화한 채로 -시작되면 `/v2`에서 서빙됩니다. - -개발 중에는 두 개의 터미널을 사용하세요: - -```bash -# Terminal 1: Flask API/server on :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## 23개 에이전트 런타임 지원 -```bash -# Terminal 2: Vite dev server on :5173 -cd frontend -nvm use -npm ci -npm run dev -``` +**오픈소스 앱에서 무료:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -`http://localhost:5173/v2/`를 여세요. Vite가 `/api` 요청을 -`http://localhost:8900`으로 프록시하므로, React 앱이 별도의 CORS 설정 -없이 로컬 Flask 서버와 통신할 수 있습니다. +**유료 플랜에서:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -Python 패키지와 함께 배포되는 번들을 빌드하려면: - -```bash -cd frontend -npm run build -``` +모든 런타임은 동일한 대시보드를 제공받습니다. 여러 개를 동시에 실행하면 헤더의 전환기가 모든 탭의 범위를 선택한 런타임에 맞춰 재조정합니다. -프로덕션 번들은 `clawmetry/static/v2/dist/`에 작성됩니다. +SDK로 직접 만든 에이전트를 사용하고 있나요? 인터셉터가 해당 에이전트의 LLM 호출도 추적합니다. [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md)를 참고하세요. -## 런타임/에이전트 호환성 +## 제공하는 기능 -ClawMetry는 OpenClaw뿐만 아니라 다양한 AI 에이전트 런타임을 관측합니다. OpenClaw가 아닌 각 런타임에는 해당 런타임의 네이티브 세션 형식을 ClawMetry의 통합된 형태로 변환하는 전용 리더 어댑터가 딸려 있습니다. 데몬은 이를 동일한 DuckDB 스토어 + 클라우드 스냅샷에 런타임 태그와 함께 수집하며, 두 개 이상의 런타임이 있을 때 Session replay 탭에 **런타임 전환기**가 표시됩니다. 전체 매트릭스와 런타임 추가 가이드는 [`docs/compatibility.md`](docs/compatibility.md)를, OpenClaw 계열 입문 자료는 [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md)를 참고하세요. +- **세션 및 트랜스크립트**: 각 에이전트가 턴별로 수행한 작업, 재생 기능 포함 +- **비용 및 토큰**: 런타임, 모델, 세션, 일자별로, 이상 징후 표시와 함께 +- **Flow**: 채널, 모델, 도구 사이를 오가는 메시지의 실시간 다이어그램 +- **Brain**: 실시간으로 발생하는 추론 및 도구 호출 이벤트 스트림 +- **메모리 및 스킬**: 각 런타임이 실제로 로드한 파일과 스킬 +- **상태 및 로그**: 디스크, 메모리, 오류율, 요청 제한, 실시간 로그 스트림 +- **알림**: 예산 한도, 오류 급증, 에이전트 오프라인 등을 Slack, Discord, PagerDuty, Telegram, 이메일로 전달 +- **승인**: 위험한 도구 호출을 실행 *전에* 일시 중지시키고 휴대폰에서 승인 ([방법](docs/APPROVALS.md)) -[Perplexity의 numbat](https://github.com/perplexityai/numbat) 에이전트 보안 도구를 사용 중이신가요? ClawMetry는 별도 설정 없이 numbat의 탐지 결과와 강제 조치 결정을 수집합니다. 자세한 내용은 [`docs/NUMBAT.md`](docs/NUMBAT.md)를 참고하세요. +## 가격 -| 런타임 / 에이전트 | 상태 | 비고 | +| 플랜 | 포함 범위 | 가격 | |---|---|---| -| **OpenClaw** | Native | 기준 런타임, 자동 감지 | -| **PicoClaw** | Beta adapter | 플랫 `providers.Message` JSONL(`~/.picoclaw/workspace/sessions`). 트랜스크립트, 모델, 도구 호출. | -| **NanoClaw** | Beta adapter | 세션별 SQLite(`data/v2-sessions`). 트랜스크립트 + 메시지 수. | -| **Hermes** | Beta adapter | SQLite `~/.hermes/state.db`. 트랜스크립트, 모델, 토큰/비용. | -| **Claude Code** | Beta adapter | JSONL `~/.claude/projects/.../.jsonl`. 트랜스크립트, 모델, 도구 호출 + thinking, 토큰 사용량. | -| **Codex** | Beta adapter | Rollout JSONL `~/.codex/sessions/...`. 트랜스크립트, 모델, 도구 호출, 토큰 사용량. | -| **Cursor** | Beta adapter | SQLite `state.vscdb`. 채팅/컴포저 트랜스크립트, 모델. | -| **Aider** | Beta adapter | 프로젝트별 `.aider.chat.history.md`. 트랜스크립트, 모델, 토큰 수. | -| **Goose** | Beta adapter | SQLite `~/.local/share/goose`. 트랜스크립트, 모델, 도구 호출, 총 토큰. | -| **opencode** | Beta adapter | SQLite `~/.local/share/opencode`. 트랜스크립트, 모델, 도구 호출, 토큰 + 비용. | -| **Qwen Code** | Beta adapter | JSONL `~/.qwen/projects/.../chats`. 트랜스크립트, 모델, 도구 호출, 토큰 사용량. | -| **Pi** | Beta adapter | JSONL `~/.pi/agent/sessions`. 트랜스크립트, 모델, 도구 호출, 토큰 + 비용. | -| **Deep Agents** | Beta adapter | SQLite `~/.deepagents/.state/sessions.db`. 트랜스크립트, 모델, 도구 호출, 토큰 + 비용. | -| **n8n** | Beta adapter | SQLite `~/.n8n/database.sqlite`. 워크플로 실행, 노드 실행, AI Agent 프롬프트, n8n이 기록하는 경우의 모델 + 토큰. | -| **Antigravity** | Beta adapter | `~/.gemini//brain/` 하위의 Brain JSONL. 대화, 도구 단계, thinking, 생성별 Gemini 토큰 분할 + 비용, 백그라운드 생성 소모량. | -| **GitHub Copilot** | Beta adapter | `~/.copilot/session-state/` 하위의 Copilot CLI `events.jsonl` + 호출별 사용량 원장인 `session-store.db`. 대화, 도구 호출, 모델 라우팅, 캐시를 고려한 토큰 분할, 벤더가 청구하는 AI 크레딧 비용. | -| **Grok** | Beta adapter | xAI Grok Build CLI(`~/.grok/bin/grok` 하위의 Rust 바이너리): 전역 이벤트 로그 `~/.grok/logs/unified.jsonl` + 세션별 `~/.grok/sessions///{events.jsonl,summary.json}`. 대화, 턴별 토큰 분할, 모델 라우팅, 무엇이 머신에서 나갔는지 확인할 수 있도록 `~/.grok/upload_queue/` 아래에 스테이징되는 CLI의 아웃바운드 저장소 페이로드. | - -"Beta adapter"는 ClawMetry가 해당 런타임의 실제 디스크 저장 형식을 위한 리더를 제공하며, 각각 실제 머신에 설치된 실제 환경을 기준으로 빌드 및 검증되었음을 의미합니다(`tests/fixtures/runtimes//` 참고). 어댑터는 읽기 전용이며, 각 런타임이 실제로 저장하는 데이터에 대해 정직하게 동작합니다(예: PicoClaw/NanoClaw/Cursor는 토큰 비용을 디스크에 기록하지 않습니다). 한 노드에서 여러 런타임이 동시에 실행 중일 때, 런타임 전환기를 사용하면 세션 뷰를 하나로 좁혀 깔끔하게 살펴볼 수 있습니다. - -## 어떤 SDK 에이전트든 추적하기, 아웃루프 비용 귀속 - -위의 런타임들은 모두 세션을 디스크에 기록합니다. 여러분이 직접 만든 **프로덕션 에이전트**, 즉 OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, 또는 순수 `httpx` 루프로 만든 것은 그렇지 않습니다. ClawMetry의 제로 설정 인터셉터는 `httpx`/`requests`를 몽키 패칭하여 여전히 해당 에이전트의 LLM 호출(비용, 토큰, 지연 시간, 오류)을 포착합니다: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()`(또는 `CLAWMETRY_SOURCE=support-agent` 환경 변수)는 각 호출에 **이름이 붙은 소스**를 태그하므로, 여러분이 운영하는 모든 제품이 대시보드의 Overview에 있는 **🔌 아웃루프 소스** 카드에서 독립적인 1급 비용 귀속 항목으로 표시됩니다. 에이전트별 호출 수, 프로바이더, 지연 시간, 오류율까지 볼 수 있습니다. 소스를 설정하지 않았다면? 호출은 여전히 추적되며, 카드만 숨겨진 상태로 남습니다. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -이는 런타임 어댑터가 공급하는 것과 동일한 데이터 레이어(DuckDB → 클라우드 스냅샷)이므로, 아웃루프 소스도 다른 모든 데이터와 마찬가지로 종단간 암호화된 상태로 클라우드 대시보드에 동기화됩니다. - -## OpenTelemetry, 벤더 중립적으로 트레이스를 어디로든 보내기 - -ClawMetry는 **GenAI 시맨틱 컨벤션**을 사용해 양방향으로 **OpenTelemetry**를 지원하므로, 여러분의 에이전트 트레이스가 하나의 도구에 절대 종속되지 않습니다. - -모든 세션(LLM 호출, 도구, 서브 에이전트, 토큰, 비용)을 OTLP/HTTP GenAI 스팬으로 **내보내어** 원하는 컬렉터(Datadog, Grafana, Honeycomb, 또는 자체 OTel Collector)로 전송할 수 있습니다: - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -인증 헤더와 폴링 간격은 선택적 환경 변수입니다: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**수집(Ingest)** — 내장 OTLP 수신기는 `/v1/traces`, `/v1/logs`, `/v1/metrics`에서 다른 어떤 것으로부터든 트레이스, 로그, 메트릭을 받아들입니다. OpenTelemetry로 계측된 앱이라면 어떤 것이든 여기로 향하게 하세요: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON 트레이스와 로그는 별도 추가 설치 없이 `pip install clawmetry`만으로 동작합니다. Protobuf 수집(및 OTLP/JSON 메트릭)에는 `pip install clawmetry[otel]`이 필요합니다. 자체적으로 `service.name`을 설정하는 앱은 런타임 전환기에서 자신만의 비용과 토큰을 가진 독립적인 에이전트로 표시됩니다. - -제로 설정, 로컬 우선인 ClawMetry 대시보드를 그대로 사용하면서도, 팀에서 이미 운영 중인 백엔드에 데이터를 함께 보낼 수 있습니다. 종속도 없고, 두 번째 에이전트를 설치할 필요도 없습니다. - -## 설정 - -대부분의 사용자는 설정이 전혀 필요하지 않습니다. ClawMetry는 워크스페이스, 로그, 세션, cron을 자동으로 감지합니다. - -커스터마이즈가 필요하다면: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -전체 옵션: `clawmetry --help` - -## 지원 채널 - -ClawMetry는 여러분이 설정한 모든 OpenClaw 채널에 대해 실시간 활동을 보여줍니다. `openclaw.json`에 실제로 설정된 채널만 Flow 다이어그램에 표시되며, 설정되지 않은 채널은 자동으로 숨겨집니다. - -Flow에서 채널 노드를 클릭하면 수신/발신 메시지 수와 함께 실시간 채팅 버블 뷰를 볼 수 있습니다. - -| 채널 | 상태 | 실시간 팝업 | 비고 | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Full | ✅ | 메시지, 통계, 10초 새로고침 | -| 💬 **iMessage** | ✅ Full | ✅ | `~/Library/Messages/chat.db`를 직접 읽음 | -| 💚 **WhatsApp** | ✅ Full | ✅ | WhatsApp Web(Baileys)을 통해 | -| 🔵 **Signal** | ✅ Full | ✅ | signal-cli를 통해 | -| 🟣 **Discord** | ✅ Full | ✅ | 길드 + 채널 감지 | -| 🟪 **Slack** | ✅ Full | ✅ | 워크스페이스 + 채널 감지 | -| 🌐 **Webchat** | ✅ Full | ✅ | 내장 웹 UI 세션 | -| 📡 **IRC** | ✅ Full | ✅ | 터미널 스타일 버블 UI | -| 🍏 **BlueBubbles** | ✅ Full | ✅ | BlueBubbles REST API를 통한 iMessage | -| 🔵 **Google Chat** | ✅ Full | ✅ | Chat API 웹훅을 통해 | -| 🟣 **MS Teams** | ✅ Full | ✅ | Teams 봇 플러그인을 통해 | -| 🔷 **Mattermost** | ✅ Full | ✅ | 셀프 호스팅 팀 채팅 | -| 🟩 **Matrix** | ✅ Full | ✅ | 탈중앙화, E2EE 지원 | -| 🟢 **LINE** | ✅ Full | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Full | ✅ | 탈중앙화 NIP-04 DM | -| 🟣 **Twitch** | ✅ Full | ✅ | IRC 연결을 통한 채팅 | -| 🔷 **Feishu/Lark** | ✅ Full | ✅ | WebSocket 이벤트 구독 | -| 🔵 **Zalo** | ✅ Full | ✅ | Zalo Bot API | - -> **자동 감지:** ClawMetry는 `~/.openclaw/openclaw.json`을 읽고, 실제로 설정한 채널만 렌더링합니다. 수동 설정이 필요 없습니다. - -## Docker 배포 - -컨테이너에서 ClawMetry를 실행하고 싶으신가요? 문제없습니다! 🐳 - -**Docker로 빠르게 시작하기:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose 예시:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **참고:** Docker에서 실행할 때는 ClawMetry가 여러분의 설정을 자동으로 감지할 수 있도록 에이전트의 데이터 + 로그 디렉터리(예: `~/.openclaw`, `~/.claude`, `~/.codex`)를 마운트하세요. - -## 요구 사항 - -- Python 3.8+ -- Flask(pip을 통해 자동 설치됨) -- 동일한 머신에 있는 AI 에이전트 런타임: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, QM(또는 Docker의 경우 마운트된 볼륨) -- Linux 또는 macOS - -## NemoClaw / OpenShell 지원 - -ClawMetry는 [NemoClaw](https://github.com/NVIDIA/NemoClaw)를 자동으로 감지합니다. NemoClaw는 샌드박스화된 OpenShell 컨테이너 안에서 에이전트를 실행하는 NVIDIA의 엔터프라이즈 보안 래퍼입니다. +| **Free** | OpenClaw + NVIDIA NemoClaw, 전체 대시보드, 로컬 전용 | $0 | +| **Starter** | 위의 다른 모든 런타임, 플릿 뷰, 클라우드 동기화 | 노드당 월 $9 | +| **Pro** | Starter + 거버넌스: 승인, 도구 위험 정책, 평가, 이상 징후 감지, 비용 최적화, OTel 내보내기 | 노드당 월 $19 | -대부분의 경우 별도 설정이 필요하지 않습니다. 동기화 데몬은 세션 파일이 호스트의 `~/.openclaw/`에 있든 OpenShell 컨테이너 내부에 있든 자동으로 찾아냅니다. +연간 플랜, Enterprise 및 최신 요금 정보는 +**[clawmetry.com/pricing](https://clawmetry.com/pricing)** 에서 확인하세요. 자체 호스팅 라이선스 +키는 클라우드 없이도 작동합니다 (`clawmetry license`). 정확한 무료/유료 구분은 +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)에 있습니다. -### 동작 방식 +## 데이터는 사용자의 기기에 남아 있습니다 -ClawMetry는 두 가지 방법으로 NemoClaw를 감지합니다: +ClawMetry는 로컬 세션 파일과 로그를 읽습니다. `clawmetry connect`를 실행하지 +않는 한 어떤 것도 기기 밖으로 나가지 않습니다. 그럴 때조차도 스냅샷은 +기기 밖으로 절대 나가지 않는 키로 종단 간 암호화되며, 브라우저에서 복호화됩니다. -1. **바이너리 감지** — `nemoclaw` CLI가 있는지 확인하고 `nemoclaw status`를 실행해 샌드박스 정보를 가져옵니다 -2. **컨테이너 감지** — 실행 중인 Docker 컨테이너를 스캔하여 `openshell`, `nemoclaw`, 또는 `ghcr.io/nvidia/` 이미지를 찾은 뒤, 볼륨 마운트나 `docker cp`를 통해 세션을 읽습니다 - -NemoClaw 컨테이너에서 동기화된 세션 파일은 클라우드 대시보드에서 `runtime=nemoclaw`와 `container_id` 메타데이터로 태그되므로, 표준 OpenClaw 세션과 한눈에 구분할 수 있습니다. - -### 권장 설정: 호스트에서 동기화 데몬 실행 - -최상의 경험을 위해서는 ClawMetry의 동기화 데몬을 (샌드박스 내부가 아닌) **호스트 머신**에서 실행하세요. 이렇게 하면 NemoClaw 네트워크 정책 제한을 피할 수 있습니다. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -동기화 데몬은 실행 중인 OpenShell 컨테이너 안의 세션을 자동으로 찾아냅니다. - -### 선택 사항: 명시적인 샌드박스 이름 지정 - -자동 감지가 동작하지 않는다면, 올바른 샌드박스를 명시적으로 지정하세요: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### 샌드박스 내부에서 실행하기(고급) - -동기화 데몬을 **반드시** OpenShell 샌드박스 내부에서 실행해야 한다면, NemoClaw 네트워크 정책에 다음 이그레스 규칙을 추가하여 ClawMetry ingest API에 접근할 수 있도록 하세요: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -다음 명령으로 적용합니다: +## 설치 ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # then: clawmetry ``` -### 포트 및 엔드포인트 - -| 엔드포인트 | 포트 | 프로토콜 | 필수 여부 | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | 필수(동기화 데몬 → 클라우드) | -| `localhost:8900` | 8900 | HTTP | 필수(로컬 대시보드 UI) | -| Docker 소켓(`/var/run/docker.sock`) | — | Unix 소켓 | 컨테이너 세션 검색용 | - -동기화 데몬은 `ingest.clawmetry.com`으로만 아웃바운드 HTTPS 호출을 합니다. 인바운드 포트는 필요하지 않습니다. - ---- - -## 클라우드 배포 - -SSH 터널, 리버스 프록시, Docker에 대해서는 **[클라우드 테스트 가이드](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)**를 참고하세요. - -## 테스트 +또는 한 줄 명령어: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -이 프로젝트는 BrowserStack으로 테스트됩니다. +macOS, Linux 또는 Windows에서 Python 3.8 이상이 필요하며, 같은 기기에 +에이전트 런타임이 최소 하나 있어야 합니다. Docker 안내: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## 문서 -## 텔레메트리 +| | | +|---|---| +| [런타임 호환성](docs/compatibility.md) | 각 어댑터가 읽는 내용, 런타임 추가 방법 | +| [Entitlements](docs/ENTITLEMENTS.md) | 무료 대 유료, 등급별 매트릭스, 라이선스 CLI | +| [승인 및 정책](docs/APPROVALS.md) | 실행 전 게이팅, 위험도 산정, 휴대폰 승인 | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | 어디로든 트레이스 내보내기, 어디서든 OTLP 수집 | +| [SDK 추적](docs/SDK_TRACKING.md) | 직접 만든 에이전트의 비용 귀속 | +| [채팅 채널](docs/CHANNELS.md) | Flow에 표시되는 채팅 어댑터 | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | 샌드박스화된 NVIDIA NemoClaw 설정 | +| [Docker](docs/DOCKER.md) | 이미지, 컴포즈, 볼륨 마운트 | +| [Architecture](ARCHITECTURE.md) · [Development](docs/DEVELOPMENT.md) | 내부 동작 방식, 소스에서 실행하기 | +| [Telemetry](docs/TELEMETRY.md) | 익명 설치 및 데스크톱 실행 핑, 끄는 방법 | -ClawMetry는 익명의 설치 라이프사이클 핑을 -`https://app.clawmetry.com/api/install`로 전송합니다: 새 머신에서 -`clawmetry` CLI를 처음 실행할 때 `install` 핑 1회, 새 버전으로 업그레이드 -후 첫 실행 시 `update` 핑 1회, 대시보드 내 온보딩 선택을 완료할 때 -`onboarded` 핑 1회입니다. 이를 통해 실제 설치 수를 집계하고(원시 PyPI -다운로드 수치는 약 98%가 미러, CI, 자동 업데이트 재다운로드입니다), -실제로 어떤 에이전트 프레임워크와 버전이 사용되고 있는지 파악합니다. +## 스크린샷 -**라이프사이클 이벤트 및 버전당 최대 1건의 POST**가 전송되며, 다음 -내용을 포함합니다: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: 토큰, 세션, 상태 | **Brain**: 실시간 에이전트 이벤트 스트림 | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: 모델 및 세션별 | **Approvals**: 위험한 도구 호출 게이팅 | -| 필드 | 예시 | 이유 | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id`에 저장된 무작위 UUID | 중복 방지; Cloud sync를 명시적으로 연결하기 전까지는 익명(그 이후 인증된 데몬 하트비트가 이 값을 전달하여 이 설치를 여러분의 계정과 연결합니다) | -| `event` | `install` / `update` / `onboarded` | 새 설치인지 기존 설치의 업그레이드인지 구분 | -| `version` | `0.12.167` | 실제로 사용 중인 버전들 | -| `os` / `os_version` | `Darwin` / `25.3.0` | 플랫폼 지원 우선순위 | -| `python` | `3.11.15` | Python 버전 지원 매트릭스 | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | 다음으로 통합해야 할 에이전트 | -| `is_ci` / `ci_provider` | `true` / `github_actions` | 실제 사용자 설치와 CI 노이즈를 구분 | - -**전송하지 않는 것**: IP(클라우드는 요청에서 서버 측으로 국가 코드만 -추출한 뒤 IP를 폐기합니다), 호스트명, 사용자명, 워크스페이스 경로, -파일 내용, 여러분의 api_key, 이메일, 그 외 개인 식별 정보나 -워크스페이스 관련 정보는 전송하지 않습니다. 전송되는 페이로드는 -[`clawmetry/telemetry.py`](clawmetry/telemetry.py)에서 직접 확인할 수 -있습니다. - -**옵트아웃**(다음 중 하나만 실행해도 영구적으로 비활성화됩니다): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -네트워크 장애가 발생해도 `clawmetry` 실행이 막히는 일은 없습니다. -이 핑은 데몬 스레드에서 3초 타임아웃으로 발사 후 잊는(fire-and-forget) -방식으로 동작합니다. +런타임별 더 많은 스크린샷: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Star History @@ -438,11 +113,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## 라이선스 -MIT - ---- +MIT · 제작: [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 여러분의 에이전트가 생각하는 모습을 확인하세요
- @vivekchand가 만듦 · clawmetry.com · OpenClaw 생태계의 일부 -

+ diff --git a/docs/i18n/ml/README.md b/docs/i18n/ml/README.md index 59ca31d767..b0336bfdf4 100644 --- a/docs/i18n/ml/README.md +++ b/docs/i18n/ml/README.md @@ -1,430 +1,107 @@ - + > മലയാളം translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**നിങ്ങളുടെ ഏജന്റ് ചിന്തിക്കുന്നത് കാണൂ.** **20 AI ഏജന്റ് റൺടൈമുകൾക്കുള്ള** തത്സമയ നിരീക്ഷണം: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex കൂടാതെ 16 എണ്ണം കൂടി. നിങ്ങളുടെ മുഴുവൻ ഏജന്റ് ഫ്ലീറ്റിനും ഒരൊറ്റ ഡാഷ്ബോർഡ്. +**നിങ്ങളുടെ ഏജന്റ് ചിന്തിക്കുന്നത് കാണൂ.** **23 AI ഏജന്റ് റൺടൈമുകൾ**ക്കായുള്ള തത്സമയ നിരീക്ഷണം: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex & മറ്റ് 19 എണ്ണം. നിങ്ങളുടെ മുഴുവൻ ഏജന്റ് ഫ്ലീറ്റിനും ഒരു ഡാഷ്ബോർഡ്. -> 🌐 **ഇത് വായിക്കുക:** [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/) +> 🌐 **ഇത് ഈ ഭാഷകളിൽ വായിക്കുക:** [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** എന്നതിൽ തുറക്കും, അത്രമാത്രം. +**http://localhost:8900** ൽ തുറക്കുന്നു. സീറോ കോൺഫിഗ്: നിങ്ങളുടെ പക്കൽ ഇതിനകം ഉള്ള ഏജന്റ് റൺടൈമുകൾ ഇത് കണ്ടെത്തുന്നു, റീഡ്-ഒൺലി ആയി അവ വായിക്കുന്നു, അവ പ്രവർത്തിക്കുന്ന രീതിയിൽ ഒന്നും മാറ്റുന്നില്ല. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 20 ഏജന്റ് റൺടൈമുകളുമായി പ്രവർത്തിക്കുന്നു - -ClawMetry ആരംഭിച്ചത് OpenClaw-നുള്ള നിരീക്ഷണമായിട്ടാണ്, ഇപ്പോൾ അത് നിങ്ങളുടെ **മുഴുവൻ ഏജന്റ് ഫ്ലീറ്റും** ഒരൊറ്റ ഡാഷ്ബോർഡിൽ അളക്കുന്നു, നിങ്ങളുടെ മെഷീനിലുള്ള ഓരോ റൺടൈമും സ്വയമേവ കണ്ടെത്തിക്കൊണ്ട്: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw, NemoClaw എന്നിവ ഓപ്പൺ സോഴ്‌സ് ആപ്പിൽ സൗജന്യമാണ്; മറ്റ് റൺടൈമുകൾ ClawMetry Cloud അല്ലെങ്കിൽ സ്വയം-ഹോസ്റ്റ് ചെയ്ത Pro ലൈസൻസ് ഉപയോഗിച്ച് സജീവമാകും. ഹെഡറിൽ നിന്ന് റൺടൈമുകൾ മാറ്റുക, ഓരോ ടാബും - ചെലവ്, ടോക്കണുകൾ, ടൂളുകൾ, ട്രെയ്‌സുകൾ - ആ റൺടൈമിലേക്ക് വീണ്ടും സ്കോപ്പ് ചെയ്യപ്പെടും. കൃത്യമായ സൗജന്യ/പണമടച്ചുള്ള വിഭജനം, ടയർ മാട്രിക്സ്, `/api/entitlement` ഘടന, `clawmetry license` CLI എന്നിവയ്ക്കായി **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** കാണുക. - -## നിങ്ങൾക്ക് ലഭിക്കുന്നത് - -- **Flow** — ചാനലുകൾ, ബ്രെയിൻ, ടൂളുകൾ എന്നിവയിലൂടെ സന്ദേശങ്ങൾ ഒഴുകുന്നത് കാണിക്കുന്ന തത്സമയ ആനിമേറ്റഡ് ഡയഗ്രം -- **Overview** — ഹെൽത്ത് ചെക്കുകൾ, ആക്ടിവിറ്റി ഹീറ്റ്മാപ്പ്, സെഷൻ എണ്ണം, മോഡൽ വിവരങ്ങൾ -- **Usage** — ദിവസേന/ആഴ്ചതോറും/മാസംതോറും വേർതിരിവുകളോടെ ടോക്കൺ, ചെലവ് ട്രാക്കിംഗ് -- **Sessions** — മോഡൽ, ടോക്കണുകൾ, അവസാന ആക്ടിവിറ്റി എന്നിവയോടെയുള്ള സജീവ ഏജന്റ് സെഷനുകൾ -- **Crons** — സ്റ്റാറ്റസ്, അടുത്ത റൺ, ദൈർഘ്യം എന്നിവയോടെയുള്ള ഷെഡ്യൂൾ ചെയ്ത ജോലികൾ -- **Logs** — വർണ്ണ-കോഡഡ് തത്സമയ ലോഗ് സ്ട്രീമിംഗ് -- **Memory** — SOUL.md, MEMORY.md, AGENTS.md, ദിനംപ്രതി കുറിപ്പുകൾ ബ്രൗസ് ചെയ്യുക -- **Transcripts** — സെഷൻ ചരിത്രങ്ങൾ വായിക്കുന്നതിനുള്ള ചാറ്റ്-ബബിൾ UI -- **Alerts** — ബജറ്റ് പരിധികൾ, പിശക്-നിരക്ക് ട്രിഗറുകൾ, ഏജന്റ്-ഓഫ്‌ലൈൻ കണ്ടെത്തൽ; Slack, Discord, PagerDuty, Telegram, Email എന്നിവയിലേക്ക് റൂട്ട് ചെയ്യുന്നു -- **Approvals** — വിനാശകരമായ ഡിലീറ്റുകൾ, ഫോഴ്‌സ് പുഷുകൾ, DB മ്യൂട്ടേഷനുകൾ, sudo, പാക്കേജ് ഇൻസ്റ്റാളേഷനുകൾ, നെറ്റ്‌വർക്ക് കോളുകൾ എന്നിവ ഒറ്റ-ക്ലിക്ക് അംഗീകാരത്തിന് പിന്നിൽ തടയുക - -## സ്ക്രീൻഷോട്ടുകൾ - -### 🧠 Brain — തത്സമയ ഏജന്റ് ഇവന്റ് സ്ട്രീം -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — ടോക്കൺ ഉപയോഗവും സെഷൻ സംഗ്രഹവും -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — തത്സമയ ടൂൾ കോൾ ഫീഡ് -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — മോഡലും സെഷനും അനുസരിച്ചുള്ള ചെലവ് വിഭജനം -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — വർക്ക്‌സ്പേസ് ഫയൽ ബ്രൗസർ -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — നിലയും ഓഡിറ്റ് ലോഗും -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) +## 23 ഏജന്റ് റൺടൈമുകളുമായി പ്രവർത്തിക്കുന്നു -### 🚨 Alerts — ബജറ്റ് പരിധികൾ, പിശക്-നിരക്ക് ട്രിഗറുകൾ, Slack / Discord / PagerDuty / Email എന്നിവയിലേക്കുള്ള വെബ്‌ഹുക്കുകൾ -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +**ഓപ്പൺ സോഴ്‌സ് ആപ്പിൽ സൗജന്യം:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### ✋ Approvals — അപകടകരമായ ടൂൾ കോളുകൾ മാനുവൽ അംഗീകാരത്തിന് പിന്നിൽ തടയുക; നയം-അടിസ്ഥാനമാക്കിയുള്ള സംരക്ഷണ നിയമങ്ങൾ -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Claude Code-നുള്ള നിർവ്വഹണത്തിനു മുമ്പുള്ള ബ്ലോക്കിംഗ്** — ഒരു കമാൻഡ് -PreToolUse ഹുക്ക് ഇൻസ്റ്റാൾ ചെയ്യുന്നു, അത് പൊരുത്തപ്പെടുന്ന ടൂൾ കോളുകളെ അവ -പ്രവർത്തിക്കുന്നതിന് *മുമ്പ്* താൽക്കാലികമായി നിർത്തുകയും നിങ്ങളുടെ തീരുമാനത്തിനായി -കാത്തിരിക്കുകയും ചെയ്യുന്നു (നിങ്ങളുടെ ഫോണിൽ നിന്ന് ഒറ്റ ടാപ്പ് -[cloud push notifications](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-ന്റെ -സ്വന്തം അനുമതി പ്രോംപ്റ്റ് ഒഴിവാക്കുന്നു (നിങ്ങൾ ഇതിനകം ഉത്തരം നൽകിക്കഴിഞ്ഞു). പൊരുത്തപ്പെടാത്ത -ടൂളുകൾക്ക് ~40ms ചെലവ് വരികയും 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 -``` +**പണമടച്ചുള്ള പ്ലാനിൽ:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -## v2 ഫ്രണ്ട്എൻഡ് ഡെവലപ്മെന്റ് +എല്ലാ റൺടൈമിനും ഒരേ ഡാഷ്ബോർഡ് ലഭിക്കുന്നു. ഒരേസമയം പലതും പ്രവർത്തിപ്പിക്കൂ, ഹെഡറിലെ സ്വിച്ചർ ഓരോ ടാബും അവയിലൊന്നിലേക്ക് വീണ്ടും സ്കോപ്പ് ചെയ്യും. -v2 React ആപ്പ് `frontend/`-ൽ സ്ഥിതി ചെയ്യുന്നു, v2 പ്രവർത്തനക്ഷമമാക്കി Flask -സെർവർ ആരംഭിക്കുമ്പോൾ `/v2`-ൽ സേവിക്കപ്പെടും. +SDK ഉപയോഗിച്ച് സ്വന്തമായി ഏജന്റ് നിർമ്മിച്ചോ? ഇന്റർസെപ്റ്റർ അതിന്റെ LLM കോളുകളും ട്രാക്ക് ചെയ്യുന്നു. [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md) കാണുക. -ഡെവലപ്പ് ചെയ്യുമ്പോൾ രണ്ട് ടെർമിനലുകൾ ഉപയോഗിക്കുക: - -```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 ആപ്പിന് -അധിക CORS സെറ്റപ്പ് ഇല്ലാതെ പ്രാദേശിക Flask സെർവറുമായി സംസാരിക്കാൻ കഴിയും. - -Python പാക്കേജിനൊപ്പം ഷിപ്പ് ചെയ്യുന്ന ബണ്ടിൽ ബിൽഡ് ചെയ്യാൻ: - -```bash -cd frontend -npm run build -``` - -പ്രൊഡക്ഷൻ ബണ്ടിൽ `clawmetry/static/v2/dist/`-ലേക്ക് എഴുതപ്പെടുന്നു. - -## റൺടൈം / ഏജന്റ് അനുയോജ്യത +## നിങ്ങൾക്ക് ലഭിക്കുന്നത് -ClawMetry OpenClaw മാത്രമല്ല, നിരവധി AI-ഏജന്റ് റൺടൈമുകൾ നിരീക്ഷിക്കുന്നു. OpenClaw-അല്ലാത്ത ഓരോ റൺടൈമും അതിന്റെ യഥാർത്ഥ സെഷൻ ഫോർമാറ്റിനെ ClawMetry-യുടെ ഏകീകൃത ആകൃതികളിലേക്ക് വിവർത്തനം ചെയ്യുന്ന ഒരു സമർപ്പിത റീഡർ അഡാപ്റ്റർ ഷിപ്പ് ചെയ്യുന്നു; ഡെമൺ അവയെ റൺടൈം ടാഗ് ചെയ്ത് അതേ DuckDB സ്റ്റോറിലേക്കും ക്ലൗഡ് സ്നാപ്പ്ഷോട്ടിലേക്കും ഇൻജസ്റ്റ് ചെയ്യുന്നു, കൂടാതെ ഒന്നിലധികം റൺടൈമുകൾ ഉള്ളപ്പോൾ Session replay ടാബ് ഒരു **റൺടൈം സ്വിച്ചർ** കാണിക്കുന്നു. പൂർണ്ണ മാട്രിക്സിനും റൺടൈമുകൾ ചേർക്കുന്നതിനുള്ള ഗൈഡിനും [`docs/compatibility.md`](docs/compatibility.md) കാണുക, OpenClaw-ഫാമിലി പരിചയത്തിന് [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) കാണുക. +- **സെഷനുകളും ട്രാൻസ്ക്രിപ്റ്റുകളും**: ഓരോ ഏജന്റും ചെയ്തത് എന്താണ്, ഓരോ ടേണിലും, റീപ്ലേയോടെ +- **ചെലവും ടോക്കണുകളും**: റൺടൈം, മോഡൽ, സെഷൻ, ദിവസം എന്നിവ പ്രകാരം, അസാധാരണത്വ ഫ്ലാഗുകളോടെ +- **ഫ്ലോ**: ചാനലുകൾ, മോഡലുകൾ, ടൂളുകൾ എന്നിവയിലൂടെ നീങ്ങുന്ന സന്ദേശങ്ങളുടെ തത്സമയ ഡയഗ്രം +- **ബ്രെയിൻ**: സംഭവിക്കുമ്പോൾ തന്നെയുള്ള റീസണിംഗ്, ടൂൾ-കോൾ ഇവന്റ് സ്ട്രീം +- **മെമ്മറിയും സ്കില്ലുകളും**: ഓരോ റൺടൈമും യഥാർത്ഥത്തിൽ ലോഡ് ചെയ്ത ഫയലുകളും സ്കില്ലുകളും +- **ആരോഗ്യവും ലോഗുകളും**: ഡിസ്ക്, മെമ്മറി, പിശക് നിരക്കുകൾ, റേറ്റ് ലിമിറ്റുകൾ, തത്സമയ ലോഗ് സ്ട്രീം +- **അലേർട്ടുകൾ**: ബജറ്റ് കാപ്പുകൾ, പിശക് സ്‌പൈക്കുകൾ, ഏജന്റ്-ഓഫ്‌ലൈൻ, Slack, Discord, PagerDuty, Telegram, Email എന്നിവയിലേക്ക് റൂട്ട് ചെയ്യപ്പെടുന്നു +- **അപ്രൂവലുകൾ**: അപകടസാധ്യതയുള്ള ടൂൾ കോളുകൾ *പ്രവർത്തിക്കുന്നതിന് മുൻപ്* താൽക്കാലികമായി നിർത്തി നിങ്ങളുടെ ഫോണിൽ നിന്ന് അംഗീകരിക്കൂ ([എങ്ങനെ](docs/APPROVALS.md)) -[Perplexity-യുടെ numbat](https://github.com/perplexityai/numbat) ഏജന്റ്-സുരക്ഷാ ടൂൾ പ്രവർത്തിപ്പിക്കുന്നുണ്ടോ? ClawMetry അതിന്റെ കണ്ടെത്തലുകളും നിർവ്വഹണ തീരുമാനങ്ങളും തുടക്കം മുതൽ ഇൻജസ്റ്റ് ചെയ്യുന്നു — [`docs/NUMBAT.md`](docs/NUMBAT.md) കാണുക. +## വിലനിർണ്ണയം -| റൺടൈം / ഏജന്റ് | സ്റ്റാറ്റസ് | കുറിപ്പുകൾ | +| പ്ലാൻ | ഇത് ഉൾക്കൊള്ളുന്നത് | വില | |---|---|---| -| **OpenClaw** | Native | റഫറൻസ് റൺടൈം, സ്വയമേവ കണ്ടെത്തുന്നു | -| **PicoClaw** | Beta adapter | ഫ്ലാറ്റ് `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`). ട്രാൻസ്ക്രിപ്റ്റുകൾ, മോഡൽ, ടൂൾ കോളുകൾ. | -| **NanoClaw** | Beta adapter | ഓരോ-സെഷനും SQLite (`data/v2-sessions`). ട്രാൻസ്ക്രിപ്റ്റുകൾ + സന്ദേശ എണ്ണങ്ങൾ. | -| **Hermes** | Beta adapter | SQLite `~/.hermes/state.db`. ട്രാൻസ്ക്രിപ്റ്റുകൾ, മോഡൽ, ടോക്കണുകൾ/ചെലവ്. | -| **Claude Code** | Beta adapter | JSONL `~/.claude/projects/.../.jsonl`. ട്രാൻസ്ക്രിപ്റ്റുകൾ, മോഡൽ, ചിന്തയോടു കൂടിയ ടൂൾ കോളുകൾ, ടോക്കൺ ഉപയോഗം. | -| **Codex** | Beta adapter | Rollout JSONL `~/.codex/sessions/...`. ട്രാൻസ്ക്രിപ്റ്റുകൾ, മോഡൽ, ടൂൾ കോളുകൾ, ടോക്കൺ ഉപയോഗം. | -| **Cursor** | Beta adapter | SQLite `state.vscdb`. ചാറ്റ്/കമ്പോസർ ട്രാൻസ്ക്രിപ്റ്റുകൾ, മോഡൽ. | -| **Aider** | Beta adapter | ഓരോ പ്രോജക്ടിനും `.aider.chat.history.md`. ട്രാൻസ്ക്രിപ്റ്റുകൾ, മോഡൽ, ടോക്കൺ എണ്ണങ്ങൾ. | -| **Goose** | Beta adapter | SQLite `~/.local/share/goose`. ട്രാൻസ്ക്രിപ്റ്റുകൾ, മോഡൽ, ടൂൾ കോളുകൾ, ടോക്കൺ ആകെത്തുകകൾ. | -| **opencode** | Beta adapter | SQLite `~/.local/share/opencode`. ട്രാൻസ്ക്രിപ്റ്റുകൾ, മോഡൽ, ടൂൾ കോളുകൾ, ടോക്കണുകൾ + ചെലവ്. | -| **Qwen Code** | Beta adapter | JSONL `~/.qwen/projects/.../chats`. ട്രാൻസ്ക്രിപ്റ്റുകൾ, മോഡൽ, ടൂൾ കോളുകൾ, ടോക്കൺ ഉപയോഗം. | -| **Pi** | Beta adapter | JSONL `~/.pi/agent/sessions`. ട്രാൻസ്ക്രിപ്റ്റുകൾ, മോഡൽ, ടൂൾ കോളുകൾ, ടോക്കണുകൾ + ചെലവ്. | -| **Deep Agents** | Beta adapter | SQLite `~/.deepagents/.state/sessions.db`. ട്രാൻസ്ക്രിപ്റ്റുകൾ, മോഡൽ, ടൂൾ കോളുകൾ, ടോക്കണുകൾ + ചെലവ്. | -| **n8n** | Beta adapter | SQLite `~/.n8n/database.sqlite`. വർക്ക്ഫ്ലോ എക്സിക്യൂഷനുകൾ, നോഡ് റണ്ണുകൾ, AI Agent പ്രോംപ്റ്റുകൾ, n8n രേഖപ്പെടുത്തുന്നിടത്ത് മോഡൽ + ടോക്കണുകൾ. | -| **Antigravity** | Beta adapter | `~/.gemini//brain/`-ന് കീഴിലുള്ള Brain JSONL. സംഭാഷണങ്ങൾ, ടൂൾ സ്റ്റെപ്പുകൾ, ചിന്ത, ഓരോ-ജനറേഷനും Gemini ടോക്കൺ വിഭജനവും ചെലവും, പശ്ചാത്തല-ജനറേഷൻ ബേണും. | -| **GitHub Copilot** | Beta adapter | `~/.copilot/session-state/`-ന് കീഴിലുള്ള Copilot CLI-യുടെ `events.jsonl` + ഓരോ-കോളിനും ഉപയോഗ ലെഡ്ജറായ `session-store.db`. സംഭാഷണങ്ങൾ, ടൂൾ കോളുകൾ, മോഡൽ റൂട്ടിംഗ്, കാഷെ-ബോധമുള്ള ടോക്കൺ വിഭജനം, വെണ്ടർ-ബില്ലു ചെയ്ത AI-ക്രെഡിറ്റ് ചെലവ്. | -| **Grok** | Beta adapter | xAI Grok Build CLI (`~/.grok/bin/grok`-ന് കീഴിലുള്ള Rust ബൈനറി): ഗ്ലോബൽ ഇവന്റ് ലോഗ് `~/.grok/logs/unified.jsonl` + ഓരോ-സെഷനും `~/.grok/sessions///{events.jsonl,summary.json}`. സംഭാഷണങ്ങൾ, ഓരോ-ടേണിനും ടോക്കൺ വിഭജനം, മോഡൽ റൂട്ടിംഗ്, കൂടാതെ CLI-യുടെ ഔട്ട്‌ബൗണ്ട് റിപ്പോ പേലോഡ് `~/.grok/upload_queue/`-ൽ സ്റ്റേജ് ചെയ്യപ്പെടുന്നു, അതിനാൽ നിങ്ങളുടെ മെഷീനിൽ നിന്ന് എന്ത് പുറത്തുപോയി എന്ന് നിങ്ങൾക്ക് കാണാം. | - -"Beta adapter" എന്നാൽ ClawMetry ആ റൺടൈമിന്റെ യഥാർത്ഥ ഓൺ-ഡിസ്ക് ഫോർമാറ്റിനുള്ള ഒരു റീഡർ ഷിപ്പ് ചെയ്യുന്നു എന്നാണ്, ഓരോന്നും ഒരു യഥാർത്ഥ മെഷീനിലെ യഥാർത്ഥ ഇൻസ്റ്റാളിനെതിരെ നിർമ്മിച്ചതും പരിശോധിച്ചുറപ്പിച്ചതുമാണ് (`tests/fixtures/runtimes//` കാണുക). അഡാപ്റ്ററുകൾ റീഡ്-ഒൺലി ആണ്; അതിന്റെ റൺടൈം യഥാർത്ഥത്തിൽ ഡിസ്കിൽ എന്താണ് സൂക്ഷിക്കുന്നത് എന്നതിനെക്കുറിച്ച് ഓരോന്നും സത്യസന്ധമാണ് (ഉദാ. PicoClaw/NanoClaw/Cursor ടോക്കൺ ചെലവ് ഡിസ്കിലേക്ക് എഴുതുന്നില്ല). ഒരു നോഡിൽ പല റൺടൈമുകൾ പ്രവർത്തിക്കുമ്പോൾ, റൺടൈം സ്വിച്ചർ വൃത്തിയായ ഡീപ്-ഡൈവിനായി സെഷനുകൾ കാഴ്ച ഒന്നിലേക്ക് സ്കോപ്പ് ചെയ്യുന്നു. - -## ഏതൊരു SDK ഏജന്റും ട്രാക്ക് ചെയ്യുക — ഔട്ട്-ലൂപ്പ് ചെലവ് ആട്രിബ്യൂഷൻ - -മുകളിലുള്ള റൺടൈമുകൾ എല്ലാം സെഷനുകൾ ഡിസ്കിലേക്ക് എഴുതുന്നു. നിങ്ങൾ OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, അല്ലെങ്കിൽ ഒരു സാധാരണ `httpx` ലൂപ്പ് ഉപയോഗിച്ച് നിർമ്മിച്ച നിങ്ങളുടെ സ്വന്തം **പ്രൊഡക്ഷൻ ഏജന്റ്** — അത് ചെയ്യുന്നില്ല. ClawMetry-യുടെ സീറോ-കോൺഫിഗ് ഇന്റർസെപ്റ്റർ `httpx`/`requests` മങ്കി-പാച്ച് ചെയ്തുകൊണ്ട് ഇപ്പോഴും അതിന്റെ LLM കോളുകൾ (ചെലവ്, ടോക്കണുകൾ, ലേറ്റൻസി, പിശകുകൾ) പിടിച്ചെടുക്കുന്നു: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (അല്ലെങ്കിൽ `CLAWMETRY_SOURCE=support-agent` എൻവ് വേരിയബിൾ) ഓരോ കോളിനെയും ഒരു **പേരുള്ള സോഴ്‌സ്** ഉപയോഗിച്ച് ടാഗ് ചെയ്യുന്നു, അതിനാൽ നിങ്ങൾ പ്രവർത്തിപ്പിക്കുന്ന ഓരോ പ്രോഡക്ടും Overview-യിലെ ഡാഷ്ബോർഡിന്റെ **🔌 Out-loop sources** കാർഡിൽ അതിന്റേതായ ഫസ്റ്റ്-ക്ലാസ്, ചെലവ്-ആട്രിബ്യൂട്ട് ചെയ്യാവുന്ന വരിയായി കാണിക്കും — ഓരോ ഏജന്റിനും കോളുകൾ, പ്രൊവൈഡറുകൾ, ലേറ്റൻസി, പിശക് നിരക്ക്. സോഴ്‌സ് സെറ്റ് ചെയ്തിട്ടില്ലേ? കോളുകൾ ഇപ്പോഴും ട്രാക്ക് ചെയ്യപ്പെടും; കാർഡ് മാത്രം മറഞ്ഞിരിക്കും. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -ഇത് റൺടൈം അഡാപ്റ്ററുകൾ ഫീഡ് ചെയ്യുന്ന അതേ ഡാറ്റ ലെയർ ആണ് (DuckDB → ക്ലൗഡ് സ്നാപ്പ്ഷോട്ട്), അതിനാൽ ഔട്ട്-ലൂപ്പ് സോഴ്‌സുകൾ മറ്റെല്ലാം പോലെ, E2E-എൻക്രിപ്റ്റ് ചെയ്തുകൊണ്ട്, ക്ലൗഡ് ഡാഷ്ബോർഡിലേക്ക് സിങ്ക് ചെയ്യുന്നു. - -## OpenTelemetry — വെണ്ടർ-ന്യൂട്രൽ, നിങ്ങളുടെ ട്രെയ്‌സുകൾ എവിടെയും അയയ്ക്കുക - -ClawMetry രണ്ട് ദിശകളിലും **OpenTelemetry** സംസാരിക്കുന്നു, **GenAI സെമാന്റിക് കൺവെൻഷനുകൾ** ഉപയോഗിച്ച്, അതിനാൽ നിങ്ങളുടെ ഏജന്റ് ട്രെയ്‌സുകൾ ഒരു ടൂളിലേക്കും ലോക്ക് ചെയ്യപ്പെടില്ല. - -ഓരോ സെഷനും — LLM കോളുകൾ, ടൂളുകൾ, സബ്-ഏജന്റുകൾ, ടോക്കണുകൾ, ചെലവ് — **എക്സ്പോർട്ട്** ചെയ്യുക OTLP/HTTP GenAI സ്പാനുകളായി ഏത് കളക്ടറിലേക്കും (Datadog, Grafana, Honeycomb, അല്ലെങ്കിൽ നിങ്ങളുടെ സ്വന്തം OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -ഓഥ് ഹെഡറുകളും പോൾ ഇന്റർവെലും ഐച്ഛിക എൻവ് വേരിയബിളുകളാണ്: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**ഇൻജസ്റ്റ്** — ബിൽറ്റ്-ഇൻ OTLP റിസീവർ `/v1/traces`, `/v1/logs`, `/v1/metrics` എന്നിവയിൽ മറ്റെന്തിൽ നിന്നും ട്രെയ്‌സുകൾ, ലോഗുകൾ, മെട്രിക്‌സ് സ്വീകരിക്കുന്നു. OpenTelemetry-ഇൻസ്ട്രുമെന്റ് ചെയ്ത ഏത് ആപ്പിനെയും അതിലേക്ക് പോയിന്റ് ചെയ്യുക: +| **ഫ്രീ** | OpenClaw + NVIDIA NemoClaw, പൂർണ്ണ ഡാഷ്ബോർഡ്, ലോക്കൽ മാത്രം | $0 | +| **സ്റ്റാർട്ടർ** | മുകളിൽ പറഞ്ഞ മറ്റെല്ലാ റൺടൈമും, ഫ്ലീറ്റ് വ്യൂ, ക്ലൗഡ് സിങ്ക് | ഒരു നോഡിന് $9 / മാസം | +| **Pro** | സ്റ്റാർട്ടർ + ഗവേണൻസ്: അപ്രൂവലുകൾ, ടൂൾ-റിസ്ക് പോളിസികൾ, evals, അസാധാരണത്വ കണ്ടെത്തൽ, cost optimizer, OTel export | ഒരു നോഡിന് $19 / മാസം | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON ട്രെയ്‌സുകളും ലോഗുകളും ഒരു സാധാരണ `pip install clawmetry`-യിൽ പ്രവർത്തിക്കും, അധിക ഒന്നും വേണ്ട. Protobuf ഇൻജസ്റ്റിന് (കൂടാതെ OTLP/JSON മെട്രിക്‌സിനും) `pip install clawmetry[otel]` വേണം. സ്വന്തം `service.name` സെറ്റ് ചെയ്യുന്ന ഒരു ആപ്പ്, അതിന്റെ ചെലവും ടോക്കണുകളും സഹിതം, റൺടൈം സ്വിച്ചറിൽ അതിന്റേതായ ഏജന്റായി കാണിക്കും. - -നിങ്ങൾക്ക് സീറോ-കോൺഫിഗ്, ലോക്കൽ-ഫസ്റ്റ് ClawMetry ഡാഷ്ബോർഡ് **കൂടാതെ** നിങ്ങളുടെ ടീം ഇതിനകം പ്രവർത്തിപ്പിക്കുന്ന ഏത് ബാക്കെൻഡിലും നിങ്ങളുടെ ഡാറ്റയും ലഭിക്കുന്നു — ലോക്ക്-ഇൻ ഇല്ല, രണ്ടാമത്തെ ഏജന്റ് ഇൻസ്റ്റാൾ ചെയ്യേണ്ടതില്ല. - -## കോൺഫിഗറേഷൻ - -മിക്ക ആളുകൾക്കും ഒരു കോൺഫിഗും ആവശ്യമില്ല. ClawMetry നിങ്ങളുടെ വർക്ക്‌സ്പേസ്, ലോഗുകൾ, സെഷനുകൾ, ക്രോണുകൾ എന്നിവ സ്വയമേവ കണ്ടെത്തുന്നു. - -നിങ്ങൾക്ക് കസ്റ്റമൈസ് ചെയ്യേണ്ടതുണ്ടെങ്കിൽ: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -എല്ലാ ഓപ്ഷനുകളും: `clawmetry --help` - -## പിന്തുണയ്ക്കുന്ന ചാനലുകൾ - -നിങ്ങൾ കോൺഫിഗർ ചെയ്ത ഓരോ OpenClaw ചാനലിനും ClawMetry തത്സമയ ആക്ടിവിറ്റി കാണിക്കുന്നു. നിങ്ങളുടെ `openclaw.json`-ൽ യഥാർത്ഥത്തിൽ സെറ്റപ്പ് ചെയ്ത ചാനലുകൾ മാത്രമേ Flow ഡയഗ്രമിൽ ദൃശ്യമാകൂ — കോൺഫിഗർ ചെയ്യാത്തവ സ്വയമേവ മറയ്ക്കപ്പെടും. - -Flow-ലെ ഏത് ചാനൽ നോഡിലും ക്ലിക്ക് ചെയ്താൽ ഇൻകമിംഗ്/ഔട്ട്ഗോയിംഗ് സന്ദേശ എണ്ണങ്ങളോടെയുള്ള തത്സമയ ചാറ്റ് ബബിൾ കാഴ്ച കാണാം. - -| ചാനൽ | സ്റ്റാറ്റസ് | ലൈവ് പോപ്പപ്പ് | കുറിപ്പുകൾ | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Full | ✅ | സന്ദേശങ്ങൾ, സ്ഥിതിവിവരക്കണക്കുകൾ, 10s റിഫ്രഷ് | -| 💬 **iMessage** | ✅ Full | ✅ | `~/Library/Messages/chat.db` നേരിട്ട് വായിക്കുന്നു | -| 💚 **WhatsApp** | ✅ Full | ✅ | WhatsApp Web (Baileys) വഴി | -| 🔵 **Signal** | ✅ Full | ✅ | signal-cli വഴി | -| 🟣 **Discord** | ✅ Full | ✅ | ഗിൽഡ് + ചാനൽ കണ്ടെത്തൽ | -| 🟪 **Slack** | ✅ Full | ✅ | വർക്ക്‌സ്പേസ് + ചാനൽ കണ്ടെത്തൽ | -| 🌐 **Webchat** | ✅ Full | ✅ | ബിൽറ്റ്-ഇൻ വെബ് UI സെഷനുകൾ | -| 📡 **IRC** | ✅ Full | ✅ | ടെർമിനൽ-സ്റ്റൈൽ ബബിൾ UI | -| 🍏 **BlueBubbles** | ✅ Full | ✅ | BlueBubbles REST API വഴി iMessage | -| 🔵 **Google Chat** | ✅ Full | ✅ | Chat API വെബ്‌ഹുക്കുകൾ വഴി | -| 🟣 **MS Teams** | ✅ Full | ✅ | Teams ബോട്ട് പ്ലഗിൻ വഴി | -| 🔷 **Mattermost** | ✅ Full | ✅ | സ്വയം-ഹോസ്റ്റ് ചെയ്ത ടീം ചാറ്റ് | -| 🟩 **Matrix** | ✅ Full | ✅ | വികേന്ദ്രീകൃതം, E2EE പിന്തുണ | -| 🟢 **LINE** | ✅ Full | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Full | ✅ | വികേന്ദ്രീകൃത NIP-04 DM-കൾ | -| 🟣 **Twitch** | ✅ Full | ✅ | IRC കണക്ഷൻ വഴി ചാറ്റ് | -| 🔷 **Feishu/Lark** | ✅ Full | ✅ | WebSocket ഇവന്റ് സബ്‌സ്ക്രിപ്ഷൻ | -| 🔵 **Zalo** | ✅ Full | ✅ | Zalo Bot API | - -> **സ്വയമേവ കണ്ടെത്തൽ:** ClawMetry നിങ്ങളുടെ `~/.openclaw/openclaw.json` വായിക്കുകയും നിങ്ങൾ യഥാർത്ഥത്തിൽ കോൺഫിഗർ ചെയ്ത ചാനലുകൾ മാത്രം റെൻഡർ ചെയ്യുകയും ചെയ്യുന്നു. മാനുവൽ സെറ്റപ്പ് ആവശ്യമില്ല. - -## Docker ഡെപ്ലോയ്‌മെന്റ് - -Docker കണ്ടെയ്നറിൽ ClawMetry പ്രവർത്തിപ്പിക്കണോ? കുഴപ്പമില്ല! 🐳 - -**Docker ഉപയോഗിച്ചുള്ള ദ്രുത തുടക്കം:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose ഉദാഹരണം:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **ശ്രദ്ധിക്കുക:** Docker-ൽ പ്രവർത്തിപ്പിക്കുമ്പോൾ, ClawMetry-ക്ക് നിങ്ങളുടെ സെറ്റപ്പ് സ്വയമേവ കണ്ടെത്താൻ കഴിയേണ്ടതിന് നിങ്ങളുടെ ഏജന്റിന്റെ ഡാറ്റ + ലോഗ് ഡയറക്ടറികൾ (ഉദാ. `~/.openclaw`, `~/.claude`, `~/.codex`) മൗണ്ട് ചെയ്യുക. - -## ആവശ്യകതകൾ - -- Python 3.8+ -- Flask (pip വഴി സ്വയമേവ ഇൻസ്റ്റാൾ ചെയ്യപ്പെടും) -- അതേ മെഷീനിൽ ഒരു AI ഏജന്റ് റൺടൈം: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, അല്ലെങ്കിൽ QM (അല്ലെങ്കിൽ Docker-നുള്ള മൗണ്ട് ചെയ്ത വോള്യങ്ങൾ) -- Linux അല്ലെങ്കിൽ macOS - -## NemoClaw / OpenShell പിന്തുണ - -ClawMetry സ്വയമേവ [NemoClaw](https://github.com/NVIDIA/NemoClaw) കണ്ടെത്തുന്നു — സാൻഡ്ബോക്സ് ചെയ്ത OpenShell കണ്ടെയ്നറുകൾക്കുള്ളിൽ ഏജന്റുകൾ പ്രവർത്തിപ്പിക്കുന്ന OpenClaw-നുള്ള NVIDIA-യുടെ എന്റർപ്രൈസ് സുരക്ഷാ റാപ്പർ. - -മിക്ക കേസുകളിലും അധിക കോൺഫിഗറേഷൻ ആവശ്യമില്ല. സെഷൻ ഫയലുകൾ ഹോസ്റ്റിലെ `~/.openclaw/`-ൽ ആയാലും OpenShell കണ്ടെയ്നറിനുള്ളിൽ ആയാലും സിങ്ക് ഡെമൺ അവ സ്വയമേവ കണ്ടെത്തുന്നു. +വാർഷിക പ്ലാനുകൾ, എന്റർപ്രൈസ്, നിലവിലെ കണക്കുകൾ എന്നിവ +**[clawmetry.com/pricing](https://clawmetry.com/pricing)** ൽ ലഭ്യമാണ്. സെൽഫ്-ഹോസ്റ്റഡ് ലൈസൻസ് +കീകൾ ക്ലൗഡ് ഇല്ലാതെയും പ്രവർത്തിക്കും (`clawmetry license`). കൃത്യമായ ഫ്രീ/പെയ്ഡ് വിഭജനം +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) ൽ ഉണ്ട്. -### ഇത് എങ്ങനെ പ്രവർത്തിക്കുന്നു +## നിങ്ങളുടെ ഡാറ്റ നിങ്ങളുടെ മെഷീനിൽ തന്നെ നിലനിൽക്കുന്നു -ClawMetry രണ്ട് വിധത്തിൽ NemoClaw കണ്ടെത്തുന്നു: +ClawMetry ലോക്കൽ സെഷൻ ഫയലുകളും ലോഗുകളും വായിക്കുന്നു. നിങ്ങൾ `clawmetry connect` പ്രവർത്തിപ്പിക്കുന്നില്ലെങ്കിൽ +നിങ്ങളുടെ ബോക്സിൽ നിന്ന് ഒന്നും പുറത്തുപോകില്ല. അപ്പോൾ പോലും, സ്നാപ്ഷോട്ട് നിങ്ങളുടെ മെഷീൻ വിട്ടുപോകാത്ത +ഒരു കീ ഉപയോഗിച്ച് എൻഡ്-ടു-എൻഡ് എൻക്രിപ്റ്റ് ചെയ്യപ്പെടുന്നു, നിങ്ങളുടെ ബ്രൗസറിൽ ഡീക്രിപ്റ്റ് ചെയ്യപ്പെടുന്നു. -1. **ബൈനറി കണ്ടെത്തൽ** — `nemoclaw` CLI ഉണ്ടോ എന്ന് പരിശോധിക്കുകയും സാൻഡ്ബോക്സ് വിവരം ലഭിക്കാൻ `nemoclaw status` പ്രവർത്തിപ്പിക്കുകയും ചെയ്യുന്നു -2. **കണ്ടെയ്നർ കണ്ടെത്തൽ** — `openshell`, `nemoclaw`, അല്ലെങ്കിൽ `ghcr.io/nvidia/` ഇമേജുകൾക്കായി പ്രവർത്തിക്കുന്ന Docker കണ്ടെയ്നറുകൾ സ്കാൻ ചെയ്യുന്നു, തുടർന്ന് വോള്യം മൗണ്ടുകൾ വഴിയോ `docker cp` വഴിയോ സെഷനുകൾ വായിക്കുന്നു - -NemoClaw കണ്ടെയ്നറുകളിൽ നിന്ന് സിങ്ക് ചെയ്ത സെഷൻ ഫയലുകൾ ക്ലൗഡ് ഡാഷ്ബോർഡിൽ `runtime=nemoclaw`, `container_id` മെറ്റാഡാറ്റ ഉപയോഗിച്ച് ടാഗ് ചെയ്യപ്പെടുന്നു, അതിനാൽ ഒറ്റനോട്ടത്തിൽ അവയെ സ്റ്റാൻഡേർഡ് OpenClaw സെഷനുകളിൽ നിന്ന് വേർതിരിച്ചറിയാം. - -### ശുപാർശ ചെയ്യുന്ന സെറ്റപ്പ്: HOST-ൽ സിങ്ക് ഡെമൺ - -മികച്ച അനുഭവത്തിന്, ClawMetry-യുടെ സിങ്ക് ഡെമൺ **ഹോസ്റ്റ് മെഷീനിൽ** (സാൻഡ്ബോക്സിനുള്ളിൽ അല്ല) പ്രവർത്തിപ്പിക്കുക. ഇത് NemoClaw നെറ്റ്‌വർക്ക് നയ നിയന്ത്രണങ്ങൾ ഒഴിവാക്കുന്നു. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -സിങ്ക് ഡെമൺ പ്രവർത്തിക്കുന്ന ഏത് OpenShell കണ്ടെയ്നറിനുള്ളിലുമുള്ള സെഷനുകൾ സ്വയമേവ കണ്ടെത്തും. - -### ഐച്ഛികം: വ്യക്തമായ സാൻഡ്ബോക്സ് പേര് - -സ്വയമേവ കണ്ടെത്തൽ പ്രവർത്തിക്കുന്നില്ലെങ്കിൽ, ClawMetry-യെ ശരിയായ സാൻഡ്ബോക്സിലേക്ക് പോയിന്റ് ചെയ്യുക: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### സാൻഡ്ബോക്സിനുള്ളിൽ പ്രവർത്തിപ്പിക്കൽ (നൂതനം) - -സിങ്ക് ഡെമൺ OpenShell സാൻഡ്ബോക്സിനുള്ളിൽ **തന്നെ** പ്രവർത്തിപ്പിക്കണമെങ്കിൽ, ClawMetry ingest API-യിലേക്ക് എത്താൻ കഴിയുന്നതിനായി നിങ്ങളുടെ NemoClaw നെറ്റ്‌വർക്ക് നയത്തിലേക്ക് ഈ എഗ്രെസ് നിയമം ചേർക്കുക: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -ഇത് ഉപയോഗിച്ച് പ്രയോഗിക്കുക: +## ഇൻസ്റ്റാൾ ചെയ്യുക ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # then: clawmetry ``` -### പോർട്ടുകളും എൻഡ്‌പോയിന്റുകളും - -| എൻഡ്‌പോയിന്റ് | പോർട്ട് | പ്രോട്ടോക്കോൾ | ആവശ്യമോ | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | അതെ (സിങ്ക് ഡെമൺ → ക്ലൗഡ്) | -| `localhost:8900` | 8900 | HTTP | അതെ (പ്രാദേശിക ഡാഷ്ബോർഡ് UI) | -| Docker സോക്കറ്റ് (`/var/run/docker.sock`) | — | Unix സോക്കറ്റ് | കണ്ടെയ്നർ സെഷൻ കണ്ടെത്തലിന് | - -സിങ്ക് ഡെമൺ `ingest.clawmetry.com`-ലേക്ക് മാത്രമേ ഔട്ട്ബൗണ്ട് HTTPS കോളുകൾ നടത്തൂ. ഇൻബൗണ്ട് പോർട്ടുകൾ ആവശ്യമില്ല. - ---- - -## ക്ലൗഡ് ഡെപ്ലോയ്‌മെന്റ് - -SSH ടണലുകൾ, റിവേഴ്‌സ് പ്രോക്സി, Docker എന്നിവയ്ക്കായി **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** കാണുക. - -## ടെസ്റ്റിംഗ് +അല്ലെങ്കിൽ ഒറ്റ-വരി കമാൻഡ്: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -ഈ പ്രോജക്ട് BrowserStack ഉപയോഗിച്ച് ടെസ്റ്റ് ചെയ്യപ്പെടുന്നു. +macOS, Linux അല്ലെങ്കിൽ Windows-ൽ Python 3.8+ ഉം, അതേ മെഷീനിൽ കുറഞ്ഞത് ഒരു ഏജന്റ് റൺടൈമും +ആവശ്യമാണ്. Docker നിർദ്ദേശങ്ങൾ: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## ഡോക്യുമെന്റേഷൻ -## ടെലിമെട്രി +| | | +|---|---| +| [റൺടൈം അനുയോജ്യത](docs/compatibility.md) | ഓരോ അഡാപ്റ്ററും എന്താണ് വായിക്കുന്നത്, ഒരു റൺടൈം എങ്ങനെ ചേർക്കാം | +| [Entitlements](docs/ENTITLEMENTS.md) | ഫ്രീ vs പെയ്ഡ്, ടയർ മാട്രിക്സ്, ലൈസൻസ് CLI | +| [അപ്രൂവലുകളും പോളിസികളും](docs/APPROVALS.md) | പ്രീ-എക്സിക്യൂഷൻ ഗേറ്റിംഗ്, റിസ്ക് സ്കോറിംഗ്, ഫോൺ അപ്രൂവലുകൾ | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | എവിടെയും ട്രെയ്സുകൾ എക്സ്പോർട്ട് ചെയ്യുക, എവിടെ നിന്നും OTLP ഇൻജസ്റ്റ് ചെയ്യുക | +| [SDK ട്രാക്കിംഗ്](docs/SDK_TRACKING.md) | നിങ്ങൾ സ്വയം നിർമ്മിച്ച ഏജന്റുകൾക്കായുള്ള ചെലവ് ആട്രിബ്യൂഷൻ | +| [ചാറ്റ് ചാനലുകൾ](docs/CHANNELS.md) | ഫ്ലോയിൽ കാണിക്കുന്ന ചാറ്റ് അഡാപ്റ്ററുകൾ | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | സാൻഡ്ബോക്സ്ഡ് NVIDIA NemoClaw സെറ്റപ്പുകൾ | +| [Docker](docs/DOCKER.md) | ഇമേജ്, compose, വോളിയം മൗണ്ടുകൾ | +| [ആർക്കിടെക്ചർ](ARCHITECTURE.md) · [ഡെവലപ്മെന്റ്](docs/DEVELOPMENT.md) | ഇത് ഉള്ളിൽ എങ്ങനെ പ്രവർത്തിക്കുന്നു; സോഴ്‌സിൽ നിന്ന് പ്രവർത്തിപ്പിക്കൽ | +| [ടെലിമെട്രി](docs/TELEMETRY.md) | അജ്ഞാത ഇൻസ്റ്റാൾ, ഡെസ്ക്ടോപ്പ്-ഓപ്പൺ പിംഗുകൾ, അവ എങ്ങനെ ഓഫ് ചെയ്യാം | -ClawMetry `https://app.clawmetry.com/api/install`-ലേക്ക് അജ്ഞാത ഇൻസ്റ്റാൾ-ലൈഫ്‌സൈക്കിൾ -പിംഗുകൾ അയയ്ക്കുന്നു: ഒരു പുതിയ മെഷീനിൽ `clawmetry` CLI ആദ്യമായി പ്രവർത്തിപ്പിക്കുമ്പോൾ ഒരു -`install` പിംഗ്, ഒരു പുതിയ പതിപ്പിലേക്ക് അപ്‌ഗ്രേഡ് ചെയ്ത ശേഷമുള്ള ആദ്യ റണ്ണിൽ ഒരു -`update` പിംഗ്, ഡാഷ്ബോർഡിനുള്ളിലെ ഓൺബോർഡിംഗ് ചോയ്സ് പൂർത്തിയാക്കുമ്പോൾ ഒരു -`onboarded` പിംഗ്. യഥാർത്ഥ ഇൻസ്റ്റാളുകൾ എണ്ണാനും (റോ PyPI ഡൗൺലോഡ് സംഖ്യകൾ ~98% -മിററുകൾ, CI, ഓട്ടോ-അപ്ഡേറ്റ് വീണ്ടും-ഡൗൺലോഡുകൾ ആണ്) യഥാർത്ഥത്തിൽ ഉപയോഗത്തിലുള്ള -ഏജന്റ് ഫ്രെയിംവർക്കുകളും പതിപ്പുകളും അറിയാനും ഞങ്ങൾ ഇത് ഉപയോഗിക്കുന്നു. +## സ്ക്രീൻഷോട്ടുകൾ -**ഓരോ പതിപ്പിനും ഓരോ ലൈഫ്‌സൈക്കിൾ ഇവന്റിനും പരമാവധി ഒരു POST**, ഇത് ഉൾക്കൊള്ളുന്നു: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **ഓവർവ്യൂ**: ടോക്കണുകൾ, സെഷനുകൾ, ആരോഗ്യം | **ബ്രെയിൻ**: തത്സമയ ഏജന്റ് ഇവന്റ് സ്ട്രീം | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **ചെലവ്**: മോഡലും സെഷനും അനുസരിച്ച് | **അപ്രൂവലുകൾ**: അപകടസാധ്യതയുള്ള ടൂൾ കോളുകൾ ഗേറ്റ് ചെയ്യുക | -| ഫീൽഡ് | ഉദാഹരണം | എന്തിന് | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id`-ൽ സൂക്ഷിച്ച റാൻഡം UUID | ഡിഡ്യൂപ്; നിങ്ങൾ വ്യക്തമായി Cloud sync കണക്ട് ചെയ്യുന്നത് വരെ അജ്ഞാതം (തുടർന്ന് ഓഥന്റിക്കേറ്റഡ് ഡെമൺ ഹാർട്ട്ബീറ്റ് ഇത് വഹിക്കുന്നു, ഈ ഇൻസ്റ്റാളിനെ നിങ്ങളുടെ അക്കൗണ്ടുമായി ബന്ധിപ്പിക്കുന്നു) | -| `event` | `install` / `update` / `onboarded` | പുതിയ ഇൻസ്റ്റാൾ vs നിലവിലുള്ള ഒന്നിന്റെ അപ്‌ഗ്രേഡ് | -| `version` | `0.12.167` | ഏതൊക്കെ പതിപ്പുകൾ ഉപയോഗത്തിലുണ്ട് | -| `os` / `os_version` | `Darwin` / `25.3.0` | പ്ലാറ്റ്ഫോം പിന്തുണാ മുൻഗണനകൾ | -| `python` | `3.11.15` | Python പതിപ്പ് പിന്തുണാ മാട്രിക്സ് | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | അടുത്തതായി ഞങ്ങൾ ഏത് ഏജന്റുകളുമായി ഇന്റഗ്രേറ്റ് ചെയ്യണം | -| `is_ci` / `ci_provider` | `true` / `github_actions` | മനുഷ്യ ഇൻസ്റ്റാളുകളെ CI ശബ്ദത്തിൽ നിന്ന് വേർതിരിക്കുന്നു | - -**ഞങ്ങൾ അയയ്ക്കാത്തത്**: IP (ക്ലൗഡ് അഭ്യർത്ഥനയിൽ നിന്ന് സെർവർ-സൈഡിൽ രാജ്യ കോഡ് -ഡെറൈവ് ചെയ്യുന്നു, തുടർന്ന് IP ഒഴിവാക്കുന്നു), ഹോസ്റ്റ്നെയിം, യൂസർനെയിം, വർക്ക്‌സ്പേസ് -പാത്ത്, ഫയൽ ഉള്ളടക്കങ്ങൾ, നിങ്ങളുടെ api_key, നിങ്ങളുടെ ഇമെയിൽ, PII അല്ലെങ്കിൽ -വർക്ക്‌സ്പേസ്-നിർദ്ദിഷ്ടമായ ഒന്നും. വയർ പേലോഡ് [`clawmetry/telemetry.py`](clawmetry/telemetry.py)-ൽ -ഓഡിറ്റ് ചെയ്യാവുന്നതാണ്. - -**ഒഴിവാക്കുക** (ഇവയിൽ ഏതെങ്കിലും ഒന്ന് ഇത് സ്ഥിരമായി പ്രവർത്തനരഹിതമാക്കും): +കൂടുതൽ, ഓരോ റൺടൈമിനും അനുസരിച്ച്: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -ഇവിടെ ഒരു നെറ്റ്‌വർക്ക് പരാജയം ഒരിക്കലും `clawmetry` പ്രവർത്തിക്കുന്നതിൽ നിന്ന് -തടയില്ല — പിംഗ് ഒരു ഡെമൺ ത്രെഡിൽ 3s ടൈംഔട്ടോടെ ഫയർ-ആൻഡ്-ഫോർഗെറ്റ് ആണ്. - -## നക്ഷത്ര ചരിത്രം +## Star History @@ -436,11 +113,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## ലൈസൻസ് -MIT - ---- +MIT · നിർമ്മിച്ചത് [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 നിങ്ങളുടെ ഏജന്റ് ചിന്തിക്കുന്നത് കാണൂ
- നിർമ്മിച്ചത് @vivekchand · clawmetry.com · OpenClaw ഇക്കോസിസ്റ്റത്തിന്റെ ഭാഗം -

+ diff --git a/docs/i18n/mr/README.md b/docs/i18n/mr/README.md index dca0d459d6..2d3a208b54 100644 --- a/docs/i18n/mr/README.md +++ b/docs/i18n/mr/README.md @@ -1,430 +1,110 @@ - + > मराठी translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**तुमचा एजंट कसा विचार करतो ते पाहा.** **२० AI एजंट रनटाइम्ससाठी** रिअल-टाइम ऑब्झर्वेबिलिटी: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex आणि आणखी १६. तुमच्या संपूर्ण एजंट फ्लीटसाठी एकच डॅशबोर्ड. +**तुमचा एजंट विचार करताना पहा.** **२३ AI एजंट रनटाइम्ससाठी** रिअल-टाइम ऑब्झर्व्हेबिलिटी: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex आणि आणखी १९. तुमच्या संपूर्ण एजंट फ्लीटसाठी एकच डॅशबोर्ड. > 🌐 **हे यामध्ये वाचा:** [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** वर उघडते आणि झाले. +**http://localhost:8900** येथे उघडते. शून्य कॉन्फिगरेशन: तुमच्याकडे आधीपासून असलेले एजंट रनटाइम्स +ते शोधते, त्यांना फक्त वाचनासाठी (read-only) वाचते आणि ते कसे चालतात यात काहीही बदल करत नाही. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## २० एजंट रनटाइम्ससोबत काम करते - -ClawMetry ची सुरुवात OpenClaw साठी ऑब्झर्वेबिलिटी म्हणून झाली आणि आता ते एकाच डॅशबोर्डमध्ये तुमच्या **संपूर्ण एजंट फ्लीटचे** मापन करते, तुमच्या मशीनवरील प्रत्येक रनटाइम आपोआप शोधून काढते: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw आणि NemoClaw हे ओपन-सोर्स ॲपमध्ये मोफत आहेत; इतर रनटाइम्स ClawMetry Cloud किंवा सेल्फ-होस्टेड Pro लायसन्ससह सक्रिय होतात. हेडरमधून रनटाइम बदला आणि प्रत्येक टॅब — खर्च, टोकन्स, टूल्स, ट्रेसेस — त्या रनटाइमनुसार पुन्हा-स्कोप होतो. नेमका मोफत/पेड विभाग, टियर मॅट्रिक्स, `/api/entitlement` शेप, आणि `clawmetry license` CLI साठी **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** पाहा. - -## तुम्हाला काय मिळते - -- **Flow** — चॅनेल्स, ब्रेन, टूल्स आणि परत यामधून वाहणारे मेसेजेस दाखवणारा लाइव्ह अ‍ॅनिमेटेड डायग्राम -- **Overview** — हेल्थ चेक्स, अ‍ॅक्टिव्हिटी हीटमॅप, सेशन काउंट्स, मॉडेल माहिती -- **Usage** — दैनिक/साप्ताहिक/मासिक विभागणीसह टोकन आणि खर्च ट्रॅकिंग -- **Sessions** — मॉडेल, टोकन्स, शेवटची अ‍ॅक्टिव्हिटीसह सक्रिय एजंट सेशन्स -- **Crons** — स्थिती, पुढील रन, कालावधीसह शेड्युल्ड जॉब्स -- **Logs** — रंगकोड केलेले रिअल-टाइम लॉग स्ट्रीमिंग -- **Memory** — SOUL.md, MEMORY.md, AGENTS.md, दैनिक नोट्स ब्राउझ करा -- **Transcripts** — सेशन इतिहास वाचण्यासाठी चॅट-बबल UI -- **Alerts** — बजेट कॅप्स, एरर-रेट ट्रिगर्स, एजंट-ऑफलाइन डिटेक्शन; Slack, Discord, PagerDuty, Telegram, ईमेलकडे मार्गस्थ करते -- **Approvals** — विध्वंसक डिलीट्स, फोर्स पुश, DB म्युटेशन्स, sudo, पॅकेज इन्स्टॉलेशन्स, नेटवर्क कॉल्स एका क्लिकच्या मंजुरीमागे थांबवा - -## स्क्रीनशॉट्स - -### 🧠 Brain — लाइव्ह एजंट इव्हेंट स्ट्रीम -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — टोकन वापर आणि सेशन सारांश -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — रिअल-टाइम टूल कॉल फीड -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — मॉडेल आणि सेशननुसार खर्च विभागणी -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — वर्कस्पेस फाइल ब्राउझर -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — पोश्चर आणि ऑडिट लॉग -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) +## २३ एजंट रनटाइम्ससोबत काम करते -### 🚨 Alerts — बजेट कॅप्स, एरर-रेट ट्रिगर्स, Slack / Discord / PagerDuty / ईमेलसाठी वेबहूक्स -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +**ओपन सोर्स अ‍ॅपमध्ये मोफत:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### ✋ Approvals — जोखमीचे टूल कॉल्स मॅन्युअल सही-मंजुरीमागे थांबवा; पॉलिसी-समर्थित संरक्षण नियम -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Claude Code साठी अंमलबजावणी-पूर्व ब्लॉकिंग** — एक कमांड जुळणारे टूल कॉल्स -*चालण्याआधीच* थांबवणारा आणि तुमच्या निर्णयाची वाट पाहणारा PreToolUse hook -इन्स्टॉल करते ([क्लाउड पुश नोटिफिकेशन्स](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 च्या -स्वतःच्या परमिशन प्रॉम्प्टला वगळले जाते (तुम्ही आधीच उत्तर दिलेले असते). -न जुळणाऱ्या टूल्सना सुमारे ४० मिलिसेकंद खर्च येतो आणि ते 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 -``` +**पेड प्लॅनवर:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -## v2 फ्रंटएंड डेव्हलपमेंट +प्रत्येक रनटाइमला तोच डॅशबोर्ड मिळतो. एकाच वेळी अनेक रनटाइम्स चालवा आणि हेडर +स्विचर प्रत्येक टॅबला त्यापैकी एकावर पुन्हा-स्कोप करतो. -v2 React ॲप `frontend/` मध्ये राहतो आणि Flask सर्व्हर v2 सक्षम करून -सुरू केला असता `/v2` वर सर्व्ह केला जातो. +एखाद्या SDK वर स्वतःचा एजंट तयार केला आहे? इंटरसेप्टर त्याच्या LLM कॉल्सचाही मागोवा घेतो. +पाहा [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -डेव्हलप करताना दोन टर्मिनल्स वापरा: - -```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 ॲप -अतिरिक्त CORS सेटअपशिवाय लोकल Flask सर्व्हरशी बोलू शकतो. - -Python पॅकेजसोबत पाठवला जाणारा बंडल तयार करण्यासाठी: - -```bash -cd frontend -npm run build -``` - -प्रोडक्शन बंडल `clawmetry/static/v2/dist/` मध्ये लिहिला जातो. - -## रनटाइम / एजंट सुसंगतता +## तुम्हाला काय मिळते -ClawMetry फक्त OpenClaw नव्हे तर अनेक AI-एजंट रनटाइम्सचे निरीक्षण करते. प्रत्येक नॉन-OpenClaw रनटाइमसाठी समर्पित रीडर अडॅप्टर पुरवला जातो जो त्या रनटाइमच्या मूळ सेशन फॉरमॅटला ClawMetry च्या एकसंध शेप्समध्ये भाषांतरित करतो; डीमन त्यांना त्याच DuckDB स्टोअर + क्लाउड स्नॅपशॉटमध्ये, रनटाइमने टॅग करून, इनजेस्ट करतो, आणि एकापेक्षा जास्त रनटाइम्स असताना Session replay टॅबमध्ये **रनटाइम स्विचर** दिसतो. संपूर्ण मॅट्रिक्स + रनटाइम्स जोडण्याच्या मार्गदर्शकासाठी [`docs/compatibility.md`](docs/compatibility.md) पाहा, आणि OpenClaw-फॅमिली प्राइमरसाठी [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) पाहा. +- **सेशन्स आणि ट्रान्सक्रिप्ट्स**: प्रत्येक एजंटने काय केले, टर्न-बाय-टर्न, रिप्लेसह +- **खर्च आणि टोकन्स**: प्रत्येक रनटाइम, मॉडेल, सेशन आणि दिवसानुसार, विसंगती (anomaly) फ्लॅग्ससह +- **फ्लो**: चॅनेल्स, मॉडेल्स आणि टूल्समधून फिरणाऱ्या मेसेजेसचा लाइव्ह आकृती +- **ब्रेन**: घडत असताना रिझनिंग आणि टूल-कॉल इव्हेंट स्ट्रीम +- **मेमरी आणि स्किल्स**: प्रत्येक रनटाइमने प्रत्यक्षात लोड केलेल्या फाइल्स आणि स्किल्स +- **आरोग्य आणि लॉग्स**: डिस्क, मेमरी, एरर रेट्स, रेट लिमिट्स, लाइव्ह लॉग स्ट्रीम +- **अलर्ट्स**: बजेट कॅप्स, एरर स्पाइक्स, एजंट-ऑफलाइन, Slack, Discord, PagerDuty, Telegram, Email कडे रूट केलेले +- **मंजुऱ्या (Approvals)**: जोखमीचे टूल कॉल्स चालण्यापूर्वीच थांबवा आणि तुमच्या फोनवरून मंजूर करा ([कसे](docs/APPROVALS.md)) -[Perplexity चे numbat](https://github.com/perplexityai/numbat) हे एजंट-सुरक्षा टूल वापरत आहात? ClawMetry त्याचे निष्कर्ष आणि अंमलबजावणी निर्णय आधीपासूनच इनजेस्ट करते — [`docs/NUMBAT.md`](docs/NUMBAT.md) पाहा. +## किंमत -| रनटाइम / एजंट | स्थिती | नोट्स | +| प्लॅन | यात काय समाविष्ट आहे | किंमत | |---|---|---| -| **OpenClaw** | नेटिव्ह | संदर्भ रनटाइम, आपोआप शोधले जाते | -| **PicoClaw** | बीटा अडॅप्टर | फ्लॅट `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`). ट्रान्सक्रिप्ट्स, मॉडेल, टूल कॉल्स. | -| **NanoClaw** | बीटा अडॅप्टर | प्रति-सेशन SQLite (`data/v2-sessions`). ट्रान्सक्रिप्ट्स + मेसेज काउंट्स. | -| **Hermes** | बीटा अडॅप्टर | SQLite `~/.hermes/state.db`. ट्रान्सक्रिप्ट्स, मॉडेल, टोकन्स/खर्च. | -| **Claude Code** | बीटा अडॅप्टर | JSONL `~/.claude/projects/.../.jsonl`. ट्रान्सक्रिप्ट्स, मॉडेल, टूल कॉल्स + थिंकिंग, टोकन वापर. | -| **Codex** | बीटा अडॅप्टर | रोलआउट 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`. वर्कफ्लो एक्झिक्युशन्स, नोड रन्स, AI Agent प्रॉम्प्ट्स, n8n जिथे नोंदवते तिथे मॉडेल + टोकन्स. | -| **Antigravity** | बीटा अडॅप्टर | `~/.gemini//brain/` खाली ब्रेन JSONL. संभाषणे, टूल स्टेप्स, थिंकिंग, प्रति-जनरेशन Gemini टोकन विभागणी + खर्च, बॅकग्राउंड-जनरेशन बर्न. | -| **GitHub Copilot** | बीटा अडॅप्टर | Copilot CLI चे `events.jsonl` `~/.copilot/session-state/` खाली + प्रति-कॉल वापर लेजर असणारा `session-store.db`. संभाषणे, टूल कॉल्स, मॉडेल राउटिंग, कॅश-जागरूक टोकन विभागणी, विक्रेता-बिल्ड AI-क्रेडिट खर्च. | -| **Grok** | बीटा अडॅप्टर | xAI Grok Build CLI (`~/.grok/bin/grok` खालील Rust बायनरी): ग्लोबल इव्हेंट लॉग `~/.grok/logs/unified.jsonl` + प्रति-सेशन `~/.grok/sessions///{events.jsonl,summary.json}`. संभाषणे, प्रति-टर्न टोकन विभागणी, मॉडेल राउटिंग, आणि तुमच्या मशीनमधून काय बाहेर गेले हे दिसावे यासाठी `~/.grok/upload_queue/` खाली स्टेज केलेला CLI चा आउटबाउंड रिपो पेलोड. | - -"बीटा अडॅप्टर" म्हणजे ClawMetry त्या रनटाइमच्या डिस्कवरील खऱ्या फॉरमॅटसाठी रीडर पाठवते, प्रत्येक खऱ्या मशीनवरील खऱ्या इन्स्टॉलविरुद्ध तयार + पडताळलेला (पाहा `tests/fixtures/runtimes//`). अडॅप्टर्स रीड-ओन्ली आहेत; प्रत्येक त्या रनटाइमने प्रत्यक्षात काय साठवले आहे याबाबत प्रामाणिक असतो (उदा. PicoClaw/NanoClaw/Cursor डिस्कवर टोकन खर्च लिहीत नाहीत). एका नोडवर अनेक रनटाइम्स चालत असताना, रनटाइम स्विचर सेशन्स व्ह्यूला स्वच्छ डीप-डाइव्हसाठी एका रनटाइमपुरता स्कोप करतो. - -## कोणताही SDK एजंट ट्रॅक करा — आउट-लूप खर्च गुणधर्म - -वरील रनटाइम्स सर्व सेशन्स डिस्कवर लिहितात. तुम्ही OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, किंवा साध्या `httpx` लूपवर बनवलेला तुमचा स्वतःचा **प्रोडक्शन एजंट** असे करत नाही. ClawMetry चा शून्य-कॉन्फिग इंटरसेप्टर `httpx`/`requests` वर मंकी-पॅचिंग करून त्याचे LLM कॉल्स (खर्च, टोकन्स, लेटन्सी, एरर्स) तरीही टिपतो: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (किंवा `CLAWMETRY_SOURCE=support-agent` env व्हेरिएबल) प्रत्येक कॉलला एका **नामांकित स्रोता**सह टॅग करते, त्यामुळे तुम्ही चालवत असलेले प्रत्येक प्रोडक्ट डॅशबोर्डच्या Overview मधील **🔌 आउट-लूप स्रोत** कार्डमध्ये स्वतःची पहिल्या-दर्जाची, खर्च-गुणधर्म देण्यायोग्य ओळ म्हणून दिसते — प्रति-एजंट कॉल्स, प्रोव्हायडर्स, लेटन्सी, एरर रेट. स्रोत सेट केला नसेल? कॉल्स तरीही ट्रॅक होतात; फक्त कार्ड लपलेले राहते. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -रनटाइम अडॅप्टर्स ज्या डेटा लेयरवर चालतात (DuckDB → क्लाउड स्नॅपशॉट) हा तोच लेयर आहे, त्यामुळे आउट-लूप स्रोत बाकी सगळ्याप्रमाणेच, E2E-एनक्रिप्टेड पद्धतीने क्लाउड डॅशबोर्डशी सिंक होतात. - -## OpenTelemetry — विक्रेता-निरपेक्ष, तुमचे ट्रेसेस कुठेही पाठवा - -ClawMetry दोन्ही दिशांनी **OpenTelemetry** बोलतो, **GenAI सिमॅंटिक कन्व्हेन्शन्स** वापरून, त्यामुळे तुमचे एजंट ट्रेसेस कधीही एका टूलमध्ये लॉक होत नाहीत. - -प्रत्येक सेशन — LLM कॉल्स, टूल्स, सब-एजंट्स, टोकन्स, खर्च — कोणत्याही कलेक्टरला (Datadog, Grafana, Honeycomb, किंवा तुमचा स्वतःचा OTel Collector) OTLP/HTTP GenAI स्पॅन्स म्हणून **एक्सपोर्ट** करा: - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -ऑथ हेडर्स आणि पोल इंटरव्हल हे ऐच्छिक env व्हेरिएबल्स आहेत: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**इनजेस्ट** — अंगभूत OTLP रिसीव्हर `/v1/traces`, `/v1/logs`, आणि `/v1/metrics` वर इतर कोणत्याही स्रोतापासून ट्रेसेस, लॉग्स आणि मेट्रिक्स स्वीकारतो. कोणतेही OpenTelemetry-इन्स्ट्रुमेंटेड ॲप त्याकडे पॉइंट करा: +| **Free** | OpenClaw + NVIDIA NemoClaw, संपूर्ण डॅशबोर्ड, फक्त लोकल | $0 | +| **Starter** | वरील इतर सर्व रनटाइम्स, फ्लीट व्ह्यू, क्लाउड सिंक | $9 प्रति नोड / महिना | +| **Pro** | Starter + गव्हर्नन्स: मंजुऱ्या, टूल-रिस्क धोरणे, इव्हॅल्स, अ‍ॅनोमली डिटेक्शन, कॉस्ट ऑप्टिमायझर, OTel एक्सपोर्ट | $19 प्रति नोड / महिना | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON ट्रेसेस आणि लॉग्स साध्या `pip install clawmetry` वर काम करतात, कोणत्याही एक्स्ट्राशिवाय. Protobuf इनजेस्ट (आणि OTLP/JSON मेट्रिक्स) साठी `pip install clawmetry[otel]` लागते. स्वतःचे `service.name` सेट करणारे ॲप रनटाइम स्विचरमध्ये स्वतःचा एजंट म्हणून, स्वतःच्या खर्च आणि टोकन्ससह दिसते. - -तुम्हाला शून्य-कॉन्फिग, लोकल-फर्स्ट ClawMetry डॅशबोर्ड **आणि** तुमचा डेटा तुमची टीम आधीच चालवत असलेल्या कोणत्याही बॅकएंडमध्ये मिळतो — कोणतेही लॉक-इन नाही, दुसरा एजंट इन्स्टॉल करण्याची गरज नाही. - -## कॉन्फिगरेशन - -बहुतेक लोकांना कोणत्याही कॉन्फिगची गरज नसते. ClawMetry तुमचे वर्कस्पेस, लॉग्स, सेशन्स, आणि क्रॉन्स आपोआप शोधते. - -तुम्हाला कस्टमाइझ करायचे असल्यास: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -सर्व पर्याय: `clawmetry --help` - -## समर्थित चॅनेल्स - -तुम्ही कॉन्फिगर केलेल्या प्रत्येक OpenClaw चॅनेलसाठी ClawMetry लाइव्ह अ‍ॅक्टिव्हिटी दाखवतो. तुमच्या `openclaw.json` मध्ये प्रत्यक्षात सेट अप केलेले चॅनेल्सच Flow डायग्राममध्ये दिसतात — कॉन्फिगर न केलेले आपोआप लपवले जातात. - -Flow मधील कोणत्याही चॅनेल नोडवर क्लिक करून येणाऱ्या/जाणाऱ्या मेसेज काउंट्ससह लाइव्ह चॅट बबल व्ह्यू पाहा. - -| चॅनेल | स्थिती | लाइव्ह पॉपअप | नोट्स | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ पूर्ण | ✅ | मेसेजेस, स्टॅट्स, १० सेकंद रिफ्रेश | -| 💬 **iMessage** | ✅ पूर्ण | ✅ | `~/Library/Messages/chat.db` थेट वाचते | -| 💚 **WhatsApp** | ✅ पूर्ण | ✅ | WhatsApp Web (Baileys) द्वारे | -| 🔵 **Signal** | ✅ पूर्ण | ✅ | signal-cli द्वारे | -| 🟣 **Discord** | ✅ पूर्ण | ✅ | गिल्ड + चॅनेल डिटेक्शन | -| 🟪 **Slack** | ✅ पूर्ण | ✅ | वर्कस्पेस + चॅनेल डिटेक्शन | -| 🌐 **Webchat** | ✅ पूर्ण | ✅ | अंगभूत वेब UI सेशन्स | -| 📡 **IRC** | ✅ पूर्ण | ✅ | टर्मिनल-शैलीतील बबल UI | -| 🍏 **BlueBubbles** | ✅ पूर्ण | ✅ | BlueBubbles REST API द्वारे iMessage | -| 🔵 **Google Chat** | ✅ पूर्ण | ✅ | Chat API वेबहूक्सद्वारे | -| 🟣 **MS Teams** | ✅ पूर्ण | ✅ | Teams बॉट प्लगइनद्वारे | -| 🔷 **Mattermost** | ✅ पूर्ण | ✅ | सेल्फ-होस्टेड टीम चॅट | -| 🟩 **Matrix** | ✅ पूर्ण | ✅ | विकेंद्रित, E2EE समर्थन | -| 🟢 **LINE** | ✅ पूर्ण | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ पूर्ण | ✅ | विकेंद्रित NIP-04 DMs | -| 🟣 **Twitch** | ✅ पूर्ण | ✅ | IRC कनेक्शनद्वारे चॅट | -| 🔷 **Feishu/Lark** | ✅ पूर्ण | ✅ | WebSocket इव्हेंट सबस्क्रिप्शन | -| 🔵 **Zalo** | ✅ पूर्ण | ✅ | Zalo Bot API | - -> **ऑटो-डिटेक्शन:** ClawMetry तुमचा `~/.openclaw/openclaw.json` वाचतो आणि तुम्ही प्रत्यक्षात कॉन्फिगर केलेले चॅनेल्सच रेंडर करतो. मॅन्युअल सेटअपची गरज नाही. - -## Docker डिप्लॉयमेंट - -ClawMetry कंटेनरमध्ये चालवायचे आहे? काही अडचण नाही! 🐳 - -**Docker सह क्विक स्टार्ट:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose उदाहरण:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **टीप:** Docker मध्ये चालवताना, तुमचा एजंटची डेटा + लॉग डिरेक्टरीज (उदा. `~/.openclaw`, `~/.claude`, `~/.codex`) माउंट करा जेणेकरून ClawMetry तुमचे सेटअप आपोआप शोधू शकेल. - -## आवश्यकता - -- Python 3.8+ -- Flask (pip द्वारे आपोआप इन्स्टॉल होते) -- त्याच मशीनवरील AI एजंट रनटाइम: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, किंवा QM (किंवा Docker साठी माउंट केलेले व्हॉल्यूम्स) -- Linux किंवा macOS - -## NemoClaw / OpenShell समर्थन - -ClawMetry [NemoClaw](https://github.com/NVIDIA/NemoClaw) — OpenShell कंटेनर्समध्ये सँडबॉक्स्ड पद्धतीने एजंट्स चालवणारे NVIDIA चे OpenClaw साठीचे एंटरप्राइझ सुरक्षा रॅपर — आपोआप शोधतो. - -बहुतेक प्रकरणांमध्ये अतिरिक्त कॉन्फिगरेशनची गरज नसते. सिंक डीमन सेशन फाइल्स आपोआप शोधतो, मग त्या होस्टवरील `~/.openclaw/` मध्ये असोत किंवा OpenShell कंटेनरच्या आत. +वार्षिक प्लॅन्स, एंटरप्राइझ आणि सध्याचे आकडे इथे आहेत +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. सेल्फ-होस्टेड लायसन्स +की क्लाउडशिवाय काम करतात (`clawmetry license`). नेमकी फ्री/पेड विभागणी +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) मध्ये आहे. -### हे कसे काम करते +## तुमचा डेटा तुमच्या मशीनवरच राहतो -ClawMetry NemoClaw दोन प्रकारे शोधतो: +ClawMetry लोकल सेशन फाइल्स आणि लॉग्स वाचते. तुम्ही `clawmetry connect` चालवल्याशिवाय +तुमच्या मशीनमधून काहीही बाहेर जात नाही. तेव्हाही स्नॅपशॉट एंड-टू-एंड एन्क्रिप्टेड असतो, +अशा की सह जी कधीही तुमच्या मशीनमधून बाहेर जात नाही आणि तुमच्या ब्राउझरमध्ये डिक्रिप्ट केली जाते. -1. **बायनरी डिटेक्शन** — `nemoclaw` CLI तपासतो आणि सँडबॉक्स माहिती मिळवण्यासाठी `nemoclaw status` चालवतो -2. **कंटेनर डिटेक्शन** — चालू असलेल्या Docker कंटेनर्समध्ये `openshell`, `nemoclaw`, किंवा `ghcr.io/nvidia/` इमेजेससाठी स्कॅन करतो, नंतर व्हॉल्यूम माउंट्स किंवा `docker cp` द्वारे सेशन्स वाचतो - -NemoClaw कंटेनर्समधून सिंक केलेल्या सेशन फाइल्सना क्लाउड डॅशबोर्डमध्ये `runtime=nemoclaw` आणि `container_id` मेटाडेटासह टॅग केले जाते, जेणेकरून तुम्ही त्यांना एका दृष्टीक्षेपात प्रमाणित OpenClaw सेशन्सपासून वेगळे ओळखू शकाल. - -### शिफारस केलेले सेटअप: होस्टवर सिंक डीमन - -उत्तम अनुभवासाठी, ClawMetry चा सिंक डीमन **होस्ट मशीनवर** चालवा (सँडबॉक्सच्या आत नाही). हे NemoClaw नेटवर्क पॉलिसी निर्बंध टाळते. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -सिंक डीमन कोणत्याही चालू OpenShell कंटेनर्सच्या आतील सेशन्स आपोआप शोधेल. - -### ऐच्छिक: स्पष्ट सँडबॉक्स नाव - -ऑटो-डिटेक्शन काम करत नसल्यास, ClawMetry ला योग्य सँडबॉक्सकडे पॉइंट करा: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### सँडबॉक्सच्या आत चालवणे (प्रगत) - -सिंक डीमन **सँडबॉक्सच्या आत** OpenShell मध्ये चालवावाच लागल्यास, त्याला ClawMetry ingest API पर्यंत पोहोचता यावे यासाठी तुमच्या NemoClaw नेटवर्क पॉलिसीमध्ये हा एग्रेस नियम जोडा: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -लागू करण्यासाठी: +## इन्स्टॉल करा ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # नंतर: clawmetry ``` -### पोर्ट्स आणि एंडपॉइंट्स - -| एंडपॉइंट | पोर्ट | प्रोटोकॉल | आवश्यक | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | होय (सिंक डीमन → क्लाउड) | -| `localhost:8900` | 8900 | HTTP | होय (लोकल डॅशबोर्ड UI) | -| Docker socket (`/var/run/docker.sock`) | — | Unix socket | कंटेनर सेशन डिस्कव्हरीसाठी | - -सिंक डीमन फक्त `ingest.clawmetry.com` कडे आउटबाउंड HTTPS कॉल्स करतो. कोणत्याही इनबाउंड पोर्ट्सची गरज नाही. - ---- - -## क्लाउड डिप्लॉयमेंट - -SSH टनेल्स, रिव्हर्स प्रॉक्सी, आणि Docker साठी **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** पाहा. - -## चाचणी +किंवा एका-ओळीत: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -हा प्रोजेक्ट BrowserStack सह टेस्ट केला जातो. +macOS, Linux किंवा Windows वर Python 3.8+ आणि त्याच मशीनवर किमान एक एजंट रनटाइम +आवश्यक आहे. Docker सूचना: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## दस्तऐवजीकरण -## टेलिमेट्री +| | | +|---|---| +| [रनटाइम सुसंगतता](docs/compatibility.md) | प्रत्येक अ‍ॅडॉप्टर काय वाचतो आणि रनटाइम कसे जोडायचे | +| [Entitlements](docs/ENTITLEMENTS.md) | फ्री विरुद्ध पेड, टियर मॅट्रिक्स, लायसन्स CLI | +| [मंजुऱ्या आणि धोरणे](docs/APPROVALS.md) | प्री-एक्झिक्युशन गेटिंग, रिस्क स्कोअरिंग, फोन मंजुऱ्या | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | कुठेही ट्रेसेस एक्सपोर्ट करा, कोठूनही OTLP इनजेस्ट करा | +| [SDK ट्रॅकिंग](docs/SDK_TRACKING.md) | तुम्ही स्वतः तयार केलेल्या एजंट्ससाठी खर्चाचे श्रेय | +| [चॅट चॅनेल्स](docs/CHANNELS.md) | फ्लोमध्ये दाखवलेले चॅट अ‍ॅडॉप्टर्स | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | सँडबॉक्स्ड NVIDIA NemoClaw सेटअप्स | +| [Docker](docs/DOCKER.md) | इमेज, कंपोज, व्हॉल्यूम माउंट्स | +| [आर्किटेक्चर](ARCHITECTURE.md) · [डेव्हलपमेंट](docs/DEVELOPMENT.md) | आतून हे कसे काम करते; सोर्समधून चालवणे | +| [टेलिमेट्री](docs/TELEMETRY.md) | निनावी इन्स्टॉल आणि डेस्कटॉप-ओपन पिंग्स, आणि त्या कशा बंद करायच्या | -ClawMetry `https://app.clawmetry.com/api/install` कडे निनावी -इन्स्टॉल-लाइफसायकल पिंग्स पाठवते: नवीन मशीनवर `clawmetry` CLI पहिल्यांदा -चालवल्यावर एक `install` पिंग, नव्या व्हर्जनमध्ये अपग्रेड केल्यावर पहिल्या -रनला एक `update` पिंग, आणि तुम्ही डॅशबोर्डमधील ऑनबोर्डिंग निवड पूर्ण -केल्यावर एक `onboarded` पिंग. आम्ही याचा वापर खऱ्या इन्स्टॉल्सची गणना -करण्यासाठी करतो (कच्चे PyPI डाउनलोड आकडे ~९८% मिरर्स, CI, आणि -ऑटो-अपडेट पुनर्डाउनलोड्स असतात) आणि प्रत्यक्षात कोणते एजंट फ्रेमवर्क्स -आणि व्हर्जन्स वापरात आहेत हे जाणून घेण्यासाठी करतो. +## स्क्रीनशॉट्स -**प्रत्येक व्हर्जनसाठी प्रति-लाइफसायकल-इव्हेंट जास्तीत जास्त एक POST**, ज्यात हे असते: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: टोकन्स, सेशन्स, आरोग्य | **Brain**: लाइव्ह एजंट इव्हेंट स्ट्रीम | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **खर्च**: मॉडेल आणि सेशननुसार | **मंजुऱ्या**: जोखमीचे टूल कॉल्स गेट करा | -| फील्ड | उदाहरण | कारण | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id` वर साठवलेला रँडम UUID | डिडुप; तुम्ही स्पष्टपणे Cloud sync कनेक्ट करेपर्यंत निनावी (त्यानंतर ऑथेंटिकेटेड डीमन हार्टबीट तो वाहून नेतो, हा इन्स्टॉल तुमच्या खात्याशी जोडतो) | -| `event` | `install` / `update` / `onboarded` | नवीन इन्स्टॉल विरुद्ध विद्यमानचे अपग्रेड | -| `version` | `0.12.167` | कोणती व्हर्जन्स वापरात आहेत | -| `os` / `os_version` | `Darwin` / `25.3.0` | प्लॅटफॉर्म समर्थन प्राधान्यक्रम | -| `python` | `3.11.15` | Python व्हर्जन समर्थन मॅट्रिक्स | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | पुढे आम्ही कोणत्या एजंट्ससोबत इंटिग्रेट करावे | -| `is_ci` / `ci_provider` | `true` / `github_actions` | मानवी इन्स्टॉल्स आणि CI आवाज वेगळे करण्यासाठी | - -**आम्ही काय पाठवत नाही**: IP (क्लाउड सर्व्हर-साइडवर रिक्वेस्टमधून देश -कोड मिळवतो, नंतर IP टाकून देतो), होस्टनेम, युजरनेम, वर्कस्पेस पाथ, -फाइल कंटेंट्स, तुमची api_key, तुमचा ईमेल, कोणतीही PII किंवा -वर्कस्पेस-विशिष्ट माहिती. वायर पेलोड -[`clawmetry/telemetry.py`](clawmetry/telemetry.py) मध्ये ऑडिट करण्यायोग्य आहे. - -**ऑप्ट आउट करा** (यापैकी कोणतीही एक कायमची अक्षम करते): +रनटाइमनुसार अधिक: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -नेटवर्क अपयश यामुळे `clawmetry` चालण्यात कधीही अडथळा येत नाही — पिंग -डीमन थ्रेडवर ३ सेकंद टाइमआउटसह फायर-अँड-फर्गेट असते. - -## स्टार हिस्ट्री +## Star History @@ -434,13 +114,8 @@ touch ~/.clawmetry/notelemetry # persistent file marker -## परवाना - -MIT +## License ---- +MIT · निर्मिती [@vivekchand](https://github.com/vivekchand) यांनी · [clawmetry.com](https://clawmetry.com) -

- 🦞 तुमचा एजंट कसा विचार करतो ते पाहा
- निर्माता @vivekchand · clawmetry.com · OpenClaw इकोसिस्टीमचा भाग -

+ diff --git a/docs/i18n/nl/README.md b/docs/i18n/nl/README.md index 1510112442..48d1f3fb8d 100644 --- a/docs/i18n/nl/README.md +++ b/docs/i18n/nl/README.md @@ -1,17 +1,16 @@ - + > Nederlands translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Zie je agent denken.** Realtime observability voor **20 AI-agentruntimes**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex & 16 andere. Eén dashboard voor je hele agentvloot. +**Zie hoe je agent denkt.** Realtime observability voor **23 AI-agentruntimes**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex & 19 andere. Eén dashboard voor je hele agentvloot. > 🌐 **Lees dit in:** [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) · [meer →](docs/i18n/) @@ -21,409 +20,92 @@ Eén commando. Geen configuratie. Detecteert alles automatisch. pip install clawmetry && clawmetry ``` -Opent op **http://localhost:8900** en je bent klaar. +Opent op **http://localhost:8900**. Geen configuratie nodig: het vindt de agentruntimes +die je al hebt, leest ze alleen-lezen, en verandert niets aan hoe ze draaien. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## Werkt met 20 agentruntimes - -ClawMetry begon als observability voor OpenClaw en meet nu je **hele agentvloot** in één dashboard, waarbij elke runtime op je machine automatisch wordt gedetecteerd: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw en NemoClaw zijn gratis in de open-source app; de andere runtimes worden geactiveerd met ClawMetry Cloud of een zelf-gehoste Pro-licentie. Wissel van runtime via de header en elk tabblad, kosten, tokens, tools, traces, herschaalt naar die runtime. Zie **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** voor de exacte gratis/betaalde verdeling, de tiermatrix, de `/api/entitlement`-structuur en de `clawmetry license`-CLI. - -## Wat je krijgt - -- **Flow** — Live geanimeerd diagram dat berichten toont die door channels, brein, tools en terug stromen -- **Overview** — Gezondheidscontroles, activiteitsheatmap, sessieaantallen, modelinfo -- **Usage** — Token- en kostentracking met dagelijkse/wekelijkse/maandelijkse uitsplitsingen -- **Sessions** — Actieve agentsessies met model, tokens, laatste activiteit -- **Crons** — Geplande taken met status, volgende run, duur -- **Logs** — Kleurgecodeerde realtime logstreaming -- **Memory** — Blader door SOUL.md, MEMORY.md, AGENTS.md, dagelijkse notities -- **Transcripts** — Chatbubbel-UI voor het lezen van sessiegeschiedenissen -- **Alerts** — Budgetlimieten, foutpercentage-triggers, detectie van offline agents; routeert naar Slack, Discord, PagerDuty, Telegram, e-mail -- **Approvals** — Blokkeer destructieve verwijderingen, force pushes, DB-mutaties, sudo, pakketinstallaties, netwerkoproepen achter een goedkeuring met één klik - -## Screenshots - -### 🧠 Brain — Live agent-eventstream -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Tokengebruik & sessiesamenvatting -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Realtime feed van tool-aanroepen -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Kostenuitsplitsing per model & sessie -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Bestandsverkenner voor de workspace -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Postuur & auditlog -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) +## Werkt met 23 agentruntimes -### 🚨 Alerts — Budgetlimieten, foutpercentage-triggers, webhooks naar Slack / Discord / PagerDuty / e-mail -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +**Gratis in de opensource-app:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### ✋ Approvals — Blokkeer risicovolle tool-aanroepen achter handmatige goedkeuring; beleidsgestuurde beschermingsregels -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Blokkering vóór uitvoering voor Claude Code** — één commando installeert een -PreToolUse-hook die overeenkomende tool-aanroepen pauzeert *voordat* ze worden uitgevoerd en -wacht op jouw beslissing (één tik vanaf je telefoon met -[cloud-pushmeldingen](https://app.clawmetry.com/push) ingeschakeld): - -```bash -clawmetry hooks install # schrijft ~/.claude/settings.json (idempotent) -clawmetry hooks status # wat is aangesloten + hoeveel beleidsregels actief zijn -clawmetry hooks uninstall # verwijdert alleen de items van ClawMetry -``` - -Een weigering blokkeert alleen die ene tool-aanroep; de agent behoudt zijn sessie en kan -een andere aanpak proberen. Goedkeuren op je telefoon slaat de eigen -toestemmingsprompt van Claude Code over (je hebt al geantwoord). Niet-overeenkomende tools kosten ~40ms en -vallen terug op de normale toestemmingsflow van Claude Code. Je krijgt ook een pushmelding op je telefoon wanneer Claude Code zelf op jou wacht (`permission_prompt`- / -`idle_prompt`-meldingen). - -## Installeren - -**One-liner (aanbevolen):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**Vanuit de broncode:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` +**Bij een betaald abonnement:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -## v2 Frontend-ontwikkeling +Elke runtime krijgt hetzelfde dashboard. Draai er meerdere tegelijk en de +schakelaar in de header herschaalt elk tabblad naar een van hen. -De v2 React-app bevindt zich in `frontend/` en wordt geserveerd op `/v2` wanneer de Flask- -server wordt gestart met v2 ingeschakeld. +Heb je je eigen agent op een SDK gebouwd in plaats daarvan? De interceptor +volgt ook diens LLM-aanroepen. Zie [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -Gebruik twee terminals tijdens het ontwikkelen: - -```bash -# Terminal 1: Flask API/server op :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` - -```bash -# Terminal 2: Vite dev server op :5173 -cd frontend -nvm use -npm ci -npm run dev -``` - -Open `http://localhost:5173/v2/`. Vite proxyt `/api`-verzoeken naar -`http://localhost:8900`, zodat de React-app met de lokale Flask-server kan praten -zonder extra CORS-configuratie. - -Om de bundel te bouwen die met het Python-pakket wordt uitgeleverd: - -```bash -cd frontend -npm run build -``` - -De productiebundel wordt weggeschreven naar `clawmetry/static/v2/dist/`. - -## Runtime-/agentcompatibiliteit +## Wat je krijgt -ClawMetry observeert veel AI-agentruntimes, niet alleen OpenClaw. Elke niet-OpenClaw-runtime levert een specifieke reader-adapter die het native sessieformaat vertaalt naar de uniforme structuren van ClawMetry; de daemon neemt ze op in dezelfde DuckDB-store + cloudsnapshot, getagd met de runtime, en het tabblad Session replay toont een **runtime-schakelaar** wanneer er meer dan één aanwezig is. Zie [`docs/compatibility.md`](docs/compatibility.md) voor de volledige matrix + een handleiding voor het toevoegen van runtimes, en [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) voor de inleiding tot de OpenClaw-familie. +- **Sessies & transcripten**: wat elke agent deed, beurt voor beurt, met replay +- **Kosten & tokens**: per runtime, model, sessie en dag, met anomaliemarkeringen +- **Flow**: live diagram van berichten die door kanalen, modellen en tools bewegen +- **Brain**: de stream van redeneer- en tool-aanroepgebeurtenissen, live +- **Memory & skills**: de bestanden en skills die elke runtime daadwerkelijk laadde +- **Health & logs**: schijf, geheugen, foutpercentages, rate limits, live logstream +- **Alerts**: budgetlimieten, foutpieken, agent-offline, doorgestuurd naar Slack, Discord, PagerDuty, Telegram, e-mail +- **Approvals**: pauzeer risicovolle tool-aanroepen *voordat* ze uitgevoerd worden en keur ze goed vanaf je telefoon ([hoe](docs/APPROVALS.md)) -Gebruik je [Perplexity's numbat](https://github.com/perplexityai/numbat) agent-securitytool? ClawMetry neemt de bevindingen en handhavingsbeslissingen daarvan standaard op; zie [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Prijzen -| Runtime / agent | Status | Notities | +| Abonnement | Wat het omvat | Prijs | |---|---|---| -| **OpenClaw** | Native | Referentieruntime, automatisch gedetecteerd | -| **PicoClaw** | Beta-adapter | Platte `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`). Transcripts, model, tool-aanroepen. | -| **NanoClaw** | Beta-adapter | SQLite per sessie (`data/v2-sessions`). Transcripts + berichttellingen. | -| **Hermes** | Beta-adapter | SQLite `~/.hermes/state.db`. Transcripts, model, tokens/kosten. | -| **Claude Code** | Beta-adapter | JSONL `~/.claude/projects/.../.jsonl`. Transcripts, model, tool-aanroepen + denkstappen, tokengebruik. | -| **Codex** | Beta-adapter | Rollout-JSONL `~/.codex/sessions/...`. Transcripts, model, tool-aanroepen, tokengebruik. | -| **Cursor** | Beta-adapter | SQLite `state.vscdb`. Chat-/composer-transcripts, model. | -| **Aider** | Beta-adapter | `.aider.chat.history.md` per project. Transcripts, model, tokentellingen. | -| **Goose** | Beta-adapter | SQLite `~/.local/share/goose`. Transcripts, model, tool-aanroepen, tokentotalen. | -| **opencode** | Beta-adapter | SQLite `~/.local/share/opencode`. Transcripts, model, tool-aanroepen, tokens + kosten. | -| **Qwen Code** | Beta-adapter | JSONL `~/.qwen/projects/.../chats`. Transcripts, model, tool-aanroepen, tokengebruik. | -| **Pi** | Beta-adapter | JSONL `~/.pi/agent/sessions`. Transcripts, model, tool-aanroepen, tokens + kosten. | -| **Deep Agents** | Beta-adapter | SQLite `~/.deepagents/.state/sessions.db`. Transcripts, model, tool-aanroepen, tokens + kosten. | -| **n8n** | Beta-adapter | SQLite `~/.n8n/database.sqlite`. Workflow-uitvoeringen, node-runs, AI Agent-prompts, model + tokens waar n8n die vastlegt. | -| **Antigravity** | Beta-adapter | Brain-JSONL onder `~/.gemini//brain/`. Gesprekken, toolstappen, denkstappen, Gemini-tokenverdeling per generatie + kosten, verbruik van achtergrondgeneraties. | -| **GitHub Copilot** | Beta-adapter | Copilot CLI `events.jsonl` onder `~/.copilot/session-state/` + het `session-store.db`-gebruiksregister per aanroep. Gesprekken, tool-aanroepen, modelroutering, cache-bewuste tokenverdeling, door de leverancier gefactureerde AI-creditkosten. | -| **Grok** | Beta-adapter | xAI Grok Build CLI (Rust-binary onder `~/.grok/bin/grok`): globaal eventlog `~/.grok/logs/unified.jsonl` + sessie-specifiek `~/.grok/sessions///{events.jsonl,summary.json}`. Gesprekken, tokenverdeling per beurt, modelroutering, en de uitgaande repo-payload van de CLI die wordt opgeslagen onder `~/.grok/upload_queue/` zodat je kunt zien wat je machine heeft verlaten. | - -"Beta-adapter" betekent dat ClawMetry een reader levert voor het echte on-disk-formaat van die runtime, elk gebouwd + geverifieerd tegen een echte installatie op een echte machine (zie `tests/fixtures/runtimes//`). Adapters zijn alleen-lezen; elk is eerlijk over wat de bijbehorende runtime daadwerkelijk opslaat (bijv. PicoClaw/NanoClaw/Cursor schrijven geen tokenkosten naar schijf). Wanneer er meerdere runtimes op één node draaien, beperkt de runtime-schakelaar de sessieweergave tot één, voor een overzichtelijke deep-dive. - -## Volg elke SDK-agent — kostentoewijzing buiten de loop - -De bovenstaande runtimes schrijven allemaal sessies naar schijf. Jouw eigen **productieagent**, degene die je hebt gebouwd op de OpenAI Agents SDK, LangChain, de Vercel AI SDK, LlamaIndex, E2B, of een simpele `httpx`-loop, doet dat niet. De zero-config-interceptor van ClawMetry vangt de LLM-aanroepen ervan toch op (kosten, tokens, latency, fouten) door `httpx`/`requests` te monkeypatchen: - -```python -import clawmetry.track # activeer de interceptor -clawmetry.track.set_source("support-agent") # geef dit product een naam - -# ...je agent draait gewoon; elke LLM-aanroep wordt nu getrackt + toegewezen. -``` - -`set_source()` (of de omgevingsvariabele `CLAWMETRY_SOURCE=support-agent`) tagt elke aanroep met een **benoemde bron**, zodat elk product dat je draait verschijnt als een eigen, volwaardig, kosten-toewijsbaar item in de kaart **🔌 Out-loop sources** van het dashboard op Overview, aanroepen, providers, latency, foutpercentage per agent. Geen bron ingesteld? De aanroepen worden nog steeds getrackt; de kaart blijft dan alleen verborgen. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Dit is dezelfde datalaag die de runtime-adapters voeden (DuckDB → cloudsnapshot), dus out-loop-bronnen synchroniseren net als al het andere naar het clouddashboard, end-to-end versleuteld. - -## OpenTelemetry — leveranciersneutraal, stuur je traces overal naartoe - -ClawMetry spreekt **OpenTelemetry** in beide richtingen, met de **GenAI semantic conventions**, zodat je agenttraces nooit vastzitten aan één tool. - -**Exporteer** elke sessie, LLM-aanroepen, tools, sub-agents, tokens, kosten, als OTLP/HTTP GenAI-spans naar elke collector (Datadog, Grafana, Honeycomb, of je eigen OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalent: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Auth-headers en pollinterval zijn optionele omgevingsvariabelen: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP-headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconden (standaard 60) -``` - -**Ingest** — de ingebouwde OTLP-ontvanger accepteert traces, logs en metrics van alles anders op `/v1/traces`, `/v1/logs` en `/v1/metrics`. Wijs elke OpenTelemetry-geïnstrumenteerde app ernaartoe: +| **Free** | OpenClaw + NVIDIA NemoClaw, volledig dashboard, alleen lokaal | $0 | +| **Starter** | Alle andere runtimes hierboven, vlootoverzicht, cloudsync | $9 per node / maand | +| **Pro** | Starter + governance: approvals, tool-risicobeleid, evaluaties, anomaliedetectie, kostenoptimalisatie, OTel-export | $19 per node / maand | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON-traces en -logs werken op een gewone `pip install clawmetry`, zonder extra's. Protobuf-ingest (en OTLP/JSON-metrics) heeft `pip install clawmetry[otel]` nodig. Een app die zijn eigen `service.name` instelt, verschijnt als eigen agent in de runtime-schakelaar, met zijn eigen kosten en tokens. - -Je krijgt het zero-config, local-first ClawMetry-dashboard **én** je data in welk backend je team ook al gebruikt; geen lock-in, geen tweede agent om te installeren. - -## Configuratie - -De meeste mensen hebben geen configuratie nodig. ClawMetry detecteert automatisch je workspace, logs, sessies en crons. - -Als je toch wilt aanpassen: - -```bash -clawmetry --port 9000 # Aangepaste poort (standaard: 8900) -clawmetry --host 127.0.0.1 # Alleen aan localhost binden -clawmetry --workspace ~/mybot # Aangepast workspace-pad -clawmetry --name "Alice" # Jouw naam in de Flow-visualisatie -``` - -Alle opties: `clawmetry --help` - -## Ondersteunde channels - -ClawMetry toont live activiteit voor elk OpenClaw-channel dat je hebt geconfigureerd. Alleen channels die daadwerkelijk zijn ingesteld in je `openclaw.json` verschijnen in het Flow-diagram; niet-geconfigureerde worden automatisch verborgen. - -Klik op een channel-node in de Flow om een live chatbubbelweergave te zien met tellingen van inkomende/uitgaande berichten. - -| Channel | Status | Live pop-up | Notities | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Volledig | ✅ | Berichten, statistieken, verversing elke 10s | -| 💬 **iMessage** | ✅ Volledig | ✅ | Leest `~/Library/Messages/chat.db` rechtstreeks | -| 💚 **WhatsApp** | ✅ Volledig | ✅ | Via WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Volledig | ✅ | Via signal-cli | -| 🟣 **Discord** | ✅ Volledig | ✅ | Detectie van guild + channel | -| 🟪 **Slack** | ✅ Volledig | ✅ | Detectie van workspace + channel | -| 🌐 **Webchat** | ✅ Volledig | ✅ | Ingebouwde web-UI-sessies | -| 📡 **IRC** | ✅ Volledig | ✅ | Bubbel-UI in terminalstijl | -| 🍏 **BlueBubbles** | ✅ Volledig | ✅ | iMessage via BlueBubbles REST API | -| 🔵 **Google Chat** | ✅ Volledig | ✅ | Via Chat API-webhooks | -| 🟣 **MS Teams** | ✅ Volledig | ✅ | Via Teams-botplugin | -| 🔷 **Mattermost** | ✅ Volledig | ✅ | Zelf-gehoste teamchat | -| 🟩 **Matrix** | ✅ Volledig | ✅ | Gedecentraliseerd, E2EE-ondersteuning | -| 🟢 **LINE** | ✅ Volledig | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Volledig | ✅ | Gedecentraliseerde NIP-04-DM's | -| 🟣 **Twitch** | ✅ Volledig | ✅ | Chat via IRC-verbinding | -| 🔷 **Feishu/Lark** | ✅ Volledig | ✅ | WebSocket-eventabonnement | -| 🔵 **Zalo** | ✅ Volledig | ✅ | Zalo Bot API | - -> **Automatische detectie:** ClawMetry leest je `~/.openclaw/openclaw.json` en toont alleen de channels die je daadwerkelijk hebt geconfigureerd. Geen handmatige instelling nodig. - -## Docker-implementatie - -Wil je ClawMetry in een container draaien? Geen probleem! 🐳 - -**Snelstart met Docker:** - -```bash -# Bouw de image -docker build -t clawmetry . - -# Draai met standaardinstellingen -docker run -p 8900:8900 clawmetry - -# Of mount de datamap van je agent (getoond: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Voorbeeld van Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Let op:** Mount bij het draaien in Docker de data- en logmappen van je agent (bijv. `~/.openclaw`, `~/.claude`, `~/.codex`) zodat ClawMetry je opstelling automatisch kan detecteren. - -## Vereisten - -- Python 3.8+ -- Flask (automatisch geïnstalleerd via pip) -- Een AI-agentruntime op dezelfde machine: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, of QM (of gemounte volumes voor Docker) -- Linux of macOS - -## NemoClaw-/OpenShell-ondersteuning - -ClawMetry detecteert automatisch [NemoClaw](https://github.com/NVIDIA/NemoClaw), NVIDIA's enterprise-securitywrapper voor OpenClaw die agents laat draaien binnen gesandboxte OpenShell-containers. - -In de meeste gevallen is geen extra configuratie nodig. De sync-daemon ontdekt automatisch sessiebestanden, of ze nu op de host in `~/.openclaw/` staan of binnen een OpenShell-container. +Jaarabonnementen, Enterprise en de actuele bedragen staan op +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Zelf-gehoste licentiesleutels +werken zonder de cloud (`clawmetry license`). De exacte gratis/betaald-verdeling staat +in [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -### Hoe het werkt +## Je data blijft op je eigen machine -ClawMetry detecteert NemoClaw op twee manieren: +ClawMetry leest lokale sessiebestanden en logs. Er verlaat niets je machine +tenzij je `clawmetry connect` uitvoert. Zelfs dan is de snapshot end-to-end +versleuteld met een sleutel die je machine nooit verlaat, en wordt deze +ontsleuteld in je browser. -1. **Binary-detectie** — controleert op de `nemoclaw`-CLI en voert `nemoclaw status` uit om sandbox-info op te halen -2. **Containerdetectie** — scant draaiende Docker-containers op `openshell`-, `nemoclaw`- of `ghcr.io/nvidia/`-images, en leest vervolgens sessies via volume-mounts of `docker cp` - -Sessiebestanden die vanuit NemoClaw-containers zijn gesynchroniseerd, worden in het clouddashboard getagd met `runtime=nemoclaw` en `container_id`-metadata, zodat je ze in één oogopslag kunt onderscheiden van standaard OpenClaw-sessies. - -### Aanbevolen opzet: sync-daemon op de HOST - -Voor de beste ervaring draai je de sync-daemon van ClawMetry op de **hostmachine** (niet binnen de sandbox). Dit voorkomt beperkingen door het netwerkbeleid van NemoClaw. - -```bash -# Op de host (buiten de sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -De sync-daemon vindt automatisch sessies binnen elke draaiende OpenShell-container. - -### Optioneel: expliciete sandboxnaam - -Als automatische detectie niet werkt, wijs ClawMetry dan naar de juiste sandbox: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Draaien binnen de sandbox (geavanceerd) - -Als je de sync-daemon **binnen** de OpenShell-sandbox moet draaien, voeg dan deze egress-regel toe aan je NemoClaw-netwerkbeleid zodat deze de ingest-API van ClawMetry kan bereiken: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Toepassen met: +## Installeren ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # daarna: clawmetry ``` -### Poorten en endpoints - -| Endpoint | Poort | Protocol | Vereist | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Ja (sync-daemon → cloud) | -| `localhost:8900` | 8900 | HTTP | Ja (lokale dashboard-UI) | -| Docker-socket (`/var/run/docker.sock`) | — | Unix-socket | Voor detectie van containersessies | - -De sync-daemon doet alleen uitgaande HTTPS-aanroepen naar `ingest.clawmetry.com`. Er zijn geen inkomende poorten vereist. - ---- - -## Cloud-implementatie - -Zie de **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** voor SSH-tunnels, reverse proxy en Docker. - -## Testen +Of de one-liner: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -Dit project wordt getest met BrowserStack. +Vereist Python 3.8+ op macOS, Linux of Windows, en minstens één agentruntime +op dezelfde machine. Docker-instructies: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## Documentatie -## Telemetrie +| | | +|---|---| +| [Runtime-compatibiliteit](docs/compatibility.md) | Wat elke adapter leest, en hoe je een runtime toevoegt | +| [Entitlements](docs/ENTITLEMENTS.md) | Gratis versus betaald, tiermatrix, license-CLI | +| [Approvals & beleid](docs/APPROVALS.md) | Gating vóór uitvoering, risicoscoring, telefoongoedkeuringen | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Exporteer traces overal naartoe, importeer OTLP van overal vandaan | +| [SDK-tracking](docs/SDK_TRACKING.md) | Kostentoewijzing voor agents die je zelf gebouwd hebt | +| [Chatkanalen](docs/CHANNELS.md) | De chatadapters die in Flow te zien zijn | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Gesandboxte NVIDIA NemoClaw-opstellingen | +| [Docker](docs/DOCKER.md) | Image, compose, volume-mounts | +| [Architectuur](ARCHITECTURE.md) · [Ontwikkeling](docs/DEVELOPMENT.md) | Hoe het intern werkt; draaien vanuit de broncode | +| [Telemetrie](docs/TELEMETRY.md) | De anonieme installatie- en desktop-open-pings, en hoe je ze uitzet | -ClawMetry stuurt anonieme install-lifecycle-pings naar -`https://app.clawmetry.com/api/install`: één `install`-ping de eerste -keer dat je de `clawmetry`-CLI op een nieuwe machine draait, één `update`-ping -bij de eerste run na een upgrade naar een nieuwe versie, en één `onboarded`- -ping wanneer je de onboardingkeuze in het dashboard voltooit. We gebruiken dit -om echte installaties te tellen (ruwe PyPI-downloadcijfers bestaan voor ~98% uit mirrors, CI, -en herdownloads door automatische updates) en om te leren welke agentframeworks en -versies daadwerkelijk in gebruik zijn. +## Screenshots -**Hoogstens één POST per lifecycle-event per versie**, met de volgende inhoud: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: tokens, sessies, health | **Brain**: live gebeurtenisstream van de agent | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: per model en sessie | **Approvals**: risicovolle tool-aanroepen gaten | -| Veld | Voorbeeld | Waarom | -|---|---|---| -| `install_id` | willekeurige UUID opgeslagen in `~/.clawmetry/install_id` | deduplicatie; anoniem totdat je expliciet Cloud sync koppelt (de geverifieerde daemon-heartbeat draagt dan mee, waardoor deze installatie aan je account wordt gekoppeld) | -| `event` | `install` / `update` / `onboarded` | nieuwe installatie versus upgrade van een bestaande | -| `version` | `0.12.167` | welke versies in gebruik zijn | -| `os` / `os_version` | `Darwin` / `25.3.0` | prioriteiten voor platformondersteuning | -| `python` | `3.11.15` | ondersteuningsmatrix voor Python-versies | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | met welke agents we hierna moeten integreren | -| `is_ci` / `ci_provider` | `true` / `github_actions` | menselijke installaties scheiden van CI-ruis | - -**Wat we NIET versturen**: IP (de cloud leidt de landcode serverzijde -af uit het verzoek en verwerpt vervolgens het IP), hostnaam, gebruikersnaam, workspacepad, -bestandsinhoud, je api_key, je e-mailadres, iets wat persoonsgegevens bevat of -workspace-specifiek is. De payload op de lijn is controleerbaar in -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Afmelden** (elk van deze schakelt het permanent uit): +Meer, per runtime: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per shell -export DO_NOT_TRACK=1 # W3C cross-tool-standaard -touch ~/.clawmetry/notelemetry # permanente bestandsmarkering -``` - -Een netwerkstoring blokkeert hier nooit het draaien van `clawmetry`; de -ping is fire-and-forget op een daemonthread met een timeout van 3s. - -## Star History +## Stergeschiedenis @@ -435,11 +117,6 @@ ping is fire-and-forget op een daemonthread met een timeout van 3s. ## Licentie -MIT - ---- +MIT · Gebouwd door [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Zie je agent denken
- Gebouwd door @vivekchand · clawmetry.com · Onderdeel van het OpenClaw-ecosysteem -

+ diff --git a/docs/i18n/pa/README.md b/docs/i18n/pa/README.md index 0d62076196..961f3e74da 100644 --- a/docs/i18n/pa/README.md +++ b/docs/i18n/pa/README.md @@ -1,19 +1,18 @@ - + > ਪੰਜਾਬੀ translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**ਆਪਣੇ ਏਜੰਟ ਨੂੰ ਸੋਚਦੇ ਦੇਖੋ।** **20 AI ਏਜੰਟ ਰਨਟਾਈਮਾਂ** ਲਈ ਰੀਅਲ-ਟਾਈਮ ਆਬਜ਼ਰਵੇਬਿਲਟੀ: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex ਅਤੇ 16 ਹੋਰ। ਤੁਹਾਡੇ ਪੂਰੇ ਏਜੰਟ ਫਲੀਟ ਲਈ ਇੱਕ ਡੈਸ਼ਬੋਰਡ। +**ਆਪਣੇ ਏਜੰਟ ਨੂੰ ਸੋਚਦੇ ਹੋਏ ਦੇਖੋ।** **23 AI ਏਜੰਟ ਰਨਟਾਈਮਾਂ** ਲਈ ਰੀਅਲ-ਟਾਈਮ ਆਬਜ਼ਰਵੇਬਿਲਿਟੀ: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex ਅਤੇ 19 ਹੋਰ। ਤੁਹਾਡੇ ਪੂਰੇ ਏਜੰਟ ਫਲੀਟ ਲਈ ਇੱਕ ਡੈਸ਼ਬੋਰਡ। -> 🌐 **ਇਸ ਨੂੰ ਇਹਨਾਂ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਪੜ੍ਹੋ:** [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/) +> 🌐 **ਇਸਨੂੰ ਇਹਨਾਂ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਪੜ੍ਹੋ:** [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/) ਇੱਕ ਕਮਾਂਡ। ਜ਼ੀਰੋ ਕੌਂਫ਼ਿਗ। ਸਭ ਕੁਝ ਆਪਣੇ ਆਪ ਪਛਾਣਦਾ ਹੈ। @@ -21,407 +20,83 @@ pip install clawmetry && clawmetry ``` -**http://localhost:8900** 'ਤੇ ਖੁੱਲ੍ਹਦਾ ਹੈ ਅਤੇ ਤੁਹਾਡਾ ਕੰਮ ਹੋ ਗਿਆ। +**http://localhost:8900** ਉੱਤੇ ਖੁੱਲ੍ਹਦਾ ਹੈ। ਜ਼ੀਰੋ ਕੌਂਫ਼ਿਗ: ਇਹ ਉਹਨਾਂ ਏਜੰਟ ਰਨਟਾਈਮਾਂ ਨੂੰ ਲੱਭ ਲੈਂਦਾ ਹੈ ਜੋ ਤੁਹਾਡੇ ਕੋਲ ਪਹਿਲਾਂ ਤੋਂ ਹੀ ਹਨ, ਉਹਨਾਂ ਨੂੰ ਸਿਰਫ਼-ਪੜ੍ਹਨ ਲਈ ਪੜ੍ਹਦਾ ਹੈ, ਅਤੇ ਉਹਨਾਂ ਦੇ ਚੱਲਣ ਦੇ ਤਰੀਕੇ ਵਿੱਚ ਕੁਝ ਵੀ ਨਹੀਂ ਬਦਲਦਾ। ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 20 ਏਜੰਟ ਰਨਟਾਈਮਾਂ ਨਾਲ ਕੰਮ ਕਰਦਾ ਹੈ - -ClawMetry ਦੀ ਸ਼ੁਰੂਆਤ OpenClaw ਲਈ ਆਬਜ਼ਰਵੇਬਿਲਟੀ ਵਜੋਂ ਹੋਈ ਸੀ, ਅਤੇ ਹੁਣ ਇਹ ਤੁਹਾਡੇ **ਪੂਰੇ ਏਜੰਟ ਫਲੀਟ** ਨੂੰ ਇੱਕ ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ ਮੀਟਰ ਕਰਦਾ ਹੈ, ਤੁਹਾਡੀ ਮਸ਼ੀਨ 'ਤੇ ਹਰ ਰਨਟਾਈਮ ਨੂੰ ਆਪਣੇ ਆਪ ਪਛਾਣਦੇ ਹੋਏ: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw ਅਤੇ NemoClaw ਓਪਨ-ਸੋਰਸ ਐਪ ਵਿੱਚ ਮੁਫ਼ਤ ਹਨ; ਬਾਕੀ ਰਨਟਾਈਮ ClawMetry Cloud ਜਾਂ ਸੈਲਫ-ਹੋਸਟਡ Pro ਲਾਇਸੈਂਸ ਨਾਲ ਸਰਗਰਮ ਹੁੰਦੇ ਹਨ। ਹੈਡਰ ਤੋਂ ਰਨਟਾਈਮ ਬਦਲੋ ਅਤੇ ਹਰ ਟੈਬ — ਲਾਗਤ, ਟੋਕਨ, ਟੂਲ, ਟਰੇਸ — ਉਸ ਰਨਟਾਈਮ ਲਈ ਮੁੜ-ਸਕੋਪ ਹੋ ਜਾਂਦੀ ਹੈ। ਸਹੀ ਮੁਫ਼ਤ/ਭੁਗਤਾਨ ਵੰਡ, ਟੀਅਰ ਮੈਟ੍ਰਿਕਸ, `/api/entitlement` ਸ਼ਕਲ, ਅਤੇ `clawmetry license` CLI ਲਈ **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** ਦੇਖੋ। - -## ਤੁਹਾਨੂੰ ਕੀ ਮਿਲਦਾ ਹੈ - -- **Flow** — ਲਾਈਵ ਐਨੀਮੇਟਡ ਡਾਇਗ੍ਰਾਮ ਜੋ ਚੈਨਲਾਂ, ਬ੍ਰੇਨ, ਟੂਲਾਂ ਵਿੱਚੋਂ ਦੀ ਹੋ ਕੇ ਅਤੇ ਵਾਪਸ ਆਉਂਦੇ ਸੁਨੇਹਿਆਂ ਨੂੰ ਦਿਖਾਉਂਦਾ ਹੈ -- **Overview** — ਸਿਹਤ ਜਾਂਚਾਂ, ਗਤੀਵਿਧੀ ਹੀਟਮੈਪ, ਸੈਸ਼ਨ ਗਿਣਤੀਆਂ, ਮਾਡਲ ਜਾਣਕਾਰੀ -- **Usage** — ਰੋਜ਼ਾਨਾ/ਹਫ਼ਤਾਵਾਰ/ਮਹੀਨਾਵਾਰ ਬ੍ਰੇਕਡਾਊਨ ਨਾਲ ਟੋਕਨ ਅਤੇ ਲਾਗਤ ਟਰੈਕਿੰਗ -- **Sessions** — ਮਾਡਲ, ਟੋਕਨ, ਆਖਰੀ ਗਤੀਵਿਧੀ ਸਮੇਤ ਸਰਗਰਮ ਏਜੰਟ ਸੈਸ਼ਨ -- **Crons** — ਸਥਿਤੀ, ਅਗਲਾ ਰਨ, ਮਿਆਦ ਸਮੇਤ ਸ਼ਡਿਊਲ ਕੀਤੇ ਜੌਬ -- **Logs** — ਰੰਗ-ਕੋਡਿਡ ਰੀਅਲ-ਟਾਈਮ ਲੌਗ ਸਟ੍ਰੀਮਿੰਗ -- **Memory** — SOUL.md, MEMORY.md, AGENTS.md, ਰੋਜ਼ਾਨਾ ਨੋਟਸ ਬ੍ਰਾਊਜ਼ ਕਰੋ -- **Transcripts** — ਸੈਸ਼ਨ ਇਤਿਹਾਸ ਪੜ੍ਹਨ ਲਈ ਚੈਟ-ਬਬਲ UI -- **Alerts** — ਬਜਟ ਸੀਮਾਵਾਂ, ਗਲਤੀ-ਦਰ ਟ੍ਰਿਗਰ, ਏਜੰਟ-ਆਫਲਾਈਨ ਖੋਜ; Slack, Discord, PagerDuty, Telegram, Email ਨੂੰ ਰੂਟ ਕਰਦਾ ਹੈ -- **Approvals** — ਵਿਨਾਸ਼ਕਾਰੀ ਡਿਲੀਟ, ਫੋਰਸ ਪੁਸ਼, DB ਮਿਊਟੇਸ਼ਨ, sudo, ਪੈਕੇਜ ਇੰਸਟਾਲ, ਨੈੱਟਵਰਕ ਕਾਲਾਂ ਨੂੰ ਇੱਕ-ਕਲਿੱਕ ਸਾਈਨ-ਆਫ਼ ਪਿੱਛੇ ਗੇਟ ਕਰੋ - -## ਸਕਰੀਨਸ਼ਾਟ - -### 🧠 Brain — ਲਾਈਵ ਏਜੰਟ ਈਵੈਂਟ ਸਟ੍ਰੀਮ -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — ਟੋਕਨ ਵਰਤੋਂ ਅਤੇ ਸੈਸ਼ਨ ਸਾਰ -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — ਰੀਅਲ-ਟਾਈਮ ਟੂਲ ਕਾਲ ਫੀਡ -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — ਮਾਡਲ ਅਤੇ ਸੈਸ਼ਨ ਵਾਰ ਲਾਗਤ ਬ੍ਰੇਕਡਾਊਨ -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — ਵਰਕਸਪੇਸ ਫਾਈਲ ਬ੍ਰਾਊਜ਼ਰ -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — ਪੋਸਚਰ ਅਤੇ ਆਡਿਟ ਲੌਗ -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — ਬਜਟ ਸੀਮਾਵਾਂ, ਗਲਤੀ-ਦਰ ਟ੍ਰਿਗਰ, Slack / Discord / PagerDuty / Email ਲਈ ਵੈੱਬਹੁੱਕ -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — ਖ਼ਤਰਨਾਕ ਟੂਲ ਕਾਲਾਂ ਨੂੰ ਮੈਨੂਅਲ ਸਾਈਨ-ਆਫ਼ ਪਿੱਛੇ ਗੇਟ ਕਰੋ; ਪਾਲਿਸੀ-ਬੈਕਡ ਸੁਰੱਖਿਆ ਨਿਯਮ -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**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 ਦਾ ਆਪਣਾ -ਇਜਾਜ਼ਤ ਪ੍ਰੌਮਪਟ ਛੱਡ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ (ਤੁਸੀਂ ਪਹਿਲਾਂ ਹੀ ਜਵਾਬ ਦੇ ਦਿੱਤਾ ਹੈ)। ਬੇਮੇਲ ਟੂਲਾਂ ਦੀ ਲਾਗਤ ~40ms ਹੁੰਦੀ ਹੈ ਅਤੇ -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 ਫਰੰਟਐਂਡ ਡਿਵੈਲਪਮੈਂਟ - -v2 React ਐਪ `frontend/` ਵਿੱਚ ਹੈ ਅਤੇ ਜਦੋਂ Flask -ਸਰਵਰ v2 ਸਮਰੱਥ ਕਰਕੇ ਸ਼ੁਰੂ ਕੀਤਾ ਜਾਂਦਾ ਹੈ ਤਾਂ `/v2` 'ਤੇ ਸਰਵ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। - -ਡਿਵੈਲਪ ਕਰਦੇ ਸਮੇਂ ਦੋ ਟਰਮੀਨਲ ਵਰਤੋ: - -```bash -# Terminal 1: Flask API/server on :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## 23 ਏਜੰਟ ਰਨਟਾਈਮਾਂ ਨਾਲ ਕੰਮ ਕਰਦਾ ਹੈ -```bash -# Terminal 2: Vite dev server on :5173 -cd frontend -nvm use -npm ci -npm run dev -``` +**ਓਪਨ ਸੋਰਸ ਐਪ ਵਿੱਚ ਮੁਫ਼ਤ:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -`http://localhost:5173/v2/` ਖੋਲ੍ਹੋ। Vite `/api` ਬੇਨਤੀਆਂ ਨੂੰ -`http://localhost:8900` ਵੱਲ ਪ੍ਰੌਕਸੀ ਕਰਦਾ ਹੈ, ਤਾਂ ਜੋ React ਐਪ ਬਿਨਾਂ ਵਾਧੂ CORS -ਸੈੱਟਅੱਪ ਦੇ ਲੋਕਲ Flask ਸਰਵਰ ਨਾਲ ਗੱਲਬਾਤ ਕਰ ਸਕੇ। +**ਭੁਗਤਾਨ ਵਾਲੀ ਯੋਜਨਾ ਉੱਤੇ:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -Python ਪੈਕੇਜ ਨਾਲ ਭੇਜਿਆ ਜਾਣ ਵਾਲਾ ਬੰਡਲ ਬਣਾਉਣ ਲਈ: - -```bash -cd frontend -npm run build -``` +ਹਰ ਰਨਟਾਈਮ ਨੂੰ ਇੱਕੋ ਹੀ ਡੈਸ਼ਬੋਰਡ ਮਿਲਦਾ ਹੈ। ਇੱਕੋ ਸਮੇਂ ਕਈ ਚਲਾਓ ਅਤੇ ਹੈਡਰ ਸਵਿੱਚਰ ਹਰ ਟੈਬ ਨੂੰ ਉਹਨਾਂ ਵਿੱਚੋਂ ਇੱਕ ਵੱਲ ਦੁਬਾਰਾ-ਸਕੋਪ ਕਰ ਦਿੰਦਾ ਹੈ। -ਪ੍ਰੋਡਕਸ਼ਨ ਬੰਡਲ `clawmetry/static/v2/dist/` ਵਿੱਚ ਲਿਖਿਆ ਜਾਂਦਾ ਹੈ। +ਕੀ ਤੁਸੀਂ ਇੱਕ SDK ਉੱਤੇ ਆਪਣਾ ਖੁਦ ਦਾ ਏਜੰਟ ਬਣਾਇਆ ਹੈ? ਇੰਟਰਸੈਪਟਰ ਇਸਦੀਆਂ LLM ਕਾਲਾਂ ਨੂੰ ਵੀ ਟਰੈਕ ਕਰਦਾ ਹੈ। ਦੇਖੋ [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md)। -## ਰਨਟਾਈਮ / ਏਜੰਟ ਅਨੁਕੂਲਤਾ +## ਤੁਹਾਨੂੰ ਕੀ ਮਿਲਦਾ ਹੈ -ClawMetry ਸਿਰਫ਼ OpenClaw ਹੀ ਨਹੀਂ, ਸਗੋਂ ਕਈ AI-ਏਜੰਟ ਰਨਟਾਈਮਾਂ ਨੂੰ ਦੇਖਦਾ ਹੈ। ਹਰੇਕ ਗ਼ੈਰ-OpenClaw ਰਨਟਾਈਮ ਇੱਕ ਸਮਰਪਿਤ ਰੀਡਰ ਐਡਾਪਟਰ ਭੇਜਦਾ ਹੈ ਜੋ ਉਸ ਦੇ ਮੂਲ ਸੈਸ਼ਨ ਫਾਰਮੈਟ ਨੂੰ ClawMetry ਦੀਆਂ ਯੂਨੀਫਾਈਡ ਸ਼ਕਲਾਂ ਵਿੱਚ ਅਨੁਵਾਦ ਕਰਦਾ ਹੈ; ਡੈਮਨ ਉਹਨਾਂ ਨੂੰ ਉਸੇ DuckDB ਸਟੋਰ + ਕਲਾਊਡ ਸਨੈਪਸ਼ੌਟ ਵਿੱਚ, ਰਨਟਾਈਮ ਨਾਲ ਟੈਗ ਕਰਕੇ ਦਾਖਲ ਕਰਦਾ ਹੈ, ਅਤੇ ਜਦੋਂ ਇੱਕ ਤੋਂ ਵੱਧ ਰਨਟਾਈਮ ਮੌਜੂਦ ਹੋਣ ਤਾਂ Session replay ਟੈਬ ਇੱਕ **ਰਨਟਾਈਮ ਸਵਿੱਚਰ** ਦਿਖਾਉਂਦੀ ਹੈ। ਪੂਰੇ ਮੈਟ੍ਰਿਕਸ + ਰਨਟਾਈਮ ਜੋੜਨ ਦੀ ਗਾਈਡ ਲਈ [`docs/compatibility.md`](docs/compatibility.md) ਦੇਖੋ, ਅਤੇ OpenClaw-ਪਰਿਵਾਰ ਪ੍ਰਾਈਮਰ ਲਈ [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) ਦੇਖੋ। +- **ਸੈਸ਼ਨ ਅਤੇ ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ**: ਹਰ ਏਜੰਟ ਨੇ ਕੀ ਕੀਤਾ, ਵਾਰੀ-ਵਾਰੀ, ਰੀਪਲੇਅ ਸਮੇਤ +- **ਲਾਗਤ ਅਤੇ ਟੋਕਨ**: ਹਰ ਰਨਟਾਈਮ, ਮਾਡਲ, ਸੈਸ਼ਨ ਅਤੇ ਦਿਨ ਲਈ, ਅਸਧਾਰਨਤਾ ਫਲੈਗਾਂ ਸਮੇਤ +- **ਫਲੋ**: ਚੈਨਲਾਂ, ਮਾਡਲਾਂ ਅਤੇ ਟੂਲਾਂ ਵਿੱਚੋਂ ਲੰਘਦੇ ਸੁਨੇਹਿਆਂ ਦਾ ਲਾਈਵ ਚਿੱਤਰ +- **ਬ੍ਰੇਨ**: ਤਰਕ ਅਤੇ ਟੂਲ-ਕਾਲ ਈਵੈਂਟ ਸਟ੍ਰੀਮ, ਜਿਵੇਂ-ਜਿਵੇਂ ਇਹ ਵਾਪਰਦਾ ਹੈ +- **ਮੈਮਰੀ ਅਤੇ ਸਕਿੱਲਾਂ**: ਉਹ ਫਾਈਲਾਂ ਅਤੇ ਸਕਿੱਲਾਂ ਜੋ ਹਰ ਰਨਟਾਈਮ ਨੇ ਅਸਲ ਵਿੱਚ ਲੋਡ ਕੀਤੀਆਂ +- **ਸਿਹਤ ਅਤੇ ਲੌਗ**: ਡਿਸਕ, ਮੈਮਰੀ, ਗਲਤੀ ਦਰਾਂ, ਰੇਟ ਲਿਮਿਟਾਂ, ਲਾਈਵ ਲੌਗ ਸਟ੍ਰੀਮ +- **ਅਲਰਟ**: ਬਜਟ ਸੀਮਾਵਾਂ, ਗਲਤੀ ਵਾਧੇ, ਏਜੰਟ-ਔਫਲਾਈਨ, Slack, Discord, PagerDuty, Telegram, Email ਵੱਲ ਰੂਟ ਕੀਤੇ +- **ਪ੍ਰਵਾਨਗੀਆਂ**: ਖਤਰਨਾਕ ਟੂਲ ਕਾਲਾਂ ਨੂੰ ਚੱਲਣ *ਤੋਂ ਪਹਿਲਾਂ* ਰੋਕੋ ਅਤੇ ਆਪਣੇ ਫ਼ੋਨ ਤੋਂ ਮਨਜ਼ੂਰੀ ਦਿਓ ([ਕਿਵੇਂ](docs/APPROVALS.md)) -[Perplexity ਦਾ numbat](https://github.com/perplexityai/numbat) ਏਜੰਟ-ਸੁਰੱਖਿਆ ਟੂਲ ਚਲਾ ਰਹੇ ਹੋ? ClawMetry ਇਸ ਦੀਆਂ ਖੋਜਾਂ ਅਤੇ ਲਾਗੂਕਰਨ ਫੈਸਲਿਆਂ ਨੂੰ ਬਾਕਸ ਤੋਂ ਬਾਹਰ ਹੀ ਦਾਖਲ ਕਰਦਾ ਹੈ — [`docs/NUMBAT.md`](docs/NUMBAT.md) ਦੇਖੋ। +## ਕੀਮਤ -| ਰਨਟਾਈਮ / ਏਜੰਟ | ਸਥਿਤੀ | ਨੋਟਸ | +| ਯੋਜਨਾ | ਕੀ ਸ਼ਾਮਲ ਹੈ | ਕੀਮਤ | |---|---|---| -| **OpenClaw** | Native | ਸੰਦਰਭ ਰਨਟਾਈਮ, ਆਪਣੇ ਆਪ ਪਛਾਣਿਆ ਜਾਂਦਾ ਹੈ | -| **PicoClaw** | Beta adapter | ਫਲੈਟ `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`)। ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਮਾਡਲ, ਟੂਲ ਕਾਲਾਂ। | -| **NanoClaw** | Beta adapter | ਪ੍ਰਤੀ-ਸੈਸ਼ਨ SQLite (`data/v2-sessions`)। ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ + ਸੁਨੇਹਾ ਗਿਣਤੀ। | -| **Hermes** | Beta adapter | SQLite `~/.hermes/state.db`। ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਮਾਡਲ, ਟੋਕਨ/ਲਾਗਤ। | -| **Claude Code** | Beta adapter | JSONL `~/.claude/projects/.../.jsonl`। ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਮਾਡਲ, ਟੂਲ ਕਾਲਾਂ + ਸੋਚ, ਟੋਕਨ ਵਰਤੋਂ। | -| **Codex** | Beta adapter | Rollout JSONL `~/.codex/sessions/...`। ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਮਾਡਲ, ਟੂਲ ਕਾਲਾਂ, ਟੋਕਨ ਵਰਤੋਂ। | -| **Cursor** | Beta adapter | SQLite `state.vscdb`। ਚੈਟ/ਕੰਪੋਜ਼ਰ ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਮਾਡਲ। | -| **Aider** | Beta adapter | ਪ੍ਰਤੀ-ਪ੍ਰੋਜੈਕਟ `.aider.chat.history.md`। ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਮਾਡਲ, ਟੋਕਨ ਗਿਣਤੀਆਂ। | -| **Goose** | Beta adapter | SQLite `~/.local/share/goose`। ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਮਾਡਲ, ਟੂਲ ਕਾਲਾਂ, ਟੋਕਨ ਕੁੱਲ। | -| **opencode** | Beta adapter | SQLite `~/.local/share/opencode`। ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਮਾਡਲ, ਟੂਲ ਕਾਲਾਂ, ਟੋਕਨ + ਲਾਗਤ। | -| **Qwen Code** | Beta adapter | JSONL `~/.qwen/projects/.../chats`। ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਮਾਡਲ, ਟੂਲ ਕਾਲਾਂ, ਟੋਕਨ ਵਰਤੋਂ। | -| **Pi** | Beta adapter | JSONL `~/.pi/agent/sessions`। ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਮਾਡਲ, ਟੂਲ ਕਾਲਾਂ, ਟੋਕਨ + ਲਾਗਤ। | -| **Deep Agents** | Beta adapter | SQLite `~/.deepagents/.state/sessions.db`। ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਮਾਡਲ, ਟੂਲ ਕਾਲਾਂ, ਟੋਕਨ + ਲਾਗਤ। | -| **n8n** | Beta adapter | SQLite `~/.n8n/database.sqlite`। ਵਰਕਫਲੋ ਐਗਜ਼ੀਕਿਊਸ਼ਨ, ਨੋਡ ਰਨ, AI Agent ਪ੍ਰੌਮਪਟ, ਜਿੱਥੇ n8n ਰਿਕਾਰਡ ਕਰੇ ਉੱਥੇ ਮਾਡਲ + ਟੋਕਨ। | -| **Antigravity** | Beta adapter | `~/.gemini//brain/` ਹੇਠ Brain JSONL। ਗੱਲਬਾਤ, ਟੂਲ ਸਟੈੱਪ, ਸੋਚ, ਪ੍ਰਤੀ-ਜਨਰੇਸ਼ਨ Gemini ਟੋਕਨ ਵੰਡ + ਲਾਗਤ, ਬੈਕਗ੍ਰਾਊਂਡ-ਜਨਰੇਸ਼ਨ ਖਰਚ। | -| **GitHub Copilot** | Beta adapter | Copilot CLI `events.jsonl` `~/.copilot/session-state/` ਹੇਠ + `session-store.db` ਪ੍ਰਤੀ-ਕਾਲ ਵਰਤੋਂ ਲੇਜ਼ਰ। ਗੱਲਬਾਤਾਂ, ਟੂਲ ਕਾਲਾਂ, ਮਾਡਲ ਰੂਟਿੰਗ, ਕੈਸ਼-ਸੁਚੇਤ ਟੋਕਨ ਵੰਡ, ਵੈਂਡਰ-ਬਿਲਡ AI-ਕ੍ਰੈਡਿਟ ਲਾਗਤ। | -| **Grok** | Beta adapter | xAI Grok Build CLI (`~/.grok/bin/grok` ਹੇਠ Rust ਬਾਈਨਰੀ): ਗਲੋਬਲ ਈਵੈਂਟ ਲੌਗ `~/.grok/logs/unified.jsonl` + ਪ੍ਰਤੀ-ਸੈਸ਼ਨ `~/.grok/sessions///{events.jsonl,summary.json}`। ਗੱਲਬਾਤਾਂ, ਪ੍ਰਤੀ-ਵਾਰੀ ਟੋਕਨ ਵੰਡ, ਮਾਡਲ ਰੂਟਿੰਗ, ਅਤੇ CLI ਦਾ ਬਾਹਰ ਜਾਣ ਵਾਲਾ ਰਿਪੋ ਪੇਲੋਡ ਜੋ `~/.grok/upload_queue/` ਹੇਠ ਸਟੇਜ ਹੁੰਦਾ ਹੈ ਤਾਂ ਜੋ ਤੁਸੀਂ ਦੇਖ ਸਕੋ ਕਿ ਤੁਹਾਡੀ ਮਸ਼ੀਨ ਤੋਂ ਕੀ ਗਿਆ। | - -"Beta adapter" ਦਾ ਮਤਲਬ ਹੈ ਕਿ ClawMetry ਉਸ ਰਨਟਾਈਮ ਦੇ ਅਸਲ ਡਿਸਕ-ਤੇ ਫਾਰਮੈਟ ਲਈ ਇੱਕ ਰੀਡਰ ਭੇਜਦਾ ਹੈ, ਹਰ ਇੱਕ ਅਸਲ ਮਸ਼ੀਨ 'ਤੇ ਅਸਲ ਇੰਸਟਾਲ ਦੇ ਖ਼ਿਲਾਫ਼ ਬਣਾਇਆ + ਪ੍ਰਮਾਣਿਤ ਕੀਤਾ ਗਿਆ (ਦੇਖੋ `tests/fixtures/runtimes//`)। ਐਡਾਪਟਰ ਸਿਰਫ਼-ਪੜ੍ਹਨ ਲਈ ਹਨ; ਹਰ ਇੱਕ ਇਸ ਬਾਰੇ ਇਮਾਨਦਾਰ ਹੈ ਕਿ ਉਸ ਦਾ ਰਨਟਾਈਮ ਅਸਲ ਵਿੱਚ ਕੀ ਸਟੋਰ ਕਰਦਾ ਹੈ (ਜਿਵੇਂ ਕਿ PicoClaw/NanoClaw/Cursor ਟੋਕਨ ਲਾਗਤ ਡਿਸਕ 'ਤੇ ਨਹੀਂ ਲਿਖਦੇ)। ਜਦੋਂ ਇੱਕ ਨੋਡ 'ਤੇ ਕਈ ਰਨਟਾਈਮ ਚੱਲਦੇ ਹੋਣ, ਰਨਟਾਈਮ ਸਵਿੱਚਰ ਇੱਕ ਸਾਫ਼ ਡੀਪ-ਡਾਈਵ ਲਈ ਸੈਸ਼ਨ ਦ੍ਰਿਸ਼ ਨੂੰ ਇੱਕ ਤੱਕ ਸੀਮਤ ਕਰਦਾ ਹੈ। - -## ਕਿਸੇ ਵੀ SDK ਏਜੰਟ ਨੂੰ ਟਰੈਕ ਕਰੋ — ਆਊਟ-ਲੂਪ ਲਾਗਤ ਐਟਰੀਬਿਊਸ਼ਨ - -ਉੱਪਰ ਦਿੱਤੇ ਸਾਰੇ ਰਨਟਾਈਮ ਸੈਸ਼ਨ ਡਿਸਕ 'ਤੇ ਲਿਖਦੇ ਹਨ। ਤੁਹਾਡਾ ਆਪਣਾ **ਪ੍ਰੋਡਕਸ਼ਨ ਏਜੰਟ** — ਜੋ ਤੁਸੀਂ OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, ਜਾਂ ਇੱਕ ਸਾਦੇ `httpx` ਲੂਪ 'ਤੇ ਬਣਾਇਆ ਹੈ — ਨਹੀਂ ਲਿਖਦਾ। ClawMetry ਦਾ ਜ਼ੀਰੋ-ਕੌਂਫ਼ਿਗ ਇੰਟਰਸੈਪਟਰ ਫਿਰ ਵੀ `httpx`/`requests` ਨੂੰ ਮੰਕੀ-ਪੈਚ ਕਰਕੇ ਇਸ ਦੀਆਂ LLM ਕਾਲਾਂ (ਲਾਗਤ, ਟੋਕਨ, ਲੇਟੈਂਸੀ, ਗਲਤੀਆਂ) ਨੂੰ ਕੈਪਚਰ ਕਰਦਾ ਹੈ: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (ਜਾਂ `CLAWMETRY_SOURCE=support-agent` env ਵੇਰੀਏਬਲ) ਹਰ ਕਾਲ ਨੂੰ ਇੱਕ **ਨਾਮੀ ਸਰੋਤ** ਨਾਲ ਟੈਗ ਕਰਦਾ ਹੈ, ਤਾਂ ਜੋ ਤੁਸੀਂ ਚਲਾਏ ਜਾਣ ਵਾਲੇ ਹਰ ਉਤਪਾਦ ਡੈਸ਼ਬੋਰਡ ਦੇ Overview 'ਤੇ **🔌 Out-loop sources** ਕਾਰਡ ਵਿੱਚ ਆਪਣੀ ਵੱਖਰੀ, ਲਾਗਤ-ਐਟਰੀਬਿਊਟੇਬਲ ਲਾਈਨ ਵਜੋਂ ਦਿਖਾਈ ਦੇਵੇ — ਪ੍ਰਤੀ ਏਜੰਟ ਕਾਲਾਂ, ਪ੍ਰੋਵਾਈਡਰ, ਲੇਟੈਂਸੀ, ਗਲਤੀ ਦਰ। ਕੋਈ ਸਰੋਤ ਸੈੱਟ ਨਹੀਂ ਕੀਤਾ? ਕਾਲਾਂ ਫਿਰ ਵੀ ਟਰੈਕ ਹੁੰਦੀਆਂ ਹਨ; ਕਾਰਡ ਬਸ ਲੁਕਿਆ ਰਹਿੰਦਾ ਹੈ। - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -ਇਹ ਉਹੀ ਡਾਟਾ ਲੇਅਰ ਹੈ ਜੋ ਰਨਟਾਈਮ ਐਡਾਪਟਰ ਫੀਡ ਕਰਦੇ ਹਨ (DuckDB → ਕਲਾਊਡ ਸਨੈਪਸ਼ੌਟ), ਇਸ ਲਈ ਆਊਟ-ਲੂਪ ਸਰੋਤ ਬਾਕੀ ਸਭ ਕੁਝ ਵਾਂਗ ਕਲਾਊਡ ਡੈਸ਼ਬੋਰਡ ਨਾਲ ਸਿੰਕ ਹੁੰਦੇ ਹਨ, E2E-ਇਨਕ੍ਰਿਪਟਡ। - -## OpenTelemetry — ਵੈਂਡਰ-ਨਿਊਟਰਲ, ਆਪਣੇ ਟਰੇਸ ਕਿਤੇ ਵੀ ਭੇਜੋ - -ClawMetry **GenAI ਸੈਮੈਂਟਿਕ ਕਨਵੈਨਸ਼ਨਾਂ** ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋਏ ਦੋਵੇਂ ਦਿਸ਼ਾਵਾਂ ਵਿੱਚ **OpenTelemetry** ਬੋਲਦਾ ਹੈ, ਤਾਂ ਜੋ ਤੁਹਾਡੇ ਏਜੰਟ ਟਰੇਸ ਕਦੇ ਵੀ ਇੱਕ ਟੂਲ ਵਿੱਚ ਲੌਕ ਨਾ ਹੋਣ। - -**ਐਕਸਪੋਰਟ** ਹਰ ਸੈਸ਼ਨ — LLM ਕਾਲਾਂ, ਟੂਲ, ਸਬ-ਏਜੰਟ, ਟੋਕਨ, ਲਾਗਤ — ਨੂੰ ਕਿਸੇ ਵੀ ਕਲੈਕਟਰ (Datadog, Grafana, Honeycomb, ਜਾਂ ਤੁਹਾਡਾ ਆਪਣਾ OTel Collector) ਵਿੱਚ OTLP/HTTP GenAI ਸਪੈਨ ਵਜੋਂ: - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -ਪ੍ਰਮਾਣੀਕਰਨ ਹੈਡਰ ਅਤੇ ਪੋਲ ਅੰਤਰਾਲ ਵਿਕਲਪਿਕ env ਵੇਰੀਏਬਲ ਹਨ: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**ਇੰਗੈਸਟ** — ਬਿਲਟ-ਇਨ OTLP ਰਿਸੀਵਰ `/v1/traces`, `/v1/logs`, ਅਤੇ `/v1/metrics` 'ਤੇ ਹੋਰ ਕਿਸੇ ਵੀ ਥਾਂ ਤੋਂ ਟਰੇਸ, ਲੌਗ, ਅਤੇ ਮੈਟ੍ਰਿਕਸ ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ। ਕਿਸੇ ਵੀ OpenTelemetry-ਇੰਸਟਰੂਮੈਂਟਿਡ ਐਪ ਨੂੰ ਇਸ ਵੱਲ ਪੌਇੰਟ ਕਰੋ: +| **ਮੁਫ਼ਤ** | OpenClaw + NVIDIA NemoClaw, ਪੂਰਾ ਡੈਸ਼ਬੋਰਡ, ਸਿਰਫ਼ ਲੋਕਲ | $0 | +| **ਸਟਾਰਟਰ** | ਉੱਪਰ ਦਿੱਤਾ ਹਰ ਹੋਰ ਰਨਟਾਈਮ, ਫਲੀਟ ਵਿਊ, ਕਲਾਊਡ ਸਿੰਕ | $9 ਪ੍ਰਤੀ ਨੋਡ / ਮਹੀਨਾ | +| **Pro** | ਸਟਾਰਟਰ + ਗਵਰਨੈਂਸ: ਪ੍ਰਵਾਨਗੀਆਂ, ਟੂਲ-ਜੋਖਮ ਨੀਤੀਆਂ, ਮੁਲਾਂਕਣ, ਅਸਧਾਰਨਤਾ ਪਛਾਣ, ਲਾਗਤ ਓਪਟੀਮਾਈਜ਼ਰ, OTel ਐਕਸਪੋਰਟ | $19 ਪ੍ਰਤੀ ਨੋਡ / ਮਹੀਨਾ | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON ਟਰੇਸ ਅਤੇ ਲੌਗ ਸਾਦੇ `pip install clawmetry` 'ਤੇ ਕੰਮ ਕਰਦੇ ਹਨ, ਕੋਈ ਵਾਧੂ ਚੀਜ਼ ਨਹੀਂ ਚਾਹੀਦੀ। Protobuf ਇੰਗੈਸਟ (ਅਤੇ OTLP/JSON ਮੈਟ੍ਰਿਕਸ) ਨੂੰ `pip install clawmetry[otel]` ਚਾਹੀਦਾ ਹੈ। ਜੋ ਐਪ ਆਪਣਾ `service.name` ਸੈੱਟ ਕਰਦੀ ਹੈ ਉਹ ਆਪਣੀ ਲਾਗਤ ਅਤੇ ਟੋਕਨਾਂ ਨਾਲ ਰਨਟਾਈਮ ਸਵਿੱਚਰ ਵਿੱਚ ਆਪਣੇ ਏਜੰਟ ਵਜੋਂ ਦਿਖਾਈ ਦਿੰਦੀ ਹੈ। - -ਤੁਹਾਨੂੰ ਜ਼ੀਰੋ-ਕੌਂਫ਼ਿਗ, ਲੋਕਲ-ਫਸਟ ClawMetry ਡੈਸ਼ਬੋਰਡ **ਅਤੇ** ਤੁਹਾਡਾ ਡਾਟਾ ਤੁਹਾਡੀ ਟੀਮ ਦੇ ਪਹਿਲਾਂ ਤੋਂ ਚੱਲ ਰਹੇ ਕਿਸੇ ਵੀ ਬੈਕਐਂਡ ਵਿੱਚ ਮਿਲਦਾ ਹੈ — ਕੋਈ ਲੌਕ-ਇਨ ਨਹੀਂ, ਕੋਈ ਦੂਜਾ ਏਜੰਟ ਇੰਸਟਾਲ ਕਰਨ ਦੀ ਲੋੜ ਨਹੀਂ। - -## ਕੌਂਫ਼ਿਗਰੇਸ਼ਨ - -ਜ਼ਿਆਦਾਤਰ ਲੋਕਾਂ ਨੂੰ ਕਿਸੇ ਕੌਂਫ਼ਿਗ ਦੀ ਲੋੜ ਨਹੀਂ। ClawMetry ਤੁਹਾਡੇ ਵਰਕਸਪੇਸ, ਲੌਗ, ਸੈਸ਼ਨ, ਅਤੇ ਕਰੌਨ ਨੂੰ ਆਪਣੇ ਆਪ ਪਛਾਣਦਾ ਹੈ। - -ਜੇ ਤੁਹਾਨੂੰ ਕਸਟਮਾਈਜ਼ ਕਰਨ ਦੀ ਲੋੜ ਹੈ: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -ਸਾਰੇ ਵਿਕਲਪ: `clawmetry --help` - -## ਸਮਰਥਿਤ ਚੈਨਲ - -ClawMetry ਤੁਹਾਡੇ ਦੁਆਰਾ ਕੌਂਫ਼ਿਗਰ ਕੀਤੇ ਹਰ OpenClaw ਚੈਨਲ ਲਈ ਲਾਈਵ ਗਤੀਵਿਧੀ ਦਿਖਾਉਂਦਾ ਹੈ। ਸਿਰਫ਼ ਉਹ ਚੈਨਲ ਜੋ ਤੁਹਾਡੀ `openclaw.json` ਵਿੱਚ ਅਸਲ ਵਿੱਚ ਸੈੱਟਅੱਪ ਕੀਤੇ ਗਏ ਹਨ Flow ਡਾਇਗ੍ਰਾਮ ਵਿੱਚ ਦਿਖਾਈ ਦਿੰਦੇ ਹਨ — ਬਿਨਾਂ-ਕੌਂਫ਼ਿਗਰ ਕੀਤੇ ਆਪਣੇ ਆਪ ਲੁਕੇ ਰਹਿੰਦੇ ਹਨ। - -Flow ਵਿੱਚ ਕਿਸੇ ਵੀ ਚੈਨਲ ਨੋਡ 'ਤੇ ਕਲਿੱਕ ਕਰਕੇ ਆਉਣ ਵਾਲੇ/ਜਾਣ ਵਾਲੇ ਸੁਨੇਹਾ ਗਿਣਤੀਆਂ ਸਮੇਤ ਇੱਕ ਲਾਈਵ ਚੈਟ ਬਬਲ ਦ੍ਰਿਸ਼ ਦੇਖੋ। - -| ਚੈਨਲ | ਸਥਿਤੀ | ਲਾਈਵ ਪੌਪਅੱਪ | ਨੋਟਸ | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ ਪੂਰਾ | ✅ | ਸੁਨੇਹੇ, ਅੰਕੜੇ, 10s ਰਿਫਰੈਸ਼ | -| 💬 **iMessage** | ✅ ਪੂਰਾ | ✅ | `~/Library/Messages/chat.db` ਨੂੰ ਸਿੱਧਾ ਪੜ੍ਹਦਾ ਹੈ | -| 💚 **WhatsApp** | ✅ ਪੂਰਾ | ✅ | WhatsApp Web (Baileys) ਰਾਹੀਂ | -| 🔵 **Signal** | ✅ ਪੂਰਾ | ✅ | signal-cli ਰਾਹੀਂ | -| 🟣 **Discord** | ✅ ਪੂਰਾ | ✅ | ਗਿਲਡ + ਚੈਨਲ ਖੋਜ | -| 🟪 **Slack** | ✅ ਪੂਰਾ | ✅ | ਵਰਕਸਪੇਸ + ਚੈਨਲ ਖੋਜ | -| 🌐 **Webchat** | ✅ ਪੂਰਾ | ✅ | ਬਿਲਟ-ਇਨ ਵੈੱਬ UI ਸੈਸ਼ਨ | -| 📡 **IRC** | ✅ ਪੂਰਾ | ✅ | ਟਰਮੀਨਲ-ਸਟਾਈਲ ਬਬਲ UI | -| 🍏 **BlueBubbles** | ✅ ਪੂਰਾ | ✅ | BlueBubbles REST API ਰਾਹੀਂ iMessage | -| 🔵 **Google Chat** | ✅ ਪੂਰਾ | ✅ | Chat API ਵੈੱਬਹੁੱਕ ਰਾਹੀਂ | -| 🟣 **MS Teams** | ✅ ਪੂਰਾ | ✅ | Teams ਬੋਟ ਪਲੱਗਇਨ ਰਾਹੀਂ | -| 🔷 **Mattermost** | ✅ ਪੂਰਾ | ✅ | ਸੈਲਫ-ਹੋਸਟਡ ਟੀਮ ਚੈਟ | -| 🟩 **Matrix** | ✅ ਪੂਰਾ | ✅ | ਵਿਕੇਂਦਰੀਕ੍ਰਿਤ, E2EE ਸਹਾਇਤਾ | -| 🟢 **LINE** | ✅ ਪੂਰਾ | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ ਪੂਰਾ | ✅ | ਵਿਕੇਂਦਰੀਕ੍ਰਿਤ NIP-04 DM | -| 🟣 **Twitch** | ✅ ਪੂਰਾ | ✅ | IRC ਕਨੈਕਸ਼ਨ ਰਾਹੀਂ ਚੈਟ | -| 🔷 **Feishu/Lark** | ✅ ਪੂਰਾ | ✅ | WebSocket ਈਵੈਂਟ ਸਬਸਕ੍ਰਿਪਸ਼ਨ | -| 🔵 **Zalo** | ✅ ਪੂਰਾ | ✅ | Zalo Bot API | - -> **ਆਟੋ-ਖੋਜ:** ClawMetry ਤੁਹਾਡੀ `~/.openclaw/openclaw.json` ਪੜ੍ਹਦਾ ਹੈ ਅਤੇ ਸਿਰਫ਼ ਉਹੀ ਚੈਨਲ ਰੈਂਡਰ ਕਰਦਾ ਹੈ ਜੋ ਤੁਸੀਂ ਅਸਲ ਵਿੱਚ ਕੌਂਫ਼ਿਗਰ ਕੀਤੇ ਹਨ। ਕੋਈ ਮੈਨੂਅਲ ਸੈੱਟਅੱਪ ਲੋੜੀਂਦਾ ਨਹੀਂ। - -## Docker ਡਿਪਲਾਇਮੈਂਟ - -ਇੱਕ ਕੰਟੇਨਰ ਵਿੱਚ ClawMetry ਚਲਾਉਣਾ ਚਾਹੁੰਦੇ ਹੋ? ਕੋਈ ਸਮੱਸਿਆ ਨਹੀਂ! 🐳 - -**Docker ਨਾਲ ਤੇਜ਼ ਸ਼ੁਰੂਆਤ:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose ਉਦਾਹਰਨ:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **ਨੋਟ:** Docker ਵਿੱਚ ਚਲਾਉਂਦੇ ਸਮੇਂ, ਆਪਣੇ ਏਜੰਟ ਦੀਆਂ ਡਾਟਾ + ਲੌਗ ਡਾਇਰੈਕਟਰੀਆਂ (ਜਿਵੇਂ ਕਿ `~/.openclaw`, `~/.claude`, `~/.codex`) ਨੂੰ ਮਾਊਂਟ ਕਰੋ ਤਾਂ ਜੋ ClawMetry ਤੁਹਾਡਾ ਸੈੱਟਅੱਪ ਆਪਣੇ ਆਪ ਪਛਾਣ ਸਕੇ। - -## ਲੋੜਾਂ - -- Python 3.8+ -- Flask (pip ਰਾਹੀਂ ਆਪਣੇ ਆਪ ਇੰਸਟਾਲ ਹੁੰਦਾ ਹੈ) -- ਉਸੇ ਮਸ਼ੀਨ 'ਤੇ ਇੱਕ AI ਏਜੰਟ ਰਨਟਾਈਮ: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, ਜਾਂ QM (ਜਾਂ Docker ਲਈ ਮਾਊਂਟ ਕੀਤੇ ਵੌਲਿਊਮ) -- Linux ਜਾਂ macOS - -## NemoClaw / OpenShell ਸਹਾਇਤਾ - -ClawMetry ਆਪਣੇ ਆਪ [NemoClaw](https://github.com/NVIDIA/NemoClaw) ਨੂੰ ਪਛਾਣਦਾ ਹੈ — NVIDIA ਦਾ ਐਂਟਰਪ੍ਰਾਈਜ਼ ਸੁਰੱਖਿਆ ਰੈਪਰ OpenClaw ਲਈ ਜੋ ਏਜੰਟਾਂ ਨੂੰ ਸੈਂਡਬਾਕਸਡ OpenShell ਕੰਟੇਨਰਾਂ ਅੰਦਰ ਚਲਾਉਂਦਾ ਹੈ। +ਸਾਲਾਨਾ ਯੋਜਨਾਵਾਂ, Enterprise ਅਤੇ ਮੌਜੂਦਾ ਅੰਕੜੇ +**[clawmetry.com/pricing](https://clawmetry.com/pricing)** ਉੱਤੇ ਮੌਜੂਦ ਹਨ। ਸੈਲਫ-ਹੋਸਟਡ ਲਾਇਸੰਸ +ਕੁੰਜੀਆਂ ਕਲਾਊਡ ਤੋਂ ਬਿਨਾਂ ਕੰਮ ਕਰਦੀਆਂ ਹਨ (`clawmetry license`)। ਮੁਫ਼ਤ/ਭੁਗਤਾਨ ਦੀ ਸਹੀ ਵੰਡ +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) ਵਿੱਚ ਹੈ। -ਜ਼ਿਆਦਾਤਰ ਮਾਮਲਿਆਂ ਵਿੱਚ ਕੋਈ ਵਾਧੂ ਕੌਂਫ਼ਿਗਰੇਸ਼ਨ ਲੋੜੀਂਦੀ ਨਹੀਂ। ਸਿੰਕ ਡੈਮਨ ਆਪਣੇ ਆਪ ਸੈਸ਼ਨ ਫਾਈਲਾਂ ਲੱਭ ਲੈਂਦਾ ਹੈ ਭਾਵੇਂ ਉਹ ਹੋਸਟ 'ਤੇ `~/.openclaw/` ਵਿੱਚ ਹੋਣ ਜਾਂ ਕਿਸੇ OpenShell ਕੰਟੇਨਰ ਅੰਦਰ। +## ਤੁਹਾਡਾ ਡੇਟਾ ਤੁਹਾਡੀ ਮਸ਼ੀਨ ਉੱਤੇ ਹੀ ਰਹਿੰਦਾ ਹੈ -### ਇਹ ਕਿਵੇਂ ਕੰਮ ਕਰਦਾ ਹੈ +ClawMetry ਲੋਕਲ ਸੈਸ਼ਨ ਫਾਈਲਾਂ ਅਤੇ ਲੌਗ ਪੜ੍ਹਦਾ ਹੈ। ਜਦੋਂ ਤੱਕ ਤੁਸੀਂ `clawmetry connect` ਨਹੀਂ ਚਲਾਉਂਦੇ, ਕੁਝ ਵੀ ਤੁਹਾਡੇ ਬਾਕਸ ਤੋਂ ਬਾਹਰ ਨਹੀਂ ਜਾਂਦਾ। ਉਦੋਂ ਵੀ, ਸਨੈਪਸ਼ਾਟ ਇੱਕ ਅਜਿਹੀ ਕੁੰਜੀ ਨਾਲ ਐਂਡ-ਟੂ-ਐਂਡ ਇਨਕ੍ਰਿਪਟਡ ਹੁੰਦਾ ਹੈ ਜੋ ਕਦੇ ਵੀ ਤੁਹਾਡੀ ਮਸ਼ੀਨ ਤੋਂ ਬਾਹਰ ਨਹੀਂ ਜਾਂਦੀ, ਅਤੇ ਤੁਹਾਡੇ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਹੀ ਡੀਕ੍ਰਿਪਟ ਹੁੰਦਾ ਹੈ। -ClawMetry NemoClaw ਨੂੰ ਦੋ ਤਰੀਕਿਆਂ ਨਾਲ ਖੋਜਦਾ ਹੈ: - -1. **ਬਾਈਨਰੀ ਖੋਜ** — `nemoclaw` CLI ਦੀ ਜਾਂਚ ਕਰਦਾ ਹੈ ਅਤੇ ਸੈਂਡਬਾਕਸ ਜਾਣਕਾਰੀ ਲਈ `nemoclaw status` ਚਲਾਉਂਦਾ ਹੈ -2. **ਕੰਟੇਨਰ ਖੋਜ** — ਚੱਲ ਰਹੇ Docker ਕੰਟੇਨਰਾਂ ਨੂੰ `openshell`, `nemoclaw`, ਜਾਂ `ghcr.io/nvidia/` ਇਮੇਜ ਲਈ ਸਕੈਨ ਕਰਦਾ ਹੈ, ਫਿਰ ਵੌਲਿਊਮ ਮਾਊਂਟ ਜਾਂ `docker cp` ਰਾਹੀਂ ਸੈਸ਼ਨ ਪੜ੍ਹਦਾ ਹੈ - -NemoClaw ਕੰਟੇਨਰਾਂ ਤੋਂ ਸਿੰਕ ਕੀਤੀਆਂ ਸੈਸ਼ਨ ਫਾਈਲਾਂ ਕਲਾਊਡ ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ `runtime=nemoclaw` ਅਤੇ `container_id` ਮੈਟਾਡਾਟਾ ਨਾਲ ਟੈਗ ਕੀਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ, ਤਾਂ ਜੋ ਤੁਸੀਂ ਇੱਕ ਨਜ਼ਰ ਵਿੱਚ ਇਹਨਾਂ ਨੂੰ ਮਿਆਰੀ OpenClaw ਸੈਸ਼ਨਾਂ ਤੋਂ ਵੱਖ ਕਰ ਸਕੋ। - -### ਸਿਫ਼ਾਰਸ਼ੀ ਸੈੱਟਅੱਪ: HOST 'ਤੇ ਸਿੰਕ ਡੈਮਨ - -ਸਭ ਤੋਂ ਵਧੀਆ ਤਜਰਬੇ ਲਈ, ClawMetry ਦਾ ਸਿੰਕ ਡੈਮਨ **ਹੋਸਟ ਮਸ਼ੀਨ** 'ਤੇ ਚਲਾਓ (ਸੈਂਡਬਾਕਸ ਦੇ ਅੰਦਰ ਨਹੀਂ)। ਇਹ NemoClaw ਨੈੱਟਵਰਕ ਪਾਲਿਸੀ ਪਾਬੰਦੀਆਂ ਤੋਂ ਬਚਦਾ ਹੈ। - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -ਸਿੰਕ ਡੈਮਨ ਆਪਣੇ ਆਪ ਕਿਸੇ ਵੀ ਚੱਲ ਰਹੇ OpenShell ਕੰਟੇਨਰ ਅੰਦਰ ਸੈਸ਼ਨ ਲੱਭ ਲਵੇਗਾ। - -### ਵਿਕਲਪਿਕ: ਸਪੱਸ਼ਟ ਸੈਂਡਬਾਕਸ ਨਾਮ - -ਜੇ ਆਟੋ-ਖੋਜ ਕੰਮ ਨਹੀਂ ਕਰਦੀ, ਤਾਂ ClawMetry ਨੂੰ ਸਹੀ ਸੈਂਡਬਾਕਸ ਵੱਲ ਪੌਇੰਟ ਕਰੋ: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### ਸੈਂਡਬਾਕਸ ਦੇ ਅੰਦਰ ਚਲਾਉਣਾ (ਐਡਵਾਂਸਡ) - -ਜੇ ਤੁਹਾਨੂੰ ਸਿੰਕ ਡੈਮਨ ਨੂੰ OpenShell ਸੈਂਡਬਾਕਸ ਦੇ **ਅੰਦਰ** ਚਲਾਉਣਾ ਹੀ ਹੈ, ਤਾਂ ਆਪਣੀ NemoClaw ਨੈੱਟਵਰਕ ਪਾਲਿਸੀ ਵਿੱਚ ਇਹ ਐਗਰੈੱਸ ਨਿਯਮ ਜੋੜੋ ਤਾਂ ਜੋ ਇਹ ClawMetry ਇੰਗੈਸਟ API ਤੱਕ ਪਹੁੰਚ ਸਕੇ: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -ਇਸ ਨਾਲ ਲਾਗੂ ਕਰੋ: +## ਇੰਸਟਾਲ ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # ਫਿਰ: clawmetry ``` -### ਪੋਰਟ ਅਤੇ ਐਂਡਪੌਇੰਟ - -| ਐਂਡਪੌਇੰਟ | ਪੋਰਟ | ਪ੍ਰੋਟੋਕੋਲ | ਲੋੜੀਂਦਾ | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | ਹਾਂ (ਸਿੰਕ ਡੈਮਨ → ਕਲਾਊਡ) | -| `localhost:8900` | 8900 | HTTP | ਹਾਂ (ਲੋਕਲ ਡੈਸ਼ਬੋਰਡ UI) | -| Docker ਸਾਕਟ (`/var/run/docker.sock`) | — | Unix ਸਾਕਟ | ਕੰਟੇਨਰ ਸੈਸ਼ਨ ਖੋਜ ਲਈ | - -ਸਿੰਕ ਡੈਮਨ ਸਿਰਫ਼ `ingest.clawmetry.com` ਨੂੰ ਬਾਹਰ ਜਾਣ ਵਾਲੀਆਂ HTTPS ਕਾਲਾਂ ਕਰਦਾ ਹੈ। ਕੋਈ ਅੰਦਰ ਆਉਣ ਵਾਲਾ ਪੋਰਟ ਲੋੜੀਂਦਾ ਨਹੀਂ। - ---- - -## ਕਲਾਊਡ ਡਿਪਲਾਇਮੈਂਟ - -SSH ਟਨਲ, ਰਿਵਰਸ ਪ੍ਰੌਕਸੀ, ਅਤੇ Docker ਲਈ **[ਕਲਾਊਡ ਟੈਸਟਿੰਗ ਗਾਈਡ](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** ਦੇਖੋ। +ਜਾਂ ਇੱਕ-ਲਾਈਨਰ: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -## ਟੈਸਟਿੰਗ +macOS, Linux ਜਾਂ Windows ਉੱਤੇ Python 3.8+ ਅਤੇ ਉਸੇ ਮਸ਼ੀਨ ਉੱਤੇ ਘੱਟੋ-ਘੱਟ ਇੱਕ ਏਜੰਟ ਰਨਟਾਈਮ ਲੋੜੀਂਦਾ ਹੈ। Docker ਹਦਾਇਤਾਂ: [docs/DOCKER.md](docs/DOCKER.md)। -ਇਸ ਪ੍ਰੋਜੈਕਟ ਦੀ ਟੈਸਟਿੰਗ BrowserStack ਨਾਲ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। +## ਦਸਤਾਵੇਜ਼ -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +| | | +|---|---| +| [ਰਨਟਾਈਮ ਅਨੁਕੂਲਤਾ](docs/compatibility.md) | ਹਰ ਅਡੈਪਟਰ ਕੀ ਪੜ੍ਹਦਾ ਹੈ, ਅਤੇ ਇੱਕ ਰਨਟਾਈਮ ਕਿਵੇਂ ਜੋੜਨਾ ਹੈ | +| [ਹੱਕਦਾਰੀਆਂ](docs/ENTITLEMENTS.md) | ਮੁਫ਼ਤ ਬਨਾਮ ਭੁਗਤਾਨ, ਟੀਅਰ ਮੈਟ੍ਰਿਕਸ, ਲਾਇਸੰਸ CLI | +| [ਪ੍ਰਵਾਨਗੀਆਂ ਅਤੇ ਨੀਤੀਆਂ](docs/APPROVALS.md) | ਪੂਰਵ-ਚਲਾਨ ਗੇਟਿੰਗ, ਜੋਖਮ ਸਕੋਰਿੰਗ, ਫ਼ੋਨ ਪ੍ਰਵਾਨਗੀਆਂ | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | ਟਰੇਸ ਕਿਤੇ ਵੀ ਐਕਸਪੋਰਟ ਕਰੋ, ਕਿਸੇ ਵੀ ਥਾਂ ਤੋਂ OTLP ਇਨਜੈਸਟ ਕਰੋ | +| [SDK ਟਰੈਕਿੰਗ](docs/SDK_TRACKING.md) | ਤੁਹਾਡੇ ਆਪਣੇ ਬਣਾਏ ਏਜੰਟਾਂ ਲਈ ਲਾਗਤ ਐਟ੍ਰਿਬਿਊਸ਼ਨ | +| [ਚੈਟ ਚੈਨਲ](docs/CHANNELS.md) | Flow ਵਿੱਚ ਦਿਖਾਏ ਗਏ ਚੈਟ ਅਡੈਪਟਰ | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | ਸੈਂਡਬੌਕਸਡ NVIDIA NemoClaw ਸੈੱਟਅੱਪ | +| [Docker](docs/DOCKER.md) | ਇਮੇਜ, ਕੰਪੋਜ਼, ਵਾਲੀਅਮ ਮਾਊਂਟ | +| [ਆਰਕੀਟੈਕਚਰ](ARCHITECTURE.md) · [ਡਿਵੈਲਪਮੈਂਟ](docs/DEVELOPMENT.md) | ਇਹ ਅੰਦਰੋਂ ਕਿਵੇਂ ਕੰਮ ਕਰਦਾ ਹੈ; ਸੋਰਸ ਤੋਂ ਚਲਾਉਣਾ | +| [ਟੈਲੀਮੈਟਰੀ](docs/TELEMETRY.md) | ਅਗਿਆਤ ਇੰਸਟਾਲ ਅਤੇ ਡੈਸਕਟੌਪ-ਓਪਨ ਪਿੰਗ, ਅਤੇ ਇਹਨਾਂ ਨੂੰ ਬੰਦ ਕਿਵੇਂ ਕਰਨਾ ਹੈ | -## ਟੈਲੀਮੈਟਰੀ +## ਸਕ੍ਰੀਨਸ਼ੌਟ -ClawMetry `https://app.clawmetry.com/api/install` ਨੂੰ ਅਗਿਆਤ ਇੰਸਟਾਲ-ਲਾਈਫਸਾਈਕਲ -ਪਿੰਗ ਭੇਜਦਾ ਹੈ: ਇੱਕ `install` ਪਿੰਗ ਜਦੋਂ ਤੁਸੀਂ ਪਹਿਲੀ ਵਾਰ ਕਿਸੇ ਨਵੀਂ ਮਸ਼ੀਨ 'ਤੇ `clawmetry` -CLI ਚਲਾਉਂਦੇ ਹੋ, ਇੱਕ `update` ਪਿੰਗ ਕਿਸੇ ਨਵੇਂ ਵਰਜ਼ਨ ਵਿੱਚ ਅੱਪਗ੍ਰੇਡ ਕਰਨ ਤੋਂ ਬਾਅਦ ਪਹਿਲੀ ਵਾਰ ਚਲਾਉਣ 'ਤੇ, -ਅਤੇ ਇੱਕ `onboarded` ਪਿੰਗ ਜਦੋਂ ਤੁਸੀਂ ਡੈਸ਼ਬੋਰਡ-ਅੰਦਰੂਨੀ ਔਨਬੋਰਡਿੰਗ ਚੋਣ ਪੂਰੀ ਕਰਦੇ ਹੋ। ਅਸੀਂ ਇਸ ਦੀ ਵਰਤੋਂ -ਅਸਲ ਇੰਸਟਾਲਾਂ ਦੀ ਗਿਣਤੀ ਲਈ ਕਰਦੇ ਹਾਂ (ਕੱਚੇ PyPI ਡਾਊਨਲੋਡ ਨੰਬਰ ~98% ਮਿਰਰ, CI, -ਅਤੇ ਆਟੋ-ਅੱਪਡੇਟ ਦੁਬਾਰਾ-ਡਾਊਨਲੋਡ ਹਨ) ਅਤੇ ਇਹ ਜਾਣਨ ਲਈ ਕਿ ਅਸਲ ਵਿੱਚ ਕਿਹੜੇ ਏਜੰਟ ਫਰੇਮਵਰਕ ਅਤੇ -ਵਰਜ਼ਨ ਵਰਤੋਂ ਵਿੱਚ ਹਨ। +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **ਓਵਰਵਿਊ**: ਟੋਕਨ, ਸੈਸ਼ਨ, ਸਿਹਤ | **ਬ੍ਰੇਨ**: ਲਾਈਵ ਏਜੰਟ ਈਵੈਂਟ ਸਟ੍ਰੀਮ | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **ਲਾਗਤ**: ਮਾਡਲ ਅਤੇ ਸੈਸ਼ਨ ਅਨੁਸਾਰ | **ਪ੍ਰਵਾਨਗੀਆਂ**: ਖਤਰਨਾਕ ਟੂਲ ਕਾਲਾਂ ਨੂੰ ਗੇਟ ਕਰੋ | -**ਹਰ ਵਰਜ਼ਨ ਲਈ ਪ੍ਰਤੀ ਲਾਈਫਸਾਈਕਲ ਈਵੈਂਟ ਵੱਧ ਤੋਂ ਵੱਧ ਇੱਕ POST**, ਜਿਸ ਵਿੱਚ ਸ਼ਾਮਲ ਹੈ: - -| ਖੇਤਰ | ਉਦਾਹਰਨ | ਕਿਉਂ | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id` 'ਤੇ ਸਟੋਰ ਕੀਤੀ ਰੈਂਡਮ UUID | ਡੀਡੁਪ; ਜਦੋਂ ਤੱਕ ਤੁਸੀਂ ਸਪੱਸ਼ਟ ਤੌਰ 'ਤੇ Cloud ਸਿੰਕ ਨਹੀਂ ਜੋੜਦੇ ਉਦੋਂ ਤੱਕ ਅਗਿਆਤ (ਫਿਰ ਪ੍ਰਮਾਣਿਤ ਡੈਮਨ ਹਾਰਟਬੀਟ ਇਸ ਨੂੰ ਲੈ ਜਾਂਦਾ ਹੈ, ਇਸ ਇੰਸਟਾਲ ਨੂੰ ਤੁਹਾਡੇ ਖਾਤੇ ਨਾਲ ਜੋੜਦੇ ਹੋਏ) | -| `event` | `install` / `update` / `onboarded` | ਨਵੀਂ ਇੰਸਟਾਲ ਬਨਾਮ ਮੌਜੂਦਾ ਦਾ ਅੱਪਗ੍ਰੇਡ | -| `version` | `0.12.167` | ਕਿਹੜੇ ਵਰਜ਼ਨ ਵਰਤੋਂ ਵਿੱਚ ਹਨ | -| `os` / `os_version` | `Darwin` / `25.3.0` | ਪਲੇਟਫਾਰਮ ਸਹਾਇਤਾ ਤਰਜੀਹਾਂ | -| `python` | `3.11.15` | Python ਵਰਜ਼ਨ ਸਹਾਇਤਾ ਮੈਟ੍ਰਿਕਸ | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | ਸਾਨੂੰ ਅੱਗੇ ਕਿਹੜੇ ਏਜੰਟਾਂ ਨਾਲ ਇੰਟੀਗ੍ਰੇਟ ਕਰਨਾ ਚਾਹੀਦਾ ਹੈ | -| `is_ci` / `ci_provider` | `true` / `github_actions` | ਮਨੁੱਖੀ ਇੰਸਟਾਲਾਂ ਨੂੰ CI ਸ਼ੋਰ ਤੋਂ ਵੱਖ ਕਰਨਾ | - -**ਅਸੀਂ ਕੀ ਨਹੀਂ ਭੇਜਦੇ**: IP (ਕਲਾਊਡ ਬੇਨਤੀ ਤੋਂ ਸਰਵਰ-ਸਾਈਡ 'ਤੇ -ਦੇਸ਼ ਕੋਡ ਕੱਢਦਾ ਹੈ, ਫਿਰ IP ਨੂੰ ਰੱਦ ਕਰਦਾ ਹੈ), ਹੋਸਟਨਾਮ, ਯੂਜ਼ਰਨਾਮ, ਵਰਕਸਪੇਸ -ਪਾਥ, ਫਾਈਲ ਸਮੱਗਰੀ, ਤੁਹਾਡੀ api_key, ਤੁਹਾਡੀ ਈਮੇਲ, ਕੋਈ ਵੀ PII ਜਾਂ -ਵਰਕਸਪੇਸ-ਵਿਸ਼ੇਸ਼ ਚੀਜ਼। ਵਾਇਰ ਪੇਲੋਡ -[`clawmetry/telemetry.py`](clawmetry/telemetry.py) ਵਿੱਚ ਆਡਿਟ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ। - -**ਔਪਟ ਆਊਟ ਕਰੋ** (ਇਹਨਾਂ ਵਿੱਚੋਂ ਕੋਈ ਵੀ ਇੱਕ ਇਸ ਨੂੰ ਸਥਾਈ ਤੌਰ 'ਤੇ ਅਸਮਰੱਥ ਕਰਦਾ ਹੈ): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -ਇੱਥੇ ਇੱਕ ਨੈੱਟਵਰਕ ਅਸਫਲਤਾ ਕਦੇ ਵੀ `clawmetry` ਨੂੰ ਚੱਲਣ ਤੋਂ ਨਹੀਂ ਰੋਕਦੀ — ਇਹ -ਪਿੰਗ ਇੱਕ ਡੈਮਨ ਥ੍ਰੈੱਡ 'ਤੇ 3 ਸਕਿੰਟ ਦੇ ਟਾਈਮਆਊਟ ਨਾਲ ਫਾਇਰ-ਐਂਡ-ਫਰਗੈੱਟ ਹੈ। +ਹੋਰ, ਹਰ ਰਨਟਾਈਮ ਅਨੁਸਾਰ: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md)। ## ਸਟਾਰ ਇਤਿਹਾਸ @@ -433,13 +108,8 @@ touch ~/.clawmetry/notelemetry # persistent file marker -## ਲਾਇਸੈਂਸ - -MIT +## ਲਾਇਸੰਸ ---- +MIT · ਬਣਾਇਆ [@vivekchand](https://github.com/vivekchand) ਦੁਆਰਾ · [clawmetry.com](https://clawmetry.com) -

- 🦞 ਆਪਣੇ ਏਜੰਟ ਨੂੰ ਸੋਚਦੇ ਦੇਖੋ
- @vivekchand ਦੁਆਰਾ ਬਣਾਇਆ ਗਿਆ · clawmetry.com · OpenClaw ਈਕੋਸਿਸਟਮ ਦਾ ਹਿੱਸਾ -

+ diff --git a/docs/i18n/pl/README.md b/docs/i18n/pl/README.md index 7f5836c27d..07beeb7b12 100644 --- a/docs/i18n/pl/README.md +++ b/docs/i18n/pl/README.md @@ -1,427 +1,105 @@ - + > Polski translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Zobacz, jak myśli twój agent.** Obserwowalność w czasie rzeczywistym dla **20 środowisk uruchomieniowych agentów AI**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex i 16 innych. Jeden dashboard dla całej floty twoich agentów. +**Zobacz, jak myśli twój agent.** Obserwowalność w czasie rzeczywistym dla **23 środowisk uruchomieniowych agentów AI**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex i 19 innych. Jeden panel dla całej floty twoich agentów. -> 🌐 **Czytaj w innych językach:** [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) · [więcej →](docs/i18n/) +> 🌐 **Przeczytaj to w:** [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) · [więcej →](docs/i18n/) -Jedna komenda. Zero konfiguracji. Wszystko wykrywane automatycznie. +Jedna komenda. Zero konfiguracji. Automatyczne wykrywanie wszystkiego. ```bash pip install clawmetry && clawmetry ``` -Otwiera się pod adresem **http://localhost:8900** i to wszystko. +Otwiera się pod adresem **http://localhost:8900**. Zero konfiguracji: znajduje środowiska uruchomieniowe agentów, które już masz, odczytuje je w trybie tylko do odczytu i niczego nie zmienia w sposobie ich działania. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## Działa z 20 środowiskami uruchomieniowymi agentów - -ClawMetry zaczęło jako narzędzie obserwowalności dla OpenClaw, a teraz mierzy **całą flotę twoich agentów** w jednym dashboardzie, automatycznie wykrywając każde środowisko uruchomieniowe na twoim komputerze: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw i NemoClaw są darmowe w aplikacji open source; pozostałe środowiska uruchomieniowe odblokowują się z ClawMetry Cloud lub licencją Pro na własnym hostingu. Przełączaj środowiska uruchomieniowe z poziomu nagłówka, a każda zakładka — koszty, tokeny, narzędzia, ślady wykonania — zostanie przeskalowana do tego środowiska. Zobacz **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)**, aby poznać dokładny podział darmowe/płatne, macierz poziomów, kształt `/api/entitlement` oraz CLI `clawmetry license`. - -## Co otrzymujesz - -- **Flow** — Animowany diagram na żywo pokazujący przepływ wiadomości przez kanały, mózg, narzędzia i z powrotem -- **Overview** — Kontrole stanu, mapa cieplna aktywności, liczba sesji, informacje o modelu -- **Usage** — Śledzenie tokenów i kosztów z rozbiciem dziennym/tygodniowym/miesięcznym -- **Sessions** — Aktywne sesje agenta z modelem, tokenami, ostatnią aktywnością -- **Crons** — Zaplanowane zadania ze statusem, kolejnym uruchomieniem, czasem trwania -- **Logs** — Kolorowe strumieniowanie logów w czasie rzeczywistym -- **Memory** — Przeglądanie SOUL.md, MEMORY.md, AGENTS.md, notatek dziennych -- **Transcripts** — Interfejs w formie dymków czatu do odczytu historii sesji -- **Alerts** — Limity budżetowe, wyzwalacze wskaźnika błędów, wykrywanie offline agenta; kierowane do Slack, Discord, PagerDuty, Telegram, e-mail -- **Approvals** — Blokowanie destrukcyjnych usunięć, wymuszonych pushy, mutacji bazy danych, sudo, instalacji pakietów, połączeń sieciowych za jednokrotną zgodą - -## Zrzuty ekranu - -### 🧠 Brain — Strumień zdarzeń agenta na żywo -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Zużycie tokenów i podsumowanie sesji -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Kanał wywołań narzędzi w czasie rzeczywistym -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Podział kosztów według modelu i sesji -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Przeglądarka plików obszaru roboczego -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Stan bezpieczeństwa i dziennik audytu -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — Limity budżetowe, wyzwalacze wskaźnika błędów, webhooki do Slack / Discord / PagerDuty / e-mail -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — Blokowanie ryzykownych wywołań narzędzi za ręczną zgodą; reguły ochrony oparte na polityce -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Blokowanie przed wykonaniem dla Claude Code** — jedna komenda instaluje -hook PreToolUse, który wstrzymuje pasujące wywołania narzędzi *zanim* zostaną wykonane i czeka -na twoją decyzję (jedno dotknięcie z telefonu przy włączonych -[powiadomieniach push w chmurze](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 -``` - -Odmowa blokuje tylko to jedno wywołanie narzędzia — agent zachowuje swoją sesję i może -spróbować innego podejścia. Zatwierdzenie na telefonie pomija własny -monit uprawnień Claude Code (już na niego odpowiedziałeś). Niedopasowane narzędzia kosztują ~40 ms i -przechodzą dalej do normalnego przepływu uprawnień Claude Code. Otrzymasz też powiadomienie push na telefon, -gdy sam Claude Code czeka na twoją reakcję (powiadomienia `permission_prompt` / -`idle_prompt`). - -## Instalacja - -**Jedna komenda (zalecane):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**Ze źródła:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` - -## Rozwój frontendu v2 - -Aplikacja React v2 znajduje się w `frontend/` i jest serwowana pod `/v2`, gdy -serwer Flask jest uruchomiony z włączonym v2. - -Podczas pracy użyj dwóch terminali: - -```bash -# Terminal 1: Flask API/server on :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## Działa z 23 środowiskami uruchomieniowymi agentów -```bash -# Terminal 2: Vite dev server on :5173 -cd frontend -nvm use -npm ci -npm run dev -``` +**Bezmyślnie za darmo w aplikacji open source:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -Otwórz `http://localhost:5173/v2/`. Vite przekierowuje żądania `/api` do -`http://localhost:8900`, dzięki czemu aplikacja React może komunikować się z lokalnym serwerem Flask -bez dodatkowej konfiguracji CORS. +**W planie płatnym:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -Aby zbudować paczkę dołączaną do pakietu Python: - -```bash -cd frontend -npm run build -``` +Każde środowisko uruchomieniowe otrzymuje ten sam panel. Uruchom kilka naraz, a przełącznik w nagłówku przeskaluje każdą zakładkę do jednego z nich. -Paczka produkcyjna zapisywana jest w `clawmetry/static/v2/dist/`. +Zbudowałeś własnego agenta na SDK zamiast tego? Interceptor śledzi również jego wywołania LLM. Zobacz [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -## Kompatybilność środowisk uruchomieniowych / agentów +## Co otrzymujesz -ClawMetry obserwuje wiele środowisk uruchomieniowych agentów AI, nie tylko OpenClaw. Każde środowisko inne niż OpenClaw ma dedykowany adapter odczytu, który tłumaczy jego natywny format sesji na ujednolicone kształty ClawMetry; demon pobiera je do tego samego magazynu DuckDB oraz migawki w chmurze, oznaczonych środowiskiem uruchomieniowym, a zakładka odtwarzania sesji pokazuje **przełącznik środowiska** gdy obecny jest więcej niż jeden. Zobacz [`docs/compatibility.md`](docs/compatibility.md), aby poznać pełną macierz oraz przewodnik dodawania środowisk, a także [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) — wprowadzenie do rodziny OpenClaw. +- **Sesje i transkrypcje**: co zrobił każdy agent, tura po turze, z możliwością odtworzenia +- **Koszty i tokeny**: w podziale na środowisko uruchomieniowe, model, sesję i dzień, z flagami anomalii +- **Flow**: żywy diagram wiadomości przepływających przez kanały, modele i narzędzia +- **Brain**: strumień zdarzeń rozumowania i wywołań narzędzi na żywo +- **Pamięć i umiejętności**: pliki i umiejętności, które faktycznie wczytało każde środowisko uruchomieniowe +- **Zdrowie i logi**: dysk, pamięć, wskaźniki błędów, limity szybkości, strumień logów na żywo +- **Alerty**: limity budżetu, skoki błędów, agent offline, kierowane do Slacka, Discorda, PagerDuty, Telegrama, e-maila +- **Zatwierdzenia**: wstrzymuj ryzykowne wywołania narzędzi *zanim* się wykonają i zatwierdzaj je z telefonu ([jak](docs/APPROVALS.md)) -Używasz narzędzia [Perplexity numbat](https://github.com/perplexityai/numbat) do bezpieczeństwa agentów? ClawMetry od razu pobiera jego wyniki i decyzje egzekwowania — zobacz [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Cennik -| Środowisko / agent | Status | Uwagi | +| Plan | Co obejmuje | Cena | |---|---|---| -| **OpenClaw** | Natywny | Środowisko referencyjne, wykrywane automatycznie | -| **PicoClaw** | Adapter beta | Płaski format `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`). Transkrypcje, model, wywołania narzędzi. | -| **NanoClaw** | Adapter beta | SQLite per sesja (`data/v2-sessions`). Transkrypcje + liczba wiadomości. | -| **Hermes** | Adapter beta | SQLite `~/.hermes/state.db`. Transkrypcje, model, tokeny/koszt. | -| **Claude Code** | Adapter beta | JSONL `~/.claude/projects/.../.jsonl`. Transkrypcje, model, wywołania narzędzi + myślenie, zużycie tokenów. | -| **Codex** | Adapter beta | Rollout JSONL `~/.codex/sessions/...`. Transkrypcje, model, wywołania narzędzi, zużycie tokenów. | -| **Cursor** | Adapter beta | SQLite `state.vscdb`. Transkrypcje czatu/composera, model. | -| **Aider** | Adapter beta | `.aider.chat.history.md` na projekt. Transkrypcje, model, liczba tokenów. | -| **Goose** | Adapter beta | SQLite `~/.local/share/goose`. Transkrypcje, model, wywołania narzędzi, sumy tokenów. | -| **opencode** | Adapter beta | SQLite `~/.local/share/opencode`. Transkrypcje, model, wywołania narzędzi, tokeny + koszt. | -| **Qwen Code** | Adapter beta | JSONL `~/.qwen/projects/.../chats`. Transkrypcje, model, wywołania narzędzi, zużycie tokenów. | -| **Pi** | Adapter beta | JSONL `~/.pi/agent/sessions`. Transkrypcje, model, wywołania narzędzi, tokeny + koszt. | -| **Deep Agents** | Adapter beta | SQLite `~/.deepagents/.state/sessions.db`. Transkrypcje, model, wywołania narzędzi, tokeny + koszt. | -| **n8n** | Adapter beta | SQLite `~/.n8n/database.sqlite`. Wykonania przepływów pracy, uruchomienia węzłów, prompty AI Agent, model + tokeny tam, gdzie n8n je zapisuje. | -| **Antigravity** | Adapter beta | Brain JSONL pod `~/.gemini//brain/`. Rozmowy, kroki narzędzi, myślenie, podział tokenów Gemini na generację + koszt, zużycie generacji w tle. | -| **GitHub Copilot** | Adapter beta | `events.jsonl` Copilot CLI pod `~/.copilot/session-state/` + rejestr zużycia per wywołanie `session-store.db`. Rozmowy, wywołania narzędzi, routing modeli, podział tokenów uwzględniający cache, koszt w kredytach AI rozliczanych przez dostawcę. | -| **Grok** | Adapter beta | xAI Grok Build CLI (binarka Rust pod `~/.grok/bin/grok`): globalny dziennik zdarzeń `~/.grok/logs/unified.jsonl` + per sesja `~/.grok/sessions///{events.jsonl,summary.json}`. Rozmowy, podział tokenów na turę, routing modeli oraz ładunek repozytorium wychodzący z CLI, umieszczany w `~/.grok/upload_queue/`, dzięki czemu widać, co opuściło twój komputer. | - -"Adapter beta" oznacza, że ClawMetry dostarcza czytnik dla rzeczywistego formatu dyskowego danego środowiska, każdy zbudowany i zweryfikowany na rzeczywistej instalacji na rzeczywistej maszynie (zobacz `tests/fixtures/runtimes//`). Adaptery są tylko do odczytu; każdy z nich jest szczery co do tego, co faktycznie przechowuje jego środowisko (np. PicoClaw/NanoClaw/Cursor nie zapisują kosztu tokenów na dysku). Gdy na jednym węźle działa kilka środowisk, przełącznik środowiska zawęża widok sesji do jednego, dla przejrzystej analizy. - -## Śledzenie dowolnego agenta SDK — atrybucja kosztów poza pętlą - -Powyższe środowiska uruchomieniowe zapisują sesje na dysku. Twój własny **agent produkcyjny** — ten zbudowany na OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B albo na zwykłej pętli `httpx` — tego nie robi. Bezkonfiguracyjny interceptor ClawMetry mimo to przechwytuje jego wywołania LLM (koszt, tokeny, opóźnienie, błędy) poprzez monkey-patching `httpx`/`requests`: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (lub zmienna środowiskowa `CLAWMETRY_SOURCE=support-agent`) oznacza każde wywołanie **nazwanym źródłem**, dzięki czemu każdy prowadzony przez ciebie produkt pojawia się jako osobna, pierwszoklasowa, przypisywalna do kosztów pozycja na karcie **🔌 Źródła poza pętlą** na zakładce Overview — wywołania, dostawcy, opóźnienie, wskaźnik błędów per agent. Nie ustawiono źródła? Wywołania nadal są śledzone; karta po prostu pozostaje ukryta. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -To ta sama warstwa danych, którą zasilają adaptery środowisk (DuckDB → migawka w chmurze), więc źródła poza pętlą synchronizują się z dashboardem w chmurze tak samo jak wszystko inne, w pełni szyfrowane end-to-end. - -## OpenTelemetry — neutralne wobec dostawców, wysyłaj swoje ślady wykonania gdziekolwiek - -ClawMetry mówi w obie strony w standardzie **OpenTelemetry**, używając **konwencji semantycznych GenAI**, dzięki czemu ślady wykonania twojego agenta nigdy nie są zamknięte w jednym narzędziu. - -**Eksport** każdej sesji — wywołania LLM, narzędzia, subagenci, tokeny, koszt — jako ślady OTLP/HTTP GenAI do dowolnego kolektora (Datadog, Grafana, Honeycomb lub własny OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Nagłówki uwierzytelniające i interwał odpytywania są opcjonalnymi zmiennymi środowiskowymi: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**Ingest** — wbudowany odbiornik OTLP przyjmuje ślady wykonania, logi i metryki z dowolnego źródła pod `/v1/traces`, `/v1/logs` i `/v1/metrics`. Skieruj tam dowolną aplikację zinstrumentowaną OpenTelemetry: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -Ślady i logi OTLP/JSON działają na zwykłym `pip install clawmetry`, bez dodatków. Ingest protobuf (i metryki OTLP/JSON) wymaga `pip install clawmetry[otel]`. Aplikacja, która ustawia własne `service.name`, pojawia się jako osobny agent w przełączniku środowisk, wraz ze swoim kosztem i tokenami. - -Otrzymujesz bezkonfiguracyjny, lokalny dashboard ClawMetry **oraz** swoje dane w dowolnym backendzie, którego już używa twój zespół — bez uzależnienia od dostawcy, bez drugiego agenta do zainstalowania. - -## Konfiguracja - -Większość osób nie potrzebuje żadnej konfiguracji. ClawMetry automatycznie wykrywa twój obszar roboczy, logi, sesje i zadania cron. - -Jeśli jednak chcesz coś dostosować: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -Wszystkie opcje: `clawmetry --help` - -## Obsługiwane kanały - -ClawMetry pokazuje aktywność na żywo dla każdego skonfigurowanego kanału OpenClaw. W diagramie Flow pojawiają się tylko kanały faktycznie skonfigurowane w twoim `openclaw.json` — nieskonfigurowane są automatycznie ukrywane. - -Kliknij dowolny węzeł kanału w Flow, aby zobaczyć widok dymków czatu na żywo z licznikami wiadomości przychodzących/wychodzących. - -| Kanał | Status | Podgląd na żywo | Uwagi | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Pełny | ✅ | Wiadomości, statystyki, odświeżanie co 10s | -| 💬 **iMessage** | ✅ Pełny | ✅ | Odczytuje bezpośrednio `~/Library/Messages/chat.db` | -| 💚 **WhatsApp** | ✅ Pełny | ✅ | Przez WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Pełny | ✅ | Przez signal-cli | -| 🟣 **Discord** | ✅ Pełny | ✅ | Wykrywanie serwera + kanału | -| 🟪 **Slack** | ✅ Pełny | ✅ | Wykrywanie workspace + kanału | -| 🌐 **Webchat** | ✅ Pełny | ✅ | Wbudowane sesje interfejsu webowego | -| 📡 **IRC** | ✅ Pełny | ✅ | Interfejs dymków w stylu terminala | -| 🍏 **BlueBubbles** | ✅ Pełny | ✅ | iMessage przez BlueBubbles REST API | -| 🔵 **Google Chat** | ✅ Pełny | ✅ | Przez webhooki Chat API | -| 🟣 **MS Teams** | ✅ Pełny | ✅ | Przez wtyczkę bota Teams | -| 🔷 **Mattermost** | ✅ Pełny | ✅ | Samodzielnie hostowany czat zespołowy | -| 🟩 **Matrix** | ✅ Pełny | ✅ | Zdecentralizowany, wsparcie E2EE | -| 🟢 **LINE** | ✅ Pełny | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Pełny | ✅ | Zdecentralizowane wiadomości NIP-04 DM | -| 🟣 **Twitch** | ✅ Pełny | ✅ | Czat przez połączenie IRC | -| 🔷 **Feishu/Lark** | ✅ Pełny | ✅ | Subskrypcja zdarzeń przez WebSocket | -| 🔵 **Zalo** | ✅ Pełny | ✅ | Zalo Bot API | - -> **Automatyczne wykrywanie:** ClawMetry odczytuje twój `~/.openclaw/openclaw.json` i renderuje tylko rzeczywiście skonfigurowane kanały. Ręczna konfiguracja nie jest wymagana. - -## Wdrożenie w Dockerze - -Chcesz uruchomić ClawMetry w kontenerze? Żaden problem! 🐳 - -**Szybki start z Dockerem:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Przykład Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Uwaga:** Podczas uruchamiania w Dockerze zamontuj katalogi danych i logów swojego agenta (np. `~/.openclaw`, `~/.claude`, `~/.codex`), aby ClawMetry mogło automatycznie wykryć twoją konfigurację. - -## Wymagania - -- Python 3.8+ -- Flask (instalowany automatycznie przez pip) -- Środowisko uruchomieniowe agenta AI na tym samym komputerze: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok lub QM (lub zamontowane woluminy dla Dockera) -- Linux lub macOS - -## Wsparcie dla NemoClaw / OpenShell - -ClawMetry automatycznie wykrywa [NemoClaw](https://github.com/NVIDIA/NemoClaw) — korporacyjną osłonę bezpieczeństwa NVIDII dla OpenClaw, która uruchamia agentów wewnątrz izolowanych kontenerów OpenShell. - -W większości przypadków nie jest potrzebna dodatkowa konfiguracja. Demon synchronizacji automatycznie odnajduje pliki sesji, niezależnie od tego, czy znajdują się w `~/.openclaw/` na hoście, czy wewnątrz kontenera OpenShell. +| **Free** | OpenClaw + NVIDIA NemoClaw, pełny panel, tylko lokalnie | 0 USD | +| **Starter** | Wszystkie pozostałe środowiska uruchomieniowe powyżej, widok floty, synchronizacja w chmurze | 9 USD za węzeł / miesiąc | +| **Pro** | Starter + governance: zatwierdzenia, polityki ryzyka narzędzi, ewaluacje, wykrywanie anomalii, optymalizator kosztów, eksport OTel | 19 USD za węzeł / miesiąc | -### Jak to działa +Plany roczne, Enterprise i aktualne ceny znajdują się na stronie +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Klucze licencyjne do samodzielnego hostowania +działają bez chmury (`clawmetry license`). Dokładny podział na darmowe/płatne funkcje znajduje się +w [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -ClawMetry wykrywa NemoClaw na dwa sposoby: +## Twoje dane pozostają na twoim komputerze -1. **Wykrywanie binarki** — sprawdza obecność CLI `nemoclaw` i uruchamia `nemoclaw status`, aby uzyskać informacje o piaskownicy -2. **Wykrywanie kontenera** — skanuje uruchomione kontenery Dockera pod kątem obrazów `openshell`, `nemoclaw` lub `ghcr.io/nvidia/`, a następnie odczytuje sesje przez zamontowane woluminy lub `docker cp` +ClawMetry odczytuje lokalne pliki sesji i logi. Nic nie opuszcza twojego komputera, chyba że +uruchomisz `clawmetry connect`. Nawet wtedy migawka jest szyfrowana end-to-end +kluczem, który nigdy nie opuszcza twojego komputera, i jest odszyfrowywana w twojej przeglądarce. -Pliki sesji zsynchronizowane z kontenerów NemoClaw są oznaczane w dashboardzie w chmurze metadanymi `runtime=nemoclaw` oraz `container_id`, dzięki czemu na pierwszy rzut oka można je odróżnić od standardowych sesji OpenClaw. - -### Zalecana konfiguracja: demon synchronizacji na HOŚCIE - -Dla najlepszego doświadczenia uruchom demon synchronizacji ClawMetry na **maszynie hosta** (nie wewnątrz piaskownicy). Pozwala to uniknąć ograniczeń polityki sieciowej NemoClaw. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -Demon synchronizacji automatycznie odnajdzie sesje wewnątrz dowolnych uruchomionych kontenerów OpenShell. - -### Opcjonalnie: jawna nazwa piaskownicy - -Jeśli automatyczne wykrywanie nie działa, wskaż ClawMetry właściwą piaskownicę: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Uruchamianie wewnątrz piaskownicy (zaawansowane) - -Jeśli musisz uruchomić demon synchronizacji **wewnątrz** piaskownicy OpenShell, dodaj tę regułę ruchu wychodzącego do swojej polityki sieciowej NemoClaw, aby mógł dotrzeć do API ingestu ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Zastosuj za pomocą: +## Instalacja ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # następnie: clawmetry ``` -### Porty i punkty końcowe - -| Punkt końcowy | Port | Protokół | Wymagany | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Tak (demon synchronizacji → chmura) | -| `localhost:8900` | 8900 | HTTP | Tak (lokalny interfejs dashboardu) | -| Gniazdo Dockera (`/var/run/docker.sock`) | — | Gniazdo Unix | Do wykrywania sesji w kontenerach | - -Demon synchronizacji wykonuje tylko wychodzące połączenia HTTPS do `ingest.clawmetry.com`. Żadne porty przychodzące nie są wymagane. - ---- - -## Wdrożenie w chmurze - -Zobacz **[Przewodnik testowania w chmurze](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)**, aby poznać tunele SSH, reverse proxy i Docker. - -## Testowanie - -Ten projekt jest testowany za pomocą BrowserStack. +Lub jedną linią: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +Wymaga Python 3.8+ na macOS, Linuksie lub Windowsie oraz co najmniej jednego środowiska uruchomieniowego agenta na +tej samej maszynie. Instrukcje Dockera: [docs/DOCKER.md](docs/DOCKER.md). -## Telemetria +## Dokumentacja -ClawMetry wysyła anonimowe sygnały cyklu życia instalacji do -`https://app.clawmetry.com/api/install`: jeden sygnał `install` przy -pierwszym uruchomieniu CLI `clawmetry` na nowej maszynie, jeden sygnał `update` -przy pierwszym uruchomieniu po aktualizacji do nowej wersji, oraz jeden sygnał `onboarded` -po ukończeniu wyboru wdrożenia w dashboardzie. Wykorzystujemy to -do liczenia rzeczywistych instalacji (surowe liczby pobrań z PyPI to w ~98% mirrory, CI -i ponowne pobrania przez automatyczne aktualizacje) oraz do poznania, które frameworki agentów i -wersje są rzeczywiście używane. +| | | +|---|---| +| [Zgodność środowisk uruchomieniowych](docs/compatibility.md) | Co odczytuje każdy adapter i jak dodać środowisko uruchomieniowe | +| [Uprawnienia](docs/ENTITLEMENTS.md) | Darmowe vs płatne, macierz poziomów, CLI licencji | +| [Zatwierdzenia i polityki](docs/APPROVALS.md) | Bramkowanie przed wykonaniem, ocena ryzyka, zatwierdzenia z telefonu | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Eksportuj ślady wszędzie, przyjmuj OTLP od wszystkiego | +| [Śledzenie SDK](docs/SDK_TRACKING.md) | Przypisywanie kosztów dla agentów zbudowanych samodzielnie | +| [Kanały czatu](docs/CHANNELS.md) | Adaptery czatu pokazywane w Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Piaskownicowe konfiguracje NVIDIA NemoClaw | +| [Docker](docs/DOCKER.md) | Obraz, compose, montowanie wolumenów | +| [Architektura](ARCHITECTURE.md) · [Rozwój](docs/DEVELOPMENT.md) | Jak to działa w środku; uruchamianie ze źródła | +| [Telemetria](docs/TELEMETRY.md) | Anonimowe sygnały instalacji i otwarcia aplikacji desktopowej oraz jak je wyłączyć | -**Co najwyżej jeden POST na zdarzenie cyklu życia na wersję**, zawierający: - -| Pole | Przykład | Dlaczego | -|---|---|---| -| `install_id` | losowy UUID przechowywany w `~/.clawmetry/install_id` | deduplikacja; anonimowy dopóki jawnie nie połączysz synchronizacji z chmurą (uwierzytelniony heartbeat demona przenosi go wtedy dalej, łącząc tę instalację z twoim kontem) | -| `event` | `install` / `update` / `onboarded` | świeża instalacja vs aktualizacja istniejącej | -| `version` | `0.12.167` | jakie wersje są w użyciu | -| `os` / `os_version` | `Darwin` / `25.3.0` | priorytety wsparcia platform | -| `python` | `3.11.15` | macierz wsparcia wersji Pythona | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | z jakimi agentami powinniśmy się dalej integrować | -| `is_ci` / `ci_provider` | `true` / `github_actions` | oddzielenie instalacji ludzkich od szumu CI | - -**Czego NIE wysyłamy**: IP (chmura wyprowadza kod kraju po stronie serwera -z żądania, a następnie odrzuca adres IP), nazwy hosta, nazwy użytkownika, ścieżki obszaru roboczego, zawartości plików, twojego api_key, twojego adresu e-mail, niczego, co jest PII lub -specyficzne dla obszaru roboczego. Payload transmisji można zweryfikować w -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Rezygnacja** (dowolna z poniższych opcji wyłącza to na stałe): +## Zrzuty ekranu -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: tokeny, sesje, zdrowie | **Brain**: strumień zdarzeń agenta na żywo | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Koszt**: według modelu i sesji | **Zatwierdzenia**: bramkowanie ryzykownych wywołań narzędzi | -Awaria sieci nigdy nie blokuje uruchomienia `clawmetry` — sygnał -jest wysyłany bezobsługowo (fire-and-forget) w wątku demona z limitem czasu 3 s. +Więcej, w podziale na środowisko uruchomieniowe: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Historia gwiazdek @@ -435,11 +113,6 @@ jest wysyłany bezobsługowo (fire-and-forget) w wątku demona z limitem czasu 3 ## Licencja -MIT - ---- +MIT · Stworzone przez [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Zobacz, jak myśli twój agent
- Stworzone przez @vivekchand · clawmetry.com · Część ekosystemu OpenClaw -

+ diff --git a/docs/i18n/pt-BR/README.md b/docs/i18n/pt-BR/README.md index d1854b6a4c..a7ae4d0f65 100644 --- a/docs/i18n/pt-BR/README.md +++ b/docs/i18n/pt-BR/README.md @@ -1,17 +1,16 @@ - + > Português (BR) translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Veja seu agente pensar.** Observabilidade em tempo real para **23 runtimes de agentes de IA**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex e mais 16. Um único painel para toda a sua frota de agentes. +**Veja seu agente pensar.** Observabilidade em tempo real para **23 runtimes de agentes de IA**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex e mais 19 outros. Um único painel para toda a sua frota de agentes. > 🌐 **Leia em:** [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) · [mais →](docs/i18n/) @@ -21,408 +20,90 @@ Um único comando. Zero configuração. Detecta tudo automaticamente. pip install clawmetry && clawmetry ``` -Abre em **http://localhost:8900** e pronto. +Abre em **http://localhost:8900**. Zero configuração: ele encontra os runtimes +de agentes que você já tem, os lê em modo somente leitura e não muda nada na forma como eles rodam. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) ## Funciona com 23 runtimes de agentes -O ClawMetry começou como observabilidade para o OpenClaw e agora mede **toda a sua frota de agentes** em um único painel, detectando automaticamente cada runtime na sua máquina: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw e NemoClaw são gratuitos no aplicativo open-source; os demais runtimes são liberados com o ClawMetry Cloud ou uma licença Pro self-hosted. Troque de runtime pelo cabeçalho e cada aba, custo, tokens, ferramentas, traces, se reajusta a esse runtime. Veja **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** para a divisão exata entre gratuito e pago, a matriz de tiers, o formato de `/api/entitlement` e a CLI `clawmetry license`. - -## O que você ganha - -- **Flow** — Diagrama animado ao vivo mostrando as mensagens fluindo por canais, brain, ferramentas e de volta -- **Overview** — Checagens de saúde, mapa de calor de atividade, contagem de sessões, informações do modelo -- **Usage** — Rastreamento de tokens e custo com detalhamento diário/semanal/mensal -- **Sessions** — Sessões de agente ativas com modelo, tokens, última atividade -- **Crons** — Tarefas agendadas com status, próxima execução, duração -- **Logs** — Streaming de logs em tempo real com cores -- **Memory** — Navegue por SOUL.md, MEMORY.md, AGENTS.md, notas diárias -- **Transcripts** — Interface em bolhas de chat para ler históricos de sessão -- **Alerts** — Limites de orçamento, gatilhos de taxa de erro, detecção de agente offline; encaminha para Slack, Discord, PagerDuty, Telegram, Email -- **Approvals** — Bloqueia exclusões destrutivas, force pushes, mutações de banco de dados, sudo, instalações de pacotes, chamadas de rede atrás de uma aprovação com um clique - -## Capturas de tela - -### 🧠 Brain — Stream de eventos do agente ao vivo -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Uso de tokens e resumo de sessões -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Feed de chamadas de ferramentas em tempo real -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Detalhamento de custo por modelo e sessão -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Navegador de arquivos do workspace -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Postura de segurança e log de auditoria -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — Limites de orçamento, gatilhos de taxa de erro, webhooks para Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +**Gratuito no app open source:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### ✋ Approvals — Bloqueia chamadas de ferramentas arriscadas atrás de aprovação manual; regras de proteção baseadas em política -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Bloqueio pré-execução para o Claude Code** — um comando instala um -hook PreToolUse que pausa chamadas de ferramentas correspondentes *antes* de elas rodarem e aguarda -sua decisão (um toque a partir do seu celular com -[notificações push na nuvem](https://app.clawmetry.com/push) habilitadas): - -```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 -``` - -Uma negativa bloqueia apenas aquela chamada de ferramenta específica, o agente mantém sua sessão e pode -tentar outra abordagem. Aprovar pelo celular pula o próprio prompt de -permissão do Claude Code (você já respondeu). Ferramentas não correspondentes custam ~40ms e -seguem o fluxo normal de permissão do Claude Code. Você também recebe um push no celular quando o Claude Code -está aguardando você (notificações `permission_prompt` / -`idle_prompt`). - -## Instalação - -**Um único comando (recomendado):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**A partir do código-fonte:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` +**Em um plano pago:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -## Desenvolvimento do frontend v2 +Todo runtime recebe o mesmo painel. Rode vários ao mesmo tempo e o seletor no +cabeçalho reajusta cada aba para um deles. -O app React v2 fica em `frontend/` e é servido em `/v2` quando o servidor -Flask é iniciado com o v2 habilitado. +Construiu seu próprio agente com um SDK em vez disso? O interceptor rastreia +as chamadas de LLM dele também. Veja [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -Use dois terminais durante o desenvolvimento: - -```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 -``` - -Abra `http://localhost:5173/v2/`. O Vite encaminha as requisições de `/api` para -`http://localhost:8900`, então o app React consegue conversar com o servidor Flask local -sem configuração extra de CORS. - -Para gerar o bundle que acompanha o pacote Python: - -```bash -cd frontend -npm run build -``` - -O bundle de produção é gravado em `clawmetry/static/v2/dist/`. - -## Compatibilidade de runtime / agente +## O que você ganha -O ClawMetry observa muitos runtimes de agentes de IA, não só o OpenClaw. Cada runtime que não seja o OpenClaw traz um adaptador de leitura dedicado que traduz o formato de sessão nativo dele para os formatos unificados do ClawMetry; o daemon os ingere no mesmo armazenamento DuckDB + snapshot na nuvem, marcados com o runtime, e a aba Session replay mostra um **seletor de runtime** quando há mais de um presente. Veja [`docs/compatibility.md`](docs/compatibility.md) para a matriz completa + um guia para adicionar runtimes, e [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) para a introdução à família OpenClaw. +- **Sessões e transcrições**: o que cada agente fez, turno a turno, com replay +- **Custo e tokens**: por runtime, modelo, sessão e dia, com sinalizadores de anomalia +- **Flow**: diagrama ao vivo das mensagens passando por canais, modelos e ferramentas +- **Brain**: o fluxo de eventos de raciocínio e chamadas de ferramentas em tempo real +- **Memória e habilidades**: os arquivos e habilidades que cada runtime realmente carregou +- **Saúde e logs**: disco, memória, taxas de erro, limites de taxa, stream de logs ao vivo +- **Alertas**: limites de orçamento, picos de erro, agente offline, roteados para Slack, Discord, PagerDuty, Telegram, Email +- **Aprovações**: pause chamadas de ferramentas arriscadas *antes* que elas rodem e aprove pelo celular ([como funciona](docs/APPROVALS.md)) -Está rodando o [numbat da Perplexity](https://github.com/perplexityai/numbat), a ferramenta de segurança de agentes? O ClawMetry ingere seus achados e decisões de enforcement prontos para uso, veja [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Preços -| Runtime / Agente | Status | Notas | +| Plano | O que cobre | Preço | |---|---|---| -| **OpenClaw** | Nativo | Runtime de referência, detectado automaticamente | -| **PicoClaw** | Adaptador beta | JSONL plano de `providers.Message` (`~/.picoclaw/workspace/sessions`). Transcrições, modelo, chamadas de ferramentas. | -| **NanoClaw** | Adaptador beta | SQLite por sessão (`data/v2-sessions`). Transcrições + contagem de mensagens. | -| **Hermes** | Adaptador beta | SQLite `~/.hermes/state.db`. Transcrições, modelo, tokens/custo. | -| **Claude Code** | Adaptador beta | JSONL `~/.claude/projects/.../.jsonl`. Transcrições, modelo, chamadas de ferramentas + thinking, uso de tokens. | -| **Codex** | Adaptador beta | Rollout JSONL `~/.codex/sessions/...`. Transcrições, modelo, chamadas de ferramentas, uso de tokens. | -| **Cursor** | Adaptador beta | SQLite `state.vscdb`. Transcrições de chat/composer, modelo. | -| **Aider** | Adaptador beta | `.aider.chat.history.md` por projeto. Transcrições, modelo, contagem de tokens. | -| **Goose** | Adaptador beta | SQLite `~/.local/share/goose`. Transcrições, modelo, chamadas de ferramentas, totais de tokens. | -| **opencode** | Adaptador beta | SQLite `~/.local/share/opencode`. Transcrições, modelo, chamadas de ferramentas, tokens + custo. | -| **Qwen Code** | Adaptador beta | JSONL `~/.qwen/projects/.../chats`. Transcrições, modelo, chamadas de ferramentas, uso de tokens. | -| **Pi** | Adaptador beta | JSONL `~/.pi/agent/sessions`. Transcrições, modelo, chamadas de ferramentas, tokens + custo. | -| **Deep Agents** | Adaptador beta | SQLite `~/.deepagents/.state/sessions.db`. Transcrições, modelo, chamadas de ferramentas, tokens + custo. | -| **n8n** | Adaptador beta | SQLite `~/.n8n/database.sqlite`. Execuções de workflow, execuções de nós, prompts do AI Agent, modelo + tokens onde o n8n os registra. | -| **Antigravity** | Adaptador beta | Brain JSONL em `~/.gemini//brain/`. Conversas, etapas de ferramentas, thinking, divisão de tokens do Gemini por geração + custo, consumo de geração em background. | -| **GitHub Copilot** | Adaptador beta | `events.jsonl` da Copilot CLI em `~/.copilot/session-state/` + o registro de uso por chamada `session-store.db`. Conversas, chamadas de ferramentas, roteamento de modelo, divisão de tokens com cache, custo em crédito de IA cobrado pelo fornecedor. | -| **Grok** | Adaptador beta | xAI Grok Build CLI (binário Rust em `~/.grok/bin/grok`): log de eventos global `~/.grok/logs/unified.jsonl` + `~/.grok/sessions///{events.jsonl,summary.json}` por sessão. Conversas, divisão de tokens por turno, roteamento de modelo, e o payload de repositório enviado pela CLI, preparado em `~/.grok/upload_queue/`, para você ver o que saiu da sua máquina. | - -"Adaptador beta" significa que o ClawMetry disponibiliza um leitor para o formato real em disco daquele runtime, cada um construído e verificado contra uma instalação real em uma máquina real (veja `tests/fixtures/runtimes//`). Os adaptadores são somente leitura; cada um é honesto sobre o que o respectivo runtime de fato armazena (por exemplo, PicoClaw/NanoClaw/Cursor não gravam o custo de tokens em disco). Quando vários runtimes rodam em um mesmo nó, o seletor de runtime restringe a visão de sessões a um deles para uma investigação mais limpa. - -## Rastreie qualquer agente de SDK — atribuição de custo out-loop - -Os runtimes acima gravam sessões em disco. Já o seu **agente de produção**, aquele que você construiu com o OpenAI Agents SDK, LangChain, o Vercel AI SDK, LlamaIndex, E2B, ou um loop simples com `httpx`, não faz isso. O interceptador zero-config do ClawMetry ainda captura suas chamadas de LLM (custo, tokens, latência, erros) fazendo monkey-patching em `httpx`/`requests`: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (ou a variável de ambiente `CLAWMETRY_SOURCE=support-agent`) marca cada chamada com uma **fonte nomeada**, de forma que cada produto que você roda aparece como uma linha própria, de primeira classe e com custo atribuível, no cartão **🔌 Out-loop sources** do painel na aba Overview, chamadas, provedores, latência, taxa de erro por agente. Sem fonte definida? As chamadas continuam sendo rastreadas; o cartão simplesmente fica oculto. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Essa é a mesma camada de dados alimentada pelos adaptadores de runtime (DuckDB → snapshot na nuvem), então as fontes out-loop sincronizam com o painel na nuvem da mesma forma que tudo o mais, com criptografia ponta a ponta. - -## OpenTelemetry — neutro em relação a fornecedor, envie seus traces para qualquer lugar - -O ClawMetry fala **OpenTelemetry** nas duas direções, usando as **convenções semânticas GenAI**, então os traces do seu agente nunca ficam presos a uma única ferramenta. - -**Exporte** cada sessão, chamadas de LLM, ferramentas, sub-agentes, tokens, custo, como spans GenAI OTLP/HTTP para qualquer coletor (Datadog, Grafana, Honeycomb, ou seu próprio OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Cabeçalhos de autenticação e intervalo de polling são variáveis de ambiente opcionais: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**Ingira** — o receptor OTLP embutido aceita traces, logs e métricas de qualquer outra fonte em `/v1/traces`, `/v1/logs` e `/v1/metrics`. Aponte qualquer aplicação instrumentada com OpenTelemetry para ele: +| **Free** | OpenClaw + NVIDIA NemoClaw, painel completo, apenas local | $0 | +| **Starter** | Todos os outros runtimes acima, visão de frota, sincronização em nuvem | $9 por nó / mês | +| **Pro** | Starter + governança: aprovações, políticas de risco de ferramentas, avaliações, detecção de anomalias, otimizador de custos, exportação OTel | $19 por nó / mês | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -Traces e logs em OTLP/JSON funcionam em um `pip install clawmetry` simples, sem extras. Ingestão em Protobuf (e métricas OTLP/JSON) precisa de `pip install clawmetry[otel]`. Uma aplicação que define seu próprio `service.name` aparece como seu próprio agente no seletor de runtime, com seu custo e tokens. - -Você ganha o painel do ClawMetry zero-config e local-first **e** seus dados no backend que sua equipe já usa, sem lock-in, sem precisar instalar um segundo agente. - -## Configuração - -A maioria das pessoas não precisa de nenhuma configuração. O ClawMetry detecta automaticamente seu workspace, logs, sessões e crons. - -Se você precisar personalizar: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -Todas as opções: `clawmetry --help` - -## Canais suportados - -O ClawMetry mostra atividade ao vivo para cada canal do OpenClaw que você tiver configurado. Apenas os canais realmente configurados no seu `openclaw.json` aparecem no diagrama Flow, os não configurados ficam ocultos automaticamente. - -Clique em qualquer nó de canal no Flow para ver uma visualização em bolhas de chat ao vivo com contagens de mensagens recebidas/enviadas. - -| Channel | Status | Live Popup | Notes | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Full | ✅ | Messages, stats, 10s refresh | -| 💬 **iMessage** | ✅ Full | ✅ | Reads `~/Library/Messages/chat.db` directly | -| 💚 **WhatsApp** | ✅ Full | ✅ | Via WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Full | ✅ | Via signal-cli | -| 🟣 **Discord** | ✅ Full | ✅ | Guild + channel detection | -| 🟪 **Slack** | ✅ Full | ✅ | Workspace + channel detection | -| 🌐 **Webchat** | ✅ Full | ✅ | Built-in web UI sessions | -| 📡 **IRC** | ✅ Full | ✅ | Terminal-style bubble UI | -| 🍏 **BlueBubbles** | ✅ Full | ✅ | iMessage via BlueBubbles REST API | -| 🔵 **Google Chat** | ✅ Full | ✅ | Via Chat API webhooks | -| 🟣 **MS Teams** | ✅ Full | ✅ | Via Teams bot plugin | -| 🔷 **Mattermost** | ✅ Full | ✅ | Self-hosted team chat | -| 🟩 **Matrix** | ✅ Full | ✅ | Decentralized, E2EE support | -| 🟢 **LINE** | ✅ Full | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Full | ✅ | Decentralized NIP-04 DMs | -| 🟣 **Twitch** | ✅ Full | ✅ | Chat via IRC connection | -| 🔷 **Feishu/Lark** | ✅ Full | ✅ | WebSocket event subscription | -| 🔵 **Zalo** | ✅ Full | ✅ | Zalo Bot API | - -> **Detecção automática:** o ClawMetry lê seu `~/.openclaw/openclaw.json` e renderiza apenas os canais que você realmente configurou. Nenhuma configuração manual necessária. - -## Implantação com Docker - -Quer rodar o ClawMetry em um container? Sem problema! 🐳 - -**Início rápido com Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Exemplo de Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Observação:** ao rodar no Docker, monte os diretórios de dados + logs do seu agente (por exemplo, `~/.openclaw`, `~/.claude`, `~/.codex`) para que o ClawMetry consiga detectar automaticamente sua configuração. - -## Requisitos - -- Python 3.8+ -- Flask (instalado automaticamente via pip) -- Um runtime de agente de IA na mesma máquina: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, ou QM (ou volumes montados para Docker) -- Linux ou macOS - -## Suporte a NemoClaw / OpenShell - -O ClawMetry detecta automaticamente o [NemoClaw](https://github.com/NVIDIA/NemoClaw), o wrapper de segurança empresarial da NVIDIA para o OpenClaw que roda agentes dentro de containers OpenShell isolados (sandboxed). - -Na maioria dos casos, nenhuma configuração extra é necessária. O daemon de sincronização descobre automaticamente os arquivos de sessão, estejam eles em `~/.openclaw/` no host ou dentro de um container OpenShell. +Planos anuais, Enterprise e os valores atuais estão em +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Chaves de licença +autogerenciadas funcionam sem a nuvem (`clawmetry license`). A divisão exata entre +gratuito/pago está em [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -### Como funciona +## Seus dados ficam na sua máquina -O ClawMetry detecta o NemoClaw de duas formas: +O ClawMetry lê arquivos de sessão e logs locais. Nada sai da sua máquina, a menos +que você rode `clawmetry connect`. Mesmo assim, o snapshot é criptografado de +ponta a ponta com uma chave que nunca sai da sua máquina, e é descriptografado +no seu navegador. -1. **Detecção por binário** — verifica a presença da CLI `nemoclaw` e executa `nemoclaw status` para obter informações do sandbox -2. **Detecção por container** — varre os containers Docker em execução em busca de imagens `openshell`, `nemoclaw`, ou `ghcr.io/nvidia/`, e então lê as sessões via volumes montados ou `docker cp` - -Os arquivos de sessão sincronizados a partir de containers NemoClaw são marcados com `runtime=nemoclaw` e metadados de `container_id` no painel na nuvem, para que você consiga diferenciá-los das sessões padrão do OpenClaw rapidamente. - -### Configuração recomendada: daemon de sincronização no HOST - -Para a melhor experiência, rode o daemon de sincronização do ClawMetry na **máquina host** (não dentro do sandbox). Isso evita as restrições de política de rede do NemoClaw. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -O daemon de sincronização encontrará automaticamente as sessões dentro de qualquer container OpenShell em execução. - -### Opcional: nome de sandbox explícito - -Se a detecção automática não funcionar, aponte o ClawMetry para o sandbox correto: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Rodando dentro do sandbox (avançado) - -Se você precisar rodar o daemon de sincronização **dentro** do sandbox OpenShell, adicione esta regra de egress à sua política de rede do NemoClaw para que ele consiga alcançar a API de ingestão do ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Aplique com: +## Instalação ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # depois: clawmetry ``` -### Portas e endpoints - -| Endpoint | Port | Protocol | Required | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Yes (sync daemon → cloud) | -| `localhost:8900` | 8900 | HTTP | Yes (local dashboard UI) | -| Docker socket (`/var/run/docker.sock`) | — | Unix socket | For container session discovery | - -O daemon de sincronização só faz chamadas HTTPS de saída para `ingest.clawmetry.com`. Nenhuma porta de entrada é necessária. - ---- - -## Implantação na nuvem - -Veja o **[Guia de Testes na Nuvem](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** para túneis SSH, proxy reverso e Docker. - -## Testes +Ou o comando único: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -Este projeto é testado com BrowserStack. +Requer Python 3.8+ no macOS, Linux ou Windows, e pelo menos um runtime de agente na +mesma máquina. Instruções para Docker: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## Documentação -## Telemetria +| | | +|---|---| +| [Compatibilidade de runtimes](docs/compatibility.md) | O que cada adaptador lê, e como adicionar um runtime | +| [Entitlements](docs/ENTITLEMENTS.md) | Gratuito vs pago, matriz de níveis, CLI de licença | +| [Aprovações e políticas](docs/APPROVALS.md) | Bloqueio pré-execução, pontuação de risco, aprovações pelo celular | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Exporte traces para qualquer lugar, ingira OTLP de qualquer fonte | +| [Rastreamento de SDK](docs/SDK_TRACKING.md) | Atribuição de custo para agentes que você mesmo construiu | +| [Canais de chat](docs/CHANNELS.md) | Os adaptadores de chat exibidos no Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Configurações de NVIDIA NemoClaw isoladas (sandbox) | +| [Docker](docs/DOCKER.md) | Imagem, compose, montagens de volume | +| [Arquitetura](ARCHITECTURE.md) · [Desenvolvimento](docs/DEVELOPMENT.md) | Como funciona por dentro; executando a partir do código-fonte | +| [Telemetria](docs/TELEMETRY.md) | Os pings anônimos de instalação e abertura do desktop, e como desativá-los | -O ClawMetry envia pings anônimos de ciclo de vida de instalação para -`https://app.clawmetry.com/api/install`: um ping de `install` na primeira -vez que você roda a CLI `clawmetry` em uma máquina nova, um ping de `update` -na primeira execução após atualizar para uma nova versão, e um ping de -`onboarded` quando você conclui a escolha de onboarding no painel. Usamos isso -para contar instalações reais (os números brutos de download do PyPI são ~98% espelhos, CI, -e re-downloads de atualização automática) e para saber quais frameworks de agente e -versões estão realmente em uso. +## Capturas de tela -**No máximo um POST por evento de ciclo de vida por versão**, contendo: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: tokens, sessões, saúde | **Brain**: fluxo de eventos do agente em tempo real | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Custo**: por modelo e sessão | **Aprovações**: bloqueia chamadas de ferramentas arriscadas | -| Field | Example | Why | -|---|---|---| -| `install_id` | random UUID stored at `~/.clawmetry/install_id` | dedup; anonymous until you explicitly connect Cloud sync (the authenticated daemon heartbeat then carries it, linking this install to your account) | -| `event` | `install` / `update` / `onboarded` | fresh install vs upgrade of an existing one | -| `version` | `0.12.167` | what versions are in the wild | -| `os` / `os_version` | `Darwin` / `25.3.0` | platform support priorities | -| `python` | `3.11.15` | Python version support matrix | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | which agents we should integrate with next | -| `is_ci` / `ci_provider` | `true` / `github_actions` | separate human installs from CI noise | - -**O que NÃO enviamos**: IP (a nuvem deriva o código do país no lado do servidor -a partir da requisição, depois descarta o IP), hostname, nome de usuário, caminho do -workspace, conteúdo de arquivos, sua api_key, seu e-mail, nada que seja PII ou -específico do workspace. O payload transmitido é auditável em -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Desativar** (qualquer uma destas opções desativa permanentemente): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -Uma falha de rede aqui nunca impede a execução do `clawmetry`, o -ping é fire-and-forget em uma thread do daemon com timeout de 3 s. +Mais, por runtime: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Histórico de estrelas @@ -436,11 +117,6 @@ ping é fire-and-forget em uma thread do daemon com timeout de 3 s. ## Licença -MIT - ---- +MIT · Criado por [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Veja seu agente pensar
- Criado por @vivekchand · clawmetry.com · Parte do ecossistema OpenClaw -

+ diff --git a/docs/i18n/pt-PT/README.md b/docs/i18n/pt-PT/README.md index b7829d5e4f..c48b28ae22 100644 --- a/docs/i18n/pt-PT/README.md +++ b/docs/i18n/pt-PT/README.md @@ -1,17 +1,16 @@ - + > Português (PT) translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Veja o seu agente a pensar.** Observabilidade em tempo real para **23 runtimes de agentes de IA**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex e mais 16. Um único painel para toda a sua frota de agentes. +**Veja o seu agente a pensar.** Observabilidade em tempo real para **23 runtimes de agentes de IA**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex e mais 19. Um único painel para toda a sua frota de agentes. > 🌐 **Leia isto em:** [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) · [mais →](docs/i18n/) @@ -21,407 +20,90 @@ Um comando. Zero configuração. Deteta tudo automaticamente. pip install clawmetry && clawmetry ``` -Abre em **http://localhost:8900** e está feito. +Abre em **http://localhost:8900**. Zero configuração: encontra os runtimes de agentes +que já tem, lê-os apenas em modo de leitura e não altera nada na forma como funcionam. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) ## Funciona com 23 runtimes de agentes -O ClawMetry começou como observabilidade para o OpenClaw e agora mede toda a sua **frota de agentes** num único painel, detetando automaticamente cada runtime na sua máquina: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw e NemoClaw são gratuitos na aplicação de código aberto; os restantes runtimes ativam-se com o ClawMetry Cloud ou com uma licença Pro self-hosted. Mude de runtime a partir do cabeçalho e todos os separadores (custo, tokens, ferramentas, traces) reajustam-se a esse runtime. Consulte **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** para a divisão exata entre gratuito/pago, a matriz de níveis, o formato de `/api/entitlement` e a CLI `clawmetry license`. - -## O que obtém - -- **Flow** — Diagrama animado ao vivo que mostra as mensagens a fluir através dos canais, do brain, das ferramentas e de volta -- **Overview** — Verificações de saúde, mapa de calor de atividade, contagem de sessões, informação do modelo -- **Usage** — Acompanhamento de tokens e custos com divisões diárias/semanais/mensais -- **Sessions** — Sessões de agentes ativas com modelo, tokens, última atividade -- **Crons** — Tarefas agendadas com estado, próxima execução, duração -- **Logs** — Streaming de logs em tempo real com código de cores -- **Memory** — Navegue por SOUL.md, MEMORY.md, AGENTS.md, notas diárias -- **Transcripts** — Interface de balões de conversa para ler históricos de sessões -- **Alerts** — Limites de orçamento, gatilhos de taxa de erro, deteção de agente offline; encaminha para Slack, Discord, PagerDuty, Telegram, Email -- **Approvals** — Bloqueia eliminações destrutivas, force pushes, mutações em bases de dados, sudo, instalações de pacotes, chamadas de rede, atrás de uma aprovação com um clique - -## Capturas de ecrã - -### 🧠 Brain — Fluxo de eventos do agente em tempo real -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Uso de tokens e resumo de sessões -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Feed de chamadas de ferramentas em tempo real -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Divisão de custos por modelo e sessão -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Explorador de ficheiros do workspace -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Postura de segurança e registo de auditoria -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — Limites de orçamento, gatilhos de taxa de erro, webhooks para Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +**Gratuito na aplicação open source:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### ✋ Approvals — Bloqueia chamadas de ferramentas de risco atrás de aprovação manual; regras de proteção baseadas em políticas -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Bloqueio pré-execução para o Claude Code** — um único comando instala um -hook PreToolUse que pausa as chamadas de ferramentas correspondentes *antes* de serem executadas e aguarda -pela sua decisão (um toque a partir do telemóvel com -[notificações push na cloud](https://app.clawmetry.com/push) ativadas): - -```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 -``` - -Uma negação bloqueia apenas essa chamada de ferramenta; o agente mantém a sua sessão e pode -tentar outra abordagem. Aprovar no telemóvel salta o próprio pedido de -permissão do Claude Code (já respondeu). Ferramentas sem correspondência custam ~40ms e -seguem para o fluxo de permissões normal do Claude Code. Também recebe uma notificação push no telemóvel quando o próprio Claude Code está à espera de si (notificações `permission_prompt` / -`idle_prompt`). - -## Instalação - -**Comando único (recomendado):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**A partir do código-fonte:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` +**Num plano pago:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -## Desenvolvimento do frontend v2 +Todos os runtimes têm acesso ao mesmo painel. Execute vários em simultâneo e o +seletor no cabeçalho reajusta cada separador para um deles. -A aplicação React v2 reside em `frontend/` e é servida em `/v2` quando o -servidor Flask é iniciado com o v2 ativado. +Construiu o seu próprio agente com um SDK em vez disso? O interceptor também +regista as suas chamadas ao LLM. Consulte [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -Use dois terminais durante o desenvolvimento: - -```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 -``` - -Abra `http://localhost:5173/v2/`. O Vite faz proxy dos pedidos `/api` para -`http://localhost:8900`, para que a aplicação React possa comunicar com o servidor Flask local -sem necessidade de configuração CORS adicional. - -Para compilar o bundle que é distribuído com o pacote Python: - -```bash -cd frontend -npm run build -``` - -O bundle de produção é escrito em `clawmetry/static/v2/dist/`. - -## Compatibilidade de Runtimes / Agentes +## O que obtém -O ClawMetry observa muitos runtimes de agentes de IA, não apenas o OpenClaw. Cada runtime que não seja o OpenClaw disponibiliza um adaptador de leitura dedicado que traduz o seu formato nativo de sessão para os formatos unificados do ClawMetry; o daemon ingere-os no mesmo repositório DuckDB + snapshot na cloud, com etiqueta do runtime, e o separador de replay de sessões mostra um **seletor de runtime** quando existe mais do que um presente. Consulte [`docs/compatibility.md`](docs/compatibility.md) para a matriz completa + um guia para adicionar runtimes, e [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) para a introdução à família OpenClaw. +- **Sessões e transcrições**: o que cada agente fez, turno a turno, com repetição +- **Custo e tokens**: por runtime, modelo, sessão e dia, com sinalização de anomalias +- **Flow**: diagrama ao vivo das mensagens a mover-se entre canais, modelos e ferramentas +- **Brain**: o fluxo de eventos de raciocínio e chamadas a ferramentas, em tempo real +- **Memória e skills**: os ficheiros e skills que cada runtime carregou de facto +- **Saúde e logs**: disco, memória, taxas de erro, limites de taxa, fluxo de logs ao vivo +- **Alertas**: limites de orçamento, picos de erros, agente offline, encaminhados para Slack, Discord, PagerDuty, Telegram, Email +- **Aprovações**: pause chamadas a ferramentas de risco *antes* de serem executadas e aprove a partir do telemóvel ([como](docs/APPROVALS.md)) -Está a usar a ferramenta de segurança de agentes [numbat da Perplexity](https://github.com/perplexityai/numbat)? O ClawMetry ingere os seus resultados e decisões de aplicação de políticas de origem, sem configuração adicional; veja [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Preços -| Runtime / Agente | Estado | Notas | +| Plano | O que cobre | Preço | |---|---|---| -| **OpenClaw** | Nativo | Runtime de referência, detetado automaticamente | -| **PicoClaw** | Adaptador beta | JSONL plano `providers.Message` (`~/.picoclaw/workspace/sessions`). Transcrições, modelo, chamadas de ferramentas. | -| **NanoClaw** | Adaptador beta | SQLite por sessão (`data/v2-sessions`). Transcrições + contagem de mensagens. | -| **Hermes** | Adaptador beta | SQLite `~/.hermes/state.db`. Transcrições, modelo, tokens/custo. | -| **Claude Code** | Adaptador beta | JSONL `~/.claude/projects/.../.jsonl`. Transcrições, modelo, chamadas de ferramentas + raciocínio, uso de tokens. | -| **Codex** | Adaptador beta | Rollout JSONL `~/.codex/sessions/...`. Transcrições, modelo, chamadas de ferramentas, uso de tokens. | -| **Cursor** | Adaptador beta | SQLite `state.vscdb`. Transcrições de chat/composer, modelo. | -| **Aider** | Adaptador beta | `.aider.chat.history.md` por projeto. Transcrições, modelo, contagem de tokens. | -| **Goose** | Adaptador beta | SQLite `~/.local/share/goose`. Transcrições, modelo, chamadas de ferramentas, totais de tokens. | -| **opencode** | Adaptador beta | SQLite `~/.local/share/opencode`. Transcrições, modelo, chamadas de ferramentas, tokens + custo. | -| **Qwen Code** | Adaptador beta | JSONL `~/.qwen/projects/.../chats`. Transcrições, modelo, chamadas de ferramentas, uso de tokens. | -| **Pi** | Adaptador beta | JSONL `~/.pi/agent/sessions`. Transcrições, modelo, chamadas de ferramentas, tokens + custo. | -| **Deep Agents** | Adaptador beta | SQLite `~/.deepagents/.state/sessions.db`. Transcrições, modelo, chamadas de ferramentas, tokens + custo. | -| **n8n** | Adaptador beta | SQLite `~/.n8n/database.sqlite`. Execuções de workflow, execuções de nós, prompts do AI Agent, modelo + tokens quando o n8n os regista. | -| **Antigravity** | Adaptador beta | Brain JSONL em `~/.gemini//brain/`. Conversas, passos de ferramentas, raciocínio, divisão de tokens Gemini por geração + custo, consumo de geração em segundo plano. | -| **GitHub Copilot** | Adaptador beta | `events.jsonl` da Copilot CLI em `~/.copilot/session-state/` + o livro-razão de uso por chamada `session-store.db`. Conversas, chamadas de ferramentas, encaminhamento de modelo, divisão de tokens com cache, custo em créditos de IA faturados pelo fornecedor. | -| **Grok** | Adaptador beta | xAI Grok Build CLI (binário Rust em `~/.grok/bin/grok`): registo global de eventos `~/.grok/logs/unified.jsonl` + por sessão `~/.grok/sessions///{events.jsonl,summary.json}`. Conversas, divisão de tokens por turno, encaminhamento de modelo, e o payload de repositório enviado pela CLI, colocado em `~/.grok/upload_queue/`, para que possa ver o que saiu da sua máquina. | - -"Adaptador beta" significa que o ClawMetry disponibiliza um leitor para o formato real em disco desse runtime, cada um construído + verificado numa instalação real numa máquina real (veja `tests/fixtures/runtimes//`). Os adaptadores são apenas de leitura; cada um é transparente quanto ao que o respetivo runtime realmente armazena (por exemplo, PicoClaw/NanoClaw/Cursor não escrevem o custo em tokens em disco). Quando vários runtimes correm num só nó, o seletor de runtime restringe a vista de sessões a um deles, para uma análise limpa e aprofundada. - -## Acompanhe qualquer agente SDK — atribuição de custos out-loop - -Os runtimes acima escrevem todos as sessões em disco. O seu próprio **agente de produção** — aquele que construiu com o OpenAI Agents SDK, LangChain, o Vercel AI SDK, LlamaIndex, E2B, ou um simples loop `httpx` — não o faz. O interceptor de zero configuração do ClawMetry continua a capturar as suas chamadas de LLM (custo, tokens, latência, erros) fazendo monkey-patching a `httpx`/`requests`: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (ou a variável de ambiente `CLAWMETRY_SOURCE=support-agent`) marca cada chamada com uma **origem nomeada**, para que cada produto que executa apareça como a sua própria linha, de primeira classe e com atribuição de custo, no cartão **🔌 Out-loop sources** do painel Overview: chamadas, fornecedores, latência, taxa de erro por agente. Sem origem definida? As chamadas continuam a ser registadas; o cartão apenas permanece oculto. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Esta é a mesma camada de dados alimentada pelos adaptadores de runtime (DuckDB → snapshot na cloud), pelo que as origens out-loop sincronizam com o painel na cloud tal como tudo o resto, com encriptação de ponta a ponta. - -## OpenTelemetry — neutro em relação a fornecedores, envie os seus traces para qualquer lado - -O ClawMetry fala **OpenTelemetry** em ambas as direções, usando as **convenções semânticas GenAI**, para que os traces do seu agente nunca fiquem presos a uma única ferramenta. - -**Exportação** de cada sessão — chamadas de LLM, ferramentas, sub-agentes, tokens, custo — como spans GenAI OTLP/HTTP para qualquer coletor (Datadog, Grafana, Honeycomb, ou o seu próprio OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Os cabeçalhos de autenticação e o intervalo de sondagem são variáveis de ambiente opcionais: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**Ingestão** — o recetor OTLP incorporado aceita traces, logs e métricas de qualquer outra fonte em `/v1/traces`, `/v1/logs` e `/v1/metrics`. Aponte qualquer aplicação instrumentada com OpenTelemetry para ele: +| **Free** | OpenClaw + NVIDIA NemoClaw, painel completo, apenas local | $0 | +| **Starter** | Todos os outros runtimes acima, vista de frota, sincronização na cloud | $9 por nó / mês | +| **Pro** | Starter + governação: aprovações, políticas de risco de ferramentas, avaliações, deteção de anomalias, otimizador de custos, exportação OTel | $19 por nó / mês | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -Os traces e logs OTLP/JSON funcionam com um simples `pip install clawmetry`, sem extras. A ingestão de Protobuf (e métricas OTLP/JSON) requer `pip install clawmetry[otel]`. Uma aplicação que define o seu próprio `service.name` aparece como o seu próprio agente no seletor de runtime, com o seu custo e tokens. - -Obtém o painel ClawMetry de configuração zero e local-first **e** os seus dados no backend que a sua equipa já utiliza; sem dependência de fornecedor, sem necessidade de instalar um segundo agente. - -## Configuração - -A maioria das pessoas não precisa de qualquer configuração. O ClawMetry deteta automaticamente o seu workspace, logs, sessões e crons. - -Se precisar de personalizar: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -Todas as opções: `clawmetry --help` - -## Canais Suportados - -O ClawMetry mostra atividade ao vivo para todos os canais OpenClaw que tiver configurados. Apenas os canais que estão realmente configurados no seu `openclaw.json` aparecem no diagrama Flow; os que não estão configurados são ocultados automaticamente. - -Clique em qualquer nó de canal no Flow para ver uma vista de balões de chat ao vivo, com contagens de mensagens recebidas/enviadas. - -| Canal | Estado | Popup ao vivo | Notas | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Completo | ✅ | Mensagens, estatísticas, atualização a cada 10s | -| 💬 **iMessage** | ✅ Completo | ✅ | Lê `~/Library/Messages/chat.db` diretamente | -| 💚 **WhatsApp** | ✅ Completo | ✅ | Via WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Completo | ✅ | Via signal-cli | -| 🟣 **Discord** | ✅ Completo | ✅ | Deteção de servidor + canal | -| 🟪 **Slack** | ✅ Completo | ✅ | Deteção de workspace + canal | -| 🌐 **Webchat** | ✅ Completo | ✅ | Sessões da interface web incorporada | -| 📡 **IRC** | ✅ Completo | ✅ | Interface de balões estilo terminal | -| 🍏 **BlueBubbles** | ✅ Completo | ✅ | iMessage via API REST do BlueBubbles | -| 🔵 **Google Chat** | ✅ Completo | ✅ | Via webhooks da Chat API | -| 🟣 **MS Teams** | ✅ Completo | ✅ | Via plugin de bot do Teams | -| 🔷 **Mattermost** | ✅ Completo | ✅ | Chat de equipa self-hosted | -| 🟩 **Matrix** | ✅ Completo | ✅ | Descentralizado, com suporte E2EE | -| 🟢 **LINE** | ✅ Completo | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Completo | ✅ | Mensagens diretas NIP-04 descentralizadas | -| 🟣 **Twitch** | ✅ Completo | ✅ | Chat via ligação IRC | -| 🔷 **Feishu/Lark** | ✅ Completo | ✅ | Subscrição de eventos via WebSocket | -| 🔵 **Zalo** | ✅ Completo | ✅ | Zalo Bot API | - -> **Deteção automática:** O ClawMetry lê o seu `~/.openclaw/openclaw.json` e apenas apresenta os canais que configurou de facto. Não é necessária configuração manual. - -## Implementação com Docker - -Quer executar o ClawMetry num contentor? Sem problema! 🐳 - -**Início rápido com Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Exemplo de Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Nota:** Ao executar em Docker, monte os diretórios de dados + logs do seu agente (por exemplo, `~/.openclaw`, `~/.claude`, `~/.codex`) para que o ClawMetry possa detetar automaticamente a sua configuração. - -## Requisitos - -- Python 3.8+ -- Flask (instalado automaticamente via pip) -- Um runtime de agente de IA na mesma máquina: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, ou QM (ou volumes montados para Docker) -- Linux ou macOS - -## Suporte para NemoClaw / OpenShell - -O ClawMetry deteta automaticamente o [NemoClaw](https://github.com/NVIDIA/NemoClaw), o wrapper de segurança empresarial da NVIDIA para o OpenClaw, que executa agentes dentro de contentores OpenShell isolados (sandboxed). - -Na maioria dos casos, não é necessária configuração adicional. O daemon de sincronização descobre automaticamente os ficheiros de sessão, quer estejam em `~/.openclaw/` no host, quer dentro de um contentor OpenShell. +Os planos anuais, Enterprise e os valores atuais estão disponíveis em +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. As chaves de licença +self-hosted funcionam sem a cloud (`clawmetry license`). A divisão exata entre +gratuito/pago está em [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -### Como funciona +## Os seus dados permanecem na sua máquina -O ClawMetry deteta o NemoClaw de duas formas: +O ClawMetry lê ficheiros de sessão e logs locais. Nada sai da sua máquina, a +menos que execute `clawmetry connect`. Mesmo nesse caso, o snapshot é +encriptado de ponta a ponta com uma chave que nunca sai da sua máquina, e é +desencriptado no seu navegador. -1. **Deteção de binário** — verifica a existência da CLI `nemoclaw` e executa `nemoclaw status` para obter informação sobre a sandbox -2. **Deteção de contentor** — analisa os contentores Docker em execução à procura de imagens `openshell`, `nemoclaw`, ou `ghcr.io/nvidia/`, e depois lê as sessões através de volumes montados ou de `docker cp` - -Os ficheiros de sessão sincronizados a partir de contentores NemoClaw são etiquetados com `runtime=nemoclaw` e metadados `container_id` no painel na cloud, para que consiga distingui-los das sessões OpenClaw normais rapidamente. - -### Configuração recomendada: daemon de sincronização no HOST - -Para a melhor experiência, execute o daemon de sincronização do ClawMetry na **máquina host** (não dentro da sandbox). Isto evita restrições de política de rede do NemoClaw. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -O daemon de sincronização irá encontrar automaticamente as sessões dentro de quaisquer contentores OpenShell em execução. - -### Opcional: nome explícito da sandbox - -Se a deteção automática não funcionar, aponte o ClawMetry para a sandbox correta: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Executar dentro da sandbox (avançado) - -Se tiver de executar o daemon de sincronização **dentro** da sandbox OpenShell, adicione esta regra de saída (egress) à sua política de rede do NemoClaw, para que consiga alcançar a API de ingestão do ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Aplique com: +## Instalação ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # depois: clawmetry ``` -### Portas e endpoints - -| Endpoint | Porta | Protocolo | Necessário | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Sim (daemon de sincronização → cloud) | -| `localhost:8900` | 8900 | HTTP | Sim (interface do painel local) | -| Socket do Docker (`/var/run/docker.sock`) | — | Socket Unix | Para descoberta de sessões em contentores | - -O daemon de sincronização faz apenas chamadas HTTPS de saída para `ingest.clawmetry.com`. Não é necessária nenhuma porta de entrada. - ---- - -## Implementação na Cloud - -Consulte o **[Guia de Testes na Cloud](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** para túneis SSH, proxy reverso e Docker. - -## Testes +Ou o comando único: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -Este projeto é testado com o BrowserStack. +Requer Python 3.8+ em macOS, Linux ou Windows, e pelo menos um runtime de +agente na mesma máquina. Instruções para Docker: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## Documentação -## Telemetria +| | | +|---|---| +| [Compatibilidade de runtimes](docs/compatibility.md) | O que cada adaptador lê, e como adicionar um runtime | +| [Entitlements](docs/ENTITLEMENTS.md) | Gratuito vs pago, matriz de níveis, CLI de licença | +| [Aprovações e políticas](docs/APPROVALS.md) | Controlo pré-execução, pontuação de risco, aprovações pelo telemóvel | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Exporte traces para qualquer lugar, ingira OTLP de qualquer fonte | +| [SDK tracking](docs/SDK_TRACKING.md) | Atribuição de custos para agentes construídos por si | +| [Canais de chat](docs/CHANNELS.md) | Os adaptadores de chat mostrados no Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Configurações sandboxed do NVIDIA NemoClaw | +| [Docker](docs/DOCKER.md) | Imagem, compose, montagens de volumes | +| [Arquitetura](ARCHITECTURE.md) · [Desenvolvimento](docs/DEVELOPMENT.md) | Como funciona por dentro; execução a partir do código-fonte | +| [Telemetria](docs/TELEMETRY.md) | Os pings anónimos de instalação e abertura da aplicação, e como os desativar | -O ClawMetry envia pings anónimos do ciclo de vida da instalação para -`https://app.clawmetry.com/api/install`: um ping de `install` na primeira -vez que executa a CLI `clawmetry` numa nova máquina, um ping de `update` -na primeira execução após atualizar para uma nova versão, e um ping de `onboarded` -quando conclui a escolha de onboarding no painel. Usamos isto -para contar instalações reais (os números brutos de downloads do PyPI são ~98% mirrors, CI, -e re-downloads de atualização automática) e para saber quais as frameworks de agentes e -versões que estão realmente em uso. +## Capturas de ecrã -**No máximo um POST por evento do ciclo de vida por versão**, contendo: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: tokens, sessões, saúde | **Brain**: fluxo de eventos do agente em tempo real | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Custo**: por modelo e sessão | **Aprovações**: controla chamadas a ferramentas de risco | -| Campo | Exemplo | Porquê | -|---|---|---| -| `install_id` | UUID aleatório guardado em `~/.clawmetry/install_id` | deduplicação; anónimo até ligar explicitamente a sincronização com a Cloud (o heartbeat autenticado do daemon passa então a incluí-lo, ligando esta instalação à sua conta) | -| `event` | `install` / `update` / `onboarded` | instalação nova vs. atualização de uma existente | -| `version` | `0.12.167` | quais as versões em uso | -| `os` / `os_version` | `Darwin` / `25.3.0` | prioridades de suporte de plataforma | -| `python` | `3.11.15` | matriz de suporte de versões do Python | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | com que agentes nos devemos integrar a seguir | -| `is_ci` / `ci_provider` | `true` / `github_actions` | separar instalações humanas de ruído de CI | - -**O que NÃO enviamos**: IP (a cloud deriva o código do país do lado do -servidor a partir do pedido, e depois descarta o IP), nome do host, nome de utilizador, caminho do -workspace, conteúdo de ficheiros, a sua api_key, o seu email, nada que seja PII ou -específico do workspace. O payload transmitido pode ser auditado em -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Desativar** (qualquer uma destas opções desativa permanentemente): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -Uma falha de rede aqui nunca bloqueia a execução do `clawmetry`; o -ping é fire-and-forget numa thread do daemon, com um timeout de 3 s. +Mais, por runtime: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Histórico de Estrelas @@ -435,11 +117,6 @@ ping é fire-and-forget numa thread do daemon, com um timeout de 3 s. ## Licença -MIT - ---- +MIT · Criado por [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Veja o seu agente a pensar
- Criado por @vivekchand · clawmetry.com · Parte do ecossistema OpenClaw -

+ diff --git a/docs/i18n/ru/README.md b/docs/i18n/ru/README.md index 2ab46c405d..beb0f123bd 100644 --- a/docs/i18n/ru/README.md +++ b/docs/i18n/ru/README.md @@ -1,428 +1,106 @@ - + > Русский translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Смотрите, как думает ваш агент.** Наблюдаемость в реальном времени для **20 рантаймов ИИ-агентов**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex и ещё 16. Единая панель для всего вашего парка агентов. +**Смотрите, как думает ваш агент.** Наблюдаемость в реальном времени для **23 сред выполнения AI-агентов**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex и ещё 19. Единая панель для всего вашего флота агентов. -> 🌐 **Читать на других языках:** [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/) +> 🌐 **Читайте на других языках:** [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**, и всё готово. +Открывается по адресу **http://localhost:8900**. Никакой настройки: система находит уже установленные у вас среды выполнения агентов, читает их данные только для чтения и никак не влияет на их работу. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## Работает с 20 рантаймами агентов - -ClawMetry начинался как инструмент наблюдаемости для OpenClaw, а теперь ведёт учёт **всего вашего парка агентов** в единой панели, автоматически определяя каждый рантайм на вашей машине: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw и NemoClaw бесплатны в приложении с открытым исходным кодом; остальные рантаймы становятся доступны с ClawMetry Cloud или с лицензией Pro для самостоятельного хостинга. Переключайте рантаймы из шапки — и каждая вкладка (стоимость, токены, инструменты, трассировки) переключится на область этого рантайма. Подробности о точном разделении бесплатных и платных функций, матрице тарифов, форме `/api/entitlement` и CLI `clawmetry license` см. в **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)**. - -## Что вы получаете - -- **Flow** — живая анимированная диаграмма, показывающая, как сообщения проходят через каналы, "мозг", инструменты и обратно -- **Overview** — проверки состояния, тепловая карта активности, счётчики сессий, информация о моделях -- **Usage** — учёт токенов и стоимости с разбивкой по дням/неделям/месяцам -- **Sessions** — активные сессии агентов с моделью, токенами, временем последней активности -- **Crons** — запланированные задачи со статусом, временем следующего запуска, длительностью -- **Logs** — цветная потоковая передача логов в реальном времени -- **Memory** — просмотр SOUL.md, MEMORY.md, AGENTS.md, ежедневных заметок -- **Transcripts** — интерфейс в виде чата для чтения истории сессий -- **Alerts** — лимиты бюджета, триггеры по частоте ошибок, обнаружение офлайн-агентов; уведомления в Slack, Discord, PagerDuty, Telegram, Email -- **Approvals** — блокировка деструктивных удалений, принудительных push, изменений в БД, sudo, установок пакетов, сетевых вызовов до подтверждения в один клик - -## Скриншоты - -### 🧠 Brain — поток событий агента в реальном времени -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — использование токенов и сводка по сессиям -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — лента вызовов инструментов в реальном времени -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — разбивка стоимости по моделям и сессиям -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — обозреватель файлов рабочего пространства -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — состояние защищённости и журнал аудита -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) +## Работает с 23 средами выполнения агентов -### 🚨 Alerts — лимиты бюджета, триггеры по частоте ошибок, вебхуки в Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +**Бесплатно в приложении с открытым исходным кодом:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### ✋ Approvals — блокировка рискованных вызовов инструментов до ручного подтверждения; правила защиты на основе политик -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Блокировка до выполнения для Claude Code** — одна команда устанавливает -хук PreToolUse, который приостанавливает подходящие вызовы инструментов *до* их выполнения и ждёт -вашего решения (одно нажатие с телефона при включённых -[облачных push-уведомлениях](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. Вы также получаете push-уведомление на телефон, когда -сам 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 -``` +**По платному плану:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -## Разработка фронтенда v2 +Для каждой среды выполнения предоставляется одна и та же панель. Запускайте несколько сред одновременно, и переключатель в шапке будет перенаправлять каждую вкладку на нужную из них. -Приложение React v2 находится в `frontend/` и обслуживается по адресу `/v2`, когда -сервер Flask запущен с включённым v2. +Создали собственного агента на базе SDK? Перехватчик отслеживает и его вызовы LLM. +См. [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -При разработке используйте два терминала: - -```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), а азы семейства OpenClaw — в [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md). +- **Сессии и транскрипты**: что делал каждый агент, шаг за шагом, с воспроизведением +- **Расходы и токены**: по средам выполнения, моделям, сессиям и дням, с флагами аномалий +- **Flow**: диаграмма в реальном времени, показывающая движение сообщений через каналы, модели и инструменты +- **Brain**: поток событий рассуждений и вызовов инструментов по мере их появления +- **Память и навыки**: файлы и навыки, которые фактически загрузила каждая среда выполнения +- **Здоровье и логи**: диск, память, частота ошибок, лимиты запросов, живой поток логов +- **Оповещения**: лимиты бюджета, всплески ошибок, отключение агента, маршрутизация в Slack, Discord, PagerDuty, Telegram, Email +- **Согласования (Approvals)**: приостановка рискованных вызовов инструментов *до* их выполнения и подтверждение с телефона ([подробнее](docs/APPROVALS.md)) -Используете инструмент безопасности агентов [Perplexity numbat](https://github.com/perplexityai/numbat)? ClawMetry сразу же принимает его находки и решения по применению политик — см. [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Тарифы -| Рантайм / агент | Статус | Примечания | +| План | Что включено | Цена | |---|---|---| -| **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`. Транскрипты чата/composer, модель. | -| **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`. Выполнения рабочих процессов, запуски узлов, промпты AI Agent, модель + токены там, где n8n их фиксирует. | -| **Antigravity** | Бета-адаптер | Brain JSONL в `~/.gemini//brain/`. Диалоги, шаги инструментов, рассуждения, разбивка токенов Gemini по каждой генерации + стоимость, расход на фоновую генерацию. | -| **GitHub Copilot** | Бета-адаптер | `events.jsonl` Copilot CLI в `~/.copilot/session-state/` + реестр использования по вызовам `session-store.db`. Диалоги, вызовы инструментов, маршрутизация моделей, разбивка токенов с учётом кеша, стоимость в AI-кредитах, выставляемых поставщиком. | -| **Grok** | Бета-адаптер | xAI Grok Build CLI (бинарник на Rust в `~/.grok/bin/grok`): глобальный журнал событий `~/.grok/logs/unified.jsonl` + пер-сессионные `~/.grok/sessions///{events.jsonl,summary.json}`. Диалоги, разбивка токенов по репликам, маршрутизация моделей и исходящая полезная нагрузка репозитория CLI, помещаемая в очередь `~/.grok/upload_queue/`, чтобы вы видели, что покинуло вашу машину. | - -"Бета-адаптер" означает, что ClawMetry поставляет читатель для реального формата хранения этого рантайма на диске, каждый из которых собран и проверен на реальной установке на реальной машине (см. `tests/fixtures/runtimes//`). Адаптеры доступны только для чтения; каждый честно отражает то, что рантайм реально хранит (например, PicoClaw/NanoClaw/Cursor не записывают стоимость токенов на диск). Когда на одном узле работает несколько рантаймов, переключатель рантайма сужает представление сессий до одного для чистого погружения. - -## Отслеживание любого SDK-агента — учёт стоимости вне цикла - -Все перечисленные выше рантаймы записывают сессии на диск. Ваш собственный **продакшн-агент** — тот, что вы построили на OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B или на обычном цикле `httpx` — этого не делает. Интерцептор ClawMetry без конфигурации всё равно перехватывает его LLM-вызовы (стоимость, токены, задержка, ошибки), подменяя `httpx`/`requests`: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (или переменная окружения `CLAWMETRY_SOURCE=support-agent`) помечает каждый вызов **именованным источником**, поэтому каждый продукт, который вы запускаете, отображается как отдельная полноценная строка с учётом стоимости на карточке **🔌 Источники вне цикла** вкладки Overview панели — вызовы, поставщики, задержка, частота ошибок по каждому агенту. Источник не задан? Вызовы всё равно отслеживаются, просто карточка остаётся скрытой. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Это тот же слой данных, который питают адаптеры рантаймов (DuckDB → облачный снапшот), поэтому источники вне цикла синхронизируются с облачной панелью так же, как и всё остальное, со сквозным шифрованием. - -## OpenTelemetry — независимость от поставщика, отправляйте трассировки куда угодно - -ClawMetry говорит на **OpenTelemetry** в обе стороны, используя **семантические соглашения GenAI**, поэтому трассировки вашего агента никогда не привязаны к одному инструменту. - -**Экспорт** каждой сессии — вызовы LLM, инструменты, суб-агенты, токены, стоимость — в виде спанов OTLP/HTTP GenAI в любой коллектор (Datadog, Grafana, Honeycomb или ваш собственный OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Заголовки авторизации и интервал опроса — необязательные переменные окружения: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**Приём** — встроенный приёмник OTLP принимает трассировки, логи и метрики от чего угодно ещё по адресам `/v1/traces`, `/v1/logs` и `/v1/metrics`. Направьте на него любое приложение с инструментацией OpenTelemetry: +| **Free** | OpenClaw + NVIDIA NemoClaw, полная панель, только локально | $0 | +| **Starter** | Все остальные среды выполнения из списка выше, обзор флота, облачная синхронизация | $9 за узел / месяц | +| **Pro** | Starter + управление: согласования, политики риска инструментов, оценки (evals), обнаружение аномалий, оптимизатор расходов, экспорт в OTel | $19 за узел / месяц | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -Приём трассировок и логов в формате OTLP/JSON работает при обычном `pip install clawmetry`, без дополнений. Приём Protobuf (и метрик OTLP/JSON) требует `pip install clawmetry[otel]`. Приложение, которое задаёт собственное `service.name`, отображается как отдельный агент в переключателе рантайма, со своей стоимостью и токенами. - -Вы получаете панель ClawMetry без конфигурации, локальную по умолчанию, **и** свои данные в любом бэкенде, который уже использует ваша команда — без привязки к поставщику, без установки второго агента. - -## Конфигурация - -Большинству людей конфигурация вообще не нужна. ClawMetry автоматически определяет ваше рабочее пространство, логи, сессии и cron-задачи. - -Если вам всё же нужна настройка: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -Все опции: `clawmetry --help` - -## Поддерживаемые каналы - -ClawMetry показывает живую активность для каждого настроенного вами канала OpenClaw. Только каналы, реально настроенные в вашем `openclaw.json`, отображаются на диаграмме Flow — ненастроенные автоматически скрываются. - -Нажмите на любой узел канала во Flow, чтобы увидеть живое представление в виде чата со счётчиками входящих/исходящих сообщений. - -| Канал | Статус | Живое всплывающее окно | Примечания | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Полностью | ✅ | Сообщения, статистика, обновление раз в 10 с | -| 💬 **iMessage** | ✅ Полностью | ✅ | Читает `~/Library/Messages/chat.db` напрямую | -| 💚 **WhatsApp** | ✅ Полностью | ✅ | Через WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Полностью | ✅ | Через signal-cli | -| 🟣 **Discord** | ✅ Полностью | ✅ | Определение гильдии + канала | -| 🟪 **Slack** | ✅ Полностью | ✅ | Определение рабочего пространства + канала | -| 🌐 **Webchat** | ✅ Полностью | ✅ | Встроенные сессии веб-интерфейса | -| 📡 **IRC** | ✅ Полностью | ✅ | Интерфейс в стиле терминала | -| 🍏 **BlueBubbles** | ✅ Полностью | ✅ | iMessage через REST API BlueBubbles | -| 🔵 **Google Chat** | ✅ Полностью | ✅ | Через вебхуки Chat API | -| 🟣 **MS Teams** | ✅ Полностью | ✅ | Через плагин бота Teams | -| 🔷 **Mattermost** | ✅ Полностью | ✅ | Собственный корпоративный чат | -| 🟩 **Matrix** | ✅ Полностью | ✅ | Децентрализованный, поддержка E2EE | -| 🟢 **LINE** | ✅ Полностью | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Полностью | ✅ | Децентрализованные личные сообщения NIP-04 | -| 🟣 **Twitch** | ✅ Полностью | ✅ | Чат через подключение IRC | -| 🔷 **Feishu/Lark** | ✅ Полностью | ✅ | Подписка на события через WebSocket | -| 🔵 **Zalo** | ✅ Полностью | ✅ | Zalo Bot API | - -> **Автоопределение:** ClawMetry читает ваш `~/.openclaw/openclaw.json` и отображает только реально настроенные вами каналы. Ручная настройка не требуется. - -## Развёртывание в Docker - -Хотите запустить ClawMetry в контейнере? Не проблема! 🐳 - -**Быстрый старт с Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Пример Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Примечание:** При запуске в Docker смонтируйте каталоги данных и логов вашего агента (например, `~/.openclaw`, `~/.claude`, `~/.codex`), чтобы ClawMetry мог автоматически определить вашу настройку. - -## Требования - -- Python 3.8+ -- Flask (устанавливается автоматически через pip) -- Рантайм ИИ-агента на той же машине: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok или QM (либо смонтированные тома для Docker) -- Linux или macOS - -## Поддержка NemoClaw / OpenShell - -ClawMetry автоматически определяет [NemoClaw](https://github.com/NVIDIA/NemoClaw) — корпоративную обёртку безопасности NVIDIA для OpenClaw, которая запускает агентов внутри изолированных контейнеров OpenShell. - -В большинстве случаев дополнительная настройка не требуется. Демон синхронизации автоматически обнаруживает файлы сессий независимо от того, находятся ли они в `~/.openclaw/` на хосте или внутри контейнера OpenShell. +Годовые планы, Enterprise и актуальные цифры смотрите на +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Ключи лицензии для self-hosted +работают без облака (`clawmetry license`). Точное разделение бесплатных и платных функций +описано в [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -### Как это работает +## Ваши данные остаются на вашей машине -ClawMetry определяет NemoClaw двумя способами: +ClawMetry читает локальные файлы сессий и логи. Ничего не покидает ваш компьютер, пока вы +не запустите `clawmetry connect`. Но даже тогда снимок данных шифруется сквозным шифрованием +с ключом, который никогда не покидает вашу машину, и расшифровывается прямо в вашем браузере. -1. **Определение по бинарнику** — проверяет наличие CLI `nemoclaw` и запускает `nemoclaw status` для получения информации о песочнице -2. **Определение по контейнеру** — сканирует запущенные контейнеры Docker на предмет образов `openshell`, `nemoclaw` или `ghcr.io/nvidia/`, затем читает сессии через смонтированные тома или `docker cp` - -Файлы сессий, синхронизированные из контейнеров NemoClaw, помечаются метаданными `runtime=nemoclaw` и `container_id` в облачной панели, чтобы вы могли с первого взгляда отличить их от обычных сессий OpenClaw. - -### Рекомендуемая настройка: демон синхронизации на ХОСТЕ - -Для наилучшего результата запускайте демон синхронизации ClawMetry на **хост-машине** (а не внутри песочницы). Это позволяет избежать ограничений сетевой политики NemoClaw. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -Демон синхронизации автоматически найдёт сессии внутри любых запущенных контейнеров OpenShell. - -### Опционально: явное имя песочницы - -Если автоопределение не работает, укажите ClawMetry нужную песочницу: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Запуск внутри песочницы (для продвинутых) - -Если вам необходимо запустить демон синхронизации **внутри** песочницы OpenShell, добавьте это правило исходящего трафика в вашу сетевую политику NemoClaw, чтобы он мог обращаться к API приёма ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Примените с помощью: +## Установка ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # затем: clawmetry ``` -### Порты и точки доступа - -| Точка доступа | Порт | Протокол | Обязательно | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Да (демон синхронизации → облако) | -| `localhost:8900` | 8900 | HTTP | Да (локальный интерфейс панели) | -| Сокет Docker (`/var/run/docker.sock`) | — | Unix-сокет | Для обнаружения сессий в контейнерах | - -Демон синхронизации выполняет только исходящие вызовы HTTPS к `ingest.clawmetry.com`. Входящие порты не требуются. - ---- - -## Развёртывание в облаке - -См. **[Руководство по тестированию в облаке](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** для SSH-туннелей, обратного прокси и Docker. - -## Тестирование +Или одной командой: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -Этот проект тестируется с помощью BrowserStack. +Требуется Python 3.8+ на macOS, Linux или Windows, а также хотя бы одна среда выполнения агента +на той же машине. Инструкции по Docker: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## Документация -## Телеметрия +| | | +|---|---| +| [Совместимость сред выполнения](docs/compatibility.md) | Что читает каждый адаптер и как добавить новую среду выполнения | +| [Права доступа (Entitlements)](docs/ENTITLEMENTS.md) | Бесплатное и платное, матрица тарифов, CLI для лицензий | +| [Согласования и политики](docs/APPROVALS.md) | Проверка перед выполнением, оценка риска, согласования с телефона | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Экспорт трейсов куда угодно, приём OTLP откуда угодно | +| [Отслеживание SDK](docs/SDK_TRACKING.md) | Учёт расходов для агентов, собранных вами самостоятельно | +| [Чат-каналы](docs/CHANNELS.md) | Адаптеры чатов, отображаемые во Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Изолированные (sandboxed) настройки NVIDIA NemoClaw | +| [Docker](docs/DOCKER.md) | Образ, compose, монтирование томов | +| [Архитектура](ARCHITECTURE.md) · [Разработка](docs/DEVELOPMENT.md) | Как всё устроено внутри; запуск из исходников | +| [Телеметрия](docs/TELEMETRY.md) | Анонимные пинги при установке и открытии приложения и как их отключить | -ClawMetry отправляет анонимные пинги жизненного цикла установки на -`https://app.clawmetry.com/api/install`: один пинг `install` при первом -запуске CLI `clawmetry` на новой машине, один пинг `update` -при первом запуске после обновления до новой версии и один пинг `onboarded`, -когда вы завершаете выбор в мастере первого запуска панели. Мы используем это -для подсчёта реальных установок (сырые цифры загрузок PyPI примерно на 98% состоят из зеркал, CI -и повторных загрузок автообновления) и для того, чтобы узнать, какие фреймворки агентов и -версии реально используются. +## Скриншоты -**Не более одного POST-запроса на событие жизненного цикла на версию**, содержащего: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: токены, сессии, здоровье системы | **Brain**: живой поток событий агента | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Расходы**: по моделям и сессиям | **Approvals**: контроль рискованных вызовов инструментов | -| Поле | Пример | Зачем | -|---|---|---| -| `install_id` | случайный UUID, хранящийся в `~/.clawmetry/install_id` | дедупликация; анонимно, пока вы явно не подключите синхронизацию с облаком (тогда аутентифицированный heartbeat демона несёт этот идентификатор, связывая эту установку с вашим аккаунтом) | -| `event` | `install` / `update` / `onboarded` | новая установка или обновление существующей | -| `version` | `0.12.167` | какие версии реально используются | -| `os` / `os_version` | `Darwin` / `25.3.0` | приоритеты поддержки платформ | -| `python` | `3.11.15` | матрица поддержки версий Python | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | с какими агентами нам стоит интегрироваться дальше | -| `is_ci` / `ci_provider` | `true` / `github_actions` | отделение установок реальными людьми от шума CI | - -**Чего мы НЕ отправляем**: IP-адрес (облако определяет код страны на стороне сервера -из запроса, а затем отбрасывает IP), имя хоста, имя пользователя, путь к рабочему -пространству, содержимое файлов, ваш api_key, ваш email, что-либо являющееся ПДн или -специфичное для рабочего пространства. Передаваемая нагрузка доступна для аудита в -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Отказаться** (любой из этих вариантов отключает это навсегда): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -Сбой сети здесь никогда не блокирует запуск `clawmetry` — пинг -отправляется в фоновом потоке демона по принципу "отправил и забыл" с таймаутом 3 с. +Больше скриншотов по каждой среде выполнения: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## История звёзд @@ -436,11 +114,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## Лицензия -MIT - ---- +MIT · Разработано [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Смотрите, как думает ваш агент
- Создано @vivekchand · clawmetry.com · часть экосистемы OpenClaw -

+ diff --git a/docs/i18n/sv/README.md b/docs/i18n/sv/README.md index 26097439f4..09fc043b78 100644 --- a/docs/i18n/sv/README.md +++ b/docs/i18n/sv/README.md @@ -1,17 +1,16 @@ - + > Svenska translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Se din agent tänka.** Realtidsövervakning för **20 AI-agentmiljöer**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex och 16 till. En instrumentpanel för hela din agentflotta. +**Se din agent tänka.** Realtidsobservabilitet för **23 AI-agentkörmiljöer**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex och 19 till. En instrumentpanel för hela din agentflotta. > 🌐 **Läs detta på:** [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) · [fler →](docs/i18n/) @@ -21,406 +20,89 @@ Ett kommando. Ingen konfiguration. Upptäcker allt automatiskt. pip install clawmetry && clawmetry ``` -Öppnas på **http://localhost:8900** och du är klar. +Öppnas på **http://localhost:8900**. Ingen konfiguration: den hittar de agentkörmiljöer +du redan har, läser dem skrivskyddat, och ändrar inget i hur de körs. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## Fungerar med 20 agentmiljöer - -ClawMetry började som observability för OpenClaw och mäter nu **hela din agentflotta** i en instrumentpanel, med automatisk detektering av varje miljö på din maskin: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw och NemoClaw är gratis i open source-appen; de övriga miljöerna aktiveras med ClawMetry Cloud eller en självhostad Pro-licens. Byt miljö från sidhuvudet, så omfattas varje flik, kostnad, tokens, verktyg, spårningar, om den valda miljön. Se **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** för den exakta gratis-/betaluppdelningen, nivåmatrisen, formen på `/api/entitlement` och CLI-kommandot `clawmetry license`. - -## Vad du får - -- **Flow** — Levande animerat diagram som visar meddelanden flöda genom kanaler, hjärna, verktyg och tillbaka -- **Overview** — Hälsokontroller, aktivitetsvärmekarta, sessionsantal, modellinformation -- **Usage** — Spårning av tokens och kostnad med dagliga/veckovisa/månatliga uppdelningar -- **Sessions** — Aktiva agentsessioner med modell, tokens, senaste aktivitet -- **Crons** — Schemalagda jobb med status, nästa körning, varaktighet -- **Logs** — Färgkodad realtidslogg-strömning -- **Memory** — Bläddra i SOUL.md, MEMORY.md, AGENTS.md, dagliga anteckningar -- **Transcripts** — Chattbubble-gränssnitt för att läsa sessionshistorik -- **Alerts** — Budgettak, felfrekvens-utlösare, agent-offline-detektering; dirigeras till Slack, Discord, PagerDuty, Telegram, e-post -- **Approvals** — Blockera destruktiva raderingar, force pushes, DB-mutationer, sudo, paketinstallationer, nätverksanrop bakom en enda klicksignering - -## Skärmdumpar - -### 🧠 Brain — Live-agentens händelseström -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Tokenanvändning och sessionssammanfattning -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Realtidsflöde av verktygsanrop -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Kostnadsuppdelning per modell och session -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Filbläddrare för arbetsytan -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Säkerhetsläge och granskningslogg -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — Budgettak, felfrekvens-utlösare, webhooks till Slack / Discord / PagerDuty / e-post -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — Blockera riskfyllda verktygsanrop bakom manuell signering; policybaserade skyddsregler -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Blockering före körning för Claude Code** — ett kommando installerar en -PreToolUse-hook som pausar matchande verktygsanrop *innan* de körs och väntar -på ditt beslut (ett tryck från din telefon med -[molnpushnotiser](https://app.clawmetry.com/push) aktiverade): - -```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 -``` - -Ett avslag blockerar bara det enskilda verktygsanropet, agenten behåller sin session och kan -prova ett annat tillvägagångssätt. Att godkänna på telefonen hoppar över Claude Codes egen -behörighetsprompt (du har redan svarat). Icke-matchande verktyg kostar ~40 ms och -faller igenom till Claude Codes normala behörighetsflöde. Du får också en telefonpush när Claude Code självt väntar på dig (`permission_prompt`- / -`idle_prompt`-notiser). - -## Installation - -**En rad (rekommenderas):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**Från källkod:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` - -## v2-frontendutveckling - -v2 React-appen finns i `frontend/` och serveras på `/v2` när Flask- -servern startas med v2 aktiverat. - -Använd två terminaler under utveckling: - -```bash -# Terminal 1: Flask API/server on :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## Fungerar med 23 agentkörmiljöer -```bash -# Terminal 2: Vite dev server on :5173 -cd frontend -nvm use -npm ci -npm run dev -``` +**Gratis i appen med öppen källkod:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -Öppna `http://localhost:5173/v2/`. Vite proxar `/api`-anrop till -`http://localhost:8900`, så React-appen kan kommunicera med den lokala Flask-servern -utan extra CORS-konfiguration. +**I en betalplan:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -För att bygga den bundle som levereras med Python-paketet: - -```bash -cd frontend -npm run build -``` +Varje körmiljö får samma instrumentpanel. Kör flera samtidigt så återfokuserar +väljaren i sidhuvudet varje flik till en av dem. -Produktionsbundlen skrivs till `clawmetry/static/v2/dist/`. +Byggde du din egen agent med ett SDK istället? Interceptorn spårar dess LLM-anrop +också. Se [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -## Kompatibilitet med miljöer/agenter +## Vad du får -ClawMetry observerar många AI-agentmiljöer, inte bara OpenClaw. Varje miljö utöver OpenClaw levereras med en dedikerad läsaradapter som översätter dess ursprungliga sessionsformat till ClawMetrys enhetliga format; daemonen matar in dem i samma DuckDB-lager + molninstantavbild, taggade med miljön, och fliken Session replay visar en **miljöväxlare** när fler än en finns. Se [`docs/compatibility.md`](docs/compatibility.md) för den fullständiga matrisen + en guide till hur man lägger till miljöer, och [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) för en introduktion till OpenClaw-familjen. +- **Sessioner och transkript**: vad varje agent gjorde, tur för tur, med uppspelning +- **Kostnad och tokens**: per körmiljö, modell, session och dag, med anomaliflaggor +- **Flow**: livediagram över meddelanden som rör sig genom kanaler, modeller och verktyg +- **Brain**: händelseströmmen för resonemang och verktygsanrop i realtid +- **Minne och färdigheter**: filerna och färdigheterna som varje körmiljö faktiskt laddade +- **Hälsa och loggar**: disk, minne, felfrekvenser, hastighetsgränser, live-loggström +- **Aviseringar**: budgettak, feltoppar, agent-offline, dirigerat till Slack, Discord, PagerDuty, Telegram, e-post +- **Godkännanden**: pausa riskabla verktygsanrop *innan* de körs och godkänn från din telefon ([hur](docs/APPROVALS.md)) -Kör du [Perplexitys numbat](https://github.com/perplexityai/numbat) agentsäkerhetsverktyg? ClawMetry tar emot dess resultat och tillämpningsbeslut direkt ur lådan, se [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Prissättning -| Miljö/agent | Status | Anteckningar | +| Plan | Vad den täcker | Pris | |---|---|---| -| **OpenClaw** | Inbyggd | Referensmiljö, upptäcks automatiskt | -| **PicoClaw** | Beta-adapter | Platt `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`). Transkript, modell, verktygsanrop. | -| **NanoClaw** | Beta-adapter | SQLite per session (`data/v2-sessions`). Transkript + meddelandeantal. | -| **Hermes** | Beta-adapter | SQLite `~/.hermes/state.db`. Transkript, modell, tokens/kostnad. | -| **Claude Code** | Beta-adapter | JSONL `~/.claude/projects/.../.jsonl`. Transkript, modell, verktygsanrop + tankeprocess, tokenanvändning. | -| **Codex** | Beta-adapter | Rollout-JSONL `~/.codex/sessions/...`. Transkript, modell, verktygsanrop, tokenanvändning. | -| **Cursor** | Beta-adapter | SQLite `state.vscdb`. Chatt-/composer-transkript, modell. | -| **Aider** | Beta-adapter | `.aider.chat.history.md` per projekt. Transkript, modell, tokenantal. | -| **Goose** | Beta-adapter | SQLite `~/.local/share/goose`. Transkript, modell, verktygsanrop, tokentotaler. | -| **opencode** | Beta-adapter | SQLite `~/.local/share/opencode`. Transkript, modell, verktygsanrop, tokens + kostnad. | -| **Qwen Code** | Beta-adapter | JSONL `~/.qwen/projects/.../chats`. Transkript, modell, verktygsanrop, tokenanvändning. | -| **Pi** | Beta-adapter | JSONL `~/.pi/agent/sessions`. Transkript, modell, verktygsanrop, tokens + kostnad. | -| **Deep Agents** | Beta-adapter | SQLite `~/.deepagents/.state/sessions.db`. Transkript, modell, verktygsanrop, tokens + kostnad. | -| **n8n** | Beta-adapter | SQLite `~/.n8n/database.sqlite`. Arbetsflödeskörningar, nodkörningar, AI Agent-prompter, modell + tokens där n8n registrerar dem. | -| **Antigravity** | Beta-adapter | Brain-JSONL under `~/.gemini//brain/`. Konversationer, verktygssteg, tankeprocess, per-generation Gemini-tokenuppdelning + kostnad, bakgrundsgenereringsförbrukning. | -| **GitHub Copilot** | Beta-adapter | Copilot CLI:s `events.jsonl` under `~/.copilot/session-state/` + `session-store.db`-liggaren för användning per anrop. Konversationer, verktygsanrop, modellroutning, cache-medveten tokenuppdelning, leverantörsfakturerad AI-kreditkostnad. | -| **Grok** | Beta-adapter | xAI Grok Build CLI (Rust-binär under `~/.grok/bin/grok`): global händelselogg `~/.grok/logs/unified.jsonl` + per session `~/.grok/sessions///{events.jsonl,summary.json}`. Konversationer, tokenuppdelning per tur, modellroutning, och CLI:ns utgående repo-nyttolast lagrad under `~/.grok/upload_queue/` så du kan se vad som lämnat din maskin. | - -"Beta-adapter" innebär att ClawMetry levererar en läsare för den miljöns faktiska format på disk, var och en byggd + verifierad mot en riktig installation på en riktig maskin (se `tests/fixtures/runtimes//`). Adaptrarna är skrivskyddade; var och en är ärlig om vad dess miljö faktiskt lagrar (t.ex. skriver PicoClaw/NanoClaw/Cursor inte tokenkostnad till disk). När flera miljöer körs på en nod avgränsar miljöväxlaren sessionsvyn till en för en ren djupdykning. - -## Spåra vilken SDK-agent som helst, kostnadsattribuering utanför loopen - -Miljöerna ovan skriver alla sessioner till disk. Din egen **produktionsagent** — den du byggde på OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, eller en vanlig `httpx`-loop — gör det inte. ClawMetrys konfigurationsfria interceptor fångar ändå dess LLM-anrop (kostnad, tokens, latens, fel) genom att monkey-patcha `httpx`/`requests`: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (eller miljövariabeln `CLAWMETRY_SOURCE=support-agent`) taggar varje anrop med en **namngiven källa**, så varje produkt du kör dyker upp som sin egen förstklassiga, kostnadsattribuerbara rad i instrumentpanelens kort **🔌 Out-loop sources** på Overview, anrop, leverantörer, latens, felfrekvens per agent. Ingen källa angiven? Anropen spåras ändå, kortet förblir bara dolt. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Detta är samma datalager som miljöadaptrarna matar (DuckDB → molninstantavbild), så out-loop-källor synkroniseras till molninstrumentpanelen precis som allt annat, ände-till-ände-krypterat. - -## OpenTelemetry, leverantörsneutralt, skicka dina spårningar vart som helst - -ClawMetry talar **OpenTelemetry** i båda riktningarna, med **GenAI-semantiska konventioner**, så dina agentspårningar blir aldrig inlåsta i ett enda verktyg. - -**Exportera** varje session — LLM-anrop, verktyg, undersagenter, tokens, kostnad — som OTLP/HTTP GenAI-spans till valfri samlare (Datadog, Grafana, Honeycomb, eller din egen OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Autentiseringshuvuden och pollintervall är valfria miljövariabler: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**Ta emot** — den inbyggda OTLP-mottagaren tar emot spårningar, loggar och mätvärden från vad som helst annat på `/v1/traces`, `/v1/logs` och `/v1/metrics`. Peka valfri OpenTelemetry-instrumenterad app mot den: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON-spårningar och loggar fungerar med en vanlig `pip install clawmetry`, inga tillägg krävs. Protobuf-mottagning (och OTLP/JSON-mätvärden) kräver `pip install clawmetry[otel]`. En app som anger sitt eget `service.name` visas som sin egen agent i miljöväxlaren, med sin kostnad och sina tokens. - -Du får den konfigurationsfria, lokalt-först ClawMetry-instrumentpanelen **och** dina data i vilken backend ditt team redan kör, ingen inlåsning, ingen andra agent att installera. - -## Konfiguration - -De flesta behöver ingen konfiguration alls. ClawMetry upptäcker automatiskt din arbetsyta, loggar, sessioner och cron-jobb. - -Om du behöver anpassa: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -Alla alternativ: `clawmetry --help` - -## Kanaler som stöds - -ClawMetry visar live-aktivitet för varje OpenClaw-kanal du har konfigurerat. Endast kanaler som faktiskt är konfigurerade i din `openclaw.json` visas i Flow-diagrammet, okonfigurerade döljs automatiskt. - -Klicka på valfri kanalnod i Flow för att se en live chattbubblevy med antal inkommande/utgående meddelanden. - -| Kanal | Status | Live-popup | Anteckningar | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Fullständig | ✅ | Meddelanden, statistik, 10 s uppdatering | -| 💬 **iMessage** | ✅ Fullständig | ✅ | Läser `~/Library/Messages/chat.db` direkt | -| 💚 **WhatsApp** | ✅ Fullständig | ✅ | Via WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Fullständig | ✅ | Via signal-cli | -| 🟣 **Discord** | ✅ Fullständig | ✅ | Detektering av gilde + kanal | -| 🟪 **Slack** | ✅ Fullständig | ✅ | Detektering av arbetsyta + kanal | -| 🌐 **Webchat** | ✅ Fullständig | ✅ | Inbyggda webbgränssnitt-sessioner | -| 📡 **IRC** | ✅ Fullständig | ✅ | Terminalliknande bubbelgränssnitt | -| 🍏 **BlueBubbles** | ✅ Fullständig | ✅ | iMessage via BlueBubbles REST API | -| 🔵 **Google Chat** | ✅ Fullständig | ✅ | Via Chat API-webhooks | -| 🟣 **MS Teams** | ✅ Fullständig | ✅ | Via Teams-bottillägg | -| 🔷 **Mattermost** | ✅ Fullständig | ✅ | Självhostad teamchatt | -| 🟩 **Matrix** | ✅ Fullständig | ✅ | Decentraliserad, stöd för E2EE | -| 🟢 **LINE** | ✅ Fullständig | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Fullständig | ✅ | Decentraliserade NIP-04-DM | -| 🟣 **Twitch** | ✅ Fullständig | ✅ | Chatt via IRC-anslutning | -| 🔷 **Feishu/Lark** | ✅ Fullständig | ✅ | WebSocket-händelseprenumeration | -| 🔵 **Zalo** | ✅ Fullständig | ✅ | Zalo Bot API | - -> **Automatisk detektering:** ClawMetry läser din `~/.openclaw/openclaw.json` och renderar bara de kanaler du faktiskt har konfigurerat. Ingen manuell konfiguration krävs. - -## Docker-distribution - -Vill du köra ClawMetry i en container? Inga problem! 🐳 - -**Snabbstart med Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose-exempel:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Obs:** När du kör i Docker, montera din agents data- och loggkataloger (t.ex. `~/.openclaw`, `~/.claude`, `~/.codex`) så att ClawMetry kan upptäcka din konfiguration automatiskt. - -## Krav - -- Python 3.8+ -- Flask (installeras automatiskt via pip) -- En AI-agentmiljö på samma maskin: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, eller QM (eller monterade volymer för Docker) -- Linux eller macOS - -## NemoClaw/OpenShell-stöd - -ClawMetry upptäcker automatiskt [NemoClaw](https://github.com/NVIDIA/NemoClaw), NVIDIAs säkerhetsomslag för företag runt OpenClaw som kör agenter inuti sandboxade OpenShell-containrar. - -Ingen extra konfiguration behövs i de flesta fall. Sync-daemonen upptäcker automatiskt sessionsfiler oavsett om de finns i `~/.openclaw/` på värden eller inuti en OpenShell-container. +| **Free** | OpenClaw + NVIDIA NemoClaw, fullständig instrumentpanel, endast lokalt | 0 $ | +| **Starter** | Alla andra körmiljöer ovan, flottvy, molnsynkronisering | 9 $ per nod/månad | +| **Pro** | Starter + styrning: godkännanden, verktygsriskpolicyer, utvärderingar, anomalidetektering, kostnadsoptimerare, OTel-export | 19 $ per nod/månad | -### Så fungerar det +Årsplaner, Enterprise och de aktuella siffrorna finns på +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Självhostade licensnycklar +fungerar utan molnet (`clawmetry license`). Den exakta gränsen mellan gratis och betalt finns i +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -ClawMetry upptäcker NemoClaw på två sätt: +## Din data stannar på din maskin -1. **Binärdetektering** — kontrollerar om `nemoclaw`-CLI:t finns och kör `nemoclaw status` för att hämta sandboxinformation -2. **Containerdetektering** — skannar körande Docker-containrar efter `openshell`-, `nemoclaw`- eller `ghcr.io/nvidia/`-avbildningar, och läser sedan sessioner via volymmonteringar eller `docker cp` +ClawMetry läser lokala sessionsfiler och loggar. Inget lämnar din maskin om du inte +kör `clawmetry connect`. Även då är ögonblicksbilden totalsträckskrypterad +med en nyckel som aldrig lämnar din maskin, och dekrypteras i din webbläsare. -Sessionsfiler synkroniserade från NemoClaw-containrar taggas med `runtime=nemoclaw` och `container_id`-metadata i molninstrumentpanelen, så du kan skilja dem från vanliga OpenClaw-sessioner med en blick. - -### Rekommenderad konfiguration: sync-daemon på VÄRDEN - -För bästa upplevelse, kör ClawMetrys sync-daemon på **värdmaskinen** (inte inuti sandboxen). Detta undviker NemoClaws nätverkspolicybegränsningar. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -Sync-daemonen hittar automatiskt sessioner inuti alla körande OpenShell-containrar. - -### Valfritt: uttryckligt sandboxnamn - -Om automatisk detektering inte fungerar, peka ClawMetry mot rätt sandbox: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Att köra inuti sandboxen (avancerat) - -Om du måste köra sync-daemonen **inuti** OpenShell-sandboxen, lägg till denna utgående regel i din NemoClaw-nätverkspolicy så att den kan nå ClawMetrys ingest-API: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Tillämpa med: +## Installation ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # sedan: clawmetry ``` -### Portar och slutpunkter - -| Slutpunkt | Port | Protokoll | Krävs | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Ja (sync-daemon → moln) | -| `localhost:8900` | 8900 | HTTP | Ja (lokal instrumentpanel-UI) | -| Docker-sockel (`/var/run/docker.sock`) | — | Unix-sockel | För upptäckt av containersessioner | - -Sync-daemonen gör bara utgående HTTPS-anrop till `ingest.clawmetry.com`. Inga inkommande portar krävs. - ---- - -## Molndistribution - -Se **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** för SSH-tunnlar, omvänd proxy och Docker. - -## Testning - -Detta projekt testas med BrowserStack. +Eller en rad: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +Kräver Python 3.8+ på macOS, Linux eller Windows, och minst en agentkörmiljö på +samma maskin. Docker-instruktioner: [docs/DOCKER.md](docs/DOCKER.md). -## Telemetri +## Dokumentation -ClawMetry skickar anonyma pingar för installationslivscykeln till -`https://app.clawmetry.com/api/install`: en `install`-ping första -gången du kör `clawmetry`-CLI:t på en ny maskin, en `update`-ping -första körningen efter en uppgradering till en ny version, och en `onboarded`- -ping när du slutför onboarding-valet i instrumentpanelen. Vi använder detta -för att räkna faktiska installationer (rå PyPI-nedladdningsstatistik är ~98 % speglingar, CI -och automatiska nedladdningar vid uppdatering) och för att lära oss vilka agentramverk och -versioner som faktiskt används. +| | | +|---|---| +| [Kompatibilitet för körmiljöer](docs/compatibility.md) | Vad varje adapter läser, och hur man lägger till en körmiljö | +| [Rättigheter](docs/ENTITLEMENTS.md) | Gratis kontra betalt, nivåmatris, licens-CLI | +| [Godkännanden och policyer](docs/APPROVALS.md) | Förhandsgranskning innan körning, riskbedömning, godkännanden via telefon | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Exportera spårningar överallt, hämta OTLP från vad som helst | +| [SDK-spårning](docs/SDK_TRACKING.md) | Kostnadsattribuering för agenter du byggt själv | +| [Chattkanaler](docs/CHANNELS.md) | Chattadaptrarna som visas i Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Sandboxade NVIDIA NemoClaw-uppsättningar | +| [Docker](docs/DOCKER.md) | Avbildning, compose, volymmonteringar | +| [Arkitektur](ARCHITECTURE.md) · [Utveckling](docs/DEVELOPMENT.md) | Hur det fungerar invändigt; köra från källkod | +| [Telemetri](docs/TELEMETRY.md) | De anonyma pingarna för installation och skrivbordsöppning, och hur man stänger av dem | -**Högst en POST per livscykelhändelse per version**, innehållande: - -| Fält | Exempel | Varför | -|---|---|---| -| `install_id` | slumpmässig UUID lagrad i `~/.clawmetry/install_id` | avdubblering; anonymt tills du uttryckligen ansluter Cloud-synk (den autentiserade daemonens hjärtslag bär då med det, och länkar denna installation till ditt konto) | -| `event` | `install` / `update` / `onboarded` | ny installation vs uppgradering av en befintlig | -| `version` | `0.12.167` | vilka versioner som används | -| `os` / `os_version` | `Darwin` / `25.3.0` | prioriteringar för plattformsstöd | -| `python` | `3.11.15` | supportmatris för Python-version | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | vilka agenter vi bör integrera med härnäst | -| `is_ci` / `ci_provider` | `true` / `github_actions` | separerar mänskliga installationer från CI-brus | - -**Vad vi INTE skickar**: IP (molnet härleder landskoden server-side -från förfrågan och kasserar sedan IP:n), värdnamn, användarnamn, sökväg till arbetsyta, filinnehåll, din api_key, din e-post, något som är PII eller -specifikt för arbetsytan. Nyttolasten som skickas kan granskas i -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Avaktivera** (valfri av dessa inaktiverar det permanent): +## Skärmdumpar -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: tokens, sessioner, hälsa | **Brain**: live agenthändelseström | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: per modell och session | **Approvals**: spärra riskabla verktygsanrop | -Ett nätverksfel här blockerar aldrig `clawmetry` från att köra, pingen -är fire-and-forget på en daemon-tråd med en timeout på 3 s. +Fler, per körmiljö: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Stjärnhistorik @@ -434,11 +116,6 @@ Ett nätverksfel här blockerar aldrig `clawmetry` från att köra, pingen ## Licens -MIT - ---- +MIT · Byggd av [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Se din agent tänka
- Byggd av @vivekchand · clawmetry.com · Del av OpenClaw-ekosystemet -

+ diff --git a/docs/i18n/ta/README.md b/docs/i18n/ta/README.md index 829d23362d..644a320a2e 100644 --- a/docs/i18n/ta/README.md +++ b/docs/i18n/ta/README.md @@ -1,429 +1,103 @@ - + > தமிழ் translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**உங்கள் ஏஜென்ட் சிந்திப்பதைப் பாருங்கள்.** **20 AI ஏஜென்ட் ரன்டைம்களுக்கான** நிகழ்நேர கண்காணிப்பு: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex மற்றும் மேலும் 16. உங்கள் முழு ஏஜென்ட் கூட்டத்திற்கும் ஒரே டாஷ்போர்டு. +**உங்கள் ஏஜென்ட் சிந்திப்பதைப் பாருங்கள்.** **23 AI ஏஜென்ட் ரன்டைம்களுக்கான** நேரடி (real-time) கண்காணிப்பு: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex மற்றும் மேலும் 19. உங்கள் முழு ஏஜென்ட் கூட்டத்திற்கும் ஒரே டாஷ்போர்டு. -> 🌐 **இதை இதில் படிக்கவும்:** [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/) +> 🌐 **இதை படிக்க:** [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** இல் திறக்கும், அவ்வளவே. +**http://localhost:8900** இல் திறக்கும். கட்டமைப்பு தேவையில்லை: நீங்கள் ஏற்கெனவே வைத்திருக்கும் ஏஜென்ட் ரன்டைம்களை அது கண்டறிந்து, அவற்றை படிக்க-மட்டும் (read-only) அணுகி, அவை இயங்கும் விதத்தில் எதையும் மாற்றாது. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 20 ஏஜென்ட் ரன்டைம்களுடன் இயங்குகிறது - -ClawMetry OpenClaw-க்கான கண்காணிப்பாகத் தொடங்கியது, இப்போது உங்கள் **முழு ஏஜென்ட் கூட்டத்தையும்** ஒரே டாஷ்போர்டில் அளவிடுகிறது, உங்கள் இயந்திரத்தில் உள்ள ஒவ்வொரு ரன்டைமையும் தானாக கண்டறிகிறது: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw மற்றும் NemoClaw ஓபன்-சோர்ஸ் ஆப்பில் இலவசம்; மற்ற ரன்டைம்கள் ClawMetry Cloud அல்லது சுய-ஹோஸ்ட் செய்யப்பட்ட Pro உரிமத்துடன் இயங்கும். ஹெடரிலிருந்து ரன்டைம்களை மாற்றவும், ஒவ்வொரு டேபும் - செலவு, டோக்கன்கள், கருவிகள், ட்ரேஸ்கள் - அந்த ரன்டைமிற்கு மறுஅளவிடப்படும். சரியான இலவச/கட்டண பிரிவு, டையர் மேட்ரிக்ஸ், `/api/entitlement` வடிவம், மற்றும் `clawmetry license` CLI ஆகியவற்றிற்கு **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** ஐப் பார்க்கவும். - -## நீங்கள் பெறுவது என்ன - -- **Flow** — சேனல்கள், மூளை, கருவிகள் வழியாக செய்திகள் பாய்வதையும் திரும்பி வருவதையும் காட்டும் நேரடி அனிமேட்டட் வரைபடம் -- **Overview** — ஆரோக்கிய சோதனைகள், செயல்பாட்டு ஹீட்மேப், அமர்வு எண்ணிக்கைகள், மாடல் தகவல் -- **Usage** — தினசரி/வாராந்திர/மாதாந்திர பிரிவுகளுடன் டோக்கன் மற்றும் செலவு கண்காணிப்பு -- **Sessions** — மாடல், டோக்கன்கள், கடைசி செயல்பாடு ஆகியவற்றுடன் செயலில் உள்ள ஏஜென்ட் அமர்வுகள் -- **Crons** — நிலை, அடுத்த இயக்கம், கால அளவுடன் திட்டமிடப்பட்ட வேலைகள் -- **Logs** — வண்ண-குறியிடப்பட்ட நிகழ்நேர பதிவு ஸ்ட்ரீமிங் -- **Memory** — SOUL.md, MEMORY.md, AGENTS.md, தினசரி குறிப்புகளை உலாவவும் -- **Transcripts** — அமர்வு வரலாறுகளைப் படிக்க சாட்-பபிள் UI -- **Alerts** — பட்ஜெட் வரம்புகள், பிழை-விகித தூண்டுதல்கள், ஏஜென்ட்-ஆஃப்லைன் கண்டறிதல்; Slack, Discord, PagerDuty, Telegram, Email க்கு வழிநடத்துகிறது -- **Approvals** — அழிவூட்டும் நீக்கல்கள், ஃபோர்ஸ் புஷ்கள், DB மாற்றங்கள், sudo, தொகுப்பு நிறுவல்கள், நெட்வொர்க் அழைப்புகளை ஒரே-கிளிக் ஒப்புதலுக்குப் பின்னால் தடுக்கும் - -## ஸ்கிரீன்ஷாட்கள் - -### 🧠 Brain — நேரடி ஏஜென்ட் நிகழ்வு ஸ்ட்ரீம் -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — டோக்கன் பயன்பாடு மற்றும் அமர்வு சுருக்கம் -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — நிகழ்நேர கருவி அழைப்பு ஃபீட் -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — மாடல் மற்றும் அமர்வு வாரியான செலவு பிரிவு -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — பணியிட கோப்பு உலாவி -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — நிலைப்பாடு மற்றும் தணிக்கை பதிவு -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — பட்ஜெட் வரம்புகள், பிழை-விகித தூண்டுதல்கள், Slack / Discord / PagerDuty / Email க்கு வெப்ஹூக்குகள் -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +## 23 ஏஜென்ட் ரன்டைம்களுடன் இயங்குகிறது -### ✋ Approvals — ஆபத்தான கருவி அழைப்புகளை கைமுறை ஒப்புதலுக்குப் பின்னால் தடுக்கவும்; கொள்கை-ஆதரவு பாதுகாப்பு விதிகள் -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) +**ஓபன் சோர்ஸ் ஆப்பில் இலவசம்:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -**Claude Code-க்கான செயல்படுத்தலுக்கு முந்தைய தடுப்பு** — ஒரே கட்டளை ஒரு -PreToolUse ஹூக்கை நிறுவுகிறது, இது பொருந்தும் கருவி அழைப்புகளை அவை இயங்குவதற்கு *முன்பே* -இடைநிறுத்தி உங்கள் முடிவுக்காக காத்திருக்கும் (உங்கள் ஃபோனிலிருந்து ஒரே தட்டல், -[cloud push notifications](https://app.clawmetry.com/push) இயக்கப்பட்டிருந்தால்): +**கட்டணத் திட்டத்தில்:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -```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-இன் சொந்த -அனுமதி வேண்டுகோளைத் தவிர்க்கிறது (நீங்கள் ஏற்கனவே பதிலளித்துவிட்டீர்கள்). பொருந்தாத கருவிகள் ~40ms -செலவழிக்கும், மேலும் 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 ஃப்ரண்ட்எண்ட் மேம்பாடு +ஒரு SDK-யில் உங்கள் சொந்த ஏஜென்டை உருவாக்கினீர்களா? இன்டர்செப்டர் அதன் LLM அழைப்புகளையும் கண்காணிக்கும். பார்க்க [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -v2 React ஆப் `frontend/` இல் உள்ளது, மேலும் v2 இயக்கப்பட்ட நிலையில் -Flask சர்வர் தொடங்கும்போது `/v2` இல் வழங்கப்படுகிறது. +## உங்களுக்குக் கிடைப்பவை -மேம்பாட்டின்போது இரண்டு டெர்மினல்களைப் பயன்படுத்தவும்: +- **அமர்வுகள் & டிரான்ஸ்கிரிப்ட்கள் (Sessions & transcripts)**: ஒவ்வொரு ஏஜென்டும் என்ன செய்தது, ஒவ்வொரு முறையாக, ரீப்ளேயுடன் +- **செலவு & டோக்கன்கள் (Cost & tokens)**: ரன்டைம், மாடல், அமர்வு மற்றும் நாள் வாரியாக, முரண்பாட்டு (anomaly) குறிகளுடன் +- **ஃப்ளோ (Flow)**: சேனல்கள், மாடல்கள் மற்றும் கருவிகள் வழியாக செல்லும் செய்திகளின் நேரடி வரைபடம் +- **பிரெயின் (Brain)**: நடக்கும் போதே தர்க்க மற்றும் கருவி-அழைப்பு நிகழ்வு ஸ்ட்ரீம் +- **நினைவகம் & திறன்கள் (Memory & skills)**: ஒவ்வொரு ரன்டைமும் உண்மையில் லோட் செய்த கோப்புகள் மற்றும் திறன்கள் +- **ஆரோக்கியம் & பதிவுகள் (Health & logs)**: டிஸ்க், நினைவகம், பிழை விகிதங்கள், rate limits, நேரடி பதிவு ஸ்ட்ரீம் +- **எச்சரிக்கைகள் (Alerts)**: பட்ஜெட் வரம்புகள், பிழை எழுச்சிகள், ஏஜென்ட்-ஆஃப்லைன், Slack, Discord, PagerDuty, Telegram, மின்னஞ்சலுக்கு அனுப்பப்படும் +- **அனுமதிகள் (Approvals)**: அபாயகரமான கருவி அழைப்புகளை அவை இயங்குவதற்கு *முன்* இடைநிறுத்தி, உங்கள் மொபைலிலிருந்தே அனுமதி வழங்கவும் ([எப்படி](docs/APPROVALS.md)) -```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 ஆப் கூடுதல் -CORS அமைப்பு இல்லாமல் லோக்கல் Flask சர்வருடன் தொடர்பு கொள்ள முடியும். - -Python தொகுப்புடன் அனுப்பப்படும் பண்டிலைக் கட்டமைக்க: - -```bash -cd frontend -npm run build -``` - -உற்பத்தி பண்டில் `clawmetry/static/v2/dist/` இல் எழுதப்படுகிறது. - -## ரன்டைம் / ஏஜென்ட் இணக்கத்தன்மை - -ClawMetry OpenClaw மட்டுமல்ல, பல AI-ஏஜென்ட் ரன்டைம்களையும் கண்காணிக்கிறது. ஒவ்வொரு OpenClaw-அல்லாத ரன்டைமும் அதன் சொந்த அமர்வு வடிவமைப்பை ClawMetry-இன் ஒருங்கிணைந்த வடிவங்களாக மொழிபெயர்க்கும் ஒரு பிரத்யேக ரீடர் அடாப்டரை வழங்குகிறது; டீமன் அவற்றை அதே DuckDB ஸ்டோர் + கிளவுட் ஸ்னாப்ஷாட்டில் உள்ளீடு செய்கிறது, ரன்டைமுடன் குறியிடப்பட்டு, மேலும் ஒன்றுக்கு மேற்பட்ட ரன்டைம்கள் இருக்கும்போது Session replay டேப் ஒரு **ரன்டைம் மாற்றியை** காட்டுகிறது. முழு மேட்ரிக்ஸ் + ரன்டைம்களைச் சேர்ப்பதற்கான வழிகாட்டிக்கு [`docs/compatibility.md`](docs/compatibility.md) ஐயும், OpenClaw-குடும்ப அறிமுகத்திற்கு [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) ஐயும் பார்க்கவும். - -[Perplexity-இன் numbat](https://github.com/perplexityai/numbat) ஏஜென்ட்-பாதுகாப்பு கருவியை இயக்குகிறீர்களா? ClawMetry அதன் கண்டுபிடிப்புகள் மற்றும் அமலாக்க முடிவுகளை உடனடியாக உள்ளீடு செய்கிறது — [`docs/NUMBAT.md`](docs/NUMBAT.md) ஐப் பார்க்கவும். - -| ரன்டைம் / ஏஜென்ட் | நிலை | குறிப்புகள் | +| திட்டம் | எதை உள்ளடக்கியது | விலை | |---|---|---| -| **OpenClaw** | சொந்தமானது | குறிப்பு ரன்டைம், தானாக கண்டறியப்படுகிறது | -| **PicoClaw** | பீட்டா அடாப்டர் | Flat `providers.Message` JSONL (`~/.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`. Workflow இயக்கங்கள், நோட் ரன்கள், AI Agent ப்ராம்ப்ட்கள், n8n பதிவு செய்யும் இடங்களில் மாடல் + டோக்கன்கள். | -| **Antigravity** | பீட்டா அடாப்டர் | `~/.gemini//brain/` க்குக் கீழே Brain JSONL. உரையாடல்கள், கருவி படிகள், சிந்தனை, ஒவ்வொரு-உருவாக்கத்திற்கான Gemini டோக்கன் பிரிவு + செலவு, பின்னணி-உருவாக்க எரிப்பு. | -| **GitHub Copilot** | பீட்டா அடாப்டர் | `~/.copilot/session-state/` இன் கீழ் Copilot CLI `events.jsonl` + ஒவ்வொரு-அழைப்பு பயன்பாட்டு லெட்ஜரான `session-store.db`. உரையாடல்கள், கருவி அழைப்புகள், மாடல் வழிநடத்துதல், கேச்-விழிப்புணர்வு டோக்கன் பிரிவு, விற்பனையாளர்-பில் செய்யப்பட்ட AI-கிரெடிட் செலவு. | -| **Grok** | பீட்டா அடாப்டர் | xAI Grok Build CLI (`~/.grok/bin/grok` இன் கீழ் Rust பைனரி): குளோபல் நிகழ்வு பதிவு `~/.grok/logs/unified.jsonl` + ஒவ்வொரு-அமர்வு `~/.grok/sessions///{events.jsonl,summary.json}`. உரையாடல்கள், ஒவ்வொரு-முறை டோக்கன் பிரிவு, மாடல் வழிநடத்துதல், மற்றும் CLI-இன் வெளிச்செல்லும் ரெப்போ பேலோட் `~/.grok/upload_queue/` இல் நிலைநிறுத்தப்பட்டு, உங்கள் இயந்திரத்திலிருந்து என்ன வெளியேறியது என்பதைப் பார்க்க முடியும். | - -"பீட்டா அடாப்டர்" என்பது ClawMetry அந்த ரன்டைமின் உண்மையான ஆன்-டிஸ்க் வடிவமைப்பிற்கான ரீடரை வழங்குகிறது என்பதைக் குறிக்கிறது, ஒவ்வொன்றும் உண்மையான இயந்திரத்தில் உண்மையான நிறுவலுக்கு எதிராக கட்டமைக்கப்பட்டு + சரிபார்க்கப்பட்டது (`tests/fixtures/runtimes//` ஐப் பார்க்கவும்). அடாப்டர்கள் ரீட்-ஒன்லி; ஒவ்வொன்றும் அதன் ரன்டைம் உண்மையில் என்ன சேமிக்கிறது என்பதில் நேர்மையானது (எ.கா. PicoClaw/NanoClaw/Cursor டோக்கன் செலவை டிஸ்க்கில் எழுதுவதில்லை). ஒரு நோடில் பல ரன்டைம்கள் இயங்கும்போது, ரன்டைம் மாற்றி சுத்தமான ஆழமான ஆய்விற்காக அமர்வுகள் காட்சியை ஒன்றுக்கு அளவிடும். - -## எந்த SDK ஏஜென்டையும் கண்காணிக்கவும் — அவுட்-லூப் செலவு பண்பளிப்பு - -மேலே உள்ள ரன்டைம்கள் அனைத்தும் அமர்வுகளை டிஸ்க்கில் எழுதுகின்றன. நீங்கள் உருவாக்கிய உங்கள் சொந்த **உற்பத்தி ஏஜென்ட்** — OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, அல்லது வெறும் `httpx` லூப் மீது கட்டப்பட்டது — அப்படி எழுதுவதில்லை. ClawMetry-இன் கட்டமைப்பு தேவையில்லாத இன்டர்செப்டர் `httpx`/`requests` ஐ மங்கி-பேட்ச் செய்வதன் மூலம் அதன் LLM அழைப்புகளை (செலவு, டோக்கன்கள், தாமதம், பிழைகள்) இன்னும் பிடிக்கிறது: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (அல்லது `CLAWMETRY_SOURCE=support-agent` சூழல் மாறி) ஒவ்வொரு அழைப்பையும் ஒரு **பெயரிடப்பட்ட மூலத்துடன்** குறியிடுகிறது, எனவே நீங்கள் இயக்கும் ஒவ்வொரு தயாரிப்பும் டாஷ்போர்டின் Overview-இல் உள்ள **🔌 Out-loop sources** கார்டில் அதன் சொந்த முதல்-வகுப்பு, செலவு-பண்பளிக்கக்கூடிய வரியாகத் தோன்றும் — ஒவ்வொரு ஏஜென்டிற்கும் அழைப்புகள், வழங்குநர்கள், தாமதம், பிழை விகிதம். மூலம் அமைக்கப்படவில்லையா? அழைப்புகள் இன்னும் கண்காணிக்கப்படும்; கார்டு மட்டும் மறைந்தே இருக்கும். - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -இது ரன்டைம் அடாப்டர்கள் உள்ளீடு செய்யும் அதே தரவு அடுக்கு (DuckDB → கிளவுட் ஸ்னாப்ஷாட்), எனவே அவுட்-லூப் மூலங்கள் மற்ற அனைத்தையும் போலவே கிளவுட் டாஷ்போர்டுக்கு ஒத்திசைக்கப்படுகின்றன, E2E-குறியாக்கம் செய்யப்பட்டு. - -## OpenTelemetry — விற்பனையாளர்-நடுநிலை, உங்கள் ட்ரேஸ்களை எங்கு வேண்டுமானாலும் அனுப்பவும் - -ClawMetry இரு திசைகளிலும் **OpenTelemetry** பேசுகிறது, **GenAI செமான்டிக் மரபுகளைப்** பயன்படுத்தி, எனவே உங்கள் ஏஜென்ட் ட்ரேஸ்கள் ஒரே ஒரு கருவியில் ஒருபோதும் பூட்டப்படாது. - -**Export** — ஒவ்வொரு அமர்வையும் — LLM அழைப்புகள், கருவிகள், துணை-ஏஜென்ட்கள், டோக்கன்கள், செலவு — எந்த கலெக்டருக்கும் (Datadog, Grafana, Honeycomb, அல்லது உங்கள் சொந்த OTel Collector) OTLP/HTTP GenAI ஸ்பான்களாக: - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -அங்கீகார ஹெடர்கள் மற்றும் போல் இடைவெளி விருப்பமான சூழல் மாறிகள்: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**Ingest** — உள்ளமைக்கப்பட்ட OTLP ரிசீவர் ட்ரேஸ்கள், பதிவுகள், மற்றும் மெட்ரிக்குகளை `/v1/traces`, `/v1/logs`, மற்றும் `/v1/metrics` இல் ஏற்றுக்கொள்கிறது. வேறு எதையும் OpenTelemetry-கருவியமைக்கப்பட்ட ஆப்பை அதை நோக்கி இயக்கவும்: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON ட்ரேஸ்கள் மற்றும் பதிவுகள் வெற்று `pip install clawmetry` இல் கூடுதல் இல்லாமல் வேலை செய்கின்றன. Protobuf ingest (மற்றும் OTLP/JSON மெட்ரிக்குகள்) க்கு `pip install clawmetry[otel]` தேவை. தனது சொந்த `service.name` ஐ அமைக்கும் ஒரு ஆப் ரன்டைம் மாற்றியில் அதன் சொந்த செலவு மற்றும் டோக்கன்களுடன் அதன் சொந்த ஏஜென்டாகத் தோன்றும். - -நீங்கள் கட்டமைப்பு தேவையில்லாத, லோக்கல்-முதல் ClawMetry டாஷ்போர்டையும் **மேலும்** உங்கள் அணி ஏற்கனவே இயக்கும் எந்த பேக்எண்டிலும் உங்கள் தரவையும் பெறுவீர்கள் — பூட்டு இல்லை, இரண்டாவது ஏஜென்ட் நிறுவ வேண்டியதில்லை. - -## கட்டமைப்பு - -பெரும்பாலான மக்களுக்கு கட்டமைப்பு தேவையில்லை. ClawMetry உங்கள் பணியிடம், பதிவுகள், அமர்வுகள், மற்றும் cron-களை தானாக கண்டறிகிறது. - -நீங்கள் தனிப்பயனாக்க வேண்டியிருந்தால்: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -அனைத்து விருப்பங்களும்: `clawmetry --help` - -## ஆதரிக்கப்படும் சேனல்கள் - -நீங்கள் கட்டமைத்துள்ள ஒவ்வொரு OpenClaw சேனலுக்கும் ClawMetry நேரடி செயல்பாட்டைக் காட்டுகிறது. உங்கள் `openclaw.json` இல் உண்மையில் அமைக்கப்பட்ட சேனல்கள் மட்டுமே Flow வரைபடத்தில் தோன்றும் — கட்டமைக்கப்படாதவை தானாக மறைக்கப்படும். - -Flow-இல் எந்த சேனல் நோடையும் கிளிக் செய்து, உள்வரும்/வெளிச்செல்லும் செய்தி எண்ணிக்கைகளுடன் நேரடி சாட் பபிள் காட்சியைப் பார்க்கலாம். - -| சேனல் | நிலை | நேரடி பாப்அப் | குறிப்புகள் | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ முழு | ✅ | செய்திகள், புள்ளிவிவரங்கள், 10வி புதுப்பிப்பு | -| 💬 **iMessage** | ✅ முழு | ✅ | `~/Library/Messages/chat.db` ஐ நேரடியாகப் படிக்கிறது | -| 💚 **WhatsApp** | ✅ முழு | ✅ | WhatsApp Web (Baileys) வழியாக | -| 🔵 **Signal** | ✅ முழு | ✅ | signal-cli வழியாக | -| 🟣 **Discord** | ✅ முழு | ✅ | Guild + சேனல் கண்டறிதல் | -| 🟪 **Slack** | ✅ முழு | ✅ | பணியிடம் + சேனல் கண்டறிதல் | -| 🌐 **Webchat** | ✅ முழு | ✅ | உள்ளமைக்கப்பட்ட வெப் UI அமர்வுகள் | -| 📡 **IRC** | ✅ முழு | ✅ | டெர்மினல்-பாணி பபிள் UI | -| 🍏 **BlueBubbles** | ✅ முழு | ✅ | BlueBubbles REST API வழியாக iMessage | -| 🔵 **Google Chat** | ✅ முழு | ✅ | Chat API வெப்ஹூக்குகள் வழியாக | -| 🟣 **MS Teams** | ✅ முழு | ✅ | Teams bot ப்ளகின் வழியாக | -| 🔷 **Mattermost** | ✅ முழு | ✅ | சுய-ஹோஸ்ட் செய்யப்பட்ட அணி சாட் | -| 🟩 **Matrix** | ✅ முழு | ✅ | பரவலாக்கப்பட்டது, E2EE ஆதரவு | -| 🟢 **LINE** | ✅ முழு | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ முழு | ✅ | பரவலாக்கப்பட்ட NIP-04 DM-கள் | -| 🟣 **Twitch** | ✅ முழு | ✅ | IRC இணைப்பு வழியாக சாட் | -| 🔷 **Feishu/Lark** | ✅ முழு | ✅ | WebSocket நிகழ்வு சந்தா | -| 🔵 **Zalo** | ✅ முழு | ✅ | Zalo Bot API | - -> **தானியங்கு கண்டறிதல்:** ClawMetry உங்கள் `~/.openclaw/openclaw.json` ஐப் படித்து, நீங்கள் உண்மையில் கட்டமைத்த சேனல்களை மட்டுமே வழங்குகிறது. கைமுறை அமைப்பு தேவையில்லை. - -## Docker வரிசைப்படுத்தல் - -ClawMetry ஐ ஒரு கன்டெய்னரில் இயக்க வேண்டுமா? பிரச்சனை இல்லை! 🐳 - -**Docker உடன் விரைவு தொடக்கம்:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose எடுத்துக்காட்டு:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **குறிப்பு:** Docker-இல் இயக்கும்போது, ClawMetry உங்கள் அமைப்பை தானாக கண்டறிய, உங்கள் ஏஜென்டின் தரவு + பதிவு கோப்பகங்களை (எ.கா. `~/.openclaw`, `~/.claude`, `~/.codex`) மவுன்ட் செய்யவும். - -## தேவைகள் - -- Python 3.8+ -- Flask (pip வழியாக தானாக நிறுவப்படுகிறது) -- அதே இயந்திரத்தில் ஒரு AI ஏஜென்ட் ரன்டைம்: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, அல்லது QM (அல்லது Docker-க்கான மவுன்ட் செய்யப்பட்ட வால்யூம்கள்) -- Linux அல்லது macOS - -## NemoClaw / OpenShell ஆதரவு - -ClawMetry [NemoClaw](https://github.com/NVIDIA/NemoClaw) ஐ தானாக கண்டறிகிறது — OpenClaw ஏஜென்ட்களை சாண்ட்பாக்ஸ் செய்யப்பட்ட OpenShell கன்டெய்னர்களுக்குள் இயக்கும் NVIDIA-இன் நிறுவன பாதுகாப்பு ரேப்பர். - -பெரும்பாலான சந்தர்ப்பங்களில் கூடுதல் கட்டமைப்பு தேவையில்லை. அமர்வு கோப்புகள் ஹோஸ்டில் `~/.openclaw/` இல் இருந்தாலும் அல்லது OpenShell கன்டெய்னருக்குள் இருந்தாலும் சிங்க் டீமன் தானாக கண்டறிகிறது. - -### இது எப்படி வேலை செய்கிறது +| **இலவசம்** | OpenClaw + NVIDIA NemoClaw, முழு டாஷ்போர்டு, உள்ளூர் மட்டும் | $0 | +| **ஸ்டார்ட்டர்** | மேலே உள்ள மற்ற அனைத்து ரன்டைம்களும், fleet பார்வை, cloud sync | மாதத்திற்கு $9 / node | +| **Pro** | ஸ்டார்ட்டர் + நிர்வாகம் (governance): அனுமதிகள், கருவி-அபாய கொள்கைகள், மதிப்பீடுகள் (evals), முரண்பாடு கண்டறிதல், செலவு மேம்படுத்தி, OTel எக்ஸ்போர்ட் | மாதத்திற்கு $19 / node | -ClawMetry இரண்டு வழிகளில் NemoClaw ஐக் கண்டறிகிறது: +வருடாந்திரத் திட்டங்கள், Enterprise மற்றும் தற்போதைய எண்கள் இங்கு உள்ளன: +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. சொந்தமாக ஹோஸ்ட் செய்யப்பட்ட உரிமப் (license) சாவிகள் cloud இல்லாமலேயே வேலை செய்யும் (`clawmetry license`). துல்லியமான இலவச/கட்டணப் பிரிவு +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) இல் உள்ளது. -1. **பைனரி கண்டறிதல்** — `nemoclaw` CLI க்காக சரிபார்த்து, சாண்ட்பாக்ஸ் தகவலைப் பெற `nemoclaw status` ஐ இயக்குகிறது -2. **கன்டெய்னர் கண்டறிதல்** — `openshell`, `nemoclaw`, அல்லது `ghcr.io/nvidia/` இமேஜ்களுக்காக இயங்கும் Docker கன்டெய்னர்களை ஸ்கேன் செய்கிறது, பின்னர் வால்யூம் மவுன்ட்கள் அல்லது `docker cp` வழியாக அமர்வுகளைப் படிக்கிறது +## உங்கள் தரவு உங்கள் கணினியிலேயே இருக்கும் -NemoClaw கன்டெய்னர்களிலிருந்து ஒத்திசைக்கப்பட்ட அமர்வு கோப்புகள் கிளவுட் டாஷ்போர்டில் `runtime=nemoclaw` மற்றும் `container_id` மெட்டாடேட்டாவுடன் குறியிடப்படுகின்றன, எனவே அவற்றை நிலையான OpenClaw அமர்வுகளிலிருந்து ஒரே பார்வையில் வேறுபடுத்தி அறியலாம். +ClawMetry உள்ளூர் அமர்வுக் கோப்புகளையும் பதிவுகளையும் படிக்கும். நீங்கள் `clawmetry connect` ஐ இயக்காத வரை உங்கள் கணினியிலிருந்து எதுவும் வெளியேறாது. அப்படி இயக்கினாலும் கூட, ஸ்னாப்ஷாட் உங்கள் கணினியை விட்டு வெளியேறாத சாவியுடன் எண்ட்-டு-எண்ட் என்க்ரிப்ட் செய்யப்பட்டு, உங்கள் பிரவுசரிலேயே டிக்ரிப்ட் செய்யப்படும். -### பரிந்துரைக்கப்பட்ட அமைப்பு: HOST-இல் சிங்க் டீமன் - -சிறந்த அனுபவத்திற்கு, ClawMetry-இன் சிங்க் டீமனை **ஹோஸ்ட் இயந்திரத்தில்** இயக்கவும் (சாண்ட்பாக்ஸிற்குள் அல்ல). இது NemoClaw நெட்வொர்க் கொள்கை கட்டுப்பாடுகளைத் தவிர்க்கிறது. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -இயங்கும் எந்த OpenShell கன்டெய்னர்களுக்குள்ளும் உள்ள அமர்வுகளை சிங்க் டீமன் தானாக கண்டுபிடிக்கும். - -### விருப்பமானது: வெளிப்படையான சாண்ட்பாக்ஸ் பெயர் - -தானியங்கு கண்டறிதல் வேலை செய்யவில்லை என்றால், ClawMetry ஐ சரியான சாண்ட்பாக்ஸை நோக்கி சுட்டிக்காட்டவும்: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### சாண்ட்பாக்ஸிற்குள் இயக்குதல் (மேம்பட்டது) - -சிங்க் டீமனை OpenShell சாண்ட்பாக்ஸிற்குள் **தான்** இயக்க வேண்டுமெனில், அது ClawMetry ingest API ஐ அடைய உங்கள் NemoClaw நெட்வொர்க் கொள்கையில் இந்த வெளிச்செல்லும் விதியைச் சேர்க்கவும்: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -இதனுடன் பயன்படுத்தவும்: +## நிறுவல் ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # பின்னர்: clawmetry ``` -### போர்ட்கள் மற்றும் endpoint-கள் +அல்லது ஒரே-வரி கட்டளை: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -| Endpoint | போர்ட் | ப்ரோட்டோகால் | தேவையா | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | ஆம் (சிங்க் டீமன் → கிளவுட்) | -| `localhost:8900` | 8900 | HTTP | ஆம் (லோக்கல் டாஷ்போர்டு UI) | -| Docker சாக்கெட் (`/var/run/docker.sock`) | — | Unix சாக்கெட் | கன்டெய்னர் அமர்வு கண்டறிதலுக்கு | +macOS, Linux அல்லது Windows இல் Python 3.8+ தேவை, மேலும் அதே கணினியில் குறைந்தது ஒரு ஏஜென்ட் ரன்டைம் இருக்க வேண்டும். Docker வழிமுறைகள்: [docs/DOCKER.md](docs/DOCKER.md). -சிங்க் டீமன் `ingest.clawmetry.com` க்கு மட்டுமே வெளிச்செல்லும் HTTPS அழைப்புகளை செய்கிறது. உள்வரும் போர்ட்கள் எதுவும் தேவையில்லை. +## ஆவணங்கள் ---- +| | | +|---|---| +| [ரன்டைம் இணக்கத்தன்மை](docs/compatibility.md) | ஒவ்வொரு அடாப்டரும் என்ன படிக்கிறது, மற்றும் ஒரு ரன்டைமை எப்படி சேர்ப்பது | +| [Entitlements](docs/ENTITLEMENTS.md) | இலவசம் vs கட்டணம், டையர் மேட்ரிக்ஸ், லைசென்ஸ் CLI | +| [அனுமதிகள் & கொள்கைகள்](docs/APPROVALS.md) | இயக்கத்திற்கு முந்தைய கட்டுப்பாடு, அபாய மதிப்பீடு, மொபைல் அனுமதிகள் | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | எங்கும் trace-களை எக்ஸ்போர்ட் செய்யவும், எதிலிருந்தும் OTLP-ஐ இங்கெஸ்ட் செய்யவும் | +| [SDK கண்காணிப்பு](docs/SDK_TRACKING.md) | நீங்களே உருவாக்கிய ஏஜென்ட்களுக்கான செலவு ஒதுக்கீடு | +| [சாட் சேனல்கள்](docs/CHANNELS.md) | Flow இல் காட்டப்படும் சாட் அடாப்டர்கள் | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | சாண்ட்பாக்ஸ் செய்யப்பட்ட NVIDIA NemoClaw அமைப்புகள் | +| [Docker](docs/DOCKER.md) | இமேஜ், compose, volume mounts | +| [கட்டமைப்பு (Architecture)](ARCHITECTURE.md) · [Development](docs/DEVELOPMENT.md) | இது உள்ளே எப்படி வேலை செய்கிறது; சோர்ஸிலிருந்து இயக்குதல் | +| [Telemetry](docs/TELEMETRY.md) | அநாமதேய நிறுவல் மற்றும் டெஸ்க்டாப்-ஓபன் பிங்குகள், அவற்றை எப்படி முடக்குவது | -## கிளவுட் வரிசைப்படுத்தல் - -SSH டன்னல்கள், reverse proxy, மற்றும் Docker-க்கு **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** ஐப் பார்க்கவும். - -## சோதனை - -இந்த திட்டம் BrowserStack உடன் சோதிக்கப்படுகிறது. - -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) - -## தொலைமெட்ரி - -ClawMetry அனானிமஸ் நிறுவல்-வாழ்க்கைச்சுழற்சி பிங்குகளை -`https://app.clawmetry.com/api/install` க்கு அனுப்புகிறது: புதிய இயந்திரத்தில் முதல்முறையாக -`clawmetry` CLI ஐ இயக்கும்போது ஒரு `install` பிங், புதிய பதிப்புக்கு -மேம்படுத்திய பிறகு முதல் இயக்கத்தில் ஒரு `update` பிங், மற்றும் டாஷ்போர்டு-உள்-தொடக்க -விருப்பத்தை நிறைவு செய்யும்போது ஒரு `onboarded` பிங். உண்மையான நிறுவல்களை -எண்ணுவதற்கும் (மூல PyPI பதிவிறக்க எண்கள் ~98% மிரர்கள், CI, மற்றும் ஆட்டோ-அப்டேட் -மறு-பதிவிறக்கங்கள்) உண்மையில் பயன்பாட்டில் உள்ள ஏஜென்ட் ஃப்ரேம்வொர்க்குகள் மற்றும் பதிப்புகளை -அறியவும் இதைப் பயன்படுத்துகிறோம். - -**ஒவ்வொரு பதிப்பிற்கும் ஒவ்வொரு வாழ்க்கைச்சுழற்சி நிகழ்விற்கும் அதிகபட்சம் ஒரு POST**, இதில் அடங்கியிருப்பது: - -| புலம் | எடுத்துக்காட்டு | ஏன் | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id` இல் சேமிக்கப்பட்ட ரேண்டம் UUID | நகல் நீக்கம்; நீங்கள் வெளிப்படையாக Cloud sync ஐ இணைக்கும் வரை அனானிமஸ் (அங்கீகரிக்கப்பட்ட டீமன் ஹார்ட்பீட் பின்னர் இதைச் சுமந்து, இந்த நிறுவலை உங்கள் கணக்குடன் இணைக்கிறது) | -| `event` | `install` / `update` / `onboarded` | புதிய நிறுவலா அல்லது ஏற்கனவே உள்ள ஒன்றின் மேம்படுத்தலா | -| `version` | `0.12.167` | என்னென்ன பதிப்புகள் பயன்பாட்டில் உள்ளன | -| `os` / `os_version` | `Darwin` / `25.3.0` | பிளாட்ஃபார்ம் ஆதரவு முன்னுரிமைகள் | -| `python` | `3.11.15` | Python பதிப்பு ஆதரவு மேட்ரிக்ஸ் | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | அடுத்து நாங்கள் எந்த ஏஜென்ட்களுடன் ஒருங்கிணைக்க வேண்டும் | -| `is_ci` / `ci_provider` | `true` / `github_actions` | மனித நிறுவல்களை CI சத்தத்திலிருந்து பிரிக்கிறது | +## ஸ்கிரீன்ஷாட்கள் -**நாங்கள் அனுப்பாதவை**: IP (கிளவுட் கோரிக்கையிலிருந்து சேவையக-பக்கமாக நாட்டுக் குறியீட்டைப் பெறுகிறது, -பின்னர் IP ஐத் தூக்கி எறிகிறது), ஹோஸ்ட்பெயர், பயனர்பெயர், பணியிடப் பாதை, கோப்பு உள்ளடக்கங்கள், -உங்கள் api_key, உங்கள் மின்னஞ்சல், PII அல்லது பணியிடம்-சார்ந்த எதுவும். வயர் பேலோட் -[`clawmetry/telemetry.py`](clawmetry/telemetry.py) இல் தணிக்கை செய்யக்கூடியது. +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **கண்ணோட்டம் (Overview)**: டோக்கன்கள், அமர்வுகள், ஆரோக்கியம் | **பிரெயின் (Brain)**: நேரடி ஏஜென்ட் நிகழ்வு ஸ்ட்ரீம் | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **செலவு (Cost)**: மாடல் மற்றும் அமர்வு வாரியாக | **அனுமதிகள் (Approvals)**: அபாயகரமான கருவி அழைப்புகளைக் கட்டுப்படுத்துதல் | -**விலகல்** (இவற்றில் ஏதேனும் ஒன்று இதை நிரந்தரமாக முடக்கும்): +ரன்டைம் வாரியாக மேலும்: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -இங்கு நெட்வொர்க் தோல்வி ஒருபோதும் `clawmetry` இயங்குவதைத் தடுக்காது — பிங் -டீமன் த்ரெட்டில் ஃபயர்-அண்ட்-ஃபர்கெட், 3 வி டைம்அவுட்டுடன். - -## Star History +## நட்சத்திர வரலாறு (Star History) @@ -435,11 +109,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## உரிமம் -MIT - ---- +MIT · உருவாக்கியவர் [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 உங்கள் ஏஜென்ட் சிந்திப்பதைப் பாருங்கள்
- @vivekchand ஆல் உருவாக்கப்பட்டது · clawmetry.com · OpenClaw சுற்றுச்சூழல் அமைப்பின் ஒரு பகுதி -

+ diff --git a/docs/i18n/te/README.md b/docs/i18n/te/README.md index ad253be633..3aeea11ac4 100644 --- a/docs/i18n/te/README.md +++ b/docs/i18n/te/README.md @@ -1,407 +1,107 @@ - + > తెలుగు translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**మీ ఏజెంట్ ఆలోచించడాన్ని చూడండి.** **20 AI ఏజెంట్ రన్‌టైమ్‌ల** కోసం రియల్-టైమ్ అబ్జర్వబిలిటీ: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex & మరో 16. మీ మొత్తం ఏజెంట్ ఫ్లీట్ కోసం ఒకే డాష్‌బోర్డ్. +**మీ ఏజెంట్ ఆలోచించడాన్ని చూడండి.** **23 AI ఏజెంట్ రన్‌టైమ్‌ల** కోసం రియల్-టైమ్ అబ్జర్వబిలిటీ: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex & మరో 19. మీ మొత్తం ఏజెంట్ ఫ్లీట్ కోసం ఒకే డాష్‌బోర్డ్. -> 🌐 **దీన్ని ఈ భాషలలో చదవండి:** [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/) +> 🌐 **దీన్ని ఈ భాషల్లో చదవండి:** [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** వద్ద ఓపెన్ అవుతుంది, అంతే. +**http://localhost:8900** వద్ద తెరుచుకుంటుంది. జీరో కాన్ఫిగ్: మీ దగ్గర ఇప్పటికే ఉన్న ఏజెంట్ రన్‌టైమ్‌లను ఇది కనుగొంటుంది, వాటిని read-only గా చదువుతుంది, మరియు అవి ఎలా నడుస్తున్నాయో అందులో ఏమీ మార్చదు. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 20 ఏజెంట్ రన్‌టైమ్‌లతో పనిచేస్తుంది - -ClawMetry OpenClaw కోసం అబ్జర్వబిలిటీగా మొదలైంది, ఇప్పుడు మీ **మొత్తం ఏజెంట్ ఫ్లీట్‌ను** ఒకే డాష్‌బోర్డ్‌లో మీటర్ చేస్తుంది, మీ మెషీన్‌లో ఉన్న ప్రతి రన్‌టైమ్‌ను ఆటో-డిటెక్ట్ చేస్తూ: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw మరియు NemoClaw ఓపెన్-సోర్స్ యాప్‌లో ఉచితం; మిగతా రన్‌టైమ్‌లు ClawMetry Cloud లేదా సెల్ఫ్-హోస్టెడ్ Pro లైసెన్స్‌తో యాక్టివేట్ అవుతాయి. హెడర్ నుండి రన్‌టైమ్‌లను మార్చండి, ప్రతి ట్యాబ్ — కాస్ట్, టోకెన్లు, టూల్స్, ట్రేసెస్ — ఆ రన్‌టైమ్‌కు రీ-స్కోప్ అవుతుంది. ఖచ్చితమైన ఫ్రీ/పెయిడ్ స్ప్లిట్, టైర్ మ్యాట్రిక్స్, `/api/entitlement` షేప్, మరియు `clawmetry license` CLI కోసం **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** చూడండి. - -## మీకు ఏమి లభిస్తుంది - -- **Flow** — ఛానెల్స్, బ్రెయిన్, టూల్స్ మరియు తిరిగి వెళ్లే మెసేజీల ప్రవాహాన్ని చూపే లైవ్ యానిమేటెడ్ డయాగ్రామ్ -- **Overview** — హెల్త్ చెక్‌లు, యాక్టివిటీ హీట్‌మ్యాప్, సెషన్ కౌంట్‌లు, మోడల్ ఇన్ఫో -- **Usage** — రోజువారీ/వారపు/నెలవారీ బ్రేక్‌డౌన్‌లతో టోకెన్ మరియు కాస్ట్ ట్రాకింగ్ -- **Sessions** — మోడల్, టోకెన్లు, చివరి యాక్టివిటీతో యాక్టివ్ ఏజెంట్ సెషన్‌లు -- **Crons** — స్టేటస్, నెక్స్ట్ రన్, డ్యూరేషన్‌తో షెడ్యూల్డ్ జాబ్‌లు -- **Logs** — కలర్-కోడెడ్ రియల్-టైమ్ లాగ్ స్ట్రీమింగ్ -- **Memory** — SOUL.md, MEMORY.md, AGENTS.md, రోజువారీ నోట్‌లను బ్రౌజ్ చేయండి -- **Transcripts** — సెషన్ హిస్టరీలను చదవడానికి చాట్-బబుల్ UI -- **Alerts** — బడ్జెట్ క్యాప్‌లు, ఎర్రర్-రేట్ ట్రిగ్గర్‌లు, ఏజెంట్-ఆఫ్‌లైన్ డిటెక్షన్; Slack, Discord, PagerDuty, Telegram, Email కు రూట్ చేస్తుంది -- **Approvals** — డిస్ట్రక్టివ్ డిలీట్‌లు, ఫోర్స్ పుష్‌లు, DB మ్యుటేషన్‌లు, sudo, ప్యాకేజీ ఇన్‌స్టాల్‌లు, నెట్‌వర్క్ కాల్‌లను ఒకే-క్లిక్ సైన్-ఆఫ్ వెనుక గేట్ చేయండి - -## స్క్రీన్‌షాట్‌లు - -### 🧠 Brain — లైవ్ ఏజెంట్ ఈవెంట్ స్ట్రీమ్ -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — టోకెన్ వినియోగం & సెషన్ సారాంశం -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — రియల్-టైమ్ టూల్ కాల్ ఫీడ్ -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — మోడల్ & సెషన్ వారీగా కాస్ట్ బ్రేక్‌డౌన్ -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — వర్క్‌స్పేస్ ఫైల్ బ్రౌజర్ -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — పోశ్చర్ & ఆడిట్ లాగ్ -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — బడ్జెట్ క్యాప్‌లు, ఎర్రర్-రేట్ ట్రిగ్గర్‌లు, Slack / Discord / PagerDuty / Email కు వెబ్‌హుక్‌లు -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — రిస్కీ టూల్ కాల్‌లను మాన్యువల్ సైన్-ఆఫ్ వెనుక గేట్ చేయండి; పాలసీ-బ్యాక్డ్ ప్రొటెక్షన్ రూల్స్ -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**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 యొక్క సొంత పర్మిషన్ ప్రాంప్ట్‌ను స్కిప్ చేస్తుంది (మీరు ఇప్పటికే సమాధానం ఇచ్చారు కాబట్టి). మ్యాచ్ కాని టూల్స్ ~40ms ఖర్చు చేసి 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 ఫ్రంటెండ్ డెవలప్‌మెంట్ - -v2 React యాప్ `frontend/` లో ఉంటుంది మరియు Flask సర్వర్ v2 ఎనేబుల్ చేసి స్టార్ట్ చేసినప్పుడు `/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 -``` +## 23 ఏజెంట్ రన్‌టైమ్‌లతో పనిచేస్తుంది -`http://localhost:5173/v2/` ఓపెన్ చేయండి. Vite `/api` రిక్వెస్ట్‌లను `http://localhost:8900` కు ప్రాక్సీ చేస్తుంది, కాబట్టి React యాప్ అదనపు CORS సెటప్ లేకుండా లోకల్ Flask సర్వర్‌తో మాట్లాడగలదు. +**ఓపెన్ సోర్స్ యాప్‌లో ఉచితం:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -Python ప్యాకేజీతో పంపే బండిల్‌ను బిల్డ్ చేయడానికి: +**చెల్లింపు ప్లాన్‌లో:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -```bash -cd frontend -npm run build -``` +ప్రతి రన్‌టైమ్‌కు ఒకే డాష్‌బోర్డ్ లభిస్తుంది. అనేకం ఒకేసారి రన్ చేయండి, హెడర్ స్విచర్ ప్రతి ట్యాబ్‌ను వాటిలో ఒకదానికి రీ-స్కోప్ చేస్తుంది. -ప్రొడక్షన్ బండిల్ `clawmetry/static/v2/dist/` కు రాయబడుతుంది. +SDK మీద మీ సొంత ఏజెంట్‌ను నిర్మించారా? ఇంటర్‌సెప్టర్ దాని LLM కాల్స్‌ను కూడా ట్రాక్ చేస్తుంది. చూడండి [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -## రన్‌టైమ్ / ఏజెంట్ కంపాటిబిలిటీ +## మీకు ఏం లభిస్తుంది -ClawMetry OpenClaw మాత్రమే కాక అనేక AI-ఏజెంట్ రన్‌టైమ్‌లను గమనిస్తుంది. ప్రతి నాన్-OpenClaw రన్‌టైమ్ దాని నేటివ్ సెషన్ ఫార్మాట్‌ను ClawMetry యొక్క యూనిఫైడ్ షేప్‌లుగా అనువదించే ఒక అంకితమైన రీడర్ అడాప్టర్‌ను షిప్ చేస్తుంది; డేమన్ వాటిని రన్‌టైమ్‌తో ట్యాగ్ చేసి అదే DuckDB స్టోర్ + క్లౌడ్ స్నాప్‌షాట్‌లోకి ఇంజెస్ట్ చేస్తుంది, మరియు ఒకటి కంటే ఎక్కువ ఉన్నప్పుడు Session replay ట్యాబ్ ఒక **రన్‌టైమ్ స్విచర్**ను చూపిస్తుంది. పూర్తి మ్యాట్రిక్స్ + రన్‌టైమ్‌లను జోడించడానికి గైడ్ కోసం [`docs/compatibility.md`](docs/compatibility.md) చూడండి, మరియు OpenClaw-ఫ్యామిలీ ప్రైమర్ కోసం [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) చూడండి. +- **సెషన్‌లు & ట్రాన్స్‌క్రిప్ట్‌లు**: ప్రతి ఏజెంట్ ఏం చేసిందో, టర్న్ బై టర్న్, రీప్లేతో సహా +- **ఖర్చు & టోకెన్‌లు**: రన్‌టైమ్, మోడల్, సెషన్ మరియు రోజు వారీగా, అనోమలీ ఫ్లాగ్‌లతో సహా +- **ఫ్లో**: ఛానెల్‌లు, మోడల్‌లు మరియు టూల్స్ మధ్య కదిలే మెసేజ్‌ల లైవ్ డయాగ్రామ్ +- **బ్రెయిన్**: జరుగుతున్న సమయంలోనే రీజనింగ్ మరియు టూల్-కాల్ ఈవెంట్ స్ట్రీమ్ +- **మెమరీ & స్కిల్స్**: ప్రతి రన్‌టైమ్ నిజంగా లోడ్ చేసిన ఫైల్‌లు మరియు స్కిల్స్ +- **హెల్త్ & లాగ్స్**: డిస్క్, మెమరీ, ఎర్రర్ రేట్లు, రేట్ లిమిట్‌లు, లైవ్ లాగ్ స్ట్రీమ్ +- **అలర్ట్‌లు**: బడ్జెట్ క్యాప్‌లు, ఎర్రర్ స్పైక్‌లు, ఏజెంట్-ఆఫ్‌లైన్, Slack, Discord, PagerDuty, Telegram, Email కు రూట్ చేయబడతాయి +- **ఆమోదాలు**: రిస్కీ టూల్ కాల్స్‌ను అవి రన్ అయ్యే *ముందే* పాజ్ చేసి, మీ ఫోన్ నుండి ఆమోదించండి ([ఎలా](docs/APPROVALS.md)) -[Perplexity యొక్క numbat](https://github.com/perplexityai/numbat) ఏజెంట్-సెక్యూరిటీ టూల్‌ను రన్ చేస్తున్నారా? ClawMetry దాని ఫైండింగ్‌లు మరియు ఎన్‌ఫోర్స్‌మెంట్ నిర్ణయాలను బాక్స్ నుండి తీసిన వెంటనే ఇంజెస్ట్ చేస్తుంది — [`docs/NUMBAT.md`](docs/NUMBAT.md) చూడండి. +## ధరల విధానం -| రన్‌టైమ్ / ఏజెంట్ | స్టేటస్ | నోట్స్ | +| ప్లాన్ | ఇందులో ఏముంది | ధర | |---|---|---| -| **OpenClaw** | నేటివ్ | రిఫరెన్స్ రన్‌టైమ్, ఆటో-డిటెక్టెడ్ | -| **PicoClaw** | బీటా అడాప్టర్ | ఫ్లాట్ `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`). ట్రాన్స్‌క్రిప్ట్‌లు, మోడల్, టూల్ కాల్‌లు. | -| **NanoClaw** | బీటా అడాప్టర్ | పర్-సెషన్ SQLite (`data/v2-sessions`). ట్రాన్స్‌క్రిప్ట్‌లు + మెసేజ్ కౌంట్‌లు. | -| **Hermes** | బీటా అడాప్టర్ | SQLite `~/.hermes/state.db`. ట్రాన్స్‌క్రిప్ట్‌లు, మోడల్, టోకెన్లు/కాస్ట్. | -| **Claude Code** | బీటా అడాప్టర్ | JSONL `~/.claude/projects/.../.jsonl`. ట్రాన్స్‌క్రిప్ట్‌లు, మోడల్, టూల్ కాల్‌లు + థింకింగ్, టోకెన్ యూసేజ్. | -| **Codex** | బీటా అడాప్టర్ | రోల్అవుట్ 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`. వర్క్‌ఫ్లో ఎగ్జిక్యూషన్‌లు, నోడ్ రన్‌లు, AI Agent ప్రాంప్ట్‌లు, n8n రికార్డ్ చేసిన చోట మోడల్ + టోకెన్లు. | -| **Antigravity** | బీటా అడాప్టర్ | `~/.gemini//brain/` కింద బ్రెయిన్ JSONL. సంభాషణలు, టూల్ స్టెప్‌లు, థింకింగ్, పర్-జనరేషన్ Gemini టోకెన్ స్ప్లిట్ + కాస్ట్, బ్యాక్‌గ్రౌండ్-జనరేషన్ బర్న్. | -| **GitHub Copilot** | బీటా అడాప్టర్ | Copilot CLI `events.jsonl` `~/.copilot/session-state/` కింద + పర్-కాల్ యూసేజ్ లెడ్జర్ అయిన `session-store.db`. సంభాషణలు, టూల్ కాల్‌లు, మోడల్ రూటింగ్, కేష్-అవేర్ టోకెన్ స్ప్లిట్, వెండర్-బిల్డ్ AI-క్రెడిట్ కాస్ట్. | -| **Grok** | బీటా అడాప్టర్ | xAI Grok Build CLI (`~/.grok/bin/grok` కింద Rust బైనరీ): గ్లోబల్ ఈవెంట్ లాగ్ `~/.grok/logs/unified.jsonl` + పర్-సెషన్ `~/.grok/sessions///{events.jsonl,summary.json}`. సంభాషణలు, పర్-టర్న్ టోకెన్ స్ప్లిట్, మోడల్ రూటింగ్, మరియు మీ మెషీన్ నుండి ఏం బయటకు వెళ్లిందో చూడడానికి `~/.grok/upload_queue/` కింద స్టేజ్ చేయబడిన CLI యొక్క అవుట్‌బౌండ్ రిపో పేలోడ్. | - -"బీటా అడాప్టర్" అంటే ClawMetry ఆ రన్‌టైమ్ యొక్క నిజమైన ఆన్-డిస్క్ ఫార్మాట్ కోసం రీడర్‌ను షిప్ చేస్తుందని అర్థం, ప్రతి ఒక్కటి నిజమైన మెషీన్‌పై నిజమైన ఇన్‌స్టాల్‌కు వ్యతిరేకంగా బిల్డ్ + వెరిఫై చేయబడింది (`tests/fixtures/runtimes//` చూడండి). అడాప్టర్‌లు రీడ్-ఓన్లీ; ప్రతి ఒక్కటి తన రన్‌టైమ్ నిజంగా దేన్ని స్టోర్ చేస్తుందో దాని గురించి నిజాయితీగా ఉంటుంది (ఉదా. PicoClaw/NanoClaw/Cursor డిస్క్‌కు టోకెన్ కాస్ట్ రాయవు). ఒక నోడ్‌పై అనేక రన్‌టైమ్‌లు రన్ అయినప్పుడు, రన్‌టైమ్ స్విచర్ క్లీన్ డీప్-డైవ్ కోసం సెషన్‌ల వ్యూను ఒకదానికి స్కోప్ చేస్తుంది. - -## ఏ SDK ఏజెంట్‌నైనా ట్రాక్ చేయండి — అవుట్-లూప్ కాస్ట్ అట్రిబ్యూషన్ - -పైన ఉన్న రన్‌టైమ్‌లన్నీ సెషన్‌లను డిస్క్‌కు రాస్తాయి. మీరు OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, లేదా ప్లెయిన్ `httpx` లూప్‌పై బిల్డ్ చేసిన మీ సొంత **ప్రొడక్షన్ ఏజెంట్** అలా చేయదు. ClawMetry యొక్క జీరో-కాన్ఫిగ్ ఇంటర్‌సెప్టర్ `httpx`/`requests` ను మంకీ-ప్యాచ్ చేయడం ద్వారా దాని LLM కాల్‌లను (కాస్ట్, టోకెన్లు, లేటెన్సీ, ఎర్రర్‌లు) ఇప్పటికీ క్యాప్చర్ చేస్తుంది: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (లేదా `CLAWMETRY_SOURCE=support-agent` env వేరియబుల్) ప్రతి కాల్‌ను ఒక **నేమ్డ్ సోర్స్**తో ట్యాగ్ చేస్తుంది, కాబట్టి మీరు రన్ చేసే ప్రతి ప్రొడక్ట్ డాష్‌బోర్డ్ యొక్క Overview లోని **🔌 Out-loop sources** కార్డ్‌లో దాని సొంత ఫస్ట్-క్లాస్, కాస్ట్-అట్రిబ్యూటబుల్ లైన్‌గా కనిపిస్తుంది — పర్ ఏజెంట్ కాల్‌లు, ప్రొవైడర్‌లు, లేటెన్సీ, ఎర్రర్ రేటు. సోర్స్ సెట్ చేయలేదా? కాల్‌లు ఇప్పటికీ ట్రాక్ అవుతాయి; కార్డ్ మాత్రం దాక్కుని ఉంటుంది. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -ఇది రన్‌టైమ్ అడాప్టర్‌లు ఫీడ్ చేసే అదే డేటా లేయర్ (DuckDB → క్లౌడ్ స్నాప్‌షాట్), కాబట్టి అవుట్-లూప్ సోర్స్‌లు మిగతా ప్రతిదానిలాగే క్లౌడ్ డాష్‌బోర్డ్‌కు సింక్ అవుతాయి, E2E-ఎన్‌క్రిప్టెడ్‌గా. - -## OpenTelemetry — వెండర్-న్యూట్రల్, మీ ట్రేసెస్‌ను ఎక్కడికైనా పంపండి - -ClawMetry రెండు దిశలలో **OpenTelemetry** మాట్లాడుతుంది, **GenAI సెమాంటిక్ కన్వెన్షన్‌లను** వాడుతూ, కాబట్టి మీ ఏజెంట్ ట్రేసెస్ ఎప్పుడూ ఒకే టూల్‌కు లాక్ అవ్వవు. - -ప్రతి సెషన్‌ను — LLM కాల్‌లు, టూల్స్, సబ్-ఏజెంట్‌లు, టోకెన్లు, కాస్ట్ — OTLP/HTTP GenAI స్పాన్‌లుగా ఏ కలెక్టర్‌కైనా (Datadog, Grafana, Honeycomb, లేదా మీ సొంత OTel Collector) **ఎక్స్‌పోర్ట్** చేయండి: - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -ఆత్ హెడర్‌లు మరియు పోల్ ఇంటర్వల్ ఐచ్ఛిక env వేరియబుల్స్: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**ఇంజెస్ట్** — బిల్ట్-ఇన్ OTLP రిసీవర్ `/v1/traces`, `/v1/logs`, మరియు `/v1/metrics` వద్ద మరేదైనా దాని నుండి ట్రేసెస్, లాగ్‌లు, మరియు మెట్రిక్‌లను అంగీకరిస్తుంది. ఏ OpenTelemetry-ఇన్‌స్ట్రుమెంటెడ్ యాప్‌నైనా దానికి పాయింట్ చేయండి: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON ట్రేసెస్ మరియు లాగ్‌లు ప్లెయిన్ `pip install clawmetry` పైనే పనిచేస్తాయి, ఎక్స్‌ట్రాలు అవసరం లేదు. ప్రోటోబఫ్ ఇంజెస్ట్ (మరియు OTLP/JSON మెట్రిక్‌లు) కు `pip install clawmetry[otel]` అవసరం. తన సొంత `service.name` సెట్ చేసుకున్న యాప్ రన్‌టైమ్ స్విచర్‌లో తన సొంత ఏజెంట్‌గా, దాని కాస్ట్ మరియు టోకెన్లతో కనిపిస్తుంది. - -మీకు జీరో-కాన్ఫిగ్, లోకల్-ఫస్ట్ ClawMetry డాష్‌బోర్డ్ **మరియు** మీ టీమ్ ఇప్పటికే రన్ చేస్తున్న ఏ బ్యాకెండ్‌లోనైనా మీ డేటా లభిస్తుంది — లాక్-ఇన్ లేదు, రెండో ఏజెంట్ ఇన్‌స్టాల్ చేయాల్సిన అవసరం లేదు. - -## కాన్ఫిగరేషన్ - -చాలా మందికి ఏ కాన్ఫిగ్ అవసరం లేదు. ClawMetry మీ వర్క్‌స్పేస్, లాగ్‌లు, సెషన్‌లు, మరియు క్రాన్‌లను ఆటో-డిటెక్ట్ చేస్తుంది. - -మీకు కస్టమైజ్ చేయాల్సిన అవసరం ఉంటే: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -అన్ని ఆప్షన్‌లు: `clawmetry --help` - -## సపోర్టెడ్ ఛానెల్స్ - -మీరు కాన్ఫిగర్ చేసిన ప్రతి OpenClaw ఛానెల్ కోసం ClawMetry లైవ్ యాక్టివిటీని చూపిస్తుంది. మీ `openclaw.json` లో నిజంగా సెటప్ చేసిన ఛానెల్‌లు మాత్రమే Flow డయాగ్రామ్‌లో కనిపిస్తాయి — కాన్ఫిగర్ చేయని వాటిని ఆటోమేటిక్‌గా దాచేస్తుంది. - -లైవ్ ఇన్‌కమింగ్/అవుట్‌గోయింగ్ మెసేజ్ కౌంట్‌లతో లైవ్ చాట్ బబుల్ వ్యూను చూడటానికి Flow లో ఏ ఛానెల్ నోడ్‌నైనా క్లిక్ చేయండి. - -| ఛానెల్ | స్టేటస్ | లైవ్ పాపప్ | నోట్స్ | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ పూర్తి | ✅ | మెసేజీలు, స్టాట్స్, 10s రిఫ్రెష్ | -| 💬 **iMessage** | ✅ పూర్తి | ✅ | `~/Library/Messages/chat.db` నేరుగా చదువుతుంది | -| 💚 **WhatsApp** | ✅ పూర్తి | ✅ | WhatsApp Web (Baileys) ద్వారా | -| 🔵 **Signal** | ✅ పూర్తి | ✅ | signal-cli ద్వారా | -| 🟣 **Discord** | ✅ పూర్తి | ✅ | గిల్డ్ + ఛానెల్ డిటెక్షన్ | -| 🟪 **Slack** | ✅ పూర్తి | ✅ | వర్క్‌స్పేస్ + ఛానెల్ డిటెక్షన్ | -| 🌐 **Webchat** | ✅ పూర్తి | ✅ | బిల్ట్-ఇన్ వెబ్ UI సెషన్‌లు | -| 📡 **IRC** | ✅ పూర్తి | ✅ | టెర్మినల్-స్టైల్ బబుల్ UI | -| 🍏 **BlueBubbles** | ✅ పూర్తి | ✅ | BlueBubbles REST API ద్వారా iMessage | -| 🔵 **Google Chat** | ✅ పూర్తి | ✅ | Chat API వెబ్‌హుక్‌ల ద్వారా | -| 🟣 **MS Teams** | ✅ పూర్తి | ✅ | Teams బాట్ ప్లగిన్ ద్వారా | -| 🔷 **Mattermost** | ✅ పూర్తి | ✅ | సెల్ఫ్-హోస్టెడ్ టీమ్ చాట్ | -| 🟩 **Matrix** | ✅ పూర్తి | ✅ | డీసెంట్రలైజ్డ్, E2EE సపోర్ట్ | -| 🟢 **LINE** | ✅ పూర్తి | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ పూర్తి | ✅ | డీసెంట్రలైజ్డ్ NIP-04 DMs | -| 🟣 **Twitch** | ✅ పూర్తి | ✅ | IRC కనెక్షన్ ద్వారా చాట్ | -| 🔷 **Feishu/Lark** | ✅ పూర్తి | ✅ | WebSocket ఈవెంట్ సబ్‌స్క్రిప్షన్ | -| 🔵 **Zalo** | ✅ పూర్తి | ✅ | Zalo Bot API | - -> **ఆటో-డిటెక్షన్:** ClawMetry మీ `~/.openclaw/openclaw.json` చదివి మీరు నిజంగా కాన్ఫిగర్ చేసిన ఛానెల్‌లను మాత్రమే రెండర్ చేస్తుంది. మాన్యువల్ సెటప్ అవసరం లేదు. - -## Docker డిప్లాయ్‌మెంట్ - -ClawMetryని కంటైనర్‌లో రన్ చేయాలనుకుంటున్నారా? సమస్య లేదు! 🐳 - -**Docker తో క్విక్ స్టార్ట్:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose ఉదాహరణ:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **గమనిక:** Docker లో రన్ చేస్తున్నప్పుడు, ClawMetry మీ సెటప్‌ను ఆటో-డిటెక్ట్ చేయగలిగేలా మీ ఏజెంట్ యొక్క డేటా + లాగ్ డైరెక్టరీలను (ఉదా. `~/.openclaw`, `~/.claude`, `~/.codex`) మౌంట్ చేయండి. - -## అవసరాలు - -- Python 3.8+ -- Flask (pip ద్వారా ఆటోమేటిక్‌గా ఇన్‌స్టాల్ అవుతుంది) -- అదే మెషీన్‌పై AI ఏజెంట్ రన్‌టైమ్: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, లేదా QM (లేదా Docker కోసం మౌంటెడ్ వాల్యూమ్‌లు) -- Linux లేదా macOS - -## NemoClaw / OpenShell సపోర్ట్ - -ClawMetry [NemoClaw](https://github.com/NVIDIA/NemoClaw) ను ఆటోమేటిక్‌గా డిటెక్ట్ చేస్తుంది — ఇది NVIDIA యొక్క ఎంటర్‌ప్రైజ్ సెక్యూరిటీ ర్యాపర్, ఇది సాండ్‌బాక్స్డ్ OpenShell కంటైనర్‌ల లోపల OpenClaw ఏజెంట్‌లను రన్ చేస్తుంది. - -చాలా సందర్భాలలో అదనపు కాన్ఫిగరేషన్ అవసరం లేదు. సెషన్ ఫైల్‌లు హోస్ట్‌పై `~/.openclaw/` లో ఉన్నా లేదా OpenShell కంటైనర్ లోపల ఉన్నా సింక్ డేమన్ వాటిని ఆటో-డిస్కవర్ చేస్తుంది. +| **Free** | OpenClaw + NVIDIA NemoClaw, పూర్తి డాష్‌బోర్డ్, లోకల్ మాత్రమే | $0 | +| **Starter** | పైన పేర్కొన్న ప్రతి ఇతర రన్‌టైమ్, ఫ్లీట్ వ్యూ, క్లౌడ్ సింక్ | నెలకు నోడ్‌కు $9 | +| **Pro** | Starter + గవర్నెన్స్: ఆమోదాలు, టూల్-రిస్క్ పాలసీలు, ఎవాల్స్, అనోమలీ డిటెక్షన్, కాస్ట్ ఆప్టిమైజర్, OTel ఎక్స్‌పోర్ట్ | నెలకు నోడ్‌కు $19 | -### ఇది ఎలా పనిచేస్తుంది +వార్షిక ప్లాన్‌లు, Enterprise మరియు ప్రస్తుత అంకెలు +**[clawmetry.com/pricing](https://clawmetry.com/pricing)** వద్ద ఉన్నాయి. సెల్ఫ్-హోస్టెడ్ లైసెన్స్ +కీలు క్లౌడ్ లేకుండా పనిచేస్తాయి (`clawmetry license`). ఖచ్చితమైన ఉచిత/చెల్లింపు విభజన +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) లో ఉంది. -ClawMetry NemoClaw ను రెండు రకాలుగా డిటెక్ట్ చేస్తుంది: +## మీ డేటా మీ మెషీన్‌లోనే ఉంటుంది -1. **బైనరీ డిటెక్షన్** — `nemoclaw` CLI ఉందో లేదో చెక్ చేసి, సాండ్‌బాక్స్ ఇన్ఫో పొందడానికి `nemoclaw status` రన్ చేస్తుంది -2. **కంటైనర్ డిటెక్షన్** — `openshell`, `nemoclaw`, లేదా `ghcr.io/nvidia/` ఇమేజ్‌ల కోసం రన్నింగ్ Docker కంటైనర్‌లను స్కాన్ చేసి, తర్వాత వాల్యూమ్ మౌంట్‌ల ద్వారా లేదా `docker cp` ద్వారా సెషన్‌లను చదువుతుంది +ClawMetry లోకల్ సెషన్ ఫైల్‌లు మరియు లాగ్‌లను చదువుతుంది. మీరు `clawmetry connect` రన్ చేయనంత +వరకు మీ బాక్స్ నుండి ఏమీ బయటకు వెళ్లదు. అప్పుడు కూడా స్నాప్‌షాట్ మీ మెషీన్‌ను ఎప్పుడూ +వదిలిపెట్టని కీతో ఎండ్-టు-ఎండ్ ఎన్‌క్రిప్ట్ చేయబడుతుంది మరియు మీ బ్రౌజర్‌లో డిక్రిప్ట్ చేయబడుతుంది. -NemoClaw కంటైనర్‌ల నుండి సింక్ చేసిన సెషన్ ఫైల్‌లు క్లౌడ్ డాష్‌బోర్డ్‌లో `runtime=nemoclaw` మరియు `container_id` మెటాడేటాతో ట్యాగ్ చేయబడతాయి, కాబట్టి మీరు వాటిని ఒక్క చూపులో స్టాండర్డ్ OpenClaw సెషన్‌ల నుండి వేరు చేయగలరు. - -### సిఫార్సు చేయబడిన సెటప్: HOST పై సింక్ డేమన్ - -మెరుగైన అనుభవం కోసం, ClawMetry యొక్క సింక్ డేమన్‌ను **హోస్ట్ మెషీన్** పై రన్ చేయండి (సాండ్‌బాక్స్ లోపల కాదు). ఇది NemoClaw నెట్‌వర్క్ పాలసీ నియంత్రణలను నివారిస్తుంది. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -సింక్ డేమన్ రన్ అవుతున్న ఏ OpenShell కంటైనర్‌ల లోపలైనా సెషన్‌లను ఆటోమేటిక్‌గా కనుగొంటుంది. - -### ఐచ్ఛికం: స్పష్టమైన సాండ్‌బాక్స్ పేరు - -ఆటో-డిటెక్షన్ పనిచేయకపోతే, ClawMetry ను సరైన సాండ్‌బాక్స్‌కు పాయింట్ చేయండి: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### సాండ్‌బాక్స్ లోపల రన్ చేయడం (అడ్వాన్స్‌డ్) - -మీరు సింక్ డేమన్‌ను OpenShell సాండ్‌బాక్స్ **లోపల** తప్పనిసరిగా రన్ చేయాల్సి వస్తే, అది ClawMetry ఇంజెస్ట్ API ను చేరుకోగలిగేలా మీ NemoClaw నెట్‌వర్క్ పాలసీకి ఈ ఎగ్రెస్ రూల్‌ను జోడించండి: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -దీనితో అప్లై చేయండి: +## ఇన్‌స్టాల్ ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # తర్వాత: clawmetry ``` -### పోర్ట్‌లు మరియు ఎండ్‌పాయింట్‌లు +లేదా ఒకే లైన్: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -| ఎండ్‌పాయింట్ | పోర్ట్ | ప్రోటోకాల్ | అవసరం | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | అవును (సింక్ డేమన్ → క్లౌడ్) | -| `localhost:8900` | 8900 | HTTP | అవును (లోకల్ డాష్‌బోర్డ్ UI) | -| Docker సాకెట్ (`/var/run/docker.sock`) | — | Unix సాకెట్ | కంటైనర్ సెషన్ డిస్కవరీ కోసం | +macOS, Linux లేదా Windows లో Python 3.8+ అవసరం, మరియు అదే మెషీన్‌లో కనీసం ఒక ఏజెంట్ +రన్‌టైమ్ ఉండాలి. Docker సూచనలు: [docs/DOCKER.md](docs/DOCKER.md). -సింక్ డేమన్ `ingest.clawmetry.com` కు మాత్రమే అవుట్‌బౌండ్ HTTPS కాల్‌లు చేస్తుంది. ఇన్‌బౌండ్ పోర్ట్‌లు ఏవీ అవసరం లేదు. +## డాక్యుమెంటేషన్ ---- +| | | +|---|---| +| [రన్‌టైమ్ కంపాటిబిలిటీ](docs/compatibility.md) | ప్రతి అడాప్టర్ ఏం చదువుతుంది, మరియు రన్‌టైమ్‌ను ఎలా జోడించాలి | +| [ఎంటైటిల్‌మెంట్స్](docs/ENTITLEMENTS.md) | ఉచితం vs చెల్లింపు, టైర్ మ్యాట్రిక్స్, లైసెన్స్ CLI | +| [ఆమోదాలు & పాలసీలు](docs/APPROVALS.md) | ప్రీ-ఎగ్జిక్యూషన్ గేటింగ్, రిస్క్ స్కోరింగ్, ఫోన్ ఆమోదాలు | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | ఎక్కడికైనా ట్రేసులు ఎక్స్‌పోర్ట్ చేయండి, ఎక్కడి నుండైనా OTLP ఇన్జెస్ట్ చేయండి | +| [SDK ట్రాకింగ్](docs/SDK_TRACKING.md) | మీరే నిర్మించిన ఏజెంట్‌ల కోసం ఖర్చు అట్రిబ్యూషన్ | +| [చాట్ ఛానెల్స్](docs/CHANNELS.md) | ఫ్లోలో చూపించే చాట్ అడాప్టర్లు | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | సాండ్‌బాక్స్డ్ NVIDIA NemoClaw సెటప్‌లు | +| [Docker](docs/DOCKER.md) | ఇమేజ్, కంపోజ్, వాల్యూమ్ మౌంట్‌లు | +| [ఆర్కిటెక్చర్](ARCHITECTURE.md) · [డెవలప్‌మెంట్](docs/DEVELOPMENT.md) | ఇది లోపల ఎలా పనిచేస్తుంది; సోర్స్ నుండి రన్ చేయడం | +| [టెలిమెట్రీ](docs/TELEMETRY.md) | అనామక ఇన్‌స్టాల్ మరియు డెస్క్‌టాప్-ఓపెన్ పింగ్‌లు, వాటిని ఎలా ఆపేయాలి | -## క్లౌడ్ డిప్లాయ్‌మెంట్ - -SSH టన్నెల్‌లు, రివర్స్ ప్రాక్సీ, మరియు Docker కోసం **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** చూడండి. - -## టెస్టింగ్ - -ఈ ప్రాజెక్ట్ BrowserStack తో టెస్ట్ చేయబడింది. - -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) - -## టెలిమెట్రీ - -ClawMetry `https://app.clawmetry.com/api/install` కు అనానిమస్ ఇన్‌స్టాల్-లైఫ్‌సైకిల్ పింగ్‌లను పంపుతుంది: మీరు కొత్త మెషీన్‌పై `clawmetry` CLI ను మొదటిసారి రన్ చేసినప్పుడు ఒక `install` పింగ్, కొత్త వెర్షన్‌కు అప్‌గ్రేడ్ చేసిన తర్వాత మొదటి రన్‌లో ఒక `update` పింగ్, మరియు మీరు డాష్‌బోర్డ్-లోపలి ఆన్‌బోర్డింగ్ ఎంపికను పూర్తి చేసినప్పుడు ఒక `onboarded` పింగ్. నిజమైన ఇన్‌స్టాల్‌లను లెక్కించడానికి (రా PyPI డౌన్‌లోడ్ నంబర్‌లు ~98% మిర్రర్‌లు, CI, మరియు ఆటో-అప్‌డేట్ రీ-డౌన్‌లోడ్‌లు) మరియు ఏ ఏజెంట్ ఫ్రేమ్‌వర్క్‌లు మరియు వెర్షన్‌లు నిజంగా వాడుకలో ఉన్నాయో తెలుసుకోవడానికి మేం దీన్ని వాడతాం. - -**వెర్షన్‌కు లైఫ్‌సైకిల్ ఈవెంట్‌కు గరిష్టంగా ఒక POST**, దీనిలో ఉంటుంది: - -| ఫీల్డ్ | ఉదాహరణ | ఎందుకు | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id` వద్ద స్టోర్ చేయబడిన రాండమ్ UUID | డిడూప్; మీరు స్పష్టంగా Cloud సింక్ కనెక్ట్ చేసేవరకు అనానిమస్ (ఆ తర్వాత అథెంటికేటెడ్ డేమన్ హార్ట్‌బీట్ దీన్ని కారీ చేస్తుంది, ఈ ఇన్‌స్టాల్‌ను మీ అకౌంట్‌కు లింక్ చేస్తుంది) | -| `event` | `install` / `update` / `onboarded` | కొత్త ఇన్‌స్టాల్ vs ఇప్పటికే ఉన్న దాని అప్‌గ్రేడ్ | -| `version` | `0.12.167` | వాడుకలో ఏ వెర్షన్‌లు ఉన్నాయి | -| `os` / `os_version` | `Darwin` / `25.3.0` | ప్లాట్‌ఫారమ్ సపోర్ట్ ప్రయారిటీలు | -| `python` | `3.11.15` | Python వెర్షన్ సపోర్ట్ మ్యాట్రిక్స్ | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | తర్వాత మేం ఏ ఏజెంట్‌లతో ఇంటిగ్రేట్ చేయాలి | -| `is_ci` / `ci_provider` | `true` / `github_actions` | హ్యూమన్ ఇన్‌స్టాల్‌లను CI నాయిస్ నుండి వేరు చేయడానికి | +## స్క్రీన్‌షాట్‌లు -**మేం పంపనివి**: IP (క్లౌడ్ రిక్వెస్ట్ నుండి సర్వర్-సైడ్‌లో కంట్రీ కోడ్‌ను డిరైవ్ చేసి, తర్వాత IPని డిస్కార్డ్ చేస్తుంది), హోస్ట్‌నేమ్, యూజర్‌నేమ్, వర్క్‌స్పేస్ పాత్, ఫైల్ కంటెంట్‌లు, మీ api_key, మీ ఇమెయిల్, PII లేదా వర్క్‌స్పేస్-స్పెసిఫిక్ ఏదైనా. వైర్ పేలోడ్ [`clawmetry/telemetry.py`](clawmetry/telemetry.py) లో ఆడిటబుల్‌గా ఉంది. +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **అవలోకనం**: టోకెన్‌లు, సెషన్‌లు, హెల్త్ | **బ్రెయిన్**: లైవ్ ఏజెంట్ ఈవెంట్ స్ట్రీమ్ | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **ఖర్చు**: మోడల్ మరియు సెషన్ వారీగా | **ఆమోదాలు**: రిస్కీ టూల్ కాల్స్‌ను గేట్ చేయడం | -**ఆప్ట్ అవుట్** (వీటిలో ఏదైనా ఒకటి దీన్ని శాశ్వతంగా డిసేబుల్ చేస్తుంది): +మరిన్ని, రన్‌టైమ్ వారీగా: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -ఇక్కడ నెట్‌వర్క్ ఫెయిల్యూర్ ఎప్పుడూ `clawmetry` రన్ కావడాన్ని బ్లాక్ చేయదు — పింగ్ అనేది 3 సెకన్ల టైమ్‌అవుట్‌తో డేమన్ థ్రెడ్‌పై ఫైర్-అండ్-ఫర్గెట్. - -## స్టార్ హిస్టరీ +## Star చరిత్ర @@ -413,11 +113,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## లైసెన్స్ -MIT - ---- +MIT · నిర్మించినవారు [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 మీ ఏజెంట్ ఆలోచించడాన్ని చూడండి
- @vivekchand నిర్మించారు · clawmetry.com · OpenClaw ఎకోసిస్టమ్‌లో భాగం -

+ diff --git a/docs/i18n/th/README.md b/docs/i18n/th/README.md index 062ed8217f..679d526d04 100644 --- a/docs/i18n/th/README.md +++ b/docs/i18n/th/README.md @@ -1,19 +1,18 @@ - + > ไทย translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**ดูความคิดของเอเจนต์คุณแบบเรียลไทม์** ระบบสังเกตการณ์แบบเรียลไทม์สำหรับ **20 รันไทม์เอเจนต์ AI**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex และอีก 16 ตัว แดชบอร์ดเดียวสำหรับกองเอเจนต์ทั้งหมดของคุณ +**ดูสิ่งที่เอเจนต์ของคุณกำลังคิด** ระบบสังเกตการณ์แบบเรียลไทม์สำหรับ **23 รันไทม์ของเอเจนต์ AI**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex และอีก 19 รายการ แดชบอร์ดเดียวสำหรับกองเอเจนต์ทั้งหมดของคุณ -> 🌐 **อ่านเป็นภาษาอื่น:** [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/) +> 🌐 **อ่านภาษาอื่น:** [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/) คำสั่งเดียว ไม่ต้องตั้งค่า ตรวจจับทุกอย่างให้อัตโนมัติ @@ -21,409 +20,91 @@ pip install clawmetry && clawmetry ``` -เปิดที่ **http://localhost:8900** แค่นี้ก็เสร็จ +เปิดที่ **http://localhost:8900** ไม่ต้องตั้งค่าใด ๆ: มันจะค้นหารันไทม์ของเอเจนต์ +ที่คุณมีอยู่แล้ว อ่านข้อมูลแบบอ่านอย่างเดียว และไม่เปลี่ยนแปลงวิธีการทำงานของมันเลย ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## ใช้งานได้กับ 20 รันไทม์เอเจนต์ - -ClawMetry เริ่มต้นจากการสังเกตการณ์สำหรับ OpenClaw และตอนนี้วัดผลให้กับ **กองเอเจนต์ทั้งหมดของคุณ** ในแดชบอร์ดเดียว โดยตรวจจับแต่ละรันไทม์บนเครื่องของคุณโดยอัตโนมัติ: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw และ NemoClaw ใช้งานได้ฟรีในแอปโอเพนซอร์ส ส่วนรันไทม์อื่น ๆ จะเปิดใช้งานได้ด้วย ClawMetry Cloud หรือไลเซนส์ Pro แบบโฮสต์เอง สลับรันไทม์ได้จากส่วนหัว และทุกแท็บ ทั้งค่าใช้จ่าย โทเคน เครื่องมือ การติดตาม จะปรับขอบเขตไปตามรันไทม์นั้น ดู **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** สำหรับรายละเอียดการแบ่งฟรี/เสียเงินที่แน่นอน ตารางระดับสิทธิ์ รูปแบบของ `/api/entitlement` และคำสั่ง CLI `clawmetry license` - -## คุณจะได้อะไร - -- **Flow** — ไดอะแกรมเคลื่อนไหวแบบเรียลไทม์ที่แสดงข้อความไหลผ่านช่องทาง สมอง เครื่องมือ แล้วย้อนกลับมา -- **Overview** — การตรวจสุขภาพ แผนที่ความร้อนของกิจกรรม จำนวนเซสชัน ข้อมูลโมเดล -- **Usage** — การติดตามโทเคนและค่าใช้จ่ายพร้อมสรุปรายวัน/รายสัปดาห์/รายเดือน -- **Sessions** — เซสชันเอเจนต์ที่กำลังทำงานอยู่ พร้อมโมเดล โทเคน กิจกรรมล่าสุด -- **Crons** — งานตามตารางเวลา พร้อมสถานะ รอบถัดไป ระยะเวลา -- **Logs** — สตรีมล็อกแบบเรียลไทม์ที่มีสีแยกประเภท -- **Memory** — เรียกดู SOUL.md, MEMORY.md, AGENTS.md, บันทึกประจำวัน -- **Transcripts** — UI แบบฟองแชทสำหรับอ่านประวัติเซสชัน -- **Alerts** — เพดานงบประมาณ ทริกเกอร์อัตราข้อผิดพลาด การตรวจจับเอเจนต์ออฟไลน์ ส่งต่อไปยัง Slack, Discord, PagerDuty, Telegram, Email -- **Approvals** — กันการลบแบบทำลายล้าง การ force push การเปลี่ยนแปลงฐานข้อมูล sudo การติดตั้งแพ็กเกจ การเรียกเครือข่าย ไว้หลังการอนุมัติแบบคลิกเดียว - -## ภาพหน้าจอ - -### 🧠 Brain — สตรีมเหตุการณ์เอเจนต์แบบเรียลไทม์ -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — การใช้โทเคนและสรุปเซสชัน -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — ฟีดการเรียกเครื่องมือแบบเรียลไทม์ -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — แจกแจงค่าใช้จ่ายตามโมเดลและเซสชัน -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — เครื่องมือเรียกดูไฟล์ในพื้นที่ทำงาน -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — สถานะความปลอดภัยและบันทึกการตรวจสอบ -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — เพดานงบประมาณ ทริกเกอร์อัตราข้อผิดพลาด เว็บฮุกไปยัง Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — กันการเรียกเครื่องมือที่มีความเสี่ยงไว้หลังการอนุมัติด้วยตนเอง กฎการป้องกันที่มีนโยบายรองรับ -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**การบล็อกก่อนการทำงานสำหรับ Claude Code** — คำสั่งเดียวติดตั้ง -hook แบบ 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 เอง -(เพราะคุณตอบไปแล้ว) เครื่องมือที่ไม่ตรงเงื่อนไขจะใช้เวลาราว ~40ms และ -ตกลงไปในโฟลว์การอนุญาตปกติของ 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 -``` - -## การพัฒนา Frontend v2 - -แอป React v2 อยู่ที่ `frontend/` และให้บริการที่ `/v2` เมื่อ Flask -server ถูกเริ่มต้นด้วยการเปิดใช้งาน 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 จะ proxy คำขอ `/api` ไปที่ -`http://localhost:8900` ทำให้แอป React สามารถคุยกับ Flask server ในเครื่อง -ได้โดยไม่ต้องตั้งค่า CORS เพิ่มเติม - -หากต้องการ build bundle ที่จะแพ็กไปพร้อมกับแพ็กเกจ Python: - -```bash -cd frontend -npm run build -``` - -bundle สำหรับใช้งานจริงจะถูกเขียนไปที่ `clawmetry/static/v2/dist/` - -## ความเข้ากันได้ของรันไทม์ / เอเจนต์ - -ClawMetry สังเกตการณ์รันไทม์เอเจนต์ AI ได้หลายตัว ไม่ใช่แค่ OpenClaw รันไทม์ที่ไม่ใช่ OpenClaw แต่ละตัวมีตัวปรับอ่านเฉพาะที่แปลงรูปแบบเซสชันดั้งเดิมของมันให้เป็นรูปทรงข้อมูลรวมของ ClawMetry แดมอนจะนำเข้าสิ่งเหล่านี้เข้าสู่ DuckDB store + สแนปช็อตคลาวด์ตัวเดียวกัน โดยติดแท็กด้วยรันไทม์ และแท็บ Session replay จะแสดง **ตัวสลับรันไทม์** เมื่อมีมากกว่าหนึ่งรันไทม์อยู่ ดู [`docs/compatibility.md`](docs/compatibility.md) สำหรับตารางเปรียบเทียบทั้งหมด + คู่มือการเพิ่มรันไทม์ และ [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) สำหรับความรู้เบื้องต้นเกี่ยวกับตระกูล OpenClaw - -กำลังใช้เครื่องมือความปลอดภัยเอเจนต์ [numbat ของ Perplexity](https://github.com/perplexityai/numbat) อยู่หรือเปล่า? ClawMetry นำเข้าผลการตรวจพบและการตัดสินใจบังคับใช้ของมันได้ทันที ดู [`docs/NUMBAT.md`](docs/NUMBAT.md) - -| Runtime / Agent | สถานะ | Live Popup | หมายเหตุ | -|---|---|---|---| -| **OpenClaw** | รองรับโดยตรง | รันไทม์อ้างอิง ตรวจจับอัตโนมัติ | -| **PicoClaw** | ตัวปรับเบต้า | `providers.Message` JSONL แบบแบน (`~/.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` บันทึกการสนทนาแบบ Chat/composer โมเดล | -| **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` การทำงานของ workflow การรันโหนด พรอมต์ AI Agent โมเดล + โทเคนในกรณีที่ n8n บันทึกไว้ | -| **Antigravity** | ตัวปรับเบต้า | Brain JSONL ใต้ `~/.gemini//brain/` บทสนทนา ขั้นตอนเครื่องมือ ความคิด การแบ่งโทเคน Gemini ต่อการสร้าง + ค่าใช้จ่าย การใช้พลังงานจากการสร้างเบื้องหลัง | -| **GitHub Copilot** | ตัวปรับเบต้า | Copilot CLI `events.jsonl` ใต้ `~/.copilot/session-state/` + บัญชีการใช้งานต่อการเรียก `session-store.db` บทสนทนา การเรียกเครื่องมือ การกำหนดเส้นทางโมเดล การแบ่งโทเคนที่คำนึงถึงแคช ค่าใช้จ่ายเครดิต AI ที่เรียกเก็บโดยผู้ให้บริการ | -| **Grok** | ตัวปรับเบต้า | xAI Grok Build CLI (ไบนารี Rust ใต้ `~/.grok/bin/grok`): บันทึกเหตุการณ์รวม `~/.grok/logs/unified.jsonl` + ต่อเซสชัน `~/.grok/sessions///{events.jsonl,summary.json}` บทสนทนา การแบ่งโทเคนต่อรอบ การกำหนดเส้นทางโมเดล และเพย์โหลดรีโปที่ขาออกของ CLI ที่จัดเตรียมไว้ใต้ `~/.grok/upload_queue/` เพื่อให้คุณเห็นว่าอะไรออกจากเครื่องของคุณไปบ้าง | - -"ตัวปรับเบต้า" หมายความว่า ClawMetry มีตัวอ่านสำหรับรูปแบบไฟล์บนดิสก์จริงของรันไทม์นั้น แต่ละตัวถูกสร้างขึ้น + ตรวจสอบยืนยันกับการติดตั้งจริงบนเครื่องจริง (ดู `tests/fixtures/runtimes//`) ตัวปรับเป็นแบบอ่านอย่างเดียว และแต่ละตัวจะซื่อสัตย์กับสิ่งที่รันไทม์ของมันเก็บไว้จริง (เช่น PicoClaw/NanoClaw/Cursor ไม่ได้เขียนค่าใช้จ่ายโทเคนลงดิสก์) เมื่อมีหลายรันไทม์ทำงานบนโหนดเดียว ตัวสลับรันไทม์จะจำกัดขอบเขตมุมมองเซสชันไปที่ตัวใดตัวหนึ่งเพื่อการเจาะลึกที่สะอาดตา - -## ติดตามเอเจนต์ SDK ใดก็ได้ — การระบุค่าใช้จ่ายนอกลูป - -รันไทม์ทั้งหมดด้านบนบันทึกเซสชันลงดิสก์ แต่ **เอเจนต์ที่ใช้งานจริง** ของคุณเอง ไม่ว่าจะสร้างด้วย OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B หรือลูป `httpx` ธรรมดา ไม่ได้ทำแบบนั้น ตัวสกัดกั้นแบบไม่ต้องตั้งค่าของ ClawMetry ยังคงจับการเรียก LLM ของมันได้ (ค่าใช้จ่าย โทเคน เวลาแฝง ข้อผิดพลาด) ด้วยการแพตช์ `httpx`/`requests` แบบ monkey-patch: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (หรือตัวแปรสภาพแวดล้อม `CLAWMETRY_SOURCE=support-agent`) จะแท็กแต่ละการเรียกด้วย **แหล่งที่มีชื่อ** ทำให้ทุกผลิตภัณฑ์ที่คุณรันปรากฏเป็นบรรทัดของตัวเองระดับหนึ่งที่สามารถระบุค่าใช้จ่ายได้ ในการ์ด **🔌 Out-loop sources** บนแท็บ Overview ของแดชบอร์ด ทั้งจำนวนการเรียก ผู้ให้บริการ เวลาแฝง อัตราข้อผิดพลาดต่อเอเจนต์ ไม่ได้ตั้งค่าแหล่งไว้เหรอ? การเรียกยังคงถูกติดตามอยู่ เพียงแต่การ์ดจะถูกซ่อนไว้ - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -นี่คือชั้นข้อมูลเดียวกับที่ตัวปรับรันไทม์ป้อนเข้า (DuckDB → สแนปช็อตคลาวด์) ดังนั้นแหล่งที่มานอกลูปจึงซิงก์ไปยังแดชบอร์ดคลาวด์เหมือนกับทุกอย่างอื่น แบบเข้ารหัสตั้งแต่ต้นทางถึงปลายทาง - -## OpenTelemetry — เป็นกลางต่อผู้ให้บริการ ส่งการติดตามไปที่ไหนก็ได้ - -ClawMetry พูดภาษา **OpenTelemetry** ได้ทั้งสองทิศทาง โดยใช้ **มาตรฐาน semantic conventions ของ GenAI** ดังนั้นการติดตามเอเจนต์ของคุณจะไม่ถูกล็อกไว้กับเครื่องมือใดเครื่องมือหนึ่ง - -**ส่งออก** ทุกเซสชัน ทั้งการเรียก LLM เครื่องมือ เอเจนต์ย่อย โทเคน ค่าใช้จ่าย เป็น OTLP/HTTP GenAI spans ไปยังตัวรวบรวมใดก็ได้ (Datadog, Grafana, Honeycomb หรือ OTel Collector ของคุณเอง): +## ใช้งานได้กับ 23 รันไทม์ของเอเจนต์ -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -ส่วนหัวการยืนยันตัวตนและช่วงเวลาการดึงข้อมูลเป็นตัวแปรสภาพแวดล้อมที่เลือกใช้ได้: +**ฟรีในแอปโอเพนซอร์ส:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**นำเข้า** ตัวรับ OTLP ในตัวรับ traces, logs และ metrics จากที่อื่นได้ที่ `/v1/traces`, `/v1/logs` และ `/v1/metrics` ชี้แอปที่ตั้งค่า OpenTelemetry ไว้แล้วมาที่นี่: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -การติดตามและล็อกแบบ OTLP/JSON ใช้งานได้บน `pip install clawmetry` ธรรมดา ไม่ต้องมีส่วนเสริม การนำเข้าแบบ Protobuf (และ metrics แบบ OTLP/JSON) ต้องใช้ `pip install clawmetry[otel]` แอปที่กำหนด `service.name` ของตัวเองจะปรากฏเป็นเอเจนต์ของตัวเองในตัวสลับรันไทม์ พร้อมค่าใช้จ่ายและโทเคนของมันเอง - -คุณจะได้ทั้งแดชบอร์ด ClawMetry แบบไม่ต้องตั้งค่าและทำงานในเครื่องเป็นหลัก **และ** ข้อมูลของคุณในแบ็กเอนด์ใดก็ตามที่ทีมของคุณใช้งานอยู่แล้ว ไม่มีการล็อกอินและไม่ต้องติดตั้งเอเจนต์ตัวที่สอง - -## การกำหนดค่า - -คนส่วนใหญ่ไม่ต้องตั้งค่าอะไรเลย ClawMetry ตรวจจับพื้นที่ทำงาน ล็อก เซสชัน และ crons ของคุณโดยอัตโนมัติ - -หากต้องการปรับแต่ง: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -ตัวเลือกทั้งหมด: `clawmetry --help` - -## ช่องทางที่รองรับ - -ClawMetry แสดงกิจกรรมแบบเรียลไทม์สำหรับทุกช่องทางของ OpenClaw ที่คุณตั้งค่าไว้ เฉพาะช่องทางที่ตั้งค่าไว้จริงใน `openclaw.json` ของคุณเท่านั้นที่จะปรากฏในไดอะแกรม Flow ส่วนช่องทางที่ยังไม่ได้ตั้งค่าจะถูกซ่อนโดยอัตโนมัติ - -คลิกที่โหนดช่องทางใด ๆ ใน Flow เพื่อดูมุมมองฟองแชทแบบเรียลไทม์พร้อมจำนวนข้อความเข้า/ออก - -| ช่องทาง | สถานะ | Live Popup | หมายเหตุ | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ เต็มรูปแบบ | ✅ | ข้อความ สถิติ รีเฟรชทุก 10 วินาที | -| 💬 **iMessage** | ✅ เต็มรูปแบบ | ✅ | อ่าน `~/Library/Messages/chat.db` โดยตรง | -| 💚 **WhatsApp** | ✅ เต็มรูปแบบ | ✅ | ผ่าน WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ เต็มรูปแบบ | ✅ | ผ่าน signal-cli | -| 🟣 **Discord** | ✅ เต็มรูปแบบ | ✅ | ตรวจจับกิลด์ + ช่องทาง | -| 🟪 **Slack** | ✅ เต็มรูปแบบ | ✅ | ตรวจจับเวิร์กสเปซ + ช่องทาง | -| 🌐 **Webchat** | ✅ เต็มรูปแบบ | ✅ | เซสชัน web UI ในตัว | -| 📡 **IRC** | ✅ เต็มรูปแบบ | ✅ | UI ฟองแชทสไตล์เทอร์มินัล | -| 🍏 **BlueBubbles** | ✅ เต็มรูปแบบ | ✅ | iMessage ผ่าน BlueBubbles REST API | -| 🔵 **Google Chat** | ✅ เต็มรูปแบบ | ✅ | ผ่าน Chat API webhooks | -| 🟣 **MS Teams** | ✅ เต็มรูปแบบ | ✅ | ผ่านปลั๊กอินบอท Teams | -| 🔷 **Mattermost** | ✅ เต็มรูปแบบ | ✅ | แชททีมแบบโฮสต์เอง | -| 🟩 **Matrix** | ✅ เต็มรูปแบบ | ✅ | กระจายศูนย์ รองรับ E2EE | -| 🟢 **LINE** | ✅ เต็มรูปแบบ | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ เต็มรูปแบบ | ✅ | ข้อความส่วนตัว NIP-04 แบบกระจายศูนย์ | -| 🟣 **Twitch** | ✅ เต็มรูปแบบ | ✅ | แชทผ่านการเชื่อมต่อ IRC | -| 🔷 **Feishu/Lark** | ✅ เต็มรูปแบบ | ✅ | การสมัครสมาชิกเหตุการณ์ผ่าน WebSocket | -| 🔵 **Zalo** | ✅ เต็มรูปแบบ | ✅ | Zalo Bot API | - -> **การตรวจจับอัตโนมัติ:** ClawMetry อ่าน `~/.openclaw/openclaw.json` ของคุณ และแสดงผลเฉพาะช่องทางที่คุณตั้งค่าไว้จริงเท่านั้น ไม่ต้องตั้งค่าด้วยตนเอง - -## การใช้งานบน Docker - -อยากรัน ClawMetry ในคอนเทนเนอร์ไหม? ไม่มีปัญหา! 🐳 - -**เริ่มต้นอย่างรวดเร็วด้วย Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**ตัวอย่าง Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` +**ในแผนแบบชำระเงิน:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -> **หมายเหตุ:** เมื่อรันใน Docker ให้ mount ไดเรกทอรีข้อมูล + ล็อกของเอเจนต์ของคุณ (เช่น `~/.openclaw`, `~/.claude`, `~/.codex`) เพื่อให้ ClawMetry ตรวจจับการตั้งค่าของคุณโดยอัตโนมัติ +ทุกรันไทม์ได้แดชบอร์ดเดียวกัน รันได้พร้อมกันหลายตัว และตัวสลับที่ส่วนหัว +จะปรับขอบเขตทุกแท็บให้ตรงกับรันไทม์ที่เลือก -## ความต้องการของระบบ +สร้างเอเจนต์ของคุณเองด้วย SDK แทนหรือเปล่า? ตัวดักจับ (interceptor) ก็ติดตาม +การเรียก LLM ของมันได้เช่นกัน ดูที่ [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md) -- Python 3.8+ -- Flask (ติดตั้งอัตโนมัติผ่าน pip) -- รันไทม์เอเจนต์ AI บนเครื่องเดียวกัน: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok หรือ QM (หรือ volume ที่ mount ไว้สำหรับ Docker) -- Linux หรือ macOS +## สิ่งที่คุณจะได้รับ -## การรองรับ NemoClaw / OpenShell +- **เซสชันและบทถอดความ**: สิ่งที่แต่ละเอเจนต์ทำ ทีละขั้นตอน พร้อมการเล่นซ้ำ +- **ต้นทุนและโทเคน**: แยกตามรันไทม์ โมเดล เซสชัน และวัน พร้อมการตั้งค่าสถานะความผิดปกติ +- **Flow**: ไดอะแกรมสดของข้อความที่เคลื่อนผ่านช่องทาง โมเดล และเครื่องมือ +- **Brain**: สตรีมเหตุการณ์การให้เหตุผลและการเรียกใช้เครื่องมือแบบเรียลไทม์ +- **หน่วยความจำและทักษะ**: ไฟล์และทักษะที่แต่ละรันไทม์โหลดขึ้นมาจริง +- **สถานะและบันทึก**: ดิสก์ หน่วยความจำ อัตราข้อผิดพลาด ขีดจำกัดอัตรา สตรีมบันทึกแบบสด +- **การแจ้งเตือน**: เพดานงบประมาณ การพุ่งขึ้นของข้อผิดพลาด เอเจนต์ออฟไลน์ ส่งไปยัง Slack, Discord, PagerDuty, Telegram, อีเมล +- **การอนุมัติ**: หยุดการเรียกใช้เครื่องมือที่มีความเสี่ยง *ก่อน* ที่จะรัน และอนุมัติจากโทรศัพท์ของคุณ ([วิธีการ](docs/APPROVALS.md)) -ClawMetry ตรวจจับ [NemoClaw](https://github.com/NVIDIA/NemoClaw) โดยอัตโนมัติ ซึ่งเป็นตัวห่อความปลอดภัยระดับองค์กรของ NVIDIA สำหรับ OpenClaw ที่รันเอเจนต์ภายในคอนเทนเนอร์ OpenShell แบบแซนด์บ็อกซ์ +## ราคา -ในกรณีส่วนใหญ่ไม่จำเป็นต้องตั้งค่าเพิ่มเติม แดมอนซิงก์จะค้นหาไฟล์เซสชันโดยอัตโนมัติ ไม่ว่าจะอยู่ใน `~/.openclaw/` บนโฮสต์หรือภายในคอนเทนเนอร์ OpenShell - -### วิธีการทำงาน - -ClawMetry ตรวจจับ NemoClaw ด้วยสองวิธี: - -1. **การตรวจจับไบนารี** — ตรวจสอบ CLI `nemoclaw` และรัน `nemoclaw status` เพื่อดึงข้อมูลแซนด์บ็อกซ์ -2. **การตรวจจับคอนเทนเนอร์** — สแกนคอนเทนเนอร์ Docker ที่กำลังทำงานอยู่เพื่อหาอิมเมจ `openshell`, `nemoclaw` หรือ `ghcr.io/nvidia/` จากนั้นอ่านเซสชันผ่าน volume mount หรือ `docker cp` - -ไฟล์เซสชันที่ซิงก์จากคอนเทนเนอร์ NemoClaw จะถูกแท็กด้วย `runtime=nemoclaw` และข้อมูลเมตา `container_id` ในแดชบอร์ดคลาวด์ ทำให้คุณแยกแยะจากเซสชัน OpenClaw มาตรฐานได้ในทันที - -### การตั้งค่าที่แนะนำ: แดมอนซิงก์บน HOST - -เพื่อประสบการณ์ที่ดีที่สุด ให้รันแดมอนซิงก์ของ ClawMetry บน **เครื่องโฮสต์** (ไม่ใช่ภายในแซนด์บ็อกซ์) วิธีนี้จะหลีกเลี่ยงข้อจำกัดของนโยบายเครือข่ายของ NemoClaw - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -แดมอนซิงก์จะค้นหาเซสชันภายในคอนเทนเนอร์ OpenShell ที่กำลังทำงานอยู่โดยอัตโนมัติ - -### ทางเลือกเสริม: ระบุชื่อแซนด์บ็อกซ์อย่างชัดเจน - -หากการตรวจจับอัตโนมัติไม่ทำงาน ให้ชี้ ClawMetry ไปยังแซนด์บ็อกซ์ที่ถูกต้อง: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` +| แผน | ครอบคลุมอะไร | ราคา | +|---|---|---| +| **Free** | OpenClaw + NVIDIA NemoClaw แดชบอร์ดเต็มรูปแบบ ใช้ในเครื่องเท่านั้น | $0 | +| **Starter** | รันไทม์อื่นทั้งหมดข้างต้น มุมมองกองเอเจนต์ การซิงค์คลาวด์ | $9 ต่อโหนด / เดือน | +| **Pro** | Starter + การกำกับดูแล: การอนุมัติ นโยบายความเสี่ยงของเครื่องมือ การประเมิน การตรวจจับความผิดปกติ ตัวเพิ่มประสิทธิภาพต้นทุน การส่งออก OTel | $19 ต่อโหนด / เดือน | -### การรันภายในแซนด์บ็อกซ์ (ขั้นสูง) +แผนรายปี Enterprise และตัวเลขปัจจุบันอยู่ที่ +**[clawmetry.com/pricing](https://clawmetry.com/pricing)** คีย์ใบอนุญาตแบบโฮสต์เอง +ทำงานได้โดยไม่ต้องใช้คลาวด์ (`clawmetry license`) การแบ่งฟรี/เสียเงินที่แน่นอน +อยู่ใน [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) -หากคุณจำเป็นต้องรันแดมอนซิงก์ **ภายใน** แซนด์บ็อกซ์ OpenShell ให้เพิ่มกฎ egress นี้เข้าไปในนโยบายเครือข่าย NemoClaw ของคุณ เพื่อให้มันเข้าถึง ClawMetry ingest API ได้: +## ข้อมูลของคุณอยู่ในเครื่องของคุณเสมอ -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` +ClawMetry อ่านไฟล์เซสชันและบันทึกในเครื่อง ไม่มีอะไรออกจากเครื่องของคุณ +เว้นแต่คุณจะรัน `clawmetry connect` แม้กระทั่งตอนนั้น สแนปช็อตก็ยังถูกเข้ารหัส +แบบ end-to-end ด้วยคีย์ที่ไม่เคยออกจากเครื่องของคุณ และถูกถอดรหัสในเบราว์เซอร์ของคุณ -นำไปใช้ด้วย: +## การติดตั้ง ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # จากนั้นรัน: clawmetry ``` -### พอร์ตและปลายทาง - -| ปลายทาง | พอร์ต | โปรโตคอล | จำเป็นหรือไม่ | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | ใช่ (แดมอนซิงก์ → คลาวด์) | -| `localhost:8900` | 8900 | HTTP | ใช่ (UI แดชบอร์ดในเครื่อง) | -| Docker socket (`/var/run/docker.sock`) | — | Unix socket | สำหรับการค้นหาเซสชันในคอนเทนเนอร์ | - -แดมอนซิงก์เรียกออกไปยัง `ingest.clawmetry.com` ผ่าน HTTPS เท่านั้น ไม่ต้องมีพอร์ตขาเข้า - ---- - -## การใช้งานบนคลาวด์ - -ดู **[คู่มือการทดสอบคลาวด์](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** สำหรับ SSH tunnel, reverse proxy และ Docker - -## การทดสอบ - -โปรเจกต์นี้ทดสอบด้วย BrowserStack +หรือคำสั่งบรรทัดเดียว: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +ต้องการ Python 3.8 ขึ้นไปบน macOS, Linux หรือ Windows และรันไทม์ของเอเจนต์ +อย่างน้อยหนึ่งตัวบนเครื่องเดียวกัน คำแนะนำ Docker: [docs/DOCKER.md](docs/DOCKER.md) -## Telemetry +## เอกสาร -ClawMetry ส่ง ping วงจรชีวิตการติดตั้งแบบไม่ระบุตัวตนไปที่ -`https://app.clawmetry.com/api/install`: ping `install` หนึ่งครั้งในครั้งแรก -ที่คุณรัน CLI `clawmetry` บนเครื่องใหม่ ping `update` หนึ่งครั้งใน -การรันครั้งแรกหลังจากอัปเกรดเป็นเวอร์ชันใหม่ และ ping `onboarded` -หนึ่งครั้งเมื่อคุณทำตัวเลือกการเริ่มต้นใช้งานในแดชบอร์ดเสร็จสิ้น เราใช้สิ่งนี้ -เพื่อนับจำนวนการติดตั้งจริง (ตัวเลขการดาวน์โหลดดิบจาก PyPI ประมาณ 98% เป็นมิเรอร์ CI -และการดาวน์โหลดซ้ำจากการอัปเดตอัตโนมัติ) และเพื่อเรียนรู้ว่าเฟรมเวิร์กเอเจนต์และ -เวอร์ชันใดที่ถูกใช้งานจริงอยู่บ้าง +| | | +|---|---| +| [ความเข้ากันได้ของรันไทม์](docs/compatibility.md) | สิ่งที่แต่ละตัวปรับใช้อ่าน และวิธีเพิ่มรันไทม์ใหม่ | +| [สิทธิ์การใช้งาน](docs/ENTITLEMENTS.md) | ฟรีเทียบกับเสียเงิน ตารางระดับ CLI ใบอนุญาต | +| [การอนุมัติและนโยบาย](docs/APPROVALS.md) | การควบคุมก่อนการทำงาน การให้คะแนนความเสี่ยง การอนุมัติทางโทรศัพท์ | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | ส่งออก trace ไปที่ไหนก็ได้ นำเข้า OTLP จากทุกที่ | +| [การติดตาม SDK](docs/SDK_TRACKING.md) | การระบุต้นทุนสำหรับเอเจนต์ที่คุณสร้างเอง | +| [ช่องทางแชท](docs/CHANNELS.md) | ตัวปรับใช้แชทที่แสดงใน Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | การตั้งค่า NVIDIA NemoClaw แบบแซนด์บ็อกซ์ | +| [Docker](docs/DOCKER.md) | อิมเมจ compose การเมานต์วอลุ่ม | +| [สถาปัตยกรรม](ARCHITECTURE.md) · [การพัฒนา](docs/DEVELOPMENT.md) | วิธีการทำงานภายใน การรันจากซอร์ส | +| [Telemetry](docs/TELEMETRY.md) | การ ping แบบไม่ระบุตัวตนตอนติดตั้งและตอนเปิดเดสก์ท็อป และวิธีปิด | -**สูงสุดหนึ่ง POST ต่อเหตุการณ์วงจรชีวิตต่อเวอร์ชัน** ประกอบด้วย: - -| ฟิลด์ | ตัวอย่าง | เหตุผล | -|---|---|---| -| `install_id` | UUID สุ่มที่เก็บไว้ที่ `~/.clawmetry/install_id` | ป้องกันการนับซ้ำ ไม่ระบุตัวตนจนกว่าคุณจะเชื่อมต่อการซิงก์คลาวด์อย่างชัดเจน (heartbeat ของแดมอนที่ยืนยันตัวตนแล้วจะนำพามันไป เชื่อมโยงการติดตั้งนี้กับบัญชีของคุณ) | -| `event` | `install` / `update` / `onboarded` | การติดตั้งใหม่เทียบกับการอัปเกรดจากของเดิม | -| `version` | `0.12.167` | เวอร์ชันใดบ้างที่ถูกใช้งานอยู่ | -| `os` / `os_version` | `Darwin` / `25.3.0` | ลำดับความสำคัญในการรองรับแพลตฟอร์ม | -| `python` | `3.11.15` | ตารางการรองรับเวอร์ชัน Python | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | เอเจนต์ใดที่เราควรผนวกรวมต่อไป | -| `is_ci` / `ci_provider` | `true` / `github_actions` | แยกการติดตั้งของมนุษย์ออกจากสัญญาณรบกวนจาก CI | - -**สิ่งที่เราไม่ส่ง**: IP (คลาวด์จะดึงรหัสประเทศจากฝั่งเซิร์ฟเวอร์ -จากคำขอ แล้วทิ้ง IP นั้นไป) ชื่อโฮสต์ ชื่อผู้ใช้ พาธพื้นที่ทำงาน -เนื้อหาไฟล์ api_key ของคุณ อีเมลของคุณ หรือสิ่งใดที่เป็นข้อมูลส่วนบุคคลหรือเฉพาะพื้นที่ทำงาน เพย์โหลดที่ส่งผ่านสายสามารถตรวจสอบได้ที่ -[`clawmetry/telemetry.py`](clawmetry/telemetry.py) - -**เลือกไม่เข้าร่วม** (วิธีใดวิธีหนึ่งต่อไปนี้จะปิดใช้งานถาวร): +## ภาพหน้าจอ -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: โทเคน เซสชัน สถานะ | **Brain**: สตรีมเหตุการณ์ของเอเจนต์แบบสด | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: แยกตามโมเดลและเซสชัน | **Approvals**: ควบคุมการเรียกใช้เครื่องมือที่มีความเสี่ยง | -ความล้มเหลวของเครือข่ายที่นี่จะไม่บล็อก `clawmetry` จากการทำงานเลย ping นี้ -เป็นแบบยิงแล้วลืมบนเธรดแดมอนที่มี timeout 3 วินาที +เพิ่มเติม แยกตามรันไทม์: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md) -## ประวัติดวงดาว +## ประวัติดาว @@ -433,13 +114,8 @@ touch ~/.clawmetry/notelemetry # persistent file marker -## สัญญาอนุญาต - -MIT +## ใบอนุญาต ---- +MIT · สร้างโดย [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 ดูความคิดของเอเจนต์คุณ
- สร้างโดย @vivekchand · clawmetry.com · ส่วนหนึ่งของระบบนิเวศ OpenClaw -

+ diff --git a/docs/i18n/tr/README.md b/docs/i18n/tr/README.md index bb361bd25d..3cdc060c97 100644 --- a/docs/i18n/tr/README.md +++ b/docs/i18n/tr/README.md @@ -1,19 +1,18 @@ - + > Türkçe translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Ajanınızın düşüncelerini görün.** **20 farklı AI ajan çalışma zamanı** için gerçek zamanlı gözlemlenebilirlik: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex ve 16 tane daha. Tüm ajan filonuz için tek bir gösterge paneli. +**Aracınızın düşünme biçimini görün.** **23 yapay zeka ajanı çalışma zamanı** için gerçek zamanlı gözlemlenebilirlik: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex ve 19 tane daha. Tüm ajan filonuz için tek bir gösterge paneli. -> 🌐 **Bunu şu dillerde okuyun:** [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) · [daha fazlası →](docs/i18n/) +> 🌐 **Bunu şu dilde okuyun:** [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) · [daha fazlası →](docs/i18n/) Tek komut. Sıfır yapılandırma. Her şeyi otomatik algılar. @@ -21,413 +20,89 @@ Tek komut. Sıfır yapılandırma. Her şeyi otomatik algılar. pip install clawmetry && clawmetry ``` -**http://localhost:8900** adresinde açılır ve işiniz biter. +**http://localhost:8900** adresinde açılır. Sıfır yapılandırma: zaten sahip olduğunuz ajan çalışma zamanlarını bulur, onları salt okunur olarak okur ve nasıl çalıştıkları konusunda hiçbir şeyi değiştirmez. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 20 ajan çalışma zamanıyla çalışır - -ClawMetry, OpenClaw için bir gözlemlenebilirlik aracı olarak başladı; şimdi ise makinenizdeki her çalışma zamanını otomatik algılayarak **tüm ajan filonuzu** tek bir gösterge panelinde ölçümlüyor: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw ve NemoClaw, açık kaynak uygulamada ücretsizdir; diğer çalışma zamanları ise ClawMetry Cloud veya kendi barındırdığınız bir Pro lisansı ile devreye girer. Üstbilgiden çalışma zamanını değiştirin; maliyet, token, araçlar, izler gibi her sekme otomatik olarak o çalışma zamanına göre kapsamlanır. Tam ücretsiz/ücretli ayrımı, katman matrisi, `/api/entitlement` şeması ve `clawmetry license` CLI'si için **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** dosyasına bakın. - -## Neler Elde Edersiniz - -- **Flow** — Kanallar, beyin, araçlar ve geri dönüş arasında akan mesajları gösteren canlı animasyonlu diyagram -- **Overview** — Sağlık kontrolleri, etkinlik ısı haritası, oturum sayıları, model bilgisi -- **Usage** — Günlük/haftalık/aylık dökümlerle token ve maliyet takibi -- **Sessions** — Model, token, son etkinlik bilgileriyle aktif ajan oturumları -- **Crons** — Durum, sonraki çalışma zamanı, süre bilgileriyle zamanlanmış işler -- **Logs** — Renk kodlu gerçek zamanlı log akışı -- **Memory** — SOUL.md, MEMORY.md, AGENTS.md ve günlük notları gözden geçirin -- **Transcripts** — Oturum geçmişlerini okumak için sohbet balonu arayüzü -- **Alerts** — Bütçe sınırları, hata oranı tetikleyicileri, ajan çevrimdışı algılama; Slack, Discord, PagerDuty, Telegram, E-posta'ya yönlendirme -- **Approvals** — Yıkıcı silme işlemlerini, zorla push'ları, veritabanı değişikliklerini, sudo'yu, paket kurulumlarını, ağ çağrılarını tek tıkla onaya kilitleyin - -## Ekran Görüntüleri +## 23 ajan çalışma zamanıyla çalışır -### 🧠 Brain — Canlı ajan olay akışı -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) +**Açık kaynak uygulamada ücretsiz:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### 📊 Overview — Token kullanımı ve oturum özeti -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) +**Ücretli planda:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -### ⚡ Flow — Gerçek zamanlı araç çağrısı akışı -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) +Her çalışma zamanı aynı gösterge panelini alır. Birden fazlasını aynı anda çalıştırın ve üstteki geçiş anahtarı her sekmeyi bunlardan birine yeniden odaklar. -### 💰 Tokens — Modele ve oturuma göre maliyet dökümü -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) +Kendi ajanınızı bir SDK üzerinde mi oluşturdunuz? İzleyici (interceptor) onun LLM çağrılarını da takip eder. Bkz. [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -### 🧬 Memory — Çalışma alanı dosya tarayıcısı -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) +## Neler elde edersiniz -### 🔐 Security — Güvenlik duruşu ve denetim günlüğü -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) +- **Oturumlar ve dökümler**: her ajanın ne yaptığı, tur tur, tekrar oynatma ile +- **Maliyet ve token'lar**: çalışma zamanı, model, oturum ve gün bazında, anomali işaretleriyle +- **Akış**: kanallar, modeller ve araçlar arasında hareket eden mesajların canlı diyagramı +- **Beyin**: gerçekleştiği anda akan muhakeme ve araç çağrısı olay akışı +- **Bellek ve beceriler**: her çalışma zamanının gerçekte yüklediği dosyalar ve beceriler +- **Sağlık ve günlükler**: disk, bellek, hata oranları, hız sınırları, canlı günlük akışı +- **Uyarılar**: bütçe sınırları, hata artışları, ajan çevrimdışı durumu; Slack, Discord, PagerDuty, Telegram, E-posta'ya yönlendirilir +- **Onaylar**: riskli araç çağrılarını çalışmadan *önce* duraklatın ve telefonunuzdan onaylayın ([nasıl](docs/APPROVALS.md)) -### 🚨 Alerts — Bütçe sınırları, hata oranı tetikleyicileri, Slack / Discord / PagerDuty / E-posta'ya webhook'lar -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — Riskli araç çağrılarını manuel onaya kilitleyin; politika destekli koruma kuralları -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Claude Code için yürütme öncesi engelleme** — tek bir komut, eşleşen -araç çağrılarını çalışmadan *önce* duraklatan ve kararınızı bekleyen bir -PreToolUse hook'u kurar ([bulut push bildirimleri](https://app.clawmetry.com/push) -etkinken telefonunuzdan tek dokunuşla): - -```bash -clawmetry hooks install # ~/.claude/settings.json dosyasına yazar (idempotent) -clawmetry hooks status # neyin bağlı olduğunu ve kaç politikanın etkin olduğunu gösterir -clawmetry hooks uninstall # yalnızca ClawMetry'nin girdilerini kaldırır -``` - -Bir reddetme yalnızca o tek araç çağrısını engeller; ajan oturumunu korur ve -başka bir yaklaşım deneyebilir. Telefonunuzdan onaylamak, Claude Code'un -kendi izin istemini atlar (zaten yanıtladınız). Eşleşmeyen araçlar ~40ms'e -mal olur ve Claude Code'un normal izin akışına düşer. Ayrıca Claude Code'un -kendisi sizi beklerken de telefonunuza push bildirimi alırsınız -(`permission_prompt` / `idle_prompt` bildirimleri). - -## Kurulum - -**Tek satırlık (önerilen):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**Kaynaktan:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` - -## v2 Ön Yüz Geliştirme - -v2 React uygulaması `frontend/` içinde bulunur ve v2 etkinleştirilerek -başlatıldığında Flask sunucusu tarafından `/v2` adresinde sunulur. - -Geliştirme sırasında iki terminal kullanın: - -```bash -# Terminal 1: :8900 üzerinde Flask API/sunucu -CLAWMETRY_V2=1 python3 dashboard.py -``` +## Fiyatlandırma -```bash -# Terminal 2: :5173 üzerinde Vite geliştirme sunucusu -cd frontend -nvm use -npm ci -npm run dev -``` - -`http://localhost:5173/v2/` adresini açın. Vite, `/api` isteklerini -`http://localhost:8900` adresine yönlendirir, böylece React uygulaması -ekstra CORS ayarına gerek kalmadan yerel Flask sunucusuyla konuşabilir. - -Python paketiyle birlikte gönderilecek paketi (bundle) oluşturmak için: - -```bash -cd frontend -npm run build -``` - -Üretim paketi `clawmetry/static/v2/dist/` içine yazılır. - -## Çalışma Zamanı / Ajan Uyumluluğu - -ClawMetry yalnızca OpenClaw'ı değil, birçok AI ajan çalışma zamanını gözlemler. OpenClaw dışındaki her çalışma zamanı, kendi yerel oturum biçimini ClawMetry'nin birleşik şekillerine dönüştüren özel bir okuyucu bağdaştırıcısıyla gelir; daemon bunları aynı DuckDB deposuna + bulut anlık görüntüsüne, çalışma zamanı etiketiyle birlikte aktarır ve birden fazla çalışma zamanı mevcut olduğunda Session replay sekmesi bir **çalışma zamanı değiştirici** gösterir. Tam matris + çalışma zamanı ekleme rehberi için [`docs/compatibility.md`](docs/compatibility.md) dosyasına, OpenClaw ailesine giriş için ise [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) dosyasına bakın. - -[Perplexity'nin numbat](https://github.com/perplexityai/numbat) ajan güvenlik aracını mı kullanıyorsunuz? ClawMetry, bulgularını ve uygulama kararlarını kutudan çıktığı gibi alır; bkz. [`docs/NUMBAT.md`](docs/NUMBAT.md). - -| Çalışma Zamanı / Ajan | Durum | Notlar | +| Plan | Neyi kapsar | Fiyat | |---|---|---| -| **OpenClaw** | Yerel | Referans çalışma zamanı, otomatik algılanır | -| **PicoClaw** | Beta bağdaştırıcı | Düz `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`). Transkriptler, model, araç çağrıları. | -| **NanoClaw** | Beta bağdaştırıcı | Oturum başına SQLite (`data/v2-sessions`). Transkriptler + mesaj sayıları. | -| **Hermes** | Beta bağdaştırıcı | SQLite `~/.hermes/state.db`. Transkriptler, model, token/maliyet. | -| **Claude Code** | Beta bağdaştırıcı | JSONL `~/.claude/projects/.../.jsonl`. Transkriptler, model, araç çağrıları + düşünme, token kullanımı. | -| **Codex** | Beta bağdaştırıcı | Rollout JSONL `~/.codex/sessions/...`. Transkriptler, model, araç çağrıları, token kullanımı. | -| **Cursor** | Beta bağdaştırıcı | SQLite `state.vscdb`. Sohbet/composer transkriptleri, model. | -| **Aider** | Beta bağdaştırıcı | Proje başına `.aider.chat.history.md`. Transkriptler, model, token sayıları. | -| **Goose** | Beta bağdaştırıcı | SQLite `~/.local/share/goose`. Transkriptler, model, araç çağrıları, token toplamları. | -| **opencode** | Beta bağdaştırıcı | SQLite `~/.local/share/opencode`. Transkriptler, model, araç çağrıları, token + maliyet. | -| **Qwen Code** | Beta bağdaştırıcı | JSONL `~/.qwen/projects/.../chats`. Transkriptler, model, araç çağrıları, token kullanımı. | -| **Pi** | Beta bağdaştırıcı | JSONL `~/.pi/agent/sessions`. Transkriptler, model, araç çağrıları, token + maliyet. | -| **Deep Agents** | Beta bağdaştırıcı | SQLite `~/.deepagents/.state/sessions.db`. Transkriptler, model, araç çağrıları, token + maliyet. | -| **n8n** | Beta bağdaştırıcı | SQLite `~/.n8n/database.sqlite`. İş akışı yürütmeleri, düğüm çalışmaları, AI Agent istemleri, n8n'nin kaydettiği yerlerde model + token. | -| **Antigravity** | Beta bağdaştırıcı | `~/.gemini//brain/` altında beyin JSONL'i. Konuşmalar, araç adımları, düşünme, üretim başına Gemini token dağılımı + maliyet, arka plan üretim tüketimi. | -| **GitHub Copilot** | Beta bağdaştırıcı | `~/.copilot/session-state/` altında Copilot CLI `events.jsonl` + çağrı başına kullanım defteri olan `session-store.db`. Konuşmalar, araç çağrıları, model yönlendirme, önbellek duyarlı token dağılımı, satıcı tarafından faturalandırılan AI-kredi maliyeti. | -| **Grok** | Beta bağdaştırıcı | xAI Grok Build CLI (`~/.grok/bin/grok` altında Rust ikili dosyası): genel olay günlüğü `~/.grok/logs/unified.jsonl` + oturum başına `~/.grok/sessions///{events.jsonl,summary.json}`. Konuşmalar, tur başına token dağılımı, model yönlendirme ve CLI'nin makinenizden çıkan içeriği görebilmeniz için `~/.grok/upload_queue/` altında hazırlanan giden repo yükü. | - -"Beta bağdaştırıcı", ClawMetry'nin o çalışma zamanının gerçek disk üzerindeki biçimi için bir okuyucu gönderdiği anlamına gelir; her biri gerçek bir makinedeki gerçek bir kurulum üzerinde oluşturulmuş ve doğrulanmıştır (bkz. `tests/fixtures/runtimes//`). Bağdaştırıcılar salt okunurdur; her biri kendi çalışma zamanının diske gerçekte ne kaydettiği konusunda dürüsttür (örneğin PicoClaw/NanoClaw/Cursor token maliyetini diske yazmaz). Bir düğümde birden fazla çalışma zamanı çalıştığında, çalışma zamanı değiştirici oturumlar görünümünü tek birine kapsamlayarak temiz bir derinlemesine inceleme sağlar. - -## Herhangi bir SDK ajanını izleyin — döngü dışı maliyet ilişkilendirme - -Yukarıdaki çalışma zamanlarının hepsi oturumları diske yazar. Sizin kendi **üretim ajanınız** ise; OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B veya düz bir `httpx` döngüsü üzerine kurduğunuz o ajan, bunu yapmaz. ClawMetry'nin sıfır yapılandırmalı yakalayıcısı, `httpx`/`requests`'i maymun yaması (monkey-patch) yaparak yine de LLM çağrılarını (maliyet, token, gecikme, hatalar) yakalar: - -```python -import clawmetry.track # yakalayıcıyı etkinleştir -clawmetry.track.set_source("support-agent") # bu ürünü adlandır - -# ...ajanınız normal şekilde çalışır; artık her LLM çağrısı izlenip ilişkilendirilir. -``` - -`set_source()` (veya `CLAWMETRY_SOURCE=support-agent` ortam değişkeni), her çağrıyı **adlandırılmış bir kaynak** ile etiketler; böylece çalıştırdığınız her ürün, gösterge panelinin Overview sekmesindeki **🔌 Döngü dışı kaynaklar** kartında kendi başına, maliyeti ilişkilendirilebilir bir satır olarak görünür; ajan başına çağrılar, sağlayıcılar, gecikme, hata oranı. Kaynak ayarlanmadıysa? Çağrılar yine izlenir; kart sadece gizli kalır. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Bu, çalışma zamanı bağdaştırıcılarının beslediği aynı veri katmanıdır (DuckDB → bulut anlık görüntüsü), bu yüzden döngü dışı kaynaklar da her şey gibi, uçtan uca şifrelenmiş olarak buluta senkronize edilir. - -## OpenTelemetry — satıcıdan bağımsız, izlerinizi istediğiniz yere gönderin - -ClawMetry, **GenAI semantik kurallarını** kullanarak her iki yönde de **OpenTelemetry** konuşur, böylece ajan izleriniz asla tek bir araca kilitlenmez. - -Her oturumu; LLM çağrıları, araçlar, alt ajanlar, token'lar, maliyet, herhangi bir toplayıcıya (Datadog, Grafana, Honeycomb veya kendi OTel Collector'ınız) OTLP/HTTP GenAI izleri olarak **dışa aktarın**: - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# eşdeğer olarak: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Kimlik doğrulama başlıkları ve sorgulama aralığı isteğe bağlı ortam değişkenleridir: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # ek HTTP başlıkları -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # saniye (varsayılan 60) -``` - -**İçe Aktar** — yerleşik OTLP alıcısı, `/v1/traces`, `/v1/logs` ve `/v1/metrics` adreslerinde başka herhangi bir yerden izleri, günlükleri ve metrikleri kabul eder. OpenTelemetry ile donatılmış herhangi bir uygulamayı buna yönlendirin: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON izleri ve günlükleri, ekstra bir şey gerekmeden düz bir `pip install clawmetry` üzerinde çalışır. Protobuf içe aktarma (ve OTLP/JSON metrikleri) `pip install clawmetry[otel]` gerektirir. Kendi `service.name` değerini ayarlayan bir uygulama, çalışma zamanı değiştiricide kendi maliyeti ve token'larıyla birlikte kendi ajanı olarak görünür. - -Hem sıfır yapılandırmalı, yerel öncelikli ClawMetry gösterge panelini **hem de** verilerinizi ekibinizin zaten çalıştırdığı herhangi bir arka uçta elde edersiniz; kilitlenme yok, kurulacak ikinci bir ajan yok. - -## Yapılandırma - -Çoğu kişinin herhangi bir yapılandırmaya ihtiyacı yoktur. ClawMetry çalışma alanınızı, günlüklerinizi, oturumlarınızı ve zamanlanmış işlerinizi otomatik algılar. - -Özelleştirme ihtiyacınız varsa: - -```bash -clawmetry --port 9000 # Özel port (varsayılan: 8900) -clawmetry --host 127.0.0.1 # Yalnızca localhost'a bağlan -clawmetry --workspace ~/mybot # Özel çalışma alanı yolu -clawmetry --name "Alice" # Flow görselleştirmesindeki adınız -``` - -Tüm seçenekler: `clawmetry --help` - -## Desteklenen Kanallar - -ClawMetry, yapılandırdığınız her OpenClaw kanalı için canlı etkinlik gösterir. Yalnızca `openclaw.json` dosyanızda gerçekten kurulu olan kanallar Flow diyagramında görünür; yapılandırılmamış olanlar otomatik olarak gizlenir. - -Flow'daki herhangi bir kanal düğümüne tıklayarak gelen/giden mesaj sayılarıyla canlı bir sohbet balonu görünümü görebilirsiniz. - -| Kanal | Durum | Canlı Açılır Pencere | Notlar | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Tam | ✅ | Mesajlar, istatistikler, 10s yenileme | -| 💬 **iMessage** | ✅ Tam | ✅ | `~/Library/Messages/chat.db` dosyasını doğrudan okur | -| 💚 **WhatsApp** | ✅ Tam | ✅ | WhatsApp Web (Baileys) üzerinden | -| 🔵 **Signal** | ✅ Tam | ✅ | signal-cli üzerinden | -| 🟣 **Discord** | ✅ Tam | ✅ | Sunucu + kanal algılama | -| 🟪 **Slack** | ✅ Tam | ✅ | Çalışma alanı + kanal algılama | -| 🌐 **Webchat** | ✅ Tam | ✅ | Yerleşik web arayüzü oturumları | -| 📡 **IRC** | ✅ Tam | ✅ | Terminal tarzı balon arayüzü | -| 🍏 **BlueBubbles** | ✅ Tam | ✅ | BlueBubbles REST API üzerinden iMessage | -| 🔵 **Google Chat** | ✅ Tam | ✅ | Chat API webhook'ları üzerinden | -| 🟣 **MS Teams** | ✅ Tam | ✅ | Teams bot eklentisi üzerinden | -| 🔷 **Mattermost** | ✅ Tam | ✅ | Kendi barındırdığınız takım sohbeti | -| 🟩 **Matrix** | ✅ Tam | ✅ | Merkezi olmayan, E2EE desteği | -| 🟢 **LINE** | ✅ Tam | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Tam | ✅ | Merkezi olmayan NIP-04 DM'ler | -| 🟣 **Twitch** | ✅ Tam | ✅ | IRC bağlantısı üzerinden sohbet | -| 🔷 **Feishu/Lark** | ✅ Tam | ✅ | WebSocket olay aboneliği | -| 🔵 **Zalo** | ✅ Tam | ✅ | Zalo Bot API | - -> **Otomatik algılama:** ClawMetry, `~/.openclaw/openclaw.json` dosyanızı okur ve yalnızca gerçekten yapılandırdığınız kanalları oluşturur. Manuel kurulum gerekmez. - -## Docker ile Dağıtım - -ClawMetry'yi bir konteynerde mi çalıştırmak istiyorsunuz? Sorun değil! 🐳 - -**Docker ile hızlı başlangıç:** - -```bash -# İmajı oluştur -docker build -t clawmetry . - -# Varsayılan ayarlarla çalıştır -docker run -p 8900:8900 clawmetry - -# Veya ajanınızın veri dizinini bağlayın (gösterilen: OpenClaw'ın ~/.openclaw'ı) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose örneği:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Not:** Docker içinde çalıştırırken, ClawMetry'nin kurulumunuzu otomatik algılayabilmesi için ajanınızın veri + günlük dizinlerini (örn. `~/.openclaw`, `~/.claude`, `~/.codex`) bağlayın. - -## Gereksinimler - -- Python 3.8+ -- Flask (pip aracılığıyla otomatik kurulur) -- Aynı makinede bir AI ajan çalışma zamanı: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok veya QM (veya Docker için bağlanmış birimler) -- Linux veya macOS - -## NemoClaw / OpenShell Desteği - -ClawMetry, OpenClaw ajanlarını sandbox'lanmış OpenShell konteynerleri içinde çalıştıran NVIDIA'nın kurumsal güvenlik sarmalayıcısı [NemoClaw](https://github.com/NVIDIA/NemoClaw)'yu otomatik algılar. +| **Ücretsiz** | OpenClaw + NVIDIA NemoClaw, tam gösterge paneli, yalnızca yerel | $0 | +| **Starter** | Yukarıdaki diğer tüm çalışma zamanları, filo görünümü, bulut senkronizasyonu | ay başına düğüm başına $9 | +| **Pro** | Starter + yönetişim: onaylar, araç risk politikaları, değerlendirmeler, anomali tespiti, maliyet optimize edici, OTel dışa aktarma | ay başına düğüm başına $19 | -Çoğu durumda ekstra yapılandırma gerekmez. Senkronizasyon daemon'u, oturum dosyalarının ister ana makinede `~/.openclaw/` içinde ister bir OpenShell konteyneri içinde olsun otomatik olarak bulur. +Yıllık planlar, Kurumsal ve güncel rakamlar +**[clawmetry.com/pricing](https://clawmetry.com/pricing)** adresinde bulunur. Kendi kendine barındırılan lisans +anahtarları bulut olmadan çalışır (`clawmetry license`). Ücretsiz/ücretli ayrımının tam detayı +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) içinde. -### Nasıl çalışır +## Verileriniz kendi makinenizde kalır -ClawMetry, NemoClaw'ı iki şekilde algılar: +ClawMetry yerel oturum dosyalarını ve günlükleri okur. `clawmetry connect` komutunu +çalıştırmadığınız sürece hiçbir şey makinenizden çıkmaz. O durumda bile anlık görüntü, +hiçbir zaman makinenizden ayrılmayan bir anahtarla uçtan uca şifrelenir ve +tarayıcınızda şifresi çözülür. -1. **İkili dosya algılama** — `nemoclaw` CLI'sini kontrol eder ve sandbox bilgisini almak için `nemoclaw status` çalıştırır -2. **Konteyner algılama** — çalışan Docker konteynerlerini `openshell`, `nemoclaw` veya `ghcr.io/nvidia/` imajları için tarar, ardından oturumları birim bağlantıları veya `docker cp` üzerinden okur - -NemoClaw konteynerlerinden senkronize edilen oturum dosyaları, bulut gösterge panelinde `runtime=nemoclaw` ve `container_id` meta verisiyle etiketlenir; böylece bunları standart OpenClaw oturumlarından ilk bakışta ayırt edebilirsiniz. - -### Önerilen kurulum: ana makinede senkronizasyon daemon'u - -En iyi deneyim için, ClawMetry'nin senkronizasyon daemon'unu sandbox içinde değil **ana makinede** çalıştırın. Bu, NemoClaw ağ politikası kısıtlamalarından kaçınır. - -```bash -# Ana makinede (sandbox dışında) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -Senkronizasyon daemon'u, çalışan herhangi bir OpenShell konteyneri içindeki oturumları otomatik olarak bulur. - -### İsteğe bağlı: açık sandbox adı - -Otomatik algılama çalışmazsa, ClawMetry'yi doğru sandbox'a yönlendirin: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Sandbox içinde çalıştırma (ileri düzey) - -Senkronizasyon daemon'unu OpenShell sandbox'ı **içinde** çalıştırmanız gerekiyorsa, ClawMetry ingest API'sine ulaşabilmesi için NemoClaw ağ politikanıza şu giden (egress) kuralını ekleyin: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Şununla uygulayın: +## Kurulum ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # ardından: clawmetry ``` -### Portlar ve uç noktalar - -| Uç Nokta | Port | Protokol | Gerekli | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Evet (senkronizasyon daemon'u → bulut) | -| `localhost:8900` | 8900 | HTTP | Evet (yerel gösterge paneli arayüzü) | -| Docker soketi (`/var/run/docker.sock`) | — | Unix soketi | Konteyner oturum keşfi için | +Veya tek satırlık komut: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -Senkronizasyon daemon'u yalnızca `ingest.clawmetry.com` adresine giden HTTPS çağrıları yapar. Herhangi bir gelen port gerekmez. +macOS, Linux veya Windows'ta Python 3.8+ ve aynı makinede en az bir ajan çalışma +zamanı gerekir. Docker talimatları: [docs/DOCKER.md](docs/DOCKER.md). ---- +## Dokümantasyon -## Bulut Dağıtımı +| | | +|---|---| +| [Çalışma zamanı uyumluluğu](docs/compatibility.md) | Her bağdaştırıcının (adapter) neyi okuduğu ve bir çalışma zamanının nasıl ekleneceği | +| [Yetkilendirmeler](docs/ENTITLEMENTS.md) | Ücretsiz ve ücretli, katman matrisi, lisans CLI'si | +| [Onaylar ve politikalar](docs/APPROVALS.md) | Çalıştırma öncesi kapı kontrolü, risk puanlama, telefon onayları | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | İzleri (traces) her yere dışa aktarın, herhangi bir yerden OTLP alın | +| [SDK izleme](docs/SDK_TRACKING.md) | Kendi oluşturduğunuz ajanlar için maliyet ilişkilendirmesi | +| [Sohbet kanalları](docs/CHANNELS.md) | Akış'ta (Flow) gösterilen sohbet bağdaştırıcıları | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Korumalı alan (sandboxed) NVIDIA NemoClaw kurulumları | +| [Docker](docs/DOCKER.md) | İmaj, compose, birim (volume) bağlamaları | +| [Mimari](ARCHITECTURE.md) · [Geliştirme](docs/DEVELOPMENT.md) | İçeride nasıl çalıştığı; kaynak koddan çalıştırma | +| [Telemetri](docs/TELEMETRY.md) | Anonim kurulum ve masaüstü açılış sinyalleri ve bunların nasıl kapatılacağı | -SSH tünelleri, ters proxy ve Docker için **[Bulut Test Kılavuzu](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)**'na bakın. +## Ekran görüntüleri -## Test +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Genel Bakış**: token'lar, oturumlar, sağlık | **Beyin**: canlı ajan olay akışı | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Maliyet**: model ve oturuma göre | **Onaylar**: riskli araç çağrılarını kapıla | -Bu proje BrowserStack ile test edilmiştir. +Çalışma zamanı başına daha fazlası: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) - -## Telemetri - -ClawMetry, `https://app.clawmetry.com/api/install` adresine anonim -kurulum yaşam döngüsü pingleri gönderir: `clawmetry` CLI'sini yeni bir -makinede ilk çalıştırdığınızda bir `install` pingi, yeni bir sürüme -yükselttikten sonraki ilk çalıştırmada bir `update` pingi ve gösterge -panelindeki katılım seçimini tamamladığınızda bir `onboarded` pingi. -Bunu, gerçek kurulum sayısını saymak için kullanıyoruz (ham PyPI indirme -rakamlarının ~%98'i yansı sunucular, CI ve otomatik güncelleme yeniden -indirmeleridir) ve hangi ajan çerçevelerinin ve sürümlerinin gerçekte -kullanımda olduğunu öğrenmek için. - -**Yaşam döngüsü olayı ve sürüm başına en fazla bir POST**, şunları içerir: - -| Alan | Örnek | Neden | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id` içinde saklanan rastgele UUID | tekrarları önleme; Bulut senkronizasyonunu açıkça bağlayana kadar anonimdir (kimliği doğrulanmış daemon nabız atışı daha sonra bunu taşır ve bu kurulumu hesabınızla ilişkilendirir) | -| `event` | `install` / `update` / `onboarded` | yeni kurulum mu yoksa var olanın yükseltilmesi mi | -| `version` | `0.12.167` | kullanımda olan sürümler | -| `os` / `os_version` | `Darwin` / `25.3.0` | platform desteği öncelikleri | -| `python` | `3.11.15` | Python sürüm destek matrisi | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | bundan sonra hangi ajanlarla entegre olmamız gerektiği | -| `is_ci` / `ci_provider` | `true` / `github_actions` | insan kurulumlarını CI gürültüsünden ayırma | - -**Göndermediğimiz şeyler**: IP adresi (bulut, ülke kodunu sunucu -tarafında istekten türetir, ardından IP'yi atar), ana bilgisayar adı, -kullanıcı adı, çalışma alanı yolu, dosya içerikleri, api_key'iniz, -e-postanız, kişisel veya çalışma alanına özgü herhangi bir şey. Kablo -üzerindeki (wire) yük, [`clawmetry/telemetry.py`](clawmetry/telemetry.py) -dosyasında denetlenebilir. - -**Devre dışı bırakma** (bunlardan herhangi biri kalıcı olarak devre dışı bırakır): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # kabuk başına -export DO_NOT_TRACK=1 # W3C araçlar arası standart -touch ~/.clawmetry/notelemetry # kalıcı dosya işaretçisi -``` - -Buradaki bir ağ hatası, `clawmetry`'nin çalışmasını asla engellemez; -ping, 3 saniyelik zaman aşımı olan bir daemon iş parçacığında ateşle ve -unut (fire-and-forget) şeklindedir. - -## Star Geçmişi +## Yıldız Geçmişi @@ -439,11 +114,6 @@ unut (fire-and-forget) şeklindedir. ## Lisans -MIT - ---- +MIT · [@vivekchand](https://github.com/vivekchand) tarafından yapıldı · [clawmetry.com](https://clawmetry.com) -

- 🦞 Ajanınızın düşüncelerini görün
- Geliştiren: @vivekchand · clawmetry.com · OpenClaw ekosisteminin bir parçasıdır -

+ diff --git a/docs/i18n/uk/README.md b/docs/i18n/uk/README.md index ca61d29dae..eb3d5d21e7 100644 --- a/docs/i18n/uk/README.md +++ b/docs/i18n/uk/README.md @@ -1,427 +1,105 @@ - + > Українська translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Дивіться, як мислить ваш агент.** Спостережуваність у реальному часі для **20 середовищ виконання AI-агентів**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex та ще 16 інших. Одна панель для всього вашого флоту агентів. +**Дивіться, як думає ваш агент.** Спостережуваність у реальному часі для **23 середовищ виконання AI-агентів**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex та ще 19 інших. Одна панель для всього вашого флоту агентів. -> 🌐 **Читайте цю сторінку іншими мовами:** [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) · [more →](docs/i18n/) +> 🌐 **Читати цією мовою:** [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) · [more →](docs/i18n/) -Одна команда. Нуль налаштувань. Автоматично визначає все. +Одна команда. Без налаштувань. Автоматично визначає все. ```bash pip install clawmetry && clawmetry ``` -Відкривається за адресою **http://localhost:8900**, і на цьому все. +Відкривається за адресою **http://localhost:8900**. Без налаштувань: система знаходить середовища виконання агентів, які у вас вже є, читає їх у режимі лише для читання і нічого не змінює в тому, як вони працюють. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## Працює з 20 середовищами виконання агентів - -ClawMetry почалася як інструмент спостережуваності для OpenClaw, а тепер вимірює **весь ваш флот агентів** в одній панелі, автоматично визначаючи кожне середовище виконання на вашій машині: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw і NemoClaw безкоштовні у застосунку з відкритим кодом; інші середовища виконання стають доступними з ClawMetry Cloud або самостійно розміщеною ліцензією Pro. Перемикайте середовища виконання з панелі заголовка, і кожна вкладка — вартість, токени, інструменти, трасування — перемасштабується під це середовище виконання. Дивіться **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** для точного розподілу безкоштовне/платне, матриці рівнів, структури `/api/entitlement` та CLI `clawmetry license`. - -## Що ви отримуєте - -- **Flow** — Живий анімований діаграма, що показує рух повідомлень через канали, мозок, інструменти та назад -- **Overview** — Перевірки стану, теплова карта активності, кількість сесій, інформація про модель -- **Usage** — Відстеження токенів і вартості з щоденною/щотижневою/щомісячною розбивкою -- **Sessions** — Активні сесії агента з моделлю, токенами, останньою активністю -- **Crons** — Заплановані завдання зі статусом, наступним запуском, тривалістю -- **Logs** — Кольорове потокове передавання логів у реальному часі -- **Memory** — Перегляд SOUL.md, MEMORY.md, AGENTS.md, щоденних нотаток -- **Transcripts** — Інтерфейс у вигляді чат-бульбашок для читання історії сесій -- **Alerts** — Ліміти бюджету, тригери частоти помилок, виявлення офлайн-агента; маршрутизація до Slack, Discord, PagerDuty, Telegram, Email -- **Approvals** — Блокування деструктивних видалень, примусових пушів, мутацій БД, sudo, встановлень пакетів, мережевих викликів за одним підтвердженням - -## Скріншоти - -### 🧠 Brain — Потік подій живого агента -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Використання токенів і зведення сесій -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Потік викликів інструментів у реальному часі -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Розбивка вартості за моделлю та сесією -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Оглядач файлів робочого простору -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Стан захищеності та журнал аудиту -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) +## Працює з 23 середовищами виконання агентів -### 🚨 Alerts — Ліміти бюджету, тригери частоти помилок, вебхуки до Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) +**Безкоштовно у застосунку з відкритим кодом:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -### ✋ Approvals — Блокування ризикованих викликів інструментів за ручним підтвердженням; правила захисту на основі політик -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Блокування перед виконанням для Claude Code** — одна команда встановлює -хук PreToolUse, який призупиняє відповідні виклики інструментів *до* їхнього виконання і чекає -на ваше рішення (одне натискання з телефону з увімкненими -[хмарними push-сповіщеннями](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. Ви також отримуєте push-сповіщення на телефон, коли 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 -``` +**У платному плані:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -## Розробка фронтенду v2 +Кожне середовище виконання отримує ту саму панель. Запускайте кілька одночасно, і перемикач у заголовку переналаштовує кожну вкладку під потрібне з них. -React-застосунок v2 знаходиться в `frontend/` і обслуговується за адресою `/v2`, коли -сервер Flask запущено з увімкненим v2. +Створили власного агента на базі SDK замість цього? Перехоплювач відстежує і його виклики LLM теж. Дивіться [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -Під час розробки використовуйте два термінали: - -```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 спостерігає за багатьма середовищами виконання AI-агентів, а не лише за OpenClaw. Кожне середовище виконання, відмінне від OpenClaw, постачається з окремим адаптером-читачем, який перетворює його рідний формат сесії у уніфіковані структури ClawMetry; демон приймає їх у те саме сховище DuckDB + хмарний знімок, позначені відповідним середовищем виконання, а вкладка повтору сесії показує **перемикач середовища виконання**, коли їх присутньо більше одного. Дивіться [`docs/compatibility.md`](docs/compatibility.md) для повної матриці + посібника з додавання середовищ виконання, і [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) для базового ознайомлення з родиною OpenClaw. +- **Сесії та транскрипти**: що робив кожен агент, крок за кроком, з можливістю відтворення +- **Вартість і токени**: за середовищем виконання, моделлю, сесією та днем, з позначками аномалій +- **Flow**: діаграма руху повідомлень у реальному часі через канали, моделі та інструменти +- **Brain**: потік подій міркувань і викликів інструментів у момент, коли вони відбуваються +- **Пам'ять і навички**: файли та навички, які фактично завантажило кожне середовище виконання +- **Стан і логи**: диск, пам'ять, частота помилок, ліміти запитів, потік логів у реальному часі +- **Сповіщення**: ліміти бюджету, сплески помилок, офлайн-агент, з маршрутизацією у Slack, Discord, PagerDuty, Telegram, Email +- **Затвердження**: призупиняйте ризиковані виклики інструментів *до* їх виконання і затверджуйте з телефону ([як](docs/APPROVALS.md)) -Використовуєте інструмент безпеки агентів [Perplexity numbat](https://github.com/perplexityai/numbat)? ClawMetry приймає його висновки та рішення щодо примусового виконання "з коробки" — дивіться [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Ціни -| Середовище виконання / агент | Статус | Примітки | +| План | Що охоплює | Ціна | |---|---|---| -| **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`. Виконання робочих процесів, запуски вузлів, підказки AI Agent, модель + токени там, де n8n їх фіксує. | -| **Antigravity** | Бета-адаптер | Brain JSONL у `~/.gemini//brain/`. Розмови, кроки інструментів, міркування, розбивка токенів Gemini для кожної генерації + вартість, витрати фонової генерації. | -| **GitHub Copilot** | Бета-адаптер | `events.jsonl` Copilot CLI у `~/.copilot/session-state/` + журнал використання `session-store.db` для кожного виклику. Розмови, виклики інструментів, маршрутизація моделі, розбивка токенів з урахуванням кешу, вартість у AI-кредитах, що виставляються постачальником. | -| **Grok** | Бета-адаптер | xAI Grok Build CLI (бінарник на Rust у `~/.grok/bin/grok`): глобальний журнал подій `~/.grok/logs/unified.jsonl` + `~/.grok/sessions///{events.jsonl,summary.json}` для кожної сесії. Розмови, розбивка токенів для кожного ходу, маршрутизація моделі, та вихідне навантаження репозиторію CLI, що зберігається в `~/.grok/upload_queue/`, щоб ви бачили, що залишило вашу машину. | - -"Бета-адаптер" означає, що ClawMetry постачає читач для реального формату на диску цього середовища виконання, кожен з яких створено + перевірено на реальному встановленні на реальній машині (дивіться `tests/fixtures/runtimes//`). Адаптери доступні лише для читання; кожен чесно відображає те, що його середовище виконання фактично зберігає (наприклад, PicoClaw/NanoClaw/Cursor не записують вартість токенів на диск). Коли на одному вузлі працює кілька середовищ виконання, перемикач середовища виконання обмежує перегляд сесій одним для чіткого глибокого аналізу. - -## Відстеження будь-якого SDK-агента — атрибуція вартості поза циклом - -Усі середовища виконання вище записують сесії на диск. Ваш власний **продакшн-агент** — той, що ви створили на OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, або на звичайному циклі `httpx` — цього не робить. Безконфігураційний перехоплювач ClawMetry все одно фіксує його LLM-виклики (вартість, токени, затримку, помилки), використовуючи monkey-patching для `httpx`/`requests`: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (або змінна середовища `CLAWMETRY_SOURCE=support-agent`) позначає кожен виклик **іменованим джерелом**, тож кожен продукт, який ви запускаєте, з'являється як власний повноцінний рядок з можливістю атрибуції вартості в картці панелі **🔌 Джерела поза циклом** на вкладці Overview — виклики, постачальники, затримка, частота помилок для кожного агента. Джерело не вказано? Виклики все одно відстежуються, картка просто залишається прихованою. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Це той самий шар даних, який живлять адаптери середовищ виконання (DuckDB → хмарний знімок), тому джерела поза циклом синхронізуються з хмарною панеллю так само, як і все інше, з наскрізним шифруванням. - -## OpenTelemetry — нейтральний до постачальника, надсилайте трасування куди завгодно - -ClawMetry розмовляє мовою **OpenTelemetry** в обидва боки, використовуючи **семантичні конвенції GenAI**, тож трасування вашого агента ніколи не будуть прив'язані до одного інструменту. - -**Експортуйте** кожну сесію — виклики LLM, інструменти, підагенти, токени, вартість — як спани OTLP/HTTP GenAI до будь-якого колектора (Datadog, Grafana, Honeycomb або власного OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Заголовки автентифікації та інтервал опитування є необов'язковими змінними середовища: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**Приймайте** — вбудований приймач OTLP приймає трасування, логи та метрики від будь-чого іншого за адресами `/v1/traces`, `/v1/logs` та `/v1/metrics`. Направте будь-який застосунок, інструментований OpenTelemetry, на нього: +| **Free** | OpenClaw + NVIDIA NemoClaw, повна панель, лише локально | $0 | +| **Starter** | Усі інші середовища виконання вище, огляд флоту, хмарна синхронізація | $9 за вузол / місяць | +| **Pro** | Starter + керування: затвердження, політики ризику інструментів, оцінювання, виявлення аномалій, оптимізатор витрат, експорт OTel | $19 за вузол / місяць | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -Трасування та логи OTLP/JSON працюють на звичайному `pip install clawmetry`, без додаткових пакетів. Приймання Protobuf (та метрики OTLP/JSON) потребує `pip install clawmetry[otel]`. Застосунок, що встановлює власне `service.name`, з'являється як окремий агент у перемикачі середовищ виконання, зі своєю вартістю та токенами. - -Ви отримуєте безконфігураційну, локально-орієнтовану панель ClawMetry **і** ваші дані в будь-якому бекенді, який вже використовує ваша команда — без прив'язки до постачальника, без другого агента для встановлення. - -## Налаштування - -Більшості людей не потрібне жодне налаштування. ClawMetry автоматично визначає ваш робочий простір, логи, сесії та cron-завдання. - -Якщо вам все ж потрібно щось налаштувати: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -Усі опції: `clawmetry --help` - -## Підтримувані канали - -ClawMetry показує активність у реальному часі для кожного каналу OpenClaw, який у вас налаштований. У діаграмі Flow з'являються лише канали, які дійсно налаштовані у вашому `openclaw.json` — неналаштовані автоматично приховуються. - -Клацніть на будь-якому вузлі каналу у Flow, щоб побачити живий перегляд у вигляді чат-бульбашок з кількістю вхідних/вихідних повідомлень. - -| Канал | Статус | Живий спливаючий перегляд | Примітки | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Повна | ✅ | Повідомлення, статистика, оновлення кожні 10с | -| 💬 **iMessage** | ✅ Повна | ✅ | Читає `~/Library/Messages/chat.db` безпосередньо | -| 💚 **WhatsApp** | ✅ Повна | ✅ | Через WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Повна | ✅ | Через signal-cli | -| 🟣 **Discord** | ✅ Повна | ✅ | Визначення гільдії + каналу | -| 🟪 **Slack** | ✅ Повна | ✅ | Визначення робочого простору + каналу | -| 🌐 **Webchat** | ✅ Повна | ✅ | Вбудовані сесії веб-інтерфейсу | -| 📡 **IRC** | ✅ Повна | ✅ | Інтерфейс у стилі термінальних бульбашок | -| 🍏 **BlueBubbles** | ✅ Повна | ✅ | iMessage через REST API BlueBubbles | -| 🔵 **Google Chat** | ✅ Повна | ✅ | Через вебхуки Chat API | -| 🟣 **MS Teams** | ✅ Повна | ✅ | Через плагін бота Teams | -| 🔷 **Mattermost** | ✅ Повна | ✅ | Самостійно розміщений командний чат | -| 🟩 **Matrix** | ✅ Повна | ✅ | Децентралізований, з підтримкою E2EE | -| 🟢 **LINE** | ✅ Повна | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Повна | ✅ | Децентралізовані NIP-04 DM | -| 🟣 **Twitch** | ✅ Повна | ✅ | Чат через з'єднання IRC | -| 🔷 **Feishu/Lark** | ✅ Повна | ✅ | Підписка на події через WebSocket | -| 🔵 **Zalo** | ✅ Повна | ✅ | Zalo Bot API | - -> **Автоматичне визначення:** ClawMetry читає ваш `~/.openclaw/openclaw.json` і рендерить лише ті канали, які ви дійсно налаштували. Ручне налаштування не потрібне. - -## Розгортання в Docker - -Хочете запустити ClawMetry в контейнері? Без проблем! 🐳 - -**Швидкий старт з Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Приклад Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Примітка:** При запуску в Docker змонтуйте директорії даних + логів вашого агента (наприклад, `~/.openclaw`, `~/.claude`, `~/.codex`), щоб ClawMetry могла автоматично визначити ваше налаштування. - -## Вимоги - -- Python 3.8+ -- Flask (встановлюється автоматично через pip) -- Середовище виконання AI-агента на тій самій машині: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, або QM (або змонтовані томи для Docker) -- Linux або macOS - -## Підтримка NemoClaw / OpenShell - -ClawMetry автоматично визначає [NemoClaw](https://github.com/NVIDIA/NemoClaw) — корпоративну обгортку безпеки NVIDIA для OpenClaw, яка запускає агентів всередині ізольованих (sandboxed) контейнерів OpenShell. - -У більшості випадків додаткове налаштування не потрібне. Демон синхронізації автоматично виявляє файли сесій незалежно від того, чи знаходяться вони в `~/.openclaw/` на хості, чи всередині контейнера OpenShell. +Річні плани, Enterprise і актуальні ціни знаходяться на сторінці +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Ключі ліцензії для самостійного розміщення +працюють без хмари (`clawmetry license`). Точний поділ безкоштовного/платного +описано в [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -### Як це працює +## Ваші дані залишаються на вашій машині -ClawMetry визначає NemoClaw двома способами: +ClawMetry читає локальні файли сесій і логи. Нічого не покидає вашу машину, якщо +ви не запустите `clawmetry connect`. Навіть тоді знімок даних шифрується наскрізно +ключем, який ніколи не залишає вашу машину, і розшифровується у вашому браузері. -1. **Визначення бінарника** — перевіряє наявність CLI `nemoclaw` і запускає `nemoclaw status`, щоб отримати інформацію про пісочницю -2. **Визначення контейнера** — сканує запущені Docker-контейнери на предмет образів `openshell`, `nemoclaw`, або `ghcr.io/nvidia/`, потім читає сесії через змонтовані томи або `docker cp` - -Файли сесій, синхронізовані з контейнерів NemoClaw, позначаються метаданими `runtime=nemoclaw` та `container_id` у хмарній панелі, тож ви можете відрізнити їх від звичайних сесій OpenClaw з першого погляду. - -### Рекомендоване налаштування: демон синхронізації на ХОСТІ - -Для найкращого досвіду запускайте демон синхронізації ClawMetry на **хост-машині** (не всередині пісочниці). Це дозволяє уникнути обмежень мережевої політики NemoClaw. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -Демон синхронізації автоматично знайде сесії всередині будь-яких запущених контейнерів OpenShell. - -### Необов'язково: явна назва пісочниці - -Якщо автоматичне визначення не працює, вкажіть ClawMetry потрібну пісочницю: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Запуск всередині пісочниці (для досвідчених користувачів) - -Якщо вам потрібно запустити демон синхронізації **всередині** пісочниці OpenShell, додайте це правило вихідного трафіку до вашої мережевої політики NemoClaw, щоб він міг досягти API прийому ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Застосуйте за допомогою: +## Встановлення ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # then: clawmetry ``` -### Порти та кінцеві точки - -| Кінцева точка | Порт | Протокол | Обов'язково | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Так (демон синхронізації → хмара) | -| `localhost:8900` | 8900 | HTTP | Так (локальний інтерфейс панелі) | -| Сокет Docker (`/var/run/docker.sock`) | — | Unix socket | Для виявлення сесій контейнера | - -Демон синхронізації робить лише вихідні виклики HTTPS до `ingest.clawmetry.com`. Вхідні порти не потрібні. - ---- - -## Хмарне розгортання - -Дивіться **[Посібник з тестування в хмарі](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** для SSH-тунелів, зворотного проксі та Docker. - -## Тестування +Або однорядковою командою: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -Цей проєкт тестується за допомогою BrowserStack. +Потрібен Python 3.8+ на macOS, Linux або Windows, і хоча б одне середовище виконання агента на +тій самій машині. Інструкції для Docker: [docs/DOCKER.md](docs/DOCKER.md). -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## Документація -## Телеметрія +| | | +|---|---| +| [Сумісність середовищ виконання](docs/compatibility.md) | Що читає кожен адаптер і як додати середовище виконання | +| [Права доступу](docs/ENTITLEMENTS.md) | Безкоштовне проти платного, матриця рівнів, ліцензійний CLI | +| [Затвердження та політики](docs/APPROVALS.md) | Перевірка перед виконанням, оцінка ризику, затвердження з телефону | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Експортуйте трейси куди завгодно, приймайте OTLP звідки завгодно | +| [Відстеження SDK](docs/SDK_TRACKING.md) | Атрибуція витрат для агентів, які ви створили самостійно | +| [Чат-канали](docs/CHANNELS.md) | Адаптери чатів, показані у Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Пісочниці для налаштувань NVIDIA NemoClaw | +| [Docker](docs/DOCKER.md) | Образ, compose, монтування томів | +| [Архітектура](ARCHITECTURE.md) · [Розробка](docs/DEVELOPMENT.md) | Як це працює всередині; запуск із вихідного коду | +| [Телеметрія](docs/TELEMETRY.md) | Анонімні пінги встановлення та відкриття на робочому столі, і як їх вимкнути | -ClawMetry надсилає анонімні пінги про життєвий цикл встановлення на -`https://app.clawmetry.com/api/install`: один пінг `install` під час -першого запуску CLI `clawmetry` на новій машині, один пінг `update` -при першому запуску після оновлення до нової версії, і один пінг -`onboarded`, коли ви завершуєте вибір ознайомлення в панелі. Ми використовуємо це, -щоб порахувати реальні встановлення (сирі цифри завантажень PyPI на ~98% складаються з дзеркал, CI -та повторних завантажень при автооновленні) і дізнатися, які фреймворки агентів та -версії дійсно використовуються. +## Скріншоти -**Не більше одного POST-запиту на подію життєвого циклу для кожної версії**, що містить: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: токени, сесії, стан | **Brain**: потік подій агента у реальному часі | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: за моделлю та сесією | **Approvals**: контроль ризикованих викликів інструментів | -| Поле | Приклад | Навіщо | -|---|---|---| -| `install_id` | випадковий UUID, збережений у `~/.clawmetry/install_id` | дедублікація; анонімний, доки ви явно не підключите хмарну синхронізацію (тоді автентифікований heartbeat демона несе його, зв'язуючи це встановлення з вашим обліковим записом) | -| `event` | `install` / `update` / `onboarded` | нове встановлення чи оновлення існуючого | -| `version` | `0.12.167` | які версії використовуються | -| `os` / `os_version` | `Darwin` / `25.3.0` | пріоритети підтримки платформ | -| `python` | `3.11.15` | матриця підтримки версій Python | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | з якими агентами нам слід інтегруватися далі | -| `is_ci` / `ci_provider` | `true` / `github_actions` | відокремити людські встановлення від шуму CI | - -**Що ми НЕ надсилаємо**: IP (хмара визначає код країни на стороні сервера -з запиту, а потім відкидає IP), ім'я хоста, ім'я користувача, шлях робочого простору, -вміст файлів, ваш api_key, вашу електронну пошту, будь-що персональне чи специфічне для -робочого простору. Мережевий пакет даних можна перевірити в -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Відмовитися** (будь-який з цих способів вимикає це назавжди): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -Збій мережі тут ніколи не блокує роботу `clawmetry` — пінг -надсилається без очікування відповіді (fire-and-forget) у потоці демона з тайм-аутом 3 с. +Більше, за середовищем виконання: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Історія зірок @@ -435,11 +113,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## Ліцензія -MIT - ---- +MIT · Створено [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Дивіться, як мислить ваш агент
- Створено @vivekchand · clawmetry.com · Частина екосистеми OpenClaw -

+ diff --git a/docs/i18n/ur/README.md b/docs/i18n/ur/README.md index 3924b3c8ae..8bffc85711 100644 --- a/docs/i18n/ur/README.md +++ b/docs/i18n/ur/README.md @@ -1,428 +1,105 @@ - + > اردو translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**اپنے ایجنٹ کو سوچتے ہوئے دیکھیں۔** **20 AI ایجنٹ رن ٹائمز** کے لیے حقیقی وقت میں مشاہدہ: [OpenClaw](https://github.com/openclaw/openclaw)، [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)، Claude Code، OpenAI Codex اور 16 مزید۔ آپ کے پورے ایجنٹ بیڑے کے لیے ایک ڈیش بورڈ۔ +**اپنے ایجنٹ کو سوچتے ہوئے دیکھیں۔** **23 AI ایجنٹ رن ٹائمز** کے لیے ریئل ٹائم آبزرویبلٹی: [OpenClaw](https://github.com/openclaw/openclaw)، [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)، Claude Code، OpenAI Codex اور مزید 19۔ آپ کے پورے ایجنٹ فلیٹ کے لیے ایک ہی ڈیش بورڈ۔ > 🌐 **اسے ان زبانوں میں پڑھیں:** [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** پر کھلتا ہے اور بس، کام مکمل۔ +**http://localhost:8900** پر کھلتا ہے۔ صفر کنفیگریشن: یہ ان ایجنٹ رن ٹائمز کو ڈھونڈ لیتا ہے جو آپ کے پاس پہلے سے موجود ہیں، انہیں صرف پڑھنے کے انداز میں (read-only) پڑھتا ہے، اور ان کے چلنے کے طریقے میں کچھ تبدیل نہیں کرتا۔ ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 20 ایجنٹ رن ٹائمز کے ساتھ کام کرتا ہے - -ClawMetry کا آغاز OpenClaw کے مشاہدے کے طور پر ہوا تھا، اور اب یہ آپ کے **پورے ایجنٹ بیڑے** کو ایک ہی ڈیش بورڈ میں ناپتا ہے، آپ کی مشین پر ہر رن ٹائم کو خود بخود پہچانتے ہوئے: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw اور NemoClaw اوپن سورس ایپ میں مفت ہیں؛ باقی رن ٹائمز ClawMetry Cloud یا سیلف ہوسٹڈ Pro لائسنس کے ساتھ فعال ہوتے ہیں۔ ہیڈر سے رن ٹائمز کے درمیان سوئچ کریں اور ہر ٹیب — لاگت، ٹوکنز، ٹولز، ٹریسز — اسی رن ٹائم کے مطابق دوبارہ ترتیب پاتا ہے۔ درست مفت/ادا شدہ تقسیم، ٹیئر میٹرکس، `/api/entitlement` شکل، اور `clawmetry license` CLI کے لیے **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** دیکھیں۔ - -## آپ کو کیا ملتا ہے - -- **Flow** — ایک لائیو اینیمیٹڈ ڈایاگرام جو چینلز، برین، ٹولز اور واپس تک بہتے پیغامات کو دکھاتا ہے -- **Overview** — ہیلتھ چیکس، سرگرمی کا ہیٹ میپ، سیشن کاؤنٹس، ماڈل کی معلومات -- **Usage** — روزانہ/ہفتہ وار/ماہانہ تقسیم کے ساتھ ٹوکن اور لاگت کی ٹریکنگ -- **Sessions** — ماڈل، ٹوکنز، آخری سرگرمی کے ساتھ فعال ایجنٹ سیشنز -- **Crons** — حیثیت، اگلا رن، دورانیے کے ساتھ شیڈول شدہ جابز -- **Logs** — رنگین حقیقی وقت لاگ اسٹریمنگ -- **Memory** — SOUL.md، MEMORY.md، AGENTS.md، روزانہ نوٹس براؤز کریں -- **Transcripts** — سیشن کی تاریخ پڑھنے کے لیے چیٹ بلبلہ UI -- **Alerts** — بجٹ کی حدیں، ایرر ریٹ ٹرگرز، ایجنٹ آف لائن کی شناخت؛ Slack، Discord، PagerDuty، Telegram، ای میل کی طرف روٹ کرتا ہے -- **Approvals** — تباہ کن ڈیلیٹس، فورس پُشز، ڈی بی میوٹیشنز، sudo، پیکج انسٹالیشنز، نیٹ ورک کالز کو ایک کلک منظوری کے پیچھے روکیں - -## اسکرین شاٹس - -### 🧠 Brain — لائیو ایجنٹ ایونٹ اسٹریم -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — ٹوکن استعمال اور سیشن خلاصہ -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — حقیقی وقت ٹول کال فیڈ -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — ماڈل اور سیشن کے حساب سے لاگت کی تقسیم -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — ورک اسپیس فائل براؤزر -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — پوزیشن اور آڈٹ لاگ -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — بجٹ کی حدیں، ایرر ریٹ ٹرگرز، Slack / Discord / PagerDuty / ای میل کے لیے ویب ہکس -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — خطرناک ٹول کالز کو دستی منظوری کے پیچھے روکیں؛ پالیسی پر مبنی تحفظاتی قواعد -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**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 کے اپنے -اجازت والے پرامپٹ کو چھوڑ دیتا ہے (آپ پہلے ہی جواب دے چکے ہیں)۔ نہ ملنے والے ٹولز -تقریباً 40ms لاگت رکھتے ہیں اور 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 فرنٹ اینڈ ڈیویلپمنٹ - -v2 React ایپ `frontend/` میں رہتی ہے اور جب Flask -سرور کو v2 فعال کر کے شروع کیا جائے تو `/v2` پر سرو کی جاتی ہے۔ - -ڈیویلپمنٹ کے دوران دو ٹرمینلز استعمال کریں: - -```bash -# Terminal 1: Flask API/server on :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## 23 ایجنٹ رن ٹائمز کے ساتھ کام کرتا ہے -```bash -# Terminal 2: Vite dev server on :5173 -cd frontend -nvm use -npm ci -npm run dev -``` +**اوپن سورس ایپ میں مفت:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -`http://localhost:5173/v2/` کھولیں۔ Vite `/api` درخواستوں کو -`http://localhost:8900` کی طرف پراکسی کرتا ہے، تاکہ React ایپ اضافی CORS -ترتیب کے بغیر مقامی Flask سرور سے بات کر سکے۔ +**پیڈ پلان پر:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -پیکج کے ساتھ شپ ہونے والا بنڈل بنانے کے لیے: - -```bash -cd frontend -npm run build -``` +ہر رن ٹائم کو ایک جیسا ڈیش بورڈ ملتا ہے۔ ایک ساتھ کئی چلائیں اور ہیڈر سوئچر ہر ٹیب کو ان میں سے کسی ایک کے دائرے میں لے آتا ہے۔ -پروڈکشن بنڈل `clawmetry/static/v2/dist/` میں لکھا جاتا ہے۔ +اپنا ایجنٹ کسی SDK پر خود بنایا ہے؟ انٹرسیپٹر اس کی LLM کالز کو بھی ٹریک کرتا ہے۔ دیکھیں [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md)۔ -## رن ٹائم / ایجنٹ مطابقت +## آپ کو کیا ملتا ہے -ClawMetry صرف OpenClaw ہی نہیں بلکہ بہت سے AI ایجنٹ رن ٹائمز کا مشاہدہ کرتا ہے۔ ہر غیر OpenClaw رن ٹائم ایک مخصوص ریڈر ایڈاپٹر شپ کرتا ہے جو اس کے مقامی سیشن فارمیٹ کو ClawMetry کی متحد شکلوں میں ترجمہ کرتا ہے؛ ڈیمن انہیں رن ٹائم کے ٹیگ کے ساتھ اسی DuckDB اسٹور + کلاؤڈ اسنیپ شاٹ میں شامل کرتا ہے، اور Session ری پلے ٹیب ایک سے زیادہ رن ٹائم موجود ہونے پر **رن ٹائم سوئچر** دکھاتا ہے۔ مکمل میٹرکس + رن ٹائمز شامل کرنے کی گائیڈ کے لیے [`docs/compatibility.md`](docs/compatibility.md) دیکھیں، اور OpenClaw فیملی کے تعارف کے لیے [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) دیکھیں۔ +- **سیشنز اور ٹرانسکرپٹس**: ہر ایجنٹ نے کیا کیا، ٹرن بہ ٹرن، ری پلے کے ساتھ +- **لاگت اور ٹوکنز**: ہر رن ٹائم، ماڈل، سیشن اور دن کے لحاظ سے، بے ضابطگی کی نشاندہی کے ساتھ +- **فلو (Flow)**: چینلز، ماڈلز اور ٹولز کے درمیان چلنے والے پیغامات کا لائیو ڈایاگرام +- **برین (Brain)**: استدلال اور ٹول کال ایونٹ اسٹریم، جیسے ہی یہ ہو رہا ہو +- **میموری اور اسکلز**: وہ فائلیں اور اسکلز جو ہر رن ٹائم نے واقعی لوڈ کیں +- **صحت اور لاگز**: ڈسک، میموری، ایرر ریٹس، ریٹ لمٹس، لائیو لاگ اسٹریم +- **الرٹس**: بجٹ کی حدیں، ایرر اسپائیکس، ایجنٹ آف لائن، جو Slack، Discord، PagerDuty، Telegram، Email کی طرف روٹ کیے جاتے ہیں +- **منظوریاں (Approvals)**: خطرناک ٹول کالز کو چلنے سے *پہلے* روکیں اور اپنے فون سے منظور کریں ([کیسے](docs/APPROVALS.md)) -کیا آپ [Perplexity کا numbat](https://github.com/perplexityai/numbat) ایجنٹ سیکیورٹی ٹول چلا رہے ہیں؟ ClawMetry اس کے نتائج اور نفاذ کے فیصلوں کو بغیر کسی اضافی ترتیب کے ضم کر لیتا ہے — دیکھیں [`docs/NUMBAT.md`](docs/NUMBAT.md)۔ +## قیمت -| رن ٹائم / ایجنٹ | حیثیت | نوٹس | +| پلان | یہ کیا کور کرتا ہے | قیمت | |---|---|---| -| **OpenClaw** | نیٹو | حوالہ رن ٹائم، خود بخود پہچانا جاتا ہے | -| **PicoClaw** | بیٹا ایڈاپٹر | فلیٹ `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`)۔ ٹرانسکرپٹس، ماڈل، ٹول کالز۔ | -| **NanoClaw** | بیٹا ایڈاپٹر | فی سیشن SQLite (`data/v2-sessions`)۔ ٹرانسکرپٹس + پیغامات کی گنتی۔ | -| **Hermes** | بیٹا ایڈاپٹر | SQLite `~/.hermes/state.db`۔ ٹرانسکرپٹس، ماڈل، ٹوکنز/لاگت۔ | -| **Claude Code** | بیٹا ایڈاپٹر | JSONL `~/.claude/projects/.../.jsonl`۔ ٹرانسکرپٹس، ماڈل، ٹول کالز + سوچ، ٹوکن استعمال۔ | -| **Codex** | بیٹا ایڈاپٹر | رول آؤٹ 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`۔ ورک فلو ایگزیکیوشنز، نوڈ رنز، AI Agent پرامپٹس، ماڈل + ٹوکنز جہاں n8n انہیں ریکارڈ کرتا ہے۔ | -| **Antigravity** | بیٹا ایڈاپٹر | برین JSONL بذریعہ `~/.gemini//brain/`۔ گفتگو، ٹول اسٹیپس، سوچ، فی جنریشن Gemini ٹوکن تقسیم + لاگت، بیک گراؤنڈ جنریشن خرچ۔ | -| **GitHub Copilot** | بیٹا ایڈاپٹر | Copilot CLI کا `events.jsonl` بذریعہ `~/.copilot/session-state/` + `session-store.db` فی کال استعمال کا لیجر۔ گفتگو، ٹول کالز، ماڈل روٹنگ، کیش سے آگاہ ٹوکن تقسیم، وینڈر کی طرف سے بل کردہ AI کریڈٹ لاگت۔ | -| **Grok** | بیٹا ایڈاپٹر | xAI Grok Build CLI (`~/.grok/bin/grok` کے تحت Rust بائنری): عالمی ایونٹ لاگ `~/.grok/logs/unified.jsonl` + فی سیشن `~/.grok/sessions///{events.jsonl,summary.json}`۔ گفتگو، فی باری ٹوکن تقسیم، ماڈل روٹنگ، اور CLI کا آؤٹ باؤنڈ ریپو پے لوڈ جو `~/.grok/upload_queue/` کے تحت اسٹیج ہوتا ہے تاکہ آپ دیکھ سکیں کہ آپ کی مشین سے کیا نکلا۔ | - -"بیٹا ایڈاپٹر" کا مطلب ہے کہ ClawMetry اس رن ٹائم کے حقیقی آن ڈسک فارمیٹ کے لیے ایک ریڈر شپ کرتا ہے، ہر ایک حقیقی مشین پر حقیقی انسٹال کے مقابلے میں بنایا اور تصدیق شدہ (دیکھیں `tests/fixtures/runtimes//`)۔ ایڈاپٹرز صرف پڑھنے کے لیے ہیں؛ ہر ایک اپنے رن ٹائم کے اصل ذخیرہ کردہ ڈیٹا کے بارے میں دیانتدار ہے (مثلاً PicoClaw/NanoClaw/Cursor ٹوکن لاگت ڈسک پر نہیں لکھتے)۔ جب ایک نوڈ پر متعدد رن ٹائمز چلتے ہیں، تو رن ٹائم سوئچر صاف ستھری گہرائی سے جانچ کے لیے سیشنز کے منظر کو ایک تک محدود کر دیتا ہے۔ - -## کسی بھی SDK ایجنٹ کو ٹریک کریں — آؤٹ لوپ لاگت انتساب - -اوپر بیان کردہ تمام رن ٹائمز سیشنز کو ڈسک پر لکھتے ہیں۔ آپ کا اپنا **پروڈکشن ایجنٹ** — وہ جو آپ نے OpenAI Agents SDK، LangChain، Vercel AI SDK، LlamaIndex، E2B، یا ایک سادہ `httpx` لوپ پر بنایا ہے — ایسا نہیں کرتا۔ ClawMetry کا صفر ترتیب انٹرسیپٹر پھر بھی `httpx`/`requests` کو مانکی پیچ کر کے اس کی LLM کالز (لاگت، ٹوکنز، لیٹنسی، ایررز) کیپچر کرتا ہے: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (یا `CLAWMETRY_SOURCE=support-agent` ماحولیاتی متغیر) ہر کال کو ایک **نامزد ماخذ** کے ساتھ ٹیگ کرتا ہے، تاکہ آپ کا چلایا ہر پروڈکٹ ڈیش بورڈ کے Overview پر **🔌 آؤٹ لوپ سورسز** کارڈ میں اپنی الگ، لاگت کے قابل انتساب لائن کے طور پر ظاہر ہو — کالز، پرووائیڈرز، لیٹنسی، فی ایجنٹ ایرر ریٹ۔ کوئی ماخذ سیٹ نہیں کیا؟ کالز پھر بھی ٹریک ہوتی ہیں؛ صرف کارڈ چھپا رہتا ہے۔ - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -یہ وہی ڈیٹا لیئر ہے جو رن ٹائم ایڈاپٹرز کو فیڈ کرتی ہے (DuckDB → کلاؤڈ اسنیپ شاٹ)، اس لیے آؤٹ لوپ سورسز باقی سب کچھ کی طرح کلاؤڈ ڈیش بورڈ سے سنک ہوتے ہیں، اینڈ ٹو اینڈ اینکرپٹڈ۔ - -## OpenTelemetry — وینڈر نیوٹرل، اپنے ٹریسز کہیں بھی بھیجیں - -ClawMetry دونوں سمتوں میں **OpenTelemetry** بولتا ہے، **GenAI سیمینٹک کنونشنز** کا استعمال کرتے ہوئے، تاکہ آپ کے ایجنٹ ٹریسز کبھی بھی کسی ایک ٹول میں بند نہ ہوں۔ - -ہر سیشن کو **برآمد** کریں — LLM کالز، ٹولز، سب ایجنٹس، ٹوکنز، لاگت — کسی بھی کلیکٹر (Datadog، Grafana، Honeycomb، یا آپ کا اپنا OTel Collector) میں OTLP/HTTP GenAI اسپینز کے طور پر: - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -اتھ ہیڈرز اور پول انٹرول اختیاری ماحولیاتی متغیرات ہیں: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**درآمد** — بلٹ اِن OTLP وصول کنندہ کسی بھی چیز سے ٹریسز، لاگز، اور میٹرکس قبول کرتا ہے `/v1/traces`، `/v1/logs`، اور `/v1/metrics` پر۔ کسی بھی OpenTelemetry سے لیس ایپ کو اس کی طرف اشارہ کریں: +| **Free** | OpenClaw + NVIDIA NemoClaw، مکمل ڈیش بورڈ، صرف لوکل | $0 | +| **Starter** | اوپر بیان کردہ ہر دوسرا رن ٹائم، فلیٹ ویو، کلاؤڈ سنک | $9 فی نوڈ / ماہ | +| **Pro** | Starter + گورننس: منظوریاں، ٹول رسک پالیسیاں، ایویلز، بے ضابطگی کی نشاندہی، لاگت آپٹیمائزر، OTel ایکسپورٹ | $19 فی نوڈ / ماہ | -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON ٹریسز اور لاگز عام `pip install clawmetry` پر کام کرتے ہیں، بغیر کسی اضافی چیز کے۔ پروٹوبف انجیسٹ (اور OTLP/JSON میٹرکس) کے لیے `pip install clawmetry[otel]` درکار ہے۔ ایک ایپ جو اپنا `service.name` سیٹ کرتی ہے، رن ٹائم سوئچر میں اپنے ہی ایجنٹ کے طور پر ظاہر ہوتی ہے، اپنی لاگت اور ٹوکنز کے ساتھ۔ - -آپ کو صفر ترتیب، لوکل فرسٹ ClawMetry ڈیش بورڈ **اور** آپ کی ٹیم جو بھی بیک اینڈ پہلے سے چلا رہی ہے اس میں آپ کا ڈیٹا دونوں ملتے ہیں — کوئی لاک اِن نہیں، دوسرا ایجنٹ انسٹال کرنے کی ضرورت نہیں۔ - -## ترتیب - -زیادہ تر لوگوں کو کسی ترتیب کی ضرورت نہیں۔ ClawMetry آپ کا ورک اسپیس، لاگز، سیشنز، اور crons خود بخود پہچان لیتا ہے۔ - -اگر آپ کو حسب ضرورت بنانا ہو: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -تمام آپشنز: `clawmetry --help` - -## معاون چینلز - -ClawMetry آپ کے ترتیب شدہ ہر OpenClaw چینل کے لیے لائیو سرگرمی دکھاتا ہے۔ صرف وہ چینلز جو حقیقت میں آپ کے `openclaw.json` میں سیٹ اپ ہیں Flow ڈایاگرام میں ظاہر ہوتے ہیں — غیر ترتیب شدہ چینلز خود بخود چھپا دیے جاتے ہیں۔ - -Flow میں کسی بھی چینل نوڈ پر کلک کر کے آنے اور جانے والے پیغامات کی تعداد کے ساتھ لائیو چیٹ بلبلہ ویو دیکھیں۔ - -| چینل | حیثیت | لائیو پاپ اپ | نوٹس | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ مکمل | ✅ | پیغامات، اعداد و شمار، 10s تازہ کاری | -| 💬 **iMessage** | ✅ مکمل | ✅ | `~/Library/Messages/chat.db` براہ راست پڑھتا ہے | -| 💚 **WhatsApp** | ✅ مکمل | ✅ | WhatsApp Web (Baileys) کے ذریعے | -| 🔵 **Signal** | ✅ مکمل | ✅ | signal-cli کے ذریعے | -| 🟣 **Discord** | ✅ مکمل | ✅ | گلڈ + چینل کی شناخت | -| 🟪 **Slack** | ✅ مکمل | ✅ | ورک اسپیس + چینل کی شناخت | -| 🌐 **Webchat** | ✅ مکمل | ✅ | بلٹ اِن ویب UI سیشنز | -| 📡 **IRC** | ✅ مکمل | ✅ | ٹرمینل طرز کا بلبلہ UI | -| 🍏 **BlueBubbles** | ✅ مکمل | ✅ | BlueBubbles REST API کے ذریعے iMessage | -| 🔵 **Google Chat** | ✅ مکمل | ✅ | Chat API ویب ہکس کے ذریعے | -| 🟣 **MS Teams** | ✅ مکمل | ✅ | Teams بوٹ پلگ اِن کے ذریعے | -| 🔷 **Mattermost** | ✅ مکمل | ✅ | سیلف ہوسٹڈ ٹیم چیٹ | -| 🟩 **Matrix** | ✅ مکمل | ✅ | غیر مرکزی، E2EE سپورٹ | -| 🟢 **LINE** | ✅ مکمل | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ مکمل | ✅ | غیر مرکزی NIP-04 DMs | -| 🟣 **Twitch** | ✅ مکمل | ✅ | IRC کنکشن کے ذریعے چیٹ | -| 🔷 **Feishu/Lark** | ✅ مکمل | ✅ | WebSocket ایونٹ سبسکرپشن | -| 🔵 **Zalo** | ✅ مکمل | ✅ | Zalo Bot API | - -> **خودکار شناخت:** ClawMetry آپ کا `~/.openclaw/openclaw.json` پڑھتا ہے اور صرف وہی چینلز رینڈر کرتا ہے جو آپ نے حقیقت میں ترتیب دیے ہیں۔ کسی دستی سیٹ اپ کی ضرورت نہیں۔ - -## Docker پر تعیناتی - -کیا آپ ClawMetry کو کنٹینر میں چلانا چاہتے ہیں؟ کوئی مسئلہ نہیں! 🐳 - -**Docker کے ساتھ فوری آغاز:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose مثال:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **نوٹ:** Docker میں چلاتے وقت، اپنے ایجنٹ کی ڈیٹا + لاگ ڈائریکٹریز (مثلاً `~/.openclaw`، `~/.claude`، `~/.codex`) کو ماؤنٹ کریں تاکہ ClawMetry آپ کے سیٹ اپ کو خود بخود پہچان سکے۔ - -## ضروریات - -- Python 3.8+ -- Flask (pip کے ذریعے خود بخود انسٹال ہوتا ہے) -- ایک ہی مشین پر AI ایجنٹ رن ٹائم: OpenClaw، NVIDIA NemoClaw، Claude Code، Codex، Cursor، Goose، Hermes، opencode، Qwen Code، Aider، NanoClaw، PicoClaw، Pi، Deep Agents، n8n، Antigravity، GitHub Copilot، Grok، یا QM (یا Docker کے لیے ماؤنٹ شدہ والیومز) -- Linux یا macOS - -## NemoClaw / OpenShell سپورٹ - -ClawMetry خود بخود [NemoClaw](https://github.com/NVIDIA/NemoClaw) — OpenClaw کے لیے NVIDIA کا انٹرپرائز سیکیورٹی ریپر جو ایجنٹس کو سینڈ باکسڈ OpenShell کنٹینرز کے اندر چلاتا ہے — کی شناخت کرتا ہے۔ +سالانہ پلانز، Enterprise اور موجودہ نمبرز یہاں موجود ہیں +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**۔ سیلف ہوسٹڈ لائسنس +کیز کلاؤڈ کے بغیر بھی کام کرتی ہیں (`clawmetry license`)۔ مفت/پیڈ کی درست تقسیم +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md) میں موجود ہے۔ -زیادہ تر معاملات میں کسی اضافی ترتیب کی ضرورت نہیں۔ سنک ڈیمن خود بخود سیشن فائلوں کو ڈھونڈ لیتا ہے چاہے وہ ہوسٹ پر `~/.openclaw/` میں ہوں یا OpenShell کنٹینر کے اندر۔ +## آپ کا ڈیٹا آپ کی مشین پر ہی رہتا ہے -### یہ کیسے کام کرتا ہے +ClawMetry مقامی سیشن فائلیں اور لاگز پڑھتا ہے۔ آپ کے سسٹم سے کچھ باہر نہیں جاتا جب تک +آپ `clawmetry connect` نہ چلائیں۔ اس صورت میں بھی اسنیپ شاٹ ایک ایسی کلید سے +اینڈ ٹو اینڈ اینکرپٹڈ ہوتا ہے جو کبھی آپ کی مشین سے باہر نہیں جاتی، اور آپ کے براؤزر میں ڈکرپٹ ہوتا ہے۔ -ClawMetry دو طریقوں سے NemoClaw کی شناخت کرتا ہے: - -1. **بائنری شناخت** — `nemoclaw` CLI کی موجودگی چیک کرتا ہے اور سینڈ باکس کی معلومات حاصل کرنے کے لیے `nemoclaw status` چلاتا ہے -2. **کنٹینر شناخت** — چلتے ہوئے Docker کنٹینرز کو `openshell`، `nemoclaw`، یا `ghcr.io/nvidia/` امیجز کے لیے اسکین کرتا ہے، پھر والیوم ماؤنٹس یا `docker cp` کے ذریعے سیشنز پڑھتا ہے - -NemoClaw کنٹینرز سے سنک شدہ سیشن فائلیں کلاؤڈ ڈیش بورڈ میں `runtime=nemoclaw` اور `container_id` میٹا ڈیٹا کے ساتھ ٹیگ کی جاتی ہیں، تاکہ آپ ایک نظر میں انہیں معیاری OpenClaw سیشنز سے الگ بتا سکیں۔ - -### تجویز کردہ سیٹ اپ: ہوسٹ پر سنک ڈیمن - -بہترین تجربے کے لیے، ClawMetry کا سنک ڈیمن **ہوسٹ مشین** پر چلائیں (سینڈ باکس کے اندر نہیں)۔ یہ NemoClaw کی نیٹ ورک پالیسی کی پابندیوں سے بچاتا ہے۔ - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -سنک ڈیمن خود بخود کسی بھی چلتے ہوئے OpenShell کنٹینر کے اندر سیشنز ڈھونڈ لے گا۔ - -### اختیاری: واضح سینڈ باکس نام - -اگر خودکار شناخت کام نہ کرے، تو ClawMetry کو صحیح سینڈ باکس کی طرف اشارہ کریں: +## انسٹال ```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### سینڈ باکس کے اندر چلانا (ایڈوانسڈ) - -اگر آپ کو سنک ڈیمن **اندر** OpenShell سینڈ باکس میں چلانا ہو، تو اپنی NemoClaw نیٹ ورک پالیسی میں یہ ایگریس رول شامل کریں تاکہ یہ ClawMetry ingest API تک پہنچ سکے: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https +pip install clawmetry # then: clawmetry ``` -اس کے ساتھ لاگو کریں: +یا ون لائنر: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -```bash -nemoclaw policy apply --file nemoclaw-policy.yaml -``` +macOS، Linux یا Windows پر Python 3.8+ درکار ہے، اور اسی مشین پر کم از کم ایک ایجنٹ +رن ٹائم۔ Docker ہدایات: [docs/DOCKER.md](docs/DOCKER.md)۔ -### پورٹس اور اینڈ پوائنٹس +## دستاویزات -| اینڈ پوائنٹ | پورٹ | پروٹوکول | لازمی | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | ہاں (سنک ڈیمن → کلاؤڈ) | -| `localhost:8900` | 8900 | HTTP | ہاں (مقامی ڈیش بورڈ UI) | -| Docker سوکٹ (`/var/run/docker.sock`) | — | یونکس سوکٹ | کنٹینر سیشن دریافت کے لیے | +| | | +|---|---| +| [رن ٹائم کمپیٹیبلٹی](docs/compatibility.md) | ہر ایڈاپٹر کیا پڑھتا ہے، اور رن ٹائم کیسے شامل کریں | +| [Entitlements](docs/ENTITLEMENTS.md) | مفت بمقابلہ پیڈ، ٹیئر میٹرکس، لائسنس CLI | +| [منظوریاں اور پالیسیاں](docs/APPROVALS.md) | پری ایگزیکیوشن گیٹنگ، رسک اسکورنگ، فون سے منظوریاں | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | ٹریسز کہیں بھی ایکسپورٹ کریں، کسی بھی جگہ سے OTLP اِن جیسٹ کریں | +| [SDK ٹریکنگ](docs/SDK_TRACKING.md) | خود بنائے گئے ایجنٹس کے لیے لاگت کی تخصیص | +| [چیٹ چینلز](docs/CHANNELS.md) | Flow میں دکھائے جانے والے چیٹ ایڈاپٹرز | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | سینڈ باکسڈ NVIDIA NemoClaw سیٹ اپس | +| [Docker](docs/DOCKER.md) | امیج، کمپوز، والیوم ماؤنٹس | +| [آرکیٹیکچر](ARCHITECTURE.md) · [ڈویلپمنٹ](docs/DEVELOPMENT.md) | اندر یہ کیسے کام کرتا ہے؛ سورس سے چلانا | +| [ٹیلی میٹری](docs/TELEMETRY.md) | گمنام انسٹال اور ڈیسک ٹاپ اوپن پنگز، اور انہیں کیسے بند کریں | -سنک ڈیمن صرف `ingest.clawmetry.com` کے لیے آؤٹ باؤنڈ HTTPS کالز کرتا ہے۔ کوئی اِن باؤنڈ پورٹس درکار نہیں۔ - ---- - -## کلاؤڈ تعیناتی - -SSH ٹنلز، ریورس پراکسی، اور Docker کے لیے **[Cloud Testing Guide](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** دیکھیں۔ - -## ٹیسٹنگ - -اس پراجیکٹ کی جانچ BrowserStack کے ساتھ کی جاتی ہے۔ - -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) - -## ٹیلی میٹری - -ClawMetry گمنام انسٹال لائف سائیکل پنگز بھیجتا ہے -`https://app.clawmetry.com/api/install` کو: ایک `install` پنگ پہلی -بار جب آپ نئی مشین پر `clawmetry` CLI چلاتے ہیں، ایک `update` پنگ -نئے ورژن میں اپ گریڈ کرنے کے بعد پہلی بار، اور ایک `onboarded` -پنگ جب آپ ڈیش بورڈ کے اندر آن بورڈنگ کا انتخاب مکمل کرتے ہیں۔ ہم اسے -حقیقی انسٹالز شمار کرنے کے لیے استعمال کرتے ہیں (خام PyPI ڈاؤن لوڈ اعداد و شمار -تقریباً 98% میررز، CI، اور خودکار اپ ڈیٹ دوبارہ ڈاؤن لوڈز ہوتے ہیں) اور یہ جاننے کے -لیے کہ کون سے ایجنٹ فریم ورکس اور ورژنز اصل میں استعمال میں ہیں۔ +## اسکرین شاٹس -**فی لائف سائیکل ایونٹ فی ورژن زیادہ سے زیادہ ایک POST**، جس میں شامل ہے: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **اوورویو**: ٹوکنز، سیشنز، صحت | **برین**: لائیو ایجنٹ ایونٹ اسٹریم | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **لاگت**: ماڈل اور سیشن کے لحاظ سے | **منظوریاں**: خطرناک ٹول کالز کو روکنا | -| فیلڈ | مثال | وجہ | -|---|---|---| -| `install_id` | `~/.clawmetry/install_id` پر محفوظ رینڈم UUID | ڈی ڈپلیکیشن؛ گمنام جب تک آپ واضح طور پر Cloud sync سے کنیکٹ نہ کریں (تصدیق شدہ ڈیمن ہارٹ بیٹ پھر اسے لے جاتا ہے، اس انسٹال کو آپ کے اکاؤنٹ سے جوڑتا ہے) | -| `event` | `install` / `update` / `onboarded` | نئی انسٹال بمقابلہ موجودہ کی اپ گریڈ | -| `version` | `0.12.167` | استعمال میں کون سے ورژنز ہیں | -| `os` / `os_version` | `Darwin` / `25.3.0` | پلیٹ فارم سپورٹ ترجیحات | -| `python` | `3.11.15` | Python ورژن سپورٹ میٹرکس | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | ہمیں آگے کن ایجنٹس کے ساتھ ضم ہونا چاہیے | -| `is_ci` / `ci_provider` | `true` / `github_actions` | انسانی انسٹالز کو CI شور سے الگ کرنا | - -**ہم کیا نہیں بھیجتے**: IP (کلاؤڈ سرور کی طرف سے درخواست سے ملک کا کوڈ اخذ -کرتا ہے، پھر IP کو مسترد کر دیتا ہے)، ہوسٹ نام، صارف نام، ورک اسپیس -پاتھ، فائل کا مواد، آپ کی api_key، آپ کا ای میل، کوئی بھی ذاتی طور پر -شناخت کے قابل معلومات یا ورک اسپیس سے متعلق چیز۔ وائر پے لوڈ -[`clawmetry/telemetry.py`](clawmetry/telemetry.py) میں قابل جانچ ہے۔ - -**اختیار سے باہر نکلیں** (ان میں سے کوئی بھی ایک اسے مستقل طور پر غیر فعال کر دیتا ہے): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -نیٹ ورک کی ناکامی یہاں کبھی بھی `clawmetry` کو چلنے سے نہیں روکتی — پنگ -ایک ڈیمن تھریڈ پر 3 سیکنڈ کے ٹائم آؤٹ کے ساتھ فائر اینڈ فرگیٹ ہے۔ +مزید، ہر رن ٹائم کے لحاظ سے: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md)۔ ## اسٹار ہسٹری @@ -436,11 +113,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## لائسنس -MIT - ---- +MIT · تیار کردہ [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 اپنے ایجنٹ کو سوچتے ہوئے دیکھیں
- تیار کردہ @vivekchand · clawmetry.com · OpenClaw ماحولیاتی نظام کا حصہ -

+ diff --git a/docs/i18n/vi/README.md b/docs/i18n/vi/README.md index b57efa2bfd..e28c4d481b 100644 --- a/docs/i18n/vi/README.md +++ b/docs/i18n/vi/README.md @@ -1,19 +1,18 @@ - + > Tiếng Việt translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**Xem agent của bạn suy nghĩ.** Khả năng quan sát thời gian thực cho **20 runtime AI agent**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex và 16 runtime khác. Một dashboard duy nhất cho toàn bộ đội hình agent của bạn. +**Xem agent của bạn suy nghĩ.** Khả năng quan sát theo thời gian thực cho **23 agent runtime AI**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex và 19 runtime khác. Một dashboard duy nhất cho toàn bộ đội agent của bạn. -> 🌐 **Đọc bằng ngôn ngữ khác:** [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) · [xem thêm →](docs/i18n/) +> 🌐 **Đọc bằng ngôn ngữ khác:** [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) · [thêm →](docs/i18n/) Một lệnh duy nhất. Không cần cấu hình. Tự động phát hiện mọi thứ. @@ -21,406 +20,90 @@ Một lệnh duy nhất. Không cần cấu hình. Tự động phát hiện m pip install clawmetry && clawmetry ``` -Mở tại **http://localhost:8900** và thế là xong. +Mở tại **http://localhost:8900**. Không cần cấu hình: nó tìm ra các agent runtime +bạn đã có sẵn, đọc chúng ở chế độ chỉ đọc, và không thay đổi gì về cách chúng chạy. ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## Hoạt động với 20 runtime agent - -ClawMetry khởi đầu là công cụ quan sát cho OpenClaw, và giờ đây đo lường **toàn bộ đội hình agent** của bạn trong một dashboard duy nhất, tự động phát hiện từng runtime trên máy của bạn: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw và NemoClaw miễn phí trong ứng dụng mã nguồn mở; các runtime khác được kích hoạt bằng ClawMetry Cloud hoặc giấy phép Pro tự lưu trữ. Chuyển đổi runtime từ header và mọi tab, chi phí, token, công cụ, trace, sẽ tự động chuyển phạm vi sang runtime đó. Xem **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** để biết chi tiết chính xác về phân chia miễn phí/trả phí, ma trận các gói, cấu trúc `/api/entitlement`, và CLI `clawmetry license`. - -## Bạn nhận được gì - -- **Flow** — Sơ đồ động trực tiếp hiển thị luồng tin nhắn qua các kênh, brain, công cụ, và quay ngược lại -- **Overview** — Kiểm tra sức khỏe hệ thống, bản đồ nhiệt hoạt động, số lượng phiên, thông tin mô hình -- **Usage** — Theo dõi token và chi phí với phân tích theo ngày/tuần/tháng -- **Sessions** — Các phiên agent đang hoạt động với mô hình, token, hoạt động gần nhất -- **Crons** — Các tác vụ theo lịch với trạng thái, lần chạy tiếp theo, thời lượng -- **Logs** — Luồng log thời gian thực có mã màu -- **Memory** — Duyệt SOUL.md, MEMORY.md, AGENTS.md, ghi chú hàng ngày -- **Transcripts** — Giao diện dạng bong bóng chat để đọc lịch sử phiên -- **Alerts** — Giới hạn ngân sách, kích hoạt tỷ lệ lỗi, phát hiện agent ngoại tuyến; định tuyến tới Slack, Discord, PagerDuty, Telegram, Email -- **Approvals** — Chặn các thao tác xóa mang tính phá hủy, force push, thay đổi DB, sudo, cài đặt gói, cuộc gọi mạng đằng sau một lần phê duyệt - -## Ảnh chụp màn hình - -### 🧠 Brain — Luồng sự kiện agent trực tiếp -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Tổng hợp sử dụng token & phiên -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — Luồng gọi công cụ thời gian thực -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — Phân tích chi phí theo mô hình & phiên -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — Trình duyệt tệp không gian làm việc -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — Tư thế bảo mật & nhật ký kiểm tra -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — Giới hạn ngân sách, kích hoạt tỷ lệ lỗi, webhook tới Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — Chặn các lệnh gọi công cụ rủi ro đằng sau phê duyệt thủ công; quy tắc bảo vệ dựa trên chính sách -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Chặn trước khi thực thi cho Claude Code** — một lệnh duy nhất cài đặt -hook PreToolUse tạm dừng các lệnh gọi công cụ phù hợp *trước khi* chúng chạy và chờ -quyết định của bạn (chỉ cần một chạm từ điện thoại khi bật -[thông báo đẩy trên cloud](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 -``` - -Một lần từ chối chỉ chặn đúng lệnh gọi công cụ đó, agent vẫn giữ nguyên phiên và có thể -thử cách tiếp cận khác. Phê duyệt trên điện thoại của bạn sẽ bỏ qua lời nhắc quyền -riêng của Claude Code (bạn đã trả lời rồi). Các công cụ không khớp tốn khoảng ~40ms và -chuyển tiếp về luồng quyền thông thường của Claude Code. Bạn cũng nhận được thông báo đẩy trên điện thoại khi chính Claude Code đang chờ bạn (thông báo -`permission_prompt` / `idle_prompt`). - -## Cài đặt - -**Một dòng lệnh (khuyến nghị):** -```bash -curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash -``` - -**pip:** -```bash -pip install clawmetry -clawmetry -``` - -**Từ mã nguồn:** -```bash -git clone https://github.com/vivekchand/clawmetry.git -cd clawmetry && pip install flask && python3 dashboard.py -``` - -## Phát triển Frontend v2 - -Ứng dụng React v2 nằm trong `frontend/` và được phục vụ tại `/v2` khi máy chủ -Flask được khởi động với v2 được bật. - -Sử dụng hai terminal khi phát triển: - -```bash -# Terminal 1: Flask API/server on :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## Hoạt động với 23 agent runtime -```bash -# Terminal 2: Vite dev server on :5173 -cd frontend -nvm use -npm ci -npm run dev -``` +**Miễn phí trong ứng dụng mã nguồn mở:** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -Mở `http://localhost:5173/v2/`. Vite chuyển tiếp các yêu cầu `/api` tới -`http://localhost:8900`, để ứng dụng React có thể giao tiếp với máy chủ Flask cục bộ -mà không cần thiết lập CORS bổ sung. +**Trong gói trả phí:** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -Để build bundle được đóng gói cùng gói Python: - -```bash -cd frontend -npm run build -``` +Mỗi runtime đều có cùng một dashboard. Chạy nhiều runtime cùng lúc và bộ chuyển đổi +ở phần đầu trang sẽ điều chỉnh phạm vi của mỗi tab về một trong số chúng. -Bundle sản xuất được ghi vào `clawmetry/static/v2/dist/`. +Bạn tự xây dựng agent của mình trên một SDK thay vì dùng sẵn? Trình interceptor +cũng theo dõi các lệnh gọi LLM của nó. Xem [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md). -## Khả năng tương thích Runtime / Agent +## Bạn nhận được gì -ClawMetry quan sát nhiều runtime AI agent, không chỉ riêng OpenClaw. Mỗi runtime không phải OpenClaw đều có một adapter đọc chuyên biệt chuyển đổi định dạng phiên gốc của nó sang các cấu trúc thống nhất của ClawMetry; daemon nạp chúng vào cùng kho DuckDB + snapshot cloud, được gắn thẻ theo runtime, và tab Session replay hiển thị một **bộ chuyển đổi runtime** khi có nhiều hơn một runtime hiện diện. Xem [`docs/compatibility.md`](docs/compatibility.md) để biết ma trận đầy đủ + hướng dẫn thêm runtime, và [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) để xem phần giới thiệu về họ OpenClaw. +- **Sessions & bản ghi**: những gì mỗi agent đã làm, theo từng lượt, kèm phát lại +- **Chi phí & token**: theo runtime, model, session và ngày, kèm cảnh báo bất thường +- **Flow**: sơ đồ trực tiếp các tin nhắn di chuyển qua các kênh, model và công cụ +- **Brain**: luồng sự kiện suy luận và gọi công cụ khi nó diễn ra +- **Memory & skills**: các tệp và skill mà mỗi runtime thực sự đã tải +- **Health & logs**: dung lượng đĩa, bộ nhớ, tỷ lệ lỗi, giới hạn tốc độ, luồng log trực tiếp +- **Alerts**: giới hạn ngân sách, đột biến lỗi, agent-offline, chuyển đến Slack, Discord, PagerDuty, Telegram, Email +- **Approvals**: tạm dừng các lệnh gọi công cụ rủi ro *trước khi* chúng chạy và phê duyệt từ điện thoại của bạn ([cách thực hiện](docs/APPROVALS.md)) -Bạn đang chạy công cụ bảo mật agent [numbat của Perplexity](https://github.com/perplexityai/numbat)? ClawMetry nạp các phát hiện và quyết định thực thi của nó ngay khi mở hộp, xem [`docs/NUMBAT.md`](docs/NUMBAT.md). +## Giá cả -| Runtime / Agent | Trạng thái | Ghi chú | +| Gói | Bao gồm những gì | Giá | |---|---|---| -| **OpenClaw** | Gốc | Runtime tham chiếu, tự động phát hiện | -| **PicoClaw** | Adapter Beta | JSONL `providers.Message` dạng phẳng (`~/.picoclaw/workspace/sessions`). Bản ghi transcript, mô hình, lệnh gọi công cụ. | -| **NanoClaw** | Adapter Beta | SQLite theo từng phiên (`data/v2-sessions`). Transcript + số lượng tin nhắn. | -| **Hermes** | Adapter Beta | SQLite `~/.hermes/state.db`. Transcript, mô hình, token/chi phí. | -| **Claude Code** | Adapter Beta | JSONL `~/.claude/projects/.../.jsonl`. Transcript, mô hình, lệnh gọi công cụ + tư duy, mức sử dụng token. | -| **Codex** | Adapter Beta | Rollout JSONL `~/.codex/sessions/...`. Transcript, mô hình, lệnh gọi công cụ, mức sử dụng token. | -| **Cursor** | Adapter Beta | SQLite `state.vscdb`. Transcript chat/composer, mô hình. | -| **Aider** | Adapter Beta | `.aider.chat.history.md` mỗi dự án. Transcript, mô hình, số lượng token. | -| **Goose** | Adapter Beta | SQLite `~/.local/share/goose`. Transcript, mô hình, lệnh gọi công cụ, tổng token. | -| **opencode** | Adapter Beta | SQLite `~/.local/share/opencode`. Transcript, mô hình, lệnh gọi công cụ, token + chi phí. | -| **Qwen Code** | Adapter Beta | JSONL `~/.qwen/projects/.../chats`. Transcript, mô hình, lệnh gọi công cụ, mức sử dụng token. | -| **Pi** | Adapter Beta | JSONL `~/.pi/agent/sessions`. Transcript, mô hình, lệnh gọi công cụ, token + chi phí. | -| **Deep Agents** | Adapter Beta | SQLite `~/.deepagents/.state/sessions.db`. Transcript, mô hình, lệnh gọi công cụ, token + chi phí. | -| **n8n** | Adapter Beta | SQLite `~/.n8n/database.sqlite`. Lần thực thi workflow, lần chạy node, prompt AI Agent, mô hình + token khi n8n ghi lại. | -| **Antigravity** | Adapter Beta | Brain JSONL dưới `~/.gemini//brain/`. Hội thoại, các bước công cụ, tư duy, phân tách token Gemini theo từng lần sinh + chi phí, mức tiêu hao sinh nền. | -| **GitHub Copilot** | Adapter Beta | Copilot CLI `events.jsonl` dưới `~/.copilot/session-state/` + sổ cái sử dụng theo từng lệnh gọi `session-store.db`. Hội thoại, lệnh gọi công cụ, định tuyến mô hình, phân tách token nhận biết cache, chi phí AI-credit do nhà cung cấp tính phí. | -| **Grok** | Adapter Beta | xAI Grok Build CLI (nhị phân Rust dưới `~/.grok/bin/grok`): nhật ký sự kiện toàn cục `~/.grok/logs/unified.jsonl` + theo từng phiên `~/.grok/sessions///{events.jsonl,summary.json}`. Hội thoại, phân tách token theo từng lượt, định tuyến mô hình, và payload repo gửi đi của CLI được lưu tạm dưới `~/.grok/upload_queue/` để bạn thấy những gì đã rời khỏi máy của mình. | - -"Adapter Beta" nghĩa là ClawMetry cung cấp một trình đọc cho định dạng lưu trữ thực tế trên đĩa của runtime đó, mỗi cái đều được xây dựng + xác minh trên một cài đặt thực trên một máy thực (xem `tests/fixtures/runtimes//`). Các adapter chỉ đọc; mỗi cái đều trung thực về những gì runtime của nó thực sự lưu trữ (ví dụ: PicoClaw/NanoClaw/Cursor không ghi chi phí token vào đĩa). Khi nhiều runtime chạy trên một node, bộ chuyển đổi runtime sẽ giới hạn phạm vi xem phiên về một runtime để dễ dàng đào sâu. - -## Theo dõi bất kỳ agent SDK nào — quy kết chi phí ngoài vòng lặp - -Các runtime ở trên đều ghi phiên vào đĩa. **Agent sản xuất** của riêng bạn, cái bạn xây dựng trên OpenAI Agents SDK, LangChain, Vercel AI SDK, LlamaIndex, E2B, hoặc một vòng lặp `httpx` đơn giản, thì không. Bộ chặn không cần cấu hình của ClawMetry vẫn nắm bắt các lệnh gọi LLM của nó (chi phí, token, độ trễ, lỗi) bằng cách monkey-patch `httpx`/`requests`: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()` (hoặc biến môi trường `CLAWMETRY_SOURCE=support-agent`) gắn thẻ mỗi lệnh gọi bằng một **nguồn được đặt tên**, để mỗi sản phẩm bạn chạy hiện lên như một dòng riêng biệt, có thể quy kết chi phí, hạng nhất trong thẻ **🔌 Nguồn ngoài vòng lặp** của dashboard trên Overview, số lệnh gọi, nhà cung cấp, độ trễ, tỷ lệ lỗi theo từng agent. Chưa đặt nguồn? Các lệnh gọi vẫn được theo dõi; thẻ chỉ đơn giản là ẩn đi. - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -Đây chính là lớp dữ liệu mà các adapter runtime cung cấp (DuckDB → snapshot cloud), vì vậy các nguồn ngoài vòng lặp cũng đồng bộ lên dashboard cloud giống như mọi thứ khác, được mã hóa đầu cuối. - -## OpenTelemetry — trung lập nhà cung cấp, gửi trace của bạn đi bất cứ đâu - -ClawMetry nói **OpenTelemetry** theo cả hai chiều, sử dụng **quy ước ngữ nghĩa GenAI**, vì vậy trace agent của bạn không bao giờ bị khóa vào một công cụ duy nhất. - -**Xuất** mỗi phiên, lệnh gọi LLM, công cụ, sub-agent, token, chi phí, dưới dạng span GenAI OTLP/HTTP tới bất kỳ collector nào (Datadog, Grafana, Honeycomb, hoặc OTel Collector của riêng bạn): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -Header xác thực và khoảng thời gian polling là các biến môi trường tùy chọn: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**Nạp** — bộ nhận OTLP tích hợp sẵn chấp nhận trace, log, và metric từ bất kỳ nguồn nào khác tại `/v1/traces`, `/v1/logs`, và `/v1/metrics`. Trỏ bất kỳ ứng dụng nào được đo lường OpenTelemetry vào đó: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -Trace và log OTLP/JSON hoạt động trên `pip install clawmetry` thuần túy, không cần thêm gì. Nạp Protobuf (và metric OTLP/JSON) cần `pip install clawmetry[otel]`. Một ứng dụng tự đặt `service.name` riêng sẽ hiện lên như agent của chính nó trong bộ chuyển đổi runtime, cùng với chi phí và token của nó. - -Bạn có được dashboard ClawMetry không cần cấu hình, ưu tiên cục bộ **và** dữ liệu của bạn trong bất kỳ backend nào đội nhóm bạn đã dùng, không khóa nhà cung cấp, không cần cài thêm agent thứ hai. - -## Cấu hình - -Hầu hết mọi người không cần bất kỳ cấu hình nào. ClawMetry tự động phát hiện không gian làm việc, log, phiên, và cron của bạn. - -Nếu bạn cần tùy chỉnh: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -Tất cả các tùy chọn: `clawmetry --help` - -## Các kênh được hỗ trợ - -ClawMetry hiển thị hoạt động trực tiếp cho mọi kênh OpenClaw bạn đã cấu hình. Chỉ những kênh thực sự được thiết lập trong `openclaw.json` của bạn mới xuất hiện trong sơ đồ Flow, các kênh chưa cấu hình sẽ tự động bị ẩn. - -Nhấp vào bất kỳ nút kênh nào trong Flow để xem giao diện bong bóng chat trực tiếp với số lượng tin nhắn đến/đi. - -| Kênh | Trạng thái | Popup trực tiếp | Ghi chú | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ Đầy đủ | ✅ | Tin nhắn, thống kê, làm mới mỗi 10 giây | -| 💬 **iMessage** | ✅ Đầy đủ | ✅ | Đọc trực tiếp `~/Library/Messages/chat.db` | -| 💚 **WhatsApp** | ✅ Đầy đủ | ✅ | Qua WhatsApp Web (Baileys) | -| 🔵 **Signal** | ✅ Đầy đủ | ✅ | Qua signal-cli | -| 🟣 **Discord** | ✅ Đầy đủ | ✅ | Phát hiện guild + kênh | -| 🟪 **Slack** | ✅ Đầy đủ | ✅ | Phát hiện workspace + kênh | -| 🌐 **Webchat** | ✅ Đầy đủ | ✅ | Các phiên giao diện web tích hợp sẵn | -| 📡 **IRC** | ✅ Đầy đủ | ✅ | Giao diện bong bóng kiểu terminal | -| 🍏 **BlueBubbles** | ✅ Đầy đủ | ✅ | iMessage qua BlueBubbles REST API | -| 🔵 **Google Chat** | ✅ Đầy đủ | ✅ | Qua webhook Chat API | -| 🟣 **MS Teams** | ✅ Đầy đủ | ✅ | Qua plugin bot Teams | -| 🔷 **Mattermost** | ✅ Đầy đủ | ✅ | Chat nhóm tự lưu trữ | -| 🟩 **Matrix** | ✅ Đầy đủ | ✅ | Phi tập trung, hỗ trợ E2EE | -| 🟢 **LINE** | ✅ Đầy đủ | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ Đầy đủ | ✅ | Tin nhắn riêng NIP-04 phi tập trung | -| 🟣 **Twitch** | ✅ Đầy đủ | ✅ | Chat qua kết nối IRC | -| 🔷 **Feishu/Lark** | ✅ Đầy đủ | ✅ | Đăng ký sự kiện WebSocket | -| 🔵 **Zalo** | ✅ Đầy đủ | ✅ | Zalo Bot API | - -> **Tự động phát hiện:** ClawMetry đọc `~/.openclaw/openclaw.json` của bạn và chỉ hiển thị các kênh mà bạn thực sự đã cấu hình. Không cần thiết lập thủ công. - -## Triển khai Docker - -Muốn chạy ClawMetry trong container? Không vấn đề gì! 🐳 - -**Bắt đầu nhanh với Docker:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Ví dụ Docker Compose:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **Lưu ý:** Khi chạy trong Docker, hãy mount các thư mục dữ liệu + log của agent bạn (ví dụ: `~/.openclaw`, `~/.claude`, `~/.codex`) để ClawMetry có thể tự động phát hiện thiết lập của bạn. - -## Yêu cầu - -- Python 3.8+ -- Flask (được cài đặt tự động qua pip) -- Một runtime AI agent trên cùng máy: OpenClaw, NVIDIA NemoClaw, Claude Code, Codex, Cursor, Goose, Hermes, opencode, Qwen Code, Aider, NanoClaw, PicoClaw, Pi, Deep Agents, n8n, Antigravity, GitHub Copilot, Grok, hoặc QM (hoặc các volume được mount cho Docker) -- Linux hoặc macOS - -## Hỗ trợ NemoClaw / OpenShell - -ClawMetry tự động phát hiện [NemoClaw](https://github.com/NVIDIA/NemoClaw), lớp bảo mật doanh nghiệp của NVIDIA cho OpenClaw chạy agent bên trong các container OpenShell được sandbox hóa. - -Không cần cấu hình bổ sung trong hầu hết các trường hợp. Sync daemon tự động khám phá các tệp phiên dù chúng nằm trong `~/.openclaw/` trên host hay bên trong một container OpenShell. +| **Free** | OpenClaw + NVIDIA NemoClaw, dashboard đầy đủ, chỉ local | $0 | +| **Starter** | Mọi runtime khác ở trên, chế độ xem đội (fleet view), đồng bộ cloud | $9 mỗi node / tháng | +| **Pro** | Starter + governance: approvals, chính sách rủi ro công cụ, đánh giá, phát hiện bất thường, tối ưu chi phí, xuất OTel | $19 mỗi node / tháng | -### Cách hoạt động +Các gói hằng năm, Enterprise và các con số hiện tại có tại +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**. Khóa giấy phép tự lưu trữ +hoạt động mà không cần cloud (`clawmetry license`). Phân chia chính xác giữa +miễn phí/trả phí có trong [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md). -ClawMetry phát hiện NemoClaw theo hai cách: +## Dữ liệu của bạn luôn ở trên máy của bạn -1. **Phát hiện nhị phân** — kiểm tra CLI `nemoclaw` và chạy `nemoclaw status` để lấy thông tin sandbox -2. **Phát hiện container** — quét các container Docker đang chạy để tìm image `openshell`, `nemoclaw`, hoặc `ghcr.io/nvidia/`, sau đó đọc các phiên qua volume mount hoặc `docker cp` +ClawMetry đọc các tệp session và log cục bộ. Không có gì rời khỏi máy của bạn trừ +khi bạn chạy `clawmetry connect`. Ngay cả khi đó, bản snapshot cũng được mã hóa +đầu cuối bằng một khóa không bao giờ rời khỏi máy của bạn, và được giải mã ngay +trong trình duyệt của bạn. -Các tệp phiên được đồng bộ từ container NemoClaw được gắn thẻ `runtime=nemoclaw` và metadata `container_id` trong dashboard cloud, để bạn có thể phân biệt chúng với các phiên OpenClaw tiêu chuẩn chỉ bằng một cái nhìn. - -### Thiết lập khuyến nghị: sync daemon trên HOST - -Để có trải nghiệm tốt nhất, hãy chạy sync daemon của ClawMetry trên **máy host** (không phải bên trong sandbox). Điều này tránh các hạn chế chính sách mạng của NemoClaw. - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -Sync daemon sẽ tự động tìm các phiên bên trong bất kỳ container OpenShell nào đang chạy. - -### Tùy chọn: tên sandbox rõ ràng - -Nếu tự động phát hiện không hoạt động, hãy trỏ ClawMetry vào đúng sandbox: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### Chạy bên trong sandbox (nâng cao) - -Nếu bạn buộc phải chạy sync daemon **bên trong** sandbox OpenShell, hãy thêm quy tắc egress này vào chính sách mạng NemoClaw của bạn để nó có thể tiếp cận API nạp của ClawMetry: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -Áp dụng bằng: +## Cài đặt ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # sau đó: clawmetry ``` -### Cổng và điểm cuối - -| Điểm cuối | Cổng | Giao thức | Bắt buộc | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | Có (sync daemon → cloud) | -| `localhost:8900` | 8900 | HTTP | Có (giao diện dashboard cục bộ) | -| Docker socket (`/var/run/docker.sock`) | — | Unix socket | Để khám phá phiên trong container | - -Sync daemon chỉ thực hiện các cuộc gọi HTTPS đi ra ngoài tới `ingest.clawmetry.com`. Không cần cổng đến (inbound) nào. - ---- - -## Triển khai Cloud - -Xem **[Hướng dẫn kiểm thử Cloud](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)** để biết về SSH tunnel, reverse proxy, và Docker. - -## Kiểm thử - -Dự án này được kiểm thử với BrowserStack. +Hoặc dùng lệnh một dòng: `curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +Cần Python 3.8+ trên macOS, Linux hoặc Windows, và ít nhất một agent runtime trên +cùng máy. Hướng dẫn Docker: [docs/DOCKER.md](docs/DOCKER.md). -## Telemetry +## Tài liệu -ClawMetry gửi các ping vòng đời cài đặt ẩn danh tới -`https://app.clawmetry.com/api/install`: một ping `install` lần đầu tiên -bạn chạy CLI `clawmetry` trên một máy mới, một ping `update` -lần chạy đầu tiên sau khi nâng cấp lên phiên bản mới, và một ping -`onboarded` khi bạn hoàn tất lựa chọn onboarding trong dashboard. Chúng tôi dùng dữ liệu này -để đếm số lượt cài đặt thực (số liệu tải xuống PyPI thô có khoảng 98% là mirror, CI, -và tải lại tự động cập nhật) và để biết những framework agent và -phiên bản nào thực sự đang được sử dụng. +| | | +|---|---| +| [Khả năng tương thích runtime](docs/compatibility.md) | Mỗi adapter đọc gì, và cách thêm một runtime | +| [Entitlements](docs/ENTITLEMENTS.md) | Miễn phí và trả phí, bảng phân cấp, license CLI | +| [Approvals & policies](docs/APPROVALS.md) | Kiểm soát trước khi thực thi, chấm điểm rủi ro, phê duyệt qua điện thoại | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | Xuất trace tới bất kỳ đâu, nhận OTLP từ bất kỳ nguồn nào | +| [SDK tracking](docs/SDK_TRACKING.md) | Gán chi phí cho các agent bạn tự xây dựng | +| [Chat channels](docs/CHANNELS.md) | Các adapter chat được hiển thị trong Flow | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | Thiết lập NVIDIA NemoClaw dạng sandbox | +| [Docker](docs/DOCKER.md) | Image, compose, gắn volume | +| [Architecture](ARCHITECTURE.md) · [Development](docs/DEVELOPMENT.md) | Cách nó hoạt động bên trong; chạy từ mã nguồn | +| [Telemetry](docs/TELEMETRY.md) | Các ping ẩn danh khi cài đặt và mở desktop, và cách tắt chúng | -**Tối đa một POST cho mỗi sự kiện vòng đời mỗi phiên bản**, chứa: - -| Trường | Ví dụ | Lý do | -|---|---|---| -| `install_id` | UUID ngẫu nhiên lưu tại `~/.clawmetry/install_id` | chống trùng lặp; ẩn danh cho tới khi bạn kết nối rõ ràng với đồng bộ Cloud (heartbeat của daemon đã xác thực sau đó sẽ mang thông tin này, liên kết lượt cài đặt này với tài khoản của bạn) | -| `event` | `install` / `update` / `onboarded` | cài đặt mới so với nâng cấp một cài đặt đã có | -| `version` | `0.12.167` | phiên bản nào đang được sử dụng | -| `os` / `os_version` | `Darwin` / `25.3.0` | ưu tiên hỗ trợ nền tảng | -| `python` | `3.11.15` | ma trận hỗ trợ phiên bản Python | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | những agent nào chúng tôi nên tích hợp tiếp theo | -| `is_ci` / `ci_provider` | `true` / `github_actions` | tách biệt cài đặt của con người với nhiễu CI | - -**Những gì chúng tôi KHÔNG gửi**: IP (cloud lấy mã quốc gia phía server -từ request, sau đó loại bỏ IP), hostname, tên người dùng, đường dẫn không gian làm việc, nội dung tệp, api_key của bạn, email của bạn, bất cứ thứ gì mang tính cá nhân hoặc -đặc thù không gian làm việc. Payload truyền tải có thể được kiểm toán tại -[`clawmetry/telemetry.py`](clawmetry/telemetry.py). - -**Từ chối tham gia** (bất kỳ cách nào sau đây sẽ vô hiệu hóa vĩnh viễn): +## Ảnh chụp màn hình -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**: token, session, tình trạng hệ thống | **Brain**: luồng sự kiện agent trực tiếp | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**: theo model và session | **Approvals**: kiểm soát các lệnh gọi công cụ rủi ro | -Lỗi mạng ở đây không bao giờ chặn `clawmetry` chạy, ping này -là fire-and-forget trên một luồng daemon với thời gian chờ 3 giây. +Thêm nữa, theo từng runtime: [docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md). ## Lịch sử Star @@ -434,11 +117,6 @@ là fire-and-forget trên một luồng daemon với thời gian chờ 3 giây. ## Giấy phép -MIT - ---- +MIT · Được xây dựng bởi [@vivekchand](https://github.com/vivekchand) · [clawmetry.com](https://clawmetry.com) -

- 🦞 Xem agent của bạn suy nghĩ
- Được xây dựng bởi @vivekchand · clawmetry.com · Một phần của hệ sinh thái OpenClaw -

+ diff --git a/docs/i18n/zh-CN/README.md b/docs/i18n/zh-CN/README.md index 844d847a89..71eed84b21 100644 --- a/docs/i18n/zh-CN/README.md +++ b/docs/i18n/zh-CN/README.md @@ -1,422 +1,105 @@ - + > 简体中文 translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**看清你的智能体在想什么。** 面向 **20 种 AI 智能体运行时**的实时可观测性工具：[OpenClaw](https://github.com/openclaw/openclaw)、[NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)、Claude Code、OpenAI Codex 以及另外 16 种。一个仪表盘,管理你的整个智能体舰队。 +**看见你的智能体在思考。** 面向 **23 种 AI 智能体运行时**的实时可观测性方案：[OpenClaw](https://github.com/openclaw/openclaw)、[NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)、Claude Code、OpenAI Codex 及其他 19 种。一个仪表盘,覆盖你的整个智能体机群。 -> 🌐 **多语言版本:** [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/) +> 🌐 **切换语言：** [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** 打开,即可完成。 +在 **http://localhost:8900** 打开。零配置：它会找到你机器上已有的智能体运行时,以只读方式读取它们,不改变它们的任何运行方式。 ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 支持 20 种智能体运行时 - -ClawMetry 最初是为 OpenClaw 打造的可观测性工具,如今已能在同一个仪表盘中计量你的**整个智能体舰队**,自动检测你机器上的每一种运行时: - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw 和 NemoClaw 在开源应用中免费提供;其他运行时则需要通过 ClawMetry Cloud 或自托管的 Pro 许可证解锁。可以从页头切换运行时,每个标签页(成本、Token、工具、追踪)都会重新聚焦到该运行时。具体的免费/付费划分、层级对照表、`/api/entitlement` 的数据结构以及 `clawmetry license` CLI,详见 **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)**。 - -## 你能获得什么 - -- **Flow** —— 动态流程图,实时展示消息在渠道、大脑、工具之间往返流转 -- **Overview** —— 健康检查、活动热力图、会话计数、模型信息 -- **Usage** —— 按日/周/月分解的 Token 与成本追踪 -- **Sessions** —— 活跃的智能体会话,包含模型、Token、最后活动时间 -- **Crons** —— 定时任务,包含状态、下次运行时间、耗时 -- **Logs** —— 彩色标注的实时日志流 -- **Memory** —— 浏览 SOUL.md、MEMORY.md、AGENTS.md、每日笔记 -- **Transcripts** —— 用聊天气泡界面阅读会话历史 -- **Alerts** —— 预算上限、错误率触发、智能体离线检测;可路由至 Slack、Discord、PagerDuty、Telegram、Email -- **Approvals** —— 将危险的删除操作、强制推送、数据库变更、sudo、包安装、网络调用挡在一键签核之后 - -## 截图 - -### 🧠 Brain —— 智能体事件实时流 -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview —— Token 使用与会话汇总 -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow —— 实时工具调用信息流 -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens —— 按模型和会话拆分成本 -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory —— 工作区文件浏览器 -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security —— 安全态势与审计日志 -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts —— 预算上限、错误率触发,以及到 Slack / Discord / PagerDuty / Email 的 Webhook -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals —— 将高风险工具调用挡在人工签核之后;基于策略的保护规则 -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**面向 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 自身的 -权限提示(你已经回答过了)。未匹配的工具大约耗费 40ms,随后回落到 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 前端开发 - -v2 版 React 应用位于 `frontend/`,当 Flask 服务器以启用 v2 的方式启动时, -会在 `/v2` 路径下提供服务。 - -开发时请使用两个终端: - -```bash -# Terminal 1: Flask API/server on :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## 支持 23 种智能体运行时 -```bash -# Terminal 2: Vite dev server on :5173 -cd frontend -nvm use -npm ci -npm run dev -``` +**开源应用中免费：** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -打开 `http://localhost:5173/v2/`。Vite 会将 `/api` 请求代理到 -`http://localhost:8900`,因此 React 应用无需额外的 CORS 配置即可与本地 -Flask 服务器通信。 +**付费计划中包含：** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -构建随 Python 包一起发布的产物包: - -```bash -cd frontend -npm run build -``` +每种运行时都能使用同一个仪表盘。同时运行多个运行时,顶部切换器会将每个标签页重新聚焦到其中一个。 -生产环境的构建产物会写入 `clawmetry/static/v2/dist/`。 +用某个 SDK 自己搭建了智能体?拦截器同样可以追踪它的 LLM 调用。参见 [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md)。 -## 运行时 / 智能体兼容性 +## 你能获得什么 -ClawMetry 观测的不仅是 OpenClaw,还有许多 AI 智能体运行时。每个非 OpenClaw 的运行时都配有专用的读取适配器,负责将其原生的会话格式转换为 ClawMetry 的统一数据结构;守护进程会将它们摄入同一个 DuckDB 存储和云端快照中,并打上运行时标签,Session replay 标签页在检测到多种运行时同时存在时会显示**运行时切换器**。完整对照表和运行时接入指南见 [`docs/compatibility.md`](docs/compatibility.md),OpenClaw 家族的入门介绍见 [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md)。 +- **会话与转录**：每个智能体逐轮做了什么,支持回放 +- **成本与令牌**：按运行时、模型、会话和日期统计,并带异常标记 +- **Flow**：消息在渠道、模型和工具之间流转的实时图示 +- **Brain**：实时呈现推理与工具调用事件流 +- **Memory 与 skills**：每个运行时实际加载的文件和技能 +- **Health 与日志**：磁盘、内存、错误率、速率限制、实时日志流 +- **Alerts**：预算上限、错误突增、智能体离线,可路由到 Slack、Discord、PagerDuty、Telegram、Email +- **Approvals**：在高风险工具调用*执行前*暂停,并可在手机上审批([了解方式](docs/APPROVALS.md)) -正在使用 [Perplexity 的 numbat](https://github.com/perplexityai/numbat) 智能体安全工具?ClawMetry 开箱即可摄入它的检测结果和执行决策,详见 [`docs/NUMBAT.md`](docs/NUMBAT.md)。 +## 定价 -| 运行时 / 智能体 | 状态 | 说明 | +| 计划 | 覆盖范围 | 价格 | |---|---|---| -| **OpenClaw** | 原生支持 | 参考运行时,自动检测 | -| **PicoClaw** | Beta 适配器 | 扁平化的 `providers.Message` JSONL(`~/.picoclaw/workspace/sessions`)。会话记录、模型、工具调用。 | -| **NanoClaw** | Beta 适配器 | 按会话存储的 SQLite(`data/v2-sessions`)。会话记录 + 消息计数。 | -| **Hermes** | Beta 适配器 | SQLite `~/.hermes/state.db`。会话记录、模型、Token/成本。 | -| **Claude Code** | Beta 适配器 | JSONL `~/.claude/projects/.../.jsonl`。会话记录、模型、工具调用 + 思考过程、Token 用量。 | -| **Codex** | Beta 适配器 | Rollout JSONL `~/.codex/sessions/...`。会话记录、模型、工具调用、Token 用量。 | -| **Cursor** | Beta 适配器 | SQLite `state.vscdb`。聊天/composer 会话记录、模型。 | -| **Aider** | Beta 适配器 | 每个项目一个 `.aider.chat.history.md`。会话记录、模型、Token 计数。 | -| **Goose** | Beta 适配器 | SQLite `~/.local/share/goose`。会话记录、模型、工具调用、Token 总量。 | -| **opencode** | Beta 适配器 | SQLite `~/.local/share/opencode`。会话记录、模型、工具调用、Token + 成本。 | -| **Qwen Code** | Beta 适配器 | JSONL `~/.qwen/projects/.../chats`。会话记录、模型、工具调用、Token 用量。 | -| **Pi** | Beta 适配器 | JSONL `~/.pi/agent/sessions`。会话记录、模型、工具调用、Token + 成本。 | -| **Deep Agents** | Beta 适配器 | SQLite `~/.deepagents/.state/sessions.db`。会话记录、模型、工具调用、Token + 成本。 | -| **n8n** | Beta 适配器 | SQLite `~/.n8n/database.sqlite`。工作流执行、节点运行、AI Agent 提示词,以及 n8n 有记录时的模型 + Token。 | -| **Antigravity** | Beta 适配器 | `~/.gemini//brain/` 下的 Brain JSONL。对话、工具步骤、思考过程、按每次生成拆分的 Gemini Token 及成本、后台生成消耗。 | -| **GitHub Copilot** | Beta 适配器 | Copilot CLI 的 `events.jsonl`(位于 `~/.copilot/session-state/`)+ `session-store.db` 中按调用记录的用量台账。对话、工具调用、模型路由、区分缓存的 Token 拆分、按供应商计费的 AI 额度成本。 | -| **Grok** | Beta 适配器 | xAI Grok Build CLI(`~/.grok/bin/grok` 下的 Rust 二进制文件):全局事件日志 `~/.grok/logs/unified.jsonl` + 按会话的 `~/.grok/sessions///{events.jsonl,summary.json}`。对话、按轮次拆分的 Token、模型路由,以及暂存在 `~/.grok/upload_queue/` 下的 CLI 出站仓库负载,方便你查看有哪些内容离开了你的机器。 | - -"Beta 适配器"意味着 ClawMetry 为该运行时真实的磁盘存储格式提供了读取器,每一个都基于真实机器上的真实安装构建并验证过(参见 `tests/fixtures/runtimes//`)。适配器均为只读;每个适配器都如实反映其运行时实际存储了什么(例如 PicoClaw/NanoClaw/Cursor 并不会把 Token 成本写入磁盘)。当一个节点上运行多个运行时时,运行时切换器会将会话视图聚焦到某一个,便于专注排查。 - -## 追踪任意 SDK 智能体 —— loop 外的成本归因 - -以上这些运行时都会将会话写入磁盘。而你自己的**生产级智能体**——无论是基于 OpenAI Agents SDK、LangChain、Vercel AI SDK、LlamaIndex、E2B 构建的,还是一个纯粹的 `httpx` 循环——却不会。ClawMetry 的零配置拦截器依然能够捕获它的 LLM 调用(成本、Token、延迟、错误),方式是对 `httpx`/`requests` 进行猴子补丁: - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()`(或环境变量 `CLAWMETRY_SOURCE=support-agent`)会给每次调用打上一个**命名来源**标签,这样你运行的每个产品都会作为独立的、可归因成本的条目出现在仪表盘 Overview 页面的 **🔌 Out-loop sources** 卡片中——每个智能体的调用数、供应商、延迟、错误率一目了然。没有设置来源?调用依然会被追踪,只是卡片会保持隐藏。 - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -这与运行时适配器所使用的数据层完全相同(DuckDB → 云端快照),因此 out-loop 来源会像其他数据一样端到端加密同步到云端仪表盘。 - -## OpenTelemetry —— 厂商中立,追踪数据可发送到任意地方 - -ClawMetry 在收发两个方向都支持 **OpenTelemetry**,并使用 **GenAI 语义约定**,因此你的智能体追踪数据永远不会被锁定在单一工具中。 - -**导出**每个会话——LLM 调用、工具、子智能体、Token、成本——以 OTLP/HTTP GenAI span 的形式导出到任意采集器(Datadog、Grafana、Honeycomb,或你自己的 OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -认证请求头和轮询间隔为可选的环境变量: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**摄入** —— 内置的 OTLP 接收器可以在 `/v1/traces`、`/v1/logs`、`/v1/metrics` 上接收来自任何其他系统的追踪、日志和指标数据。将任何具备 OpenTelemetry 埋点的应用指向它即可: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON 格式的追踪和日志在普通 `pip install clawmetry` 下即可使用,无需额外依赖。Protobuf 摄入(以及 OTLP/JSON 格式的指标)则需要 `pip install clawmetry[otel]`。设置了自己 `service.name` 的应用会在运行时切换器中作为独立的智能体出现,拥有自己的成本和 Token 数据。 - -你既能获得零配置、本地优先的 ClawMetry 仪表盘,**又**能将数据同步到你团队已经在用的任何后端,没有锁定,也不需要安装第二个智能体。 - -## 配置 - -大多数人不需要任何配置。ClawMetry 会自动检测你的工作区、日志、会话和定时任务。 - -如果确实需要自定义: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -所有选项:`clawmetry --help` - -## 支持的渠道 - -ClawMetry 会为你已配置的每个 OpenClaw 渠道显示实时活动。只有在你的 `openclaw.json` 中实际配置过的渠道才会出现在 Flow 图中,未配置的渠道会自动隐藏。 - -点击 Flow 图中的任意渠道节点即可查看实时聊天气泡视图,包含收发消息计数。 - -| 渠道 | 状态 | 实时弹窗 | 说明 | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ 完整支持 | ✅ | 消息、统计数据,10 秒刷新一次 | -| 💬 **iMessage** | ✅ 完整支持 | ✅ | 直接读取 `~/Library/Messages/chat.db` | -| 💚 **WhatsApp** | ✅ 完整支持 | ✅ | 通过 WhatsApp Web(Baileys) | -| 🔵 **Signal** | ✅ 完整支持 | ✅ | 通过 signal-cli | -| 🟣 **Discord** | ✅ 完整支持 | ✅ | 服务器 + 频道检测 | -| 🟪 **Slack** | ✅ 完整支持 | ✅ | 工作区 + 频道检测 | -| 🌐 **Webchat** | ✅ 完整支持 | ✅ | 内置网页 UI 会话 | -| 📡 **IRC** | ✅ 完整支持 | ✅ | 终端风格的气泡界面 | -| 🍏 **BlueBubbles** | ✅ 完整支持 | ✅ | 通过 BlueBubbles REST API 实现 iMessage | -| 🔵 **Google Chat** | ✅ 完整支持 | ✅ | 通过 Chat API webhook | -| 🟣 **MS Teams** | ✅ 完整支持 | ✅ | 通过 Teams 机器人插件 | -| 🔷 **Mattermost** | ✅ 完整支持 | ✅ | 自托管团队聊天工具 | -| 🟩 **Matrix** | ✅ 完整支持 | ✅ | 去中心化,支持端到端加密 | -| 🟢 **LINE** | ✅ 完整支持 | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ 完整支持 | ✅ | 去中心化 NIP-04 私信 | -| 🟣 **Twitch** | ✅ 完整支持 | ✅ | 通过 IRC 连接实现聊天 | -| 🔷 **Feishu/Lark** | ✅ 完整支持 | ✅ | WebSocket 事件订阅 | -| 🔵 **Zalo** | ✅ 完整支持 | ✅ | Zalo Bot API | - -> **自动检测:** ClawMetry 会读取你的 `~/.openclaw/openclaw.json`,只渲染你实际配置过的渠道,无需手动设置。 - -## Docker 部署 - -想在容器中运行 ClawMetry?没问题!🐳 - -**使用 Docker 快速开始:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose 示例:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **注意:** 在 Docker 中运行时,请挂载你的智能体的数据和日志目录(例如 `~/.openclaw`、`~/.claude`、`~/.codex`),以便 ClawMetry 能自动检测你的配置。 - -## 环境要求 - -- Python 3.8+ -- Flask(通过 pip 自动安装) -- 同一台机器上运行的 AI 智能体运行时:OpenClaw、NVIDIA NemoClaw、Claude Code、Codex、Cursor、Goose、Hermes、opencode、Qwen Code、Aider、NanoClaw、PicoClaw、Pi、Deep Agents、n8n、Antigravity、GitHub Copilot、Grok 或 QM(在 Docker 中则为挂载的数据卷) -- Linux 或 macOS - -## NemoClaw / OpenShell 支持 - -ClawMetry 会自动检测 [NemoClaw](https://github.com/NVIDIA/NemoClaw) —— NVIDIA 为 OpenClaw 打造的企业级安全封装层,在沙盒化的 OpenShell 容器中运行智能体。 - -大多数情况下无需额外配置。无论会话文件位于宿主机的 `~/.openclaw/` 还是 OpenShell 容器内部,同步守护进程都会自动发现它们。 +| **Free** | OpenClaw + NVIDIA NemoClaw,完整仪表盘,仅限本地 | $0 | +| **Starter** | 上述其他所有运行时、机群视图、云同步 | 每节点每月 $9 | +| **Pro** | Starter + 治理能力：审批、工具风险策略、评估、异常检测、成本优化器、OTel 导出 | 每节点每月 $19 | -### 工作原理 +年付方案、企业版及最新价格见 +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**。自托管许可证密钥 +无需云端即可使用(`clawmetry license`)。免费/付费的详细划分见 +[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)。 -ClawMetry 通过两种方式检测 NemoClaw: +## 你的数据留在你的机器上 -1. **二进制检测** —— 检查是否存在 `nemoclaw` CLI,并运行 `nemoclaw status` 获取沙盒信息 -2. **容器检测** —— 扫描运行中的 Docker 容器,查找包含 `openshell`、`nemoclaw` 或 `ghcr.io/nvidia/` 的镜像,然后通过卷挂载或 `docker cp` 读取会话数据 +ClawMetry 读取本地会话文件和日志。除非你运行 `clawmetry connect`, +否则不会有任何数据离开你的设备。即便如此,快照也会使用一个永远不会 +离开你机器的密钥进行端到端加密,并在你的浏览器中解密。 -从 NemoClaw 容器同步的会话文件,在云端仪表盘中会被打上 `runtime=nemoclaw` 和 `container_id` 元数据标签,让你一眼就能将它们与标准的 OpenClaw 会话区分开来。 - -### 推荐配置:在宿主机上运行同步守护进程 - -为获得最佳体验,请在**宿主机**(而非沙盒内部)运行 ClawMetry 的同步守护进程。这样可以避开 NemoClaw 的网络策略限制。 - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -同步守护进程会自动查找任何运行中的 OpenShell 容器内的会话数据。 - -### 可选:显式指定沙盒名称 - -如果自动检测未生效,可以指定 ClawMetry 应使用的沙盒: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### 在沙盒内部运行(进阶用法) - -如果你必须在 OpenShell 沙盒**内部**运行同步守护进程,请在你的 NemoClaw 网络策略中添加以下出站规则,使其能够访问 ClawMetry 的接收 API: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -使用以下命令应用配置: +## 安装 ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # 然后运行: clawmetry ``` -### 端口与端点 - -| 端点 | 端口 | 协议 | 是否必需 | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | 是(同步守护进程 → 云端) | -| `localhost:8900` | 8900 | HTTP | 是(本地仪表盘 UI) | -| Docker socket(`/var/run/docker.sock`) | — | Unix socket | 用于容器会话发现 | - -同步守护进程只会向 `ingest.clawmetry.com` 发起出站 HTTPS 调用,不需要任何入站端口。 - ---- - -## 云端部署 - -有关 SSH 隧道、反向代理和 Docker 的说明,请参见 **[云端测试指南](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)**。 - -## 测试 - -本项目使用 BrowserStack 进行测试。 +或使用一行命令：`curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +需要在 macOS、Linux 或 Windows 上运行 Python 3.8+,并且同一台机器上至少 +安装了一种智能体运行时。Docker 说明见 [docs/DOCKER.md](docs/DOCKER.md)。 -## 遥测 +## 文档 -ClawMetry 会向 `https://app.clawmetry.com/api/install` 发送匿名的安装生命周期 -数据:首次在新机器上运行 `clawmetry` CLI 时发送一次 `install` 数据, -升级到新版本后首次运行时发送一次 `update` 数据,完成仪表盘内的引导选择时 -发送一次 `onboarded` 数据。我们借此统计真实的安装量(原始的 PyPI 下载 -数字约 98% 来自镜像、CI 和自动更新的重复下载),并了解实际使用中有哪些 -智能体框架和版本。 +| | | +|---|---| +| [运行时兼容性](docs/compatibility.md) | 每个适配器读取的内容,以及如何添加新的运行时 | +| [权益(Entitlements)](docs/ENTITLEMENTS.md) | 免费 vs 付费、层级矩阵、许可证 CLI | +| [审批与策略](docs/APPROVALS.md) | 执行前门控、风险评分、手机审批 | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | 将追踪数据导出到任何地方,从任何来源接收 OTLP | +| [SDK 追踪](docs/SDK_TRACKING.md) | 为你自己构建的智能体做成本归因 | +| [聊天渠道](docs/CHANNELS.md) | Flow 中展示的聊天适配器 | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | 沙盒化的 NVIDIA NemoClaw 配置 | +| [Docker](docs/DOCKER.md) | 镜像、compose、卷挂载 | +| [架构](ARCHITECTURE.md) · [开发](docs/DEVELOPMENT.md) | 内部工作原理;从源码运行 | +| [遥测](docs/TELEMETRY.md) | 匿名的安装与桌面打开 ping,以及如何关闭它们 | -**每个生命周期事件、每个版本最多发送一次 POST**,内容包括: - -| 字段 | 示例 | 用途 | -|---|---|---| -| `install_id` | 存储在 `~/.clawmetry/install_id` 的随机 UUID | 去重;在你显式连接 Cloud 同步之前保持匿名(此后经过身份验证的守护进程心跳会携带它,将此次安装与你的账户关联) | -| `event` | `install` / `update` / `onboarded` | 区分全新安装与现有安装的升级 | -| `version` | `0.12.167` | 了解实际使用中的版本分布 | -| `os` / `os_version` | `Darwin` / `25.3.0` | 平台支持优先级 | -| `python` | `3.11.15` | Python 版本支持矩阵 | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | 我们接下来应该集成哪些智能体 | -| `is_ci` / `ci_provider` | `true` / `github_actions` | 将人工安装与 CI 噪音区分开 | - -**我们不会发送的内容**:IP(云端会在服务端根据请求推导国家代码,随后 -丢弃该 IP)、主机名、用户名、工作区路径、文件内容、你的 api_key、你的 -邮箱,以及任何 PII 或与工作区相关的信息。完整的传输负载可在 -[`clawmetry/telemetry.py`](clawmetry/telemetry.py) 中审查。 - -**退出遥测**(以下任意一种方式即可永久禁用): +## 截图 -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**：令牌、会话、健康状态 | **Brain**：实时智能体事件流 | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**：按模型和会话统计 | **Approvals**：为高风险工具调用设置门控 | -网络故障不会阻塞 `clawmetry` 的运行,遥测请求在守护线程上以“发送后不等待 -结果”的方式执行,超时时间为 3 秒。 +按运行时查看更多截图：[docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md)。 ## Star 历史 @@ -430,11 +113,6 @@ touch ~/.clawmetry/notelemetry # persistent file marker ## 许可证 -MIT - ---- +MIT · 由 [@vivekchand](https://github.com/vivekchand) 构建 · [clawmetry.com](https://clawmetry.com) -

- 🦞 看清你的智能体在想什么
- 由 @vivekchand 构建 · clawmetry.com · OpenClaw 生态系统的一部分 -

+ diff --git a/docs/i18n/zh-TW/README.md b/docs/i18n/zh-TW/README.md index 4ce2274308..82d7ba7183 100644 --- a/docs/i18n/zh-TW/README.md +++ b/docs/i18n/zh-TW/README.md @@ -1,424 +1,105 @@ - + > 繁體中文 translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes. # 🦞 ClawMetry -[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) -[![PyPI Downloads/week](https://static.pepy.tech/badge/clawmetry/week)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![PyPI version](https://img.shields.io/pypi/v/clawmetry?color=E5443A&label=version)](https://pypi.org/project/clawmetry/) +[![PyPI Downloads](https://static.pepy.tech/badge/clawmetry)](https://clickpy.clickhouse.com/dashboard/clawmetry) [![GitHub stars](https://img.shields.io/github/stars/vivekchand/clawmetry?style=flat&color=E5443A)](https://github.com/vivekchand/clawmetry/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ClawMetry - #5 Product of the Day on Product Hunt -**看見你的 agent 如何思考。** 為 **20 種 AI agent 執行環境**提供即時可觀測性：[OpenClaw](https://github.com/openclaw/openclaw)、[NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)、Claude Code、OpenAI Codex，以及另外 16 種。一個儀表板管理你整個 agent 艦隊。 +**看見你的智能體如何思考。** 為 **23 種 AI 智能體執行環境**提供即時可觀測性：[OpenClaw](https://github.com/openclaw/openclaw)、[NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)、Claude Code、OpenAI Codex 及其他 19 種。一個儀表板，管理你整個智能體艦隊。 > 🌐 **閱讀其他語言版本：** [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** 開啟，就這麼簡單。 +於 **http://localhost:8900** 開啟。零設定：它會找到你已經在使用的智能體執行環境，以唯讀方式讀取，不會改變它們的任何運作方式。 ![Flow Visualization](https://clawmetry.com/screenshots/flow.png) -## 支援 20 種 agent 執行環境 - -ClawMetry 最初是為 OpenClaw 打造的可觀測性工具，現在已經能在同一個儀表板中監測你**整個 agent 艦隊**，並自動偵測機器上的每種執行環境： - -🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n** · 🪐 **Antigravity** · 🐙 **GitHub Copilot** · **Grok** · **QM** · 🐋 **DeepSeek Harness** - -OpenClaw 和 NemoClaw 在開源應用程式中免費使用；其他執行環境需要 ClawMetry Cloud 或自架的 Pro 授權才能啟用。從頁首切換執行環境後,每個分頁(成本、tokens、工具、traces)都會重新聚焦到該執行環境。確切的免費/付費區分、方案比較表、`/api/entitlement` 格式,以及 `clawmetry license` CLI,請參閱 **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)**。 - -## 你能獲得什麼 - -- **Flow** — 動態圖表,即時顯示訊息如何流經頻道、大腦、工具再返回 -- **Overview** — 健康檢查、活動熱力圖、session 數量、模型資訊 -- **Usage** — token 與成本追蹤,提供每日/每週/每月的細分 -- **Sessions** — 使用中的 agent session,顯示模型、tokens、最後活動時間 -- **Crons** — 排程工作,顯示狀態、下次執行時間、耗時 -- **Logs** — 彩色標示的即時日誌串流 -- **Memory** — 瀏覽 SOUL.md、MEMORY.md、AGENTS.md、每日筆記 -- **Transcripts** — 聊天氣泡介面,方便閱讀 session 歷史紀錄 -- **Alerts** — 預算上限、錯誤率觸發、agent 離線偵測;可路由至 Slack、Discord、PagerDuty、Telegram、Email -- **Approvals** — 將破壞性刪除、強制推送、資料庫變更、sudo、套件安裝、網路呼叫,擋在一鍵核准之前 - -## 螢幕截圖 - -### 🧠 Brain — 即時 agent 事件串流 -![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) - -### 📊 Overview — Token 使用量與 session 摘要 -![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) - -### ⚡ Flow — 即時工具呼叫動態 -![Flow tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/flow.png) - -### 💰 Tokens — 依模型與 session 細分成本 -![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) - -### 🧬 Memory — 工作區檔案瀏覽器 -![Memory tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/memory.png) - -### 🔐 Security — 安全態勢與稽核日誌 -![Security tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/security.png) - -### 🚨 Alerts — 預算上限、錯誤率觸發,並將 webhook 傳送至 Slack / Discord / PagerDuty / Email -![Alerts tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/alerts.png) - -### ✋ Approvals — 將風險工具呼叫擋在人工簽核之前;由政策支援的防護規則 -![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) - -**Claude Code 的執行前攔截** — 一行指令即可安裝 -PreToolUse hook,在符合條件的工具呼叫*執行前*暫停,並等待你的決定 -(啟用[雲端推播通知](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 -``` - -拒絕只會擋下那一次工具呼叫,agent 仍保有其 session,可以嘗試其他做法。用手機核准會略過 Claude Code 自身的 -權限提示(因為你已經回答過了)。未匹配的工具只會多花約 40ms,並會回退到 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 前端開發 - -v2 React 應用程式位於 `frontend/`,啟用 v2 後,Flask -伺服器會將其服務於 `/v2`。 - -開發時請開啟兩個終端機: - -```bash -# Terminal 1: Flask API/server on :8900 -CLAWMETRY_V2=1 python3 dashboard.py -``` +## 支援 23 種智能體執行環境 -```bash -# Terminal 2: Vite dev server on :5173 -cd frontend -nvm use -npm ci -npm run dev -``` +**開源應用程式中免費提供：** 🦞 **[OpenClaw](https://clawmetry.com/runtimes/openclaw)** · 🟩 **[NVIDIA NemoClaw](https://clawmetry.com/nemoclaw)** -開啟 `http://localhost:5173/v2/`。Vite 會將 `/api` 請求代理到 -`http://localhost:8900`,因此 React 應用程式無需額外的 CORS 設定 -即可與本機 Flask 伺服器通訊。 +**付費方案提供：** ◆ **[Claude Code](https://clawmetry.com/runtimes/claude-code)** · ⬡ **[OpenAI Codex](https://clawmetry.com/runtimes/codex)** · **[Cursor](https://clawmetry.com/runtimes/cursor)** · 🪿 **[Goose](https://clawmetry.com/runtimes/goose)** · ⚡ **[Hermes](https://clawmetry.com/runtimes/hermes)** · **[opencode](https://clawmetry.com/runtimes/opencode)** · ◈ **[Qwen Code](https://clawmetry.com/runtimes/qwen-code)** · **[Aider](https://clawmetry.com/runtimes/aider)** · **[NanoClaw](https://clawmetry.com/runtimes/nanoclaw)** · **[PicoClaw](https://clawmetry.com/runtimes/picoclaw)** · **[Pi](https://clawmetry.com/runtimes/pi)** · **[Deep Agents](https://clawmetry.com/runtimes/deep-agents)** · 🔗 **[n8n](https://clawmetry.com/runtimes/n8n)** · 🪐 **[Antigravity](https://clawmetry.com/runtimes/antigravity)** · 🐙 **[GitHub Copilot](https://clawmetry.com/runtimes/copilot)** · **[Grok](https://clawmetry.com/runtimes/grok)** · **[QM](https://clawmetry.com/runtimes/qm)** · 🐋 **[DeepSeek Harness](https://clawmetry.com/runtimes/deepseek-harness)** · 🦾 **[Exo](https://clawmetry.com/runtimes/exo)** · 🌙 **[Kimi CLI](https://clawmetry.com/runtimes/kimi)** · 🅳 **[Devin](https://clawmetry.com/runtimes/devin)** -若要建置隨 Python 套件一起發佈的 bundle: - -```bash -cd frontend -npm run build -``` +每個執行環境都使用同一個儀表板。同時執行多個時，頂部的切換器會將每個分頁重新對應到你選擇的其中一個。 -正式環境的 bundle 會輸出到 `clawmetry/static/v2/dist/`。 +用 SDK 自行打造了自己的智能體嗎？攔截器也會追蹤它的 LLM 呼叫。詳見 [docs/SDK_TRACKING.md](docs/SDK_TRACKING.md)。 -## 執行環境 / Agent 相容性 +## 你將獲得什麼 -ClawMetry 觀測許多 AI agent 執行環境,不只是 OpenClaw。每個非 OpenClaw 的執行環境都有專屬的讀取轉接器(reader adapter),將其原生的 session 格式轉換成 ClawMetry 的統一格式;daemon 會將這些資料匯入同一個 DuckDB 儲存庫與雲端快照,並標記所屬執行環境,當偵測到一個以上的執行環境時,Session replay 分頁會顯示**執行環境切換器**。完整比較表與新增執行環境的指南請參閱 [`docs/compatibility.md`](docs/compatibility.md),OpenClaw 家族入門介紹請參閱 [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md)。 +- **工作階段與逐字稿**：每個智能體逐輪做了什麼,並可回放 +- **成本與 token**：依執行環境、模型、工作階段與日期分類,並附帶異常標記 +- **Flow**：訊息在頻道、模型與工具之間流動的即時圖表 +- **Brain**：即時呈現的推理與工具呼叫事件串流 +- **記憶與技能**：每個執行環境實際載入的檔案與技能 +- **健康狀態與日誌**：磁碟、記憶體、錯誤率、速率限制、即時日誌串流 +- **警示**：預算上限、錯誤激增、智能體離線,可路由至 Slack、Discord、PagerDuty、Telegram、Email +- **核准**：在風險工具呼叫執行*之前*先暫停,並可從手機核准（[了解方式](docs/APPROVALS.md)） -正在使用 [Perplexity 的 numbat](https://github.com/perplexityai/numbat) agent 安全工具嗎?ClawMetry 開箱即可擷取其偵測結果與強制執行決策——詳見 [`docs/NUMBAT.md`](docs/NUMBAT.md)。 +## 價格 -| 執行環境 / Agent | 狀態 | 備註 | +| 方案 | 涵蓋內容 | 價格 | |---|---|---| -| **OpenClaw** | 原生支援 | 參考執行環境,自動偵測 | -| **PicoClaw** | Beta 轉接器 | 扁平化的 `providers.Message` JSONL(`~/.picoclaw/workspace/sessions`)。Transcripts、模型、工具呼叫。 | -| **NanoClaw** | Beta 轉接器 | 每個 session 一份 SQLite(`data/v2-sessions`)。Transcripts + 訊息數量。 | -| **Hermes** | Beta 轉接器 | SQLite `~/.hermes/state.db`。Transcripts、模型、tokens/成本。 | -| **Claude Code** | Beta 轉接器 | JSONL `~/.claude/projects/.../.jsonl`。Transcripts、模型、工具呼叫 + thinking、token 使用量。 | -| **Codex** | Beta 轉接器 | Rollout JSONL `~/.codex/sessions/...`。Transcripts、模型、工具呼叫、token 使用量。 | -| **Cursor** | Beta 轉接器 | SQLite `state.vscdb`。Chat/composer transcripts、模型。 | -| **Aider** | Beta 轉接器 | 每個專案一份 `.aider.chat.history.md`。Transcripts、模型、token 計數。 | -| **Goose** | Beta 轉接器 | SQLite `~/.local/share/goose`。Transcripts、模型、工具呼叫、token 總量。 | -| **opencode** | Beta 轉接器 | SQLite `~/.local/share/opencode`。Transcripts、模型、工具呼叫、tokens + 成本。 | -| **Qwen Code** | Beta 轉接器 | JSONL `~/.qwen/projects/.../chats`。Transcripts、模型、工具呼叫、token 使用量。 | -| **Pi** | Beta 轉接器 | JSONL `~/.pi/agent/sessions`。Transcripts、模型、工具呼叫、tokens + 成本。 | -| **Deep Agents** | Beta 轉接器 | SQLite `~/.deepagents/.state/sessions.db`。Transcripts、模型、工具呼叫、tokens + 成本。 | -| **n8n** | Beta 轉接器 | SQLite `~/.n8n/database.sqlite`。工作流程執行、節點執行、AI Agent 提示,以及 n8n 有紀錄時的模型 + tokens。 | -| **Antigravity** | Beta 轉接器 | Brain JSONL,位於 `~/.gemini//brain/`。對話、工具步驟、thinking、每次生成的 Gemini token 細分 + 成本、背景生成耗用量。 | -| **GitHub Copilot** | Beta 轉接器 | Copilot CLI `events.jsonl`,位於 `~/.copilot/session-state/`,加上 `session-store.db` 每次呼叫的使用量帳本。對話、工具呼叫、模型路由、快取感知的 token 細分、由供應商計費的 AI-credit 成本。 | -| **Grok** | Beta 轉接器 | xAI Grok Build CLI(位於 `~/.grok/bin/grok` 的 Rust 執行檔):全域事件日誌 `~/.grok/logs/unified.jsonl` + 每個 session 的 `~/.grok/sessions///{events.jsonl,summary.json}`。對話、每輪 token 細分、模型路由,以及暫存於 `~/.grok/upload_queue/` 的 CLI 外送 repo payload,讓你看見離開你機器的資料。 | - -「Beta 轉接器」代表 ClawMetry 提供該執行環境真實磁碟格式的讀取器,且每個都是根據真實機器上的真實安裝建置並驗證的(見 `tests/fixtures/runtimes//`)。轉接器皆為唯讀,並且對其執行環境實際儲存的內容如實呈現(例如 PicoClaw/NanoClaw/Cursor 並不會將 token 成本寫入磁碟)。當一個節點上執行多個執行環境時,執行環境切換器可以將 sessions 檢視聚焦到單一環境,方便深入研究。 - -## 追蹤任何 SDK agent — 迴圈外成本歸因 - -上述執行環境都會將 session 寫入磁碟。但你自己的**正式環境 agent**——你基於 OpenAI Agents SDK、LangChain、Vercel AI SDK、LlamaIndex、E2B,或單純用 `httpx` 寫的迴圈打造的那個——並不會。ClawMetry 的零設定攔截器仍能透過 monkey-patch `httpx`/`requests`,擷取它的 LLM 呼叫(成本、tokens、延遲、錯誤): - -```python -import clawmetry.track # activate the interceptor -clawmetry.track.set_source("support-agent") # name this product - -# ...your agent runs as normal; every LLM call is now tracked + attributed. -``` - -`set_source()`(或 `CLAWMETRY_SOURCE=support-agent` 環境變數)會為每次呼叫標記一個**具名來源**,因此你執行的每個產品都會在儀表板 Overview 的 **🔌 迴圈外來源**卡片中,以獨立、可歸因成本的形式顯示——每個 agent 的呼叫數、供應商、延遲、錯誤率。沒有設定來源?呼叫依然會被追蹤,只是卡片會保持隱藏。 - -```bash -CLAWMETRY_SOURCE=billing-agent python my_agent.py -``` - -這與執行環境轉接器所使用的資料層相同(DuckDB → 雲端快照),因此迴圈外來源會與其他一切一樣同步到雲端儀表板,並採端對端加密。 - -## OpenTelemetry — 供應商中立,將你的 traces 傳送到任何地方 - -ClawMetry 使用 **GenAI 語意慣例**,雙向支援 **OpenTelemetry**,因此你的 agent traces 永遠不會被鎖在單一工具中。 - -**匯出**每個 session——LLM 呼叫、工具、子 agent、tokens、成本——以 OTLP/HTTP GenAI spans 的形式送往任何 collector(Datadog、Grafana、Honeycomb,或你自己的 OTel Collector): - -```bash -clawmetry --otel-export http://localhost:4318/v1/traces -# equivalently: -CLAWMETRY_OTEL_EXPORT_ENDPOINT=http://localhost:4318/v1/traces clawmetry -``` - -驗證標頭與輪詢間隔為可選的環境變數: - -```bash -CLAWMETRY_OTEL_EXPORT_HEADERS='{"X-API-Key":"…"}' # extra HTTP headers -CLAWMETRY_OTEL_EXPORT_INTERVAL=60 # seconds (default 60) -``` - -**匯入** — 內建的 OTLP 接收器可在 `/v1/traces`、`/v1/logs`、`/v1/metrics` 接收來自其他任何來源的 traces、logs 與 metrics。將任何已套用 OpenTelemetry 檢測的應用程式指向這裡: - -```bash -OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8900 OTEL_EXPORTER_OTLP_PROTOCOL=http/json your-app -``` - -OTLP/JSON traces 與 logs 在單純 `pip install clawmetry` 的情況下就能運作,不需要額外套件。Protobuf 匯入(以及 OTLP/JSON metrics)則需要 `pip install clawmetry[otel]`。設定了自己的 `service.name` 的應用程式,會在執行環境切換器中以獨立 agent 的身分出現,並顯示其成本與 tokens。 - -你可以同時擁有零設定、本機優先的 ClawMetry 儀表板,**以及**你的資料存放在團隊已在使用的任何後端——沒有鎖定,也不需要安裝第二個 agent。 - -## 設定 - -大多數人不需要任何設定。ClawMetry 會自動偵測你的工作區、日誌、sessions 與 crons。 - -如果你確實需要自訂: - -```bash -clawmetry --port 9000 # Custom port (default: 8900) -clawmetry --host 127.0.0.1 # Bind to localhost only -clawmetry --workspace ~/mybot # Custom workspace path -clawmetry --name "Alice" # Your name in Flow visualization -``` - -所有選項:`clawmetry --help` - -## 支援的頻道 - -ClawMetry 會為你設定的每個 OpenClaw 頻道顯示即時活動。只有實際在你的 `openclaw.json` 中設定過的頻道才會出現在 Flow 圖表中,未設定的頻道會自動隱藏。 - -點選 Flow 中的任一頻道節點,即可看到即時聊天氣泡檢視,顯示收發訊息的數量。 - -| 頻道 | 狀態 | 即時彈出視窗 | 備註 | -|---------|--------|------------|-------| -| 📱 **Telegram** | ✅ 完整支援 | ✅ | 訊息、統計資料,10 秒更新一次 | -| 💬 **iMessage** | ✅ 完整支援 | ✅ | 直接讀取 `~/Library/Messages/chat.db` | -| 💚 **WhatsApp** | ✅ 完整支援 | ✅ | 透過 WhatsApp Web(Baileys) | -| 🔵 **Signal** | ✅ 完整支援 | ✅ | 透過 signal-cli | -| 🟣 **Discord** | ✅ 完整支援 | ✅ | Guild + 頻道偵測 | -| 🟪 **Slack** | ✅ 完整支援 | ✅ | Workspace + 頻道偵測 | -| 🌐 **Webchat** | ✅ 完整支援 | ✅ | 內建網頁介面 session | -| 📡 **IRC** | ✅ 完整支援 | ✅ | 終端機風格的氣泡介面 | -| 🍏 **BlueBubbles** | ✅ 完整支援 | ✅ | 透過 BlueBubbles REST API 支援 iMessage | -| 🔵 **Google Chat** | ✅ 完整支援 | ✅ | 透過 Chat API webhooks | -| 🟣 **MS Teams** | ✅ 完整支援 | ✅ | 透過 Teams bot 外掛 | -| 🔷 **Mattermost** | ✅ 完整支援 | ✅ | 自架團隊聊天 | -| 🟩 **Matrix** | ✅ 完整支援 | ✅ | 去中心化,支援 E2EE | -| 🟢 **LINE** | ✅ 完整支援 | ✅ | LINE Messaging API | -| ⚡ **Nostr** | ✅ 完整支援 | ✅ | 去中心化 NIP-04 私訊 | -| 🟣 **Twitch** | ✅ 完整支援 | ✅ | 透過 IRC 連線的聊天室 | -| 🔷 **Feishu/Lark** | ✅ 完整支援 | ✅ | WebSocket 事件訂閱 | -| 🔵 **Zalo** | ✅ 完整支援 | ✅ | Zalo Bot API | - -> **自動偵測:** ClawMetry 會讀取你的 `~/.openclaw/openclaw.json`,只渲染你實際設定過的頻道。不需要手動設定。 - -## Docker 部署 - -想在容器中執行 ClawMetry?沒問題!🐳 - -**使用 Docker 快速開始:** - -```bash -# Build the image -docker build -t clawmetry . - -# Run with default settings -docker run -p 8900:8900 clawmetry - -# Or mount your agent's data dir (shown: OpenClaw's ~/.openclaw) -docker run -p 8900:8900 \ - -v ~/.openclaw:/root/.openclaw \ - -v /tmp/moltbot:/tmp/moltbot \ - clawmetry -``` - -**Docker Compose 範例:** - -```yaml -version: '3.8' -services: - clawmetry: - build: . - ports: - - "8900:8900" - volumes: - - ~/.openclaw:/root/.openclaw:ro - - /tmp/moltbot:/tmp/moltbot:ro - restart: unless-stopped -``` - -> **注意:** 在 Docker 中執行時,請掛載你的 agent 資料 + 日誌目錄(例如 `~/.openclaw`、`~/.claude`、`~/.codex`),讓 ClawMetry 能自動偵測你的設定。 - -## 系統需求 - -- Python 3.8+ -- Flask(透過 pip 自動安裝) -- 同一台機器上的 AI agent 執行環境:OpenClaw、NVIDIA NemoClaw、Claude Code、Codex、Cursor、Goose、Hermes、opencode、Qwen Code、Aider、NanoClaw、PicoClaw、Pi、Deep Agents、n8n、Antigravity、GitHub Copilot、Grok 或 QM(Docker 則需掛載對應的資料卷) -- Linux 或 macOS - -## NemoClaw / OpenShell 支援 - -ClawMetry 會自動偵測 [NemoClaw](https://github.com/NVIDIA/NemoClaw)——NVIDIA 為 OpenClaw 打造的企業級安全包裝器,在受沙箱隔離的 OpenShell 容器中執行 agent。 +| **Free** | OpenClaw + NVIDIA NemoClaw,完整儀表板,僅限本機 | $0 | +| **Starter** | 上述其他所有執行環境、艦隊檢視、雲端同步 | 每節點每月 $9 | +| **Pro** | Starter + 治理功能：核准、工具風險政策、評估、異常偵測、成本最佳化工具、OTel 匯出 | 每節點每月 $19 | -大多數情況下不需要額外設定。無論 session 檔案位於主機的 `~/.openclaw/` 還是 OpenShell 容器內部,sync daemon 都會自動發現它們。 +年費方案、Enterprise 及目前的價格,請見 +**[clawmetry.com/pricing](https://clawmetry.com/pricing)**。自架授權金鑰 +無需雲端即可運作（`clawmetry license`）。免費與付費的確切劃分方式 +請見 [docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)。 -### 運作方式 +## 你的資料留在你的機器上 -ClawMetry 以兩種方式偵測 NemoClaw: +ClawMetry 讀取本機的工作階段檔案與日誌。除非你執行 +`clawmetry connect`,否則資料不會離開你的機器。即使執行了該指令,快照 +也會以端對端加密方式傳輸,金鑰永遠不會離開你的機器,並在你的瀏覽器中解密。 -1. **執行檔偵測** — 檢查是否有 `nemoclaw` CLI,並執行 `nemoclaw status` 取得沙箱資訊 -2. **容器偵測** — 掃描執行中的 Docker 容器,尋找 `openshell`、`nemoclaw` 或 `ghcr.io/nvidia/` 映像檔,再透過卷掛載或 `docker cp` 讀取 session - -從 NemoClaw 容器同步的 session 檔案,會在雲端儀表板中標記 `runtime=nemoclaw` 與 `container_id` 中繼資料,讓你能一眼分辨它們與標準 OpenClaw session 的差異。 - -### 建議設定:在主機上執行 sync daemon - -為了獲得最佳體驗,請在**主機**(而非沙箱內部)執行 ClawMetry 的 sync daemon。這樣可以避免 NemoClaw 網路政策的限制。 - -```bash -# On the host (outside the sandbox) -pip install clawmetry -clawmetry connect -clawmetry sync -``` - -sync daemon 會自動在任何執行中的 OpenShell 容器內尋找 session。 - -### 選用:明確指定沙箱名稱 - -如果自動偵測無法運作,可以指定 ClawMetry 應使用的沙箱: - -```bash -export NEMOCLAW_SANDBOX=my-sandbox-name -clawmetry sync -``` - -### 在沙箱內執行(進階) - -如果你必須在 OpenShell 沙箱**內部**執行 sync daemon,請在你的 NemoClaw 網路政策中新增以下出站規則,讓它能連上 ClawMetry 的匯入 API: - -```yaml -# nemoclaw-policy.yaml -network: - egress: - - host: ingest.clawmetry.com - port: 443 - protocol: https -``` - -套用方式: +## 安裝 ```bash -nemoclaw policy apply --file nemoclaw-policy.yaml +pip install clawmetry # then: clawmetry ``` -### 連接埠與端點 - -| 端點 | 連接埠 | 通訊協定 | 是否必要 | -|---|---|---|---| -| `ingest.clawmetry.com` | 443 | HTTPS | 是(sync daemon → 雲端) | -| `localhost:8900` | 8900 | HTTP | 是(本機儀表板 UI) | -| Docker socket(`/var/run/docker.sock`) | — | Unix socket | 用於容器 session 探索 | - -sync daemon 僅會發出對 `ingest.clawmetry.com` 的出站 HTTPS 呼叫,不需要任何入站連接埠。 - ---- - -## 雲端部署 - -請參閱 **[雲端測試指南](https://github.com/vivekchand/clawmetry/blob/main/docs/CLOUD_TESTING.md)**,了解 SSH 通道、反向代理與 Docker 的相關內容。 - -## 測試 +或使用一行指令：`curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash` -本專案使用 BrowserStack 進行測試。 +需要 macOS、Linux 或 Windows 上的 Python 3.8+,以及同一台機器上至少一個 +智能體執行環境。Docker 安裝說明：[docs/DOCKER.md](docs/DOCKER.md)。 -[![BrowserStack](https://img.shields.io/badge/tested%20with-BrowserStack-orange.svg)](https://browserstack.com) +## 文件 -## 遙測 +| | | +|---|---| +| [執行環境相容性](docs/compatibility.md) | 每個轉接器讀取的內容,以及如何新增執行環境 | +| [權益](docs/ENTITLEMENTS.md) | 免費 vs 付費、方案矩陣、授權 CLI | +| [核准與政策](docs/APPROVALS.md) | 執行前把關、風險評分、手機核准 | +| [OpenTelemetry](docs/OPENTELEMETRY.md) | 將追蹤資料匯出至任何地方,並從任何來源攝入 OTLP | +| [SDK 追蹤](docs/SDK_TRACKING.md) | 為你自行打造的智能體進行成本歸因 | +| [聊天頻道](docs/CHANNELS.md) | Flow 中顯示的聊天轉接器 | +| [NemoClaw / OpenShell](docs/NEMOCLAW.md) | 沙箱化的 NVIDIA NemoClaw 設定 | +| [Docker](docs/DOCKER.md) | 映像檔、compose、磁碟區掛載 | +| [架構](ARCHITECTURE.md) · [開發](docs/DEVELOPMENT.md) | 內部運作方式;從原始碼執行 | +| [遙測](docs/TELEMETRY.md) | 匿名的安裝與桌面開啟回報,以及如何關閉它們 | -ClawMetry 會向 -`https://app.clawmetry.com/api/install` 傳送匿名的安裝生命週期 ping:在新機器上第一次 -執行 `clawmetry` CLI 時傳送一次 `install` ping,升級到新版本後第一次 -執行時傳送一次 `update` ping,以及完成儀表板內的引導選擇時 -傳送一次 `onboarded` ping。我們用這個機制來統計真實安裝數 -(原始 PyPI 下載數字約有 98% 來自鏡像、CI 與自動更新的重複下載), -並了解實際使用中的 agent 框架與版本。 +## 螢幕截圖 -**每個生命週期事件、每個版本最多只會傳送一次 POST**,內容包含: +| | | +|---|---| +| ![Overview tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/overview.png) | ![Brain tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/brain.png) | +| **Overview**：token、工作階段、健康狀態 | **Brain**：即時智能體事件串流 | +| ![Tokens tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/tokens.png) | ![Approvals tab](https://raw.githubusercontent.com/vivekchand/clawmetry/main/screenshots/approvals.png) | +| **Cost**：依模型與工作階段分類 | **Approvals**：把關風險工具呼叫 | -| 欄位 | 範例 | 用途 | -|---|---|---| -| `install_id` | 儲存於 `~/.clawmetry/install_id` 的隨機 UUID | 去重複;在你明確連結 Cloud sync 前皆為匿名(之後已驗證的 daemon heartbeat 會攜帶它,將此安裝與你的帳號連結) | -| `event` | `install` / `update` / `onboarded` | 全新安裝或既有安裝的升級 | -| `version` | `0.12.167` | 了解實際使用中的版本 | -| `os` / `os_version` | `Darwin` / `25.3.0` | 平台支援優先順序 | -| `python` | `3.11.15` | Python 版本支援矩陣 | -| `agent` | `openclaw` / `nemoclaw` / `hermes` / `none` | 我們接下來應該整合哪些 agent | -| `is_ci` / `ci_provider` | `true` / `github_actions` | 將人工安裝與 CI 雜訊區分開來 | - -**我們不會傳送**:IP(雲端會在伺服器端從請求中推算國碼, -之後即捨棄該 IP)、主機名稱、使用者名稱、工作區 -路徑、檔案內容、你的 api_key、你的電子郵件,以及任何個資或 -工作區相關資訊。傳輸的 payload 可在 -[`clawmetry/telemetry.py`](clawmetry/telemetry.py) 中稽核。 - -**選擇退出**(以下任一方式即可永久停用): - -```bash -export CLAWMETRY_NO_TELEMETRY=1 # per-shell -export DO_NOT_TRACK=1 # W3C cross-tool standard -touch ~/.clawmetry/notelemetry # persistent file marker -``` - -這裡的網路失敗永遠不會阻擋 `clawmetry` 執行——這個 -ping 是在 daemon 執行緒上以「發送後不理會」(fire-and-forget)方式進行,逾時為 3 秒。 +更多內容,依執行環境分類：[docs/RUNTIME_SCREENSHOTS.md](docs/RUNTIME_SCREENSHOTS.md)。 ## Star 歷史 @@ -430,13 +111,8 @@ ping 是在 daemon 執行緒上以「發送後不理會」(fire-and-forget)方 -## 授權條款 - -MIT +## 授權 ---- +MIT · 由 [@vivekchand](https://github.com/vivekchand) 打造 · [clawmetry.com](https://clawmetry.com) -

- 🦞 看見你的 agent 如何思考
- 由 @vivekchand 打造 · clawmetry.com · OpenClaw 生態系的一部分 -

+