explaingit

cschanhniem/clawping

Analysis updated 2026-05-18

★ 24TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A Cloudflare Workers-based Telegram watchdog that monitors home servers and self-hosted apps from the inside, with no open ports needed.

Mindmap

mindmap
  root((ClawPing))
    Monitoring
      Server Heartbeats
      Disk Space
      Backup Freshness
      Docker Containers
    Architecture
      Cloudflare Worker
      Go Agent
      React Dashboard
    Alerts
      Telegram Notifications
      No Open Ports
    Setup
      One Click Deploy
      pnpm Install

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get a Telegram alert when a home server or NAS stops responding, without opening any inbound ports.

USE CASE 2

Watch for a stale backup, a full disk, or a dead Docker container on a self-hosted machine.

USE CASE 3

Deploy a monitoring control plane to Cloudflare Workers with a one-click deploy button.

USE CASE 4

Run a lightweight Go agent on a server that only sends outbound heartbeats, keeping the machine unreachable from outside.

What is it built with?

TypeScriptGoCloudflare WorkersReact

How does it compare?

cschanhniem/clawpingcub3y0nd/entropicflh-raouf/td-bdd
Stars242424
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Cloudflare account for the Worker plus a Telegram bot, full steps live in separate docs files, not the main README.

In plain English

ClawPing is a monitoring tool for home servers, NAS boxes, and self-hosted applications. It watches your machines from the inside and sends you alerts through Telegram when something goes wrong, such as when a server stops responding, a disk fills up, a backup goes stale, or a Docker container stops running. The way it works avoids a common challenge with home server monitoring: you do not need a public IP address or any open inbound ports. Instead, a small agent program runs on your server and sends regular check-in messages outward to a Cloudflare Worker. If the check-ins stop arriving, or if the agent reports a problem, the Cloudflare Worker sends you a Telegram alert. Because all the traffic flows outward from your machine rather than inward, your server does not need to be reachable from the internet. The project is structured as a monorepo with three main parts. The first is the Cloudflare Worker, which acts as the control plane, receiving heartbeats and triggering alerts. The second is a React dashboard for setup and day-to-day management. The third is the agent, written in Go, which runs on the server being monitored. A one-click deploy button for the Cloudflare Worker is included in the README. The README is brief and refers to separate documentation files for the full setup steps. The project is open source and built with TypeScript for the web components and Go for the local agent.

Copy-paste prompts

Prompt 1
Help me deploy the ClawPing Cloudflare Worker using the one-click deploy button and set up the React dashboard for onboarding.
Prompt 2
I want to run the ClawPing Go agent on my home server. Walk me through the agent install steps in docs/agent-linux.md.
Prompt 3
Explain how ClawPing avoids needing a public IP or open inbound ports by using outbound heartbeats to a Cloudflare Worker.
Prompt 4
Show me how to configure ClawPing to alert me on Telegram when a Docker container on my server stops running.
Prompt 5
Walk me through the monorepo layout of this project and where the worker, dashboard, and agent code each live.

Frequently asked questions

What is clawping?

A Cloudflare Workers-based Telegram watchdog that monitors home servers and self-hosted apps from the inside, with no open ports needed.

What language is clawping written in?

Mainly TypeScript. The stack also includes TypeScript, Go, Cloudflare Workers.

How hard is clawping to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is clawping for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos