Skip to main content

ClawLens - Real-time observability dashboard for OpenClaw AI agents

Project description

🦞 ClawLens

PyPI License: MIT GitHub stars

Full observability for your .claw agent. Watch your agent think, track costs, debug crons, and browse memory — all in one dashboard.

One command. Zero config. Auto-detects everything.

pip install clawlens && clawlens

Opens at http://localhost:8900 and you're done.

Flow Visualization

What You Get

  • Flow — Live animated diagram showing messages flowing through channels, brain, tools, and back
  • Overview — Health checks, activity heatmap, session counts, model info
  • Usage — Token and cost tracking with daily/weekly/monthly breakdowns
  • Sessions — Active agent sessions with model, tokens, last activity
  • Crons — Scheduled jobs with status, next run, duration
  • Logs — Color-coded real-time log streaming
  • Memory — Browse SOUL.md, MEMORY.md, AGENTS.md, daily notes
  • Transcripts — Chat-bubble UI for reading session histories

Screenshots

Flow Overview Sub-Agent
Flow Overview Sub-Agent
Summary Crons Memory
Summary Crons Memory

Install

pip (recommended):

pip install clawlens
clawlens

One-liner:

curl -sSL https://raw.githubusercontent.com/0xChitlin/clawlens/main/install.sh | bash

From source:

git clone https://github.com/0xChitlin/clawlens.git
cd clawlens && pip install flask && python3 dashboard.py

Configuration

Most people don't need any config. ClawLens auto-detects your workspace, logs, sessions, and crons.

If you do need to customize:

clawlens --port 9000              # Custom port (default: 8900)
clawlens --host 127.0.0.1         # Bind to localhost only
clawlens --workspace ~/mybot      # Custom workspace path
clawlens --name "Alice"           # Your name in Flow visualization

All options: clawlens --help

Requirements

  • Python 3.8+
  • Flask (installed automatically via pip)
  • OpenClaw running on the same machine
  • Linux or macOS

Cloud Deployment

See the Cloud Testing Guide for SSH tunnels, reverse proxy, and Docker.

License

MIT


🦞 Full observability for your .claw agent
Built by @vivekchand · clawlens.com · Part of the OpenClaw ecosystem

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clawlens-0.9.3.tar.gz (130.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

clawlens-0.9.3-py3-none-any.whl (131.2 kB view details)

Uploaded Python 3

File details

Details for the file clawlens-0.9.3.tar.gz.

File metadata

  • Download URL: clawlens-0.9.3.tar.gz
  • Upload date:
  • Size: 130.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for clawlens-0.9.3.tar.gz
Algorithm Hash digest
SHA256 6e2e73f4cc52077395fc2e2400e680377385104ea5dee49c9c37445acd55fbf1
MD5 9cc04db88ac7de96cf9c9718f3ba8b4c
BLAKE2b-256 f96ff5809f6ae46b63e8e839d90dc25fa098a21d0ddbffd19069158056e03342

See more details on using hashes here.

File details

Details for the file clawlens-0.9.3-py3-none-any.whl.

File metadata

  • Download URL: clawlens-0.9.3-py3-none-any.whl
  • Upload date:
  • Size: 131.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for clawlens-0.9.3-py3-none-any.whl
Algorithm Hash digest
SHA256 ae44ebde179d096ccbd293ba9da791d3bd1f817dcfdbb4cd29efde2af86989ce
MD5 bae41ded262888bc374ea9be6d48aaa7
BLAKE2b-256 10a26c7e9a86f1b85c567312855043535a45774cc749c5f24ab5e75ae414fff3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page