Purpose and Significance

Openclaw-viewer is a lightweight web dashboard purpose-built for monitoring Clawdbot instances—an AI assistant framework that runs autonomously as a background daemon. As Clawdbot handles complex autonomous operations across multiple messaging platforms (Telegram, Discord, WhatsApp) with memory, cron jobs, file access, and tool integrations, visibility into its runtime behavior becomes essential. Openclaw-viewer bridges this gap by providing a real-time control panel where developers and operators can observe bot activity, diagnose issues, and intervene when necessary, without needing direct terminal or log file access.

Key Features

Live System Monitoring — Real-time CPU, RAM, disk usage, and uptime metrics with at-a-glance resource tracking
Streaming Log Viewer — Server-Sent Events (SSE) deliver gateway logs in real-time for instant insight into bot operations
Cron Job Management — View scheduled tasks, toggle activation status, and manually trigger jobs for testing and debugging
File Browser — Navigate and inspect workspace files that Clawdbot reads and writes during execution
Database Query Interface — Browse SQLite tables and execute queries on bot-managed databases without external tools
Process Monitor — List running processes with the ability to terminate hung or misbehaving processes
Dark Mode — Built-in theme for comfortable extended monitoring sessions

How It Works

Openclaw-viewer runs as a companion service on the same machine (or accessible network) as your Clawdbot instance. It reads from standard Clawdbot paths (~/.clawdbot/ for config and state, ~/clawd/ for workspace data, and ~/.clawdbot/gateway.log for live logs), exposing this information through a modern React-based UI built with Next.js 15, Tailwind CSS, and shadcn/ui components. Configuration is minimal—environment variables allow customization of data paths, and the dashboard exposes a REST API for programmatic access to system stats, logs, cron jobs, files, databases, and processes.

Getting Started

Installation is straightforward:

git clone https://github.com/prasann16/openclaw-viewer.git
cd openclaw-viewer
npm install
npm run dev

The dashboard runs on http://localhost:3000 and automatically detects Clawdbot on your system. For custom paths, use environment variables: CLAWD_ROOT=/custom/path npm run dev.

Use Cases

Local Development — Run alongside Clawdbot on your development machine to debug and test new features
Remote Server Monitoring — Deploy on a VPS running Clawdbot and access securely via Tailscale or SSH tunnel
Clawdbot Cloud Integration — Powers the monitoring dashboard in managed Clawdbot Cloud deployments, giving users visibility into their hosted bot's activity
Troubleshooting — Quickly identify resource bottlenecks, log errors, and test cron schedules without terminal access

API Endpoints

For developers integrating with Clawdbot programmatically, openclaw-viewer exposes a complete REST API:

GET /api/system — CPU, RAM, disk, and uptime metrics
GET /api/logs — Server-Sent Events stream of gateway logs
GET /api/activity — Recent activity and event history
GET /api/cron — List all cron jobs with status
POST /api/cron/{id}/toggle — Enable or disable a scheduled task
POST /api/cron/{id}/run — Manually execute a cron job
GET /api/files — List workspace files
GET /api/file?path=... — Read file contents
GET /api/database — List SQLite tables
GET /api/database/{table} — Query table rows
GET /api/processes — List running processes
POST /api/process/kill — Terminate a process

Remote Access Strategies

Tailscale (Recommended): Create a private encrypted network between devices. Install on both server and local machine, then access via the server's Tailscale IP (e.g., http://100.x.x.x:3000). Optionally enable HTTPS via tailscale serve --bg 3000. Free for personal use.

SSH Tunnel: Forward the dashboard port through SSH: ssh -L 3000:localhost:3000 user@yourserver, then access http://localhost:3000 on your local machine.

Technology Stack

Framework: Next.js 15 (App Router)
UI: Tailwind CSS with shadcn/ui components
State Management: React hooks
Streaming: Server-Sent Events (SSE) for real-time log updates
Language: TypeScript for type safety

Who This Is For

Openclaw-viewer is essential for Clawdbot operators—developers building autonomous AI agents, DevOps teams managing Clawdbot instances on servers, and teams using Clawdbot Cloud who want deeper visibility into bot behavior. It's particularly valuable for debugging bot logic, monitoring resource consumption, testing cron schedules, and quickly accessing bot-generated data without writing custom scripts.

Resources

GitHub Repository
License: MIT
rnd-al-smith-serv00/clawdbot — The autonomous AI assistant framework this dashboard monitors
Tailscale-Setup — Secure remote access for monitoring tools

Source: GitHub repository prasann16/openclaw-viewer, MIT license, last updated February 2026.

Read original