Open Source · v0.1.2 · MIT License

Observability for
OpenClaw Deployments

Monitor every component of your OpenClaw AI deployment. Get instant alerts when anything breaks. Works on macOS and Linux.

Get Started → View on GitHub
curl -fsSL https://raw.githubusercontent.com/datamino/originclaw/main/install.sh | bash
5
Monitoring Layers
1s
Watchdog Interval
4
Alert Channels
0
Config Required
What it monitors

Every layer of your
OpenClaw deployment

Auto-discovers your OpenClaw setup and monitors everything from infrastructure to business outcomes.

LAYER 1

Infrastructure

CPU, memory, disk and network health of the host machine.

CPUMemoryDiskNetwork
LAYER 2

OpenClaw Core

Gateway process, cron jobs, heartbeat, and active sessions.

GatewayCron JobsHeartbeatSessions
LAYER 3

Integrations

All connected APIs and MCP servers auto-discovered from your config.

GmailCalendarAPIsMCP Servers
LAYER 4 & 5

Skills & Business Outcomes

Background daemons, skills, and delivery of business-critical outputs.

DaemonsScriptsAlertsBriefs
⚡

Instant Watchdog

Checks every 1 second. Fires email and Telegram the moment your gateway goes down.

🔍

Auto-Discovery

Reads your openclaw.json automatically. No manual config. Works with any deployment.

📧

Multi-Channel Alerts

Telegram, Email, Discord, Slack. 3-strike confirmation prevents false alarms.

📊

Live Dashboard

Premium React topology dashboard. Real-time data. Drag and expand components.

🔧

Self-Healing

Attempts automatic recovery before alerting. Restarts failed processes automatically.

🌐

Multi-Client

One install monitors multiple OpenClaw deployments with isolated alerts per client.

Documentation

All commands

Everything you can do with originclaw-monitor.

originclaw-monitor initAuto-discover OpenClaw and configure monitoring. Reads openclaw.json, mcporter.json, LaunchAgents.
SETUP
originclaw-monitor statusShow full system health. Gateway, crons, heartbeat, integrations, daemons, last heartbeat.
STATUS
originclaw-monitor startStart monitoring daemon and gateway watchdog. Runs in background, alerts on failures.
START
originclaw-monitor runRun one full check cycle across all 5 layers. Good for testing or one-off health checks.
RUN
originclaw-monitor watchdogStart gateway watchdog. Checks every 1 second, fires alert immediately on first failure.
WATCHDOG
originclaw-monitor dashboardStart monitoring API and web dashboard. Opens topology view at http://localhost:8787.
UI
originclaw-monitor test-alertSend a test email and Telegram message to verify alert channels are configured correctly.
TEST
originclaw-monitor helpShow all commands with descriptions. Also runs when no command is provided.
HELP
Alert Channels

Get notified anywhere

✈️

Telegram

telegram_token + telegram_chat_id

📧

Email via Resend

resend_api_key + developer_email

💬

Discord

discord_webhook

⏭️

Slack

slack_webhook

Installation

Up and running in 3 commands

Works on macOS and Linux. Python 3.9+ required.

1

Install

Install from PyPI.

pip3 install originclaw-monitor
2

Configure

Auto-discovers OpenClaw setup.

originclaw-monitor init
3

Start

Watchdog starts immediately.

originclaw-monitor start
~/.originclaw/config.json
{
  "client_name": "Wayne Bos",
  "developer_email": "dev@example.com",
  "resend_api_key": "re_...",
  "telegram_token": "bot_token",
  "telegram_chat_id": "123456789",
  "interval_seconds": 300
}