openclaw-dashboard 0.2.0__py3-none-any.whl

openclaw_dashboard-0.2.0.dist-info/METADATA

@@ -0,0 +1,305 @@
+Metadata-Version: 2.4
+Name: openclaw-dashboard
+Version: 0.2.0
+Summary: Real-time observability dashboard for OpenClaw AI agents
+Home-page: https://github.com/vivekchand/openclaw-dashboard
+Author: Vivek Chand
+Author-email: vivek@openclaw.dev
+License: MIT
+Project-URL: Bug Reports, https://github.com/vivekchand/openclaw-dashboard/issues
+Project-URL: Source, https://github.com/vivekchand/openclaw-dashboard
+Keywords: openclaw moltbot dashboard observability ai agent monitoring
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: flask>=2.0
+Provides-Extra: otel
+Requires-Dist: opentelemetry-proto>=1.20.0; extra == "otel"
+Requires-Dist: protobuf>=4.21.0; extra == "otel"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 🦞 OpenClaw Dashboard
+
+**See your agent think.** The Grafana for your personal AI agent.
+
+Real-time observability dashboard for [OpenClaw](https://github.com/nicobailon/openclaw)/[Moltbot](https://github.com/nicobailon/moltbot) AI agents. One file. Zero config. Just run it.
+
+![Overview](screenshots/overview.jpg)
+
+---
+
+## ⚡ Quick Start
+
+```bash
+pip install openclaw-dashboard
+openclaw-dashboard
+```
+
+Or run directly:
+
+```bash
+pip install flask
+python3 dashboard.py
+```
+
+Opens at **http://localhost:8900** — auto-detects your OpenClaw workspace.
+
+---
+
+## 📸 Screenshots
+
+<table>
+<tr>
+<td align="center"><strong>Overview</strong><br><img src="screenshots/overview.jpg" width="380"/></td>
+<td align="center"><strong>Flow Visualization</strong><br><img src="screenshots/flow.jpg" width="380"/></td>
+</tr>
+<tr>
+<td align="center"><strong>Sessions</strong><br><img src="screenshots/sessions.jpg" width="380"/></td>
+<td align="center"><strong>Cron Jobs</strong><br><img src="screenshots/crons.jpg" width="380"/></td>
+</tr>
+<tr>
+<td align="center"><strong>Live Logs</strong><br><img src="screenshots/logs.jpg" width="380"/></td>
+<td align="center"><strong>Memory Files</strong><br><img src="screenshots/memory.jpg" width="380"/></td>
+</tr>
+</table>
+
+---
+
+## ✨ Features
+
+| Tab | What it shows |
+|-----|--------------|
+| **Overview** | Model, sessions, crons, tokens, memory, **❤️ health checks** (auto-refresh via SSE), **🔥 activity heatmap** (GitHub-style), recent logs |
+| **📊 Usage** | **Token/cost tracking** — bar chart of tokens per day (14 days), today/week/month totals, cost breakdown. **With OTLP**: real token counts, actual cost, avg run duration, messages processed, model breakdown |
+| **Sessions** | All active agent sessions with model, channel, token usage, last activity |
+| **Crons** | Scheduled jobs with status, schedule, last run, next run, duration |
+| **Logs** | Parsed JSON logs with color-coded levels, configurable line count, **real-time SSE streaming** |
+| **Memory** | Clickable file browser for SOUL.md, MEMORY.md, AGENTS.md, daily memory files |
+| **📜 Transcripts** | **Session transcript viewer** — browse .jsonl files, click to see chat-bubble conversation view with color-coded roles, expand/collapse |
+| **Flow** | **Real-time animated SVG** showing data flow: You → Channels → Gateway → Brain → Tools → Infrastructure |
+
+### Flow Visualization
+
+The Flow tab is the star — a live animated architecture diagram that lights up in real-time as your agent processes messages:
+
+- 🟣 **Purple particles** — your message entering through a channel
+- 🔵 **Blue particles** — request flowing to the brain
+- 🟡 **Yellow particles** — tool calls (exec, browser, search, cron, tts, memory)
+- 🟢 **Green particles** — response flowing back to you
+- 🔴 **Red flash** — errors
+- 🔵 **Cyan pulses** — infrastructure layer activity (network, storage, runtime)
+
+### New in v0.2: OTLP Receiver + Full Observability
+
+- **📡 OTLP Receiver** — Dashboard becomes a lightweight OTel collector. Point OpenClaw at it, get real metrics. No Grafana/Prometheus needed.
+- **🔥 Activity Heatmap** — GitHub-style 7×24 grid showing when your agent is busiest. Pure CSS, no libraries.
+- **❤️ Health Checks** — Gateway, disk, memory, uptime, OTLP status at a glance. Auto-refreshes every 30s via SSE.
+- **📊 Real Token/Cost Tracking** — With OTLP: real token counts, actual cost, model breakdown, avg run duration.
+- **📜 Transcript Viewer** — Read your agent's conversations in a beautiful chat-bubble UI. Color-coded roles, expand/collapse for long messages.
+
+---
+
+## 🤔 What Makes This Different?
+
+| | OpenClaw Dashboard | Langfuse | AgentOps |
+|---|---|---|---|
+| **Install** | `pip install openclaw-dashboard` | Docker + Postgres | SDK + cloud account |
+| **Config** | Zero. Auto-detects everything. | Database URLs, API keys | API keys, SDK init |
+| **Focus** | Personal AI agent | Enterprise LLM apps | Enterprise agent monitoring |
+| **Memory-first** | ✅ Browse SOUL.md, MEMORY.md, daily notes | ❌ | ❌ |
+| **Single file** | ✅ One Python file, one dependency | ❌ Multi-service | ❌ Cloud service |
+| **Transcripts** | ✅ Chat-bubble viewer built-in | ✅ (needs SDK) | ✅ (needs SDK) |
+| **Cost tracking** | ✅ Zero config (OTLP or log parsing) | ✅ (needs SDK) | ✅ (needs SDK) |
+| **Built-in OTel collector** | ✅ OTLP/HTTP receiver | ❌ | ❌ |
+
+**TL;DR:** Langfuse and AgentOps are great for teams building LLM products. OpenClaw Dashboard is for the person running a personal AI agent on their own machine — zero instrumentation, zero config, memory-first. It's the **Grafana for your personal AI agent**.
+
+---
+
+## 📡 Real-time Metrics (OpenTelemetry)
+
+The dashboard can act as a **lightweight OpenTelemetry collector** — no need for Grafana, Prometheus, or a separate OTel Collector. Just point OpenClaw at the dashboard.
+
+### Setup
+
+**1. Install OTLP support:**
+
+```bash
+pip install openclaw-dashboard[otel]
+```
+
+**2. Configure OpenClaw** — add one line to your config:
+
+```yaml
+diagnostics:
+  otel:
+    endpoint: http://localhost:8900
+```
+
+That's it! The dashboard now receives real-time metrics directly from OpenClaw.
+
+### What you get
+
+| Metric | Source | What it shows |
+|--------|--------|---------------|
+| **Token counts** per day | `openclaw.tokens` | Real input/output/total token usage (bar chart) |
+| **Cost** per day | `openclaw.cost.usd` | Actual cost from your provider |
+| **Avg run duration** | `openclaw.run.duration_ms` | How long model completions take |
+| **Messages processed** | `openclaw.message.processed` | Message throughput |
+| **Model breakdown** | attributes | Which models are being used and how much |
+| **OTLP Connected** indicator | health check | Green when data is flowing |
+
+### OTLP Endpoints
+
+- `POST /v1/metrics` — receives OTLP/HTTP protobuf metric data
+- `POST /v1/traces` — receives OTLP/HTTP protobuf trace data
+
+### Without OTLP
+
+Everything still works! The dashboard falls back to parsing session JSONL files for token estimates. OTLP just gives you **real** numbers instead of estimates.
+
+### Persistence
+
+Metrics are stored in-memory (capped at ~10K entries per category, 14-day retention) and auto-persisted to `{workspace}/.openclaw-dashboard-metrics.json` every 60 seconds. Override the path with `--metrics-file` or `OPENCLAW_METRICS_FILE`.
+
+---
+
+## ⚙️ Configuration
+
+### CLI Arguments
+
+```bash
+openclaw-dashboard --port 9000          # Custom port (default: 8900)
+openclaw-dashboard --host 127.0.0.1     # Bind to localhost only
+openclaw-dashboard --workspace ~/mybot  # Custom workspace path
+openclaw-dashboard --log-dir /var/log   # Custom log directory
+openclaw-dashboard --sessions-dir ~/data # Custom sessions directory
+openclaw-dashboard --metrics-file ~/m.json # Custom metrics persistence path
+openclaw-dashboard --name "Alice"       # Your name in Flow visualization
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `OPENCLAW_HOME` | Agent workspace directory | Auto-detected |
+| `OPENCLAW_WORKSPACE` | Alternative to OPENCLAW_HOME | Auto-detected |
+| `OPENCLAW_SESSIONS_DIR` | Sessions directory (.jsonl transcripts) | Auto-detected |
+| `OPENCLAW_LOG_DIR` | Log directory | `/tmp/moltbot` |
+| `OPENCLAW_METRICS_FILE` | Metrics persistence file path | `{workspace}/.openclaw-dashboard-metrics.json` |
+| `OPENCLAW_USER` | Your name in Flow tab | `You` |
+
+### Auto-Detection
+
+If no paths are configured, the dashboard automatically searches for:
+
+1. **Workspace**: Checks `~/.clawdbot/agents/main/config.json` → `~/.clawdbot/workspace` → `~/clawd` → `~/openclaw` → current directory. Looks for `SOUL.md`, `AGENTS.md`, `MEMORY.md`, or `memory/` directory.
+2. **Logs**: Checks `/tmp/moltbot` → `/tmp/openclaw` → `~/.clawdbot/logs`
+3. **Sessions**: Reads from `~/.clawdbot/agents/main/sessions/`
+4. **Crons**: Reads from `~/.clawdbot/cron/jobs.json`
+
+---
+
+## 🏗️ How It Works
+
+The dashboard is a single-file Flask app that reads directly from your OpenClaw/Moltbot data directories:
+
+```
+Your Agent (Moltbot)          OpenClaw Dashboard
+┌─────────────────┐          ┌─────────────────┐
+│ Writes logs to   │─────────▶│ Reads & parses   │
+│ /tmp/moltbot/    │          │ JSON log lines   │
+│                  │          │                  │
+│ Stores sessions  │─────────▶│ Lists sessions   │
+│ in ~/.clawdbot/  │          │ with metadata    │
+│                  │          │                  │
+│ Saves crons to   │─────────▶│ Shows schedules  │
+│ cron/jobs.json   │          │ and status       │
+│                  │          │                  │
+│ Agent workspace  │─────────▶│ Browses memory   │
+│ SOUL.md, etc.    │          │ files inline     │
+└─────────────────┘          └─────────────────┘
+```
+
+**Real-time streaming** uses `tail -f` piped through Server-Sent Events (SSE) — no WebSockets, no dependencies, just works.
+
+---
+
+## 📦 Installation Options
+
+### pip (recommended)
+
+```bash
+pip install openclaw-dashboard
+openclaw-dashboard
+```
+
+### From source
+
+```bash
+git clone https://github.com/vivekchand/openclaw-dashboard.git
+cd openclaw-dashboard
+pip install -r requirements.txt
+python3 dashboard.py
+```
+
+### One-liner
+
+```bash
+curl -sSL https://raw.githubusercontent.com/vivekchand/openclaw-dashboard/main/install.sh | bash
+```
+
+---
+
+## 🔧 Requirements
+
+- **Python 3.8+**
+- **Flask** (only required dependency)
+- **opentelemetry-proto + protobuf** (optional, for OTLP receiver — `pip install openclaw-dashboard[otel]`)
+- **OpenClaw/Moltbot** running on the same machine (reads its logs and state files)
+- Linux/macOS (uses `tail`, `df`, `free`, `/proc/loadavg`)
+
+---
+
+## 📄 License
+
+MIT — do whatever you want with it.
+
+---
+
+## 🙏 Credits
+
+- Built by [Vivek Chand](https://linkedin.com/in/vivekchand46) as part of the OpenClaw ecosystem
+- Powered by [OpenClaw](https://github.com/nicobailon/openclaw) and [Moltbot](https://github.com/nicobailon/moltbot)
+- The Flow visualization was inspired by watching an AI agent actually think
+
+---
+
+<p align="center">
+  <strong>🦞 See your agent think</strong><br>
+  <sub>Star this repo if you find it useful!</sub>
+</p>

openclaw_dashboard-0.2.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+dashboard.py,sha256=7IPP7zAOvROZgFucwK824SmWz3ofp4d37NbE6R5M2WU,118059
+openclaw_dashboard-0.2.0.dist-info/licenses/LICENSE,sha256=zdQBHvfCz4k8T_ib6mtyWYbQXGtD-g8Ih3t20sax_xE,1068
+openclaw_dashboard-0.2.0.dist-info/METADATA,sha256=HSHloGDqeQA1s1o7-PiNZdDHFtPzOkwu7u5FvDeYBvA,12129
+openclaw_dashboard-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+openclaw_dashboard-0.2.0.dist-info/entry_points.txt,sha256=KOl_T1Y4jpcei3v6mUBNAZjvQ_taCKcuTcK5-RIYJVo,54
+openclaw_dashboard-0.2.0.dist-info/top_level.txt,sha256=nUjTqzgVogKOY9x6wFtA4q49KTJadlMNYm7wGoqlPMg,10
+openclaw_dashboard-0.2.0.dist-info/RECORD,,

openclaw_dashboard-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

openclaw_dashboard-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+openclaw-dashboard = dashboard:main

openclaw_dashboard-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vivek Chand
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

openclaw_dashboard-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+dashboard