ClawPing — Notification Layer for the AI Agent Ecosystem

Core Features

Everything you need to stay in the loop

From simple time-based reminders to complex condition alerts — ClawPing handles the whole spectrum.

⏰

Smart Reminders

Natural time formats: 30s, 5m, 2h, 1d. No complex cron syntax for simple reminders — just say when and what.

time-based

📊

Condition Alerts

Monitor crypto prices via CoinGecko, custom webhook conditions, and any data source you can poll. Fire only when it matters.

condition-based

🤖

Telegram Bot

Chat-native interface with slash commands. /remind, /alert, /list, /cancel — talk to ClawPing the way you'd text a colleague.

@ClawPingBot

📧

Email Notifications

Beautifully formatted HTML emails with full context, timestamps, and source metadata. Professional and always on time.

SMTP / HTML

🔗

Agent Webhooks

Other agents ping humans via REST API. ClawScout finds news → ClawPing notifies you. The Claw ecosystem in action.

POST /webhook

🔄

Recurring Pings

Set once, repeat forever. Daily standups, weekly reviews, monthly billing reminders — cron-powered and bulletproof.

cron-based

How It Works

Up and running in 3 steps

From zero to your first ping in minutes. No black magic required.

⚙️

Setup

Deploy ClawPing via Docker or pip. Connect your Telegram bot token and SMTP config. Takes under 5 minutes.

✏️

Create Pings

Use Telegram slash commands, the REST API, or let other agents call your webhook endpoint. Multiple interfaces, one service.

🔔

Get Notified

ClawPing delivers to Telegram, Email, or both — on time, every time. APScheduler ensures nothing slips through the cracks.

API Preview

Dead simple to integrate

Whether you're a human on Telegram or an agent calling an API — ClawPing speaks your language.

telegram_commands.sh

# Time-based reminder
/remind 30m Check the oven

# Price alert — BTC threshold
/alert btc below 60000 "BTC dipped, time to act?"

# Recurring standup (cron syntax)
/repeat "0 9 * * 1-5" Daily standup — update Jira first!

# One-shot reminder in 2 hours
/remind 2h Deploy to production

# List all active pings
/list

# Cancel a specific ping
/cancel ping_7f3a9b2c

# Instant test ping
/ping Hello from ClawPing! 🔔

create_ping.sh

# Create a time-based reminder
curl -X POST https://api.clawping.xyz/api/pings \
  -H "Authorization: Bearer $CLAWPING_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type":    "reminder",
    "message": "Deploy the new version to production",
    "delay":   "2h",
    "channel": "telegram",
    "chat_id": "437734870"
  }'

# Create a price condition alert
curl -X POST https://api.clawping.xyz/api/pings \
  -H "Authorization: Bearer $CLAWPING_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "condition",
    "condition": {
      "asset":     "bitcoin",
      "operator":  "below",
      "threshold": 60000
    },
    "message": "BTC dipped — check your positions",
    "channel": "email",
    "email":   "you@example.com"
  }'

agent_webhook.json

// ClawScout triggers ClawPing
// POST https://api.clawping.xyz/webhook/agents
// X-Agent-Key: sk_agent_clawscout_xxx

{
  "agent_id":  "clawscout-v1.2",
  "priority":  "urgent",
  "recipient": {
    "channel": "telegram",
    "chat_id": "437734870"
  },
  "notification": {
    "title":      "🚨 Breaking: SEC approves Bitcoin ETF",
    "body":       "Major development detected. BTC price impact expected.",
    "source_url": "https://reuters.com/article/...",
    "timestamp":  "2026-02-25T09:31:00Z"
  },
  "metadata": {
    "triggered_by": "news_monitor",
    "confidence":    0.97,
    "tags":         ["crypto", "regulatory", "breaking"]
  }
}

response.json

// HTTP 201 Created — POST /api/pings
{
  "id":           "ping_7f3a9b2c",
  "status":       "scheduled",
  "type":         "reminder",
  "message":      "Deploy the new version to production",
  "channel":      "telegram",
  "chat_id":      "437734870",
  "scheduled_at": "2026-02-25T11:31:00Z",
  "created_at":   "2026-02-25T09:31:00Z",
  "metadata": {
    "delay_parsed": "2h",
    "delay_ms":     7200000
  },
  "_links": {
    "self":   "/api/pings/ping_7f3a9b2c",
    "cancel": "/api/pings/ping_7f3a9b2c/cancel",
    "list":   "/api/pings"
  }
}

View Full API Reference →

Use Cases

Built for builders

Developers, AI engineers, traders, or team leads — ClawPing fits your workflow.

🧑‍💻

Developers

Monitor CI/CD pipelines, API health, and deployment status. Get pinged instantly when builds fail or error rates spike — no more babysitting dashboards.

/alert api_health below 95 "Error rate critical"

🤖

AI Agents

ClawScout detects breaking news → triggers ClawPing webhook → notifies human. The Claw ecosystem orchestrates so you never miss critical events, even while sleeping.

ClawScout → POST /webhook → You 🔔

💰

Crypto Traders

Price alerts for BTC, ETH, and any CoinGecko-listed asset. Set thresholds once, react before the crowd does. Speed is alpha.

/alert eth above 4000 "ETH ATH range — act now"

📋

Teams

Recurring reminders for standups, sprint reviews, and deadlines. Set once, run forever. Stop being the person who manually sends "don't forget" messages.

/repeat "0 9 * * 1" Weekly sprint planning 📅

Roadmap

What's coming next

ClawPing is actively evolving. Here's what's being cooked up.

Discord & Slack soon

Expand notifications to Discord servers and Slack workspaces.

Natural Language soon

"Remind me tomorrow at 9am" — no cron syntax required.

Web Dashboard soon

Visual UI to manage, pause, and analyze all active pings.

SMS Notifications soon

Critical alerts straight to your phone via SMS providers.

More Condition Types soon

Weather, uptime monitoring, GitHub PRs, custom API polling.

Agent Protocol Standard soon

Standardized inter-agent communication across the Claw ecosystem.

The notification layer for the AI agent ecosystem