Built for 80% of OpenClaw users who run Telegram bots

Your Telegram bot is silent.
OpenClaw says it's running.

Orchesis is an open-source HTTP proxy that monitors OpenClaw Telegram bot traffic to detect silent message drops, VPN failures, loop storms, and injection attacks — sending you a Telegram alert with the diagnosis before your users notice anything is wrong.

bot status: running · messages delivered: 0 · last alert: never · Orchesis: 90s detect

Install in 5 minutes →★ Star on GitHub
📨 Silent drop detection
🔒 VPN failure alerts
Loop storm detection
MIT license · Free
Four problems that actually happen

Real issues. Real GitHub numbers.

Each one is documented in the OpenClaw issue tracker. Each one is verifiable.

Issue #28622 · OpenClaw
0
messages received, bot shows running

Silent message drop

Telegram stops delivering messages to the bot. No error in OpenClaw logs. No webhook failure. The bot is alive. Messages are gone. Users think you broke something.

Orchesis detects it in 90 secondsCompares expected message rate against actual. Telegram alert with channel, time, and last successful delivery.

Issue #33013 · OpenClaw
VPN
breaks Telegram polling silently

VPN kills your bot at 3am

VPN rotation disconnects Telegram long-polling. OpenClaw doesn't know. Retries silently fail. Your bot is offline until someone manually restarts it. Nobody's watching at 3am.

Orchesis detects VPN failure in 2 minutesMonitors polling continuity. Sends Telegram alert with reconnect command before the first user notices.

Issue #43178 · OpenClaw
18
agents sharing one OAuth profile

Watchdog cascade

18 agents sharing one OAuth profile. Agent A refreshes the token. Agent B uses the stale one, gets 401, falls back to Opus at $0.186/turn. Watchdog triggers. All 18 agents restart simultaneously. $636/month from one config decision.

Orchesis identifies the cascade root causeCross-agent token tracking shows which agent caused the refresh race. One fix, not 18 restarts.

Issue #9828 · OpenClaw
~100K
extra tokens per message, default config

Config schema cost on every message

Default OpenClaw config injects the full configuration schema into every system prompt. Every Telegram message triggers a call with ~100,000 extra tokens. Breaks Anthropic prompt caching. You pay full price on every call instead of 90% savings.

orchesis verify finds it in 30 secondsShows exact overhead, cost per message, and the one-line fix.

What the alerts look like

You get a message. Not a dashboard.

Every alert has a cause, a time, and an action. No noise. No false positives.

Silent drop alert
🔴 ORCHESIS ALERT
Silent message drop detected
Channel: Telegram · @mybotname
Last delivery: 14:23:07 UTC
Elapsed: 7m 14s
Cause: VPN reconnect gap
Action: /reconnect to restore
Loop storm alert
⚠ ORCHESIS ALERT
Loop storm detected
Agent: coder-01 · Telegram channel
Calls: 122 identical in 4m 30s
loopDetection status: ON · Alerts: 0
Cost rate: $0.186/call · Opus fallback
Action: /thaw agent:coder-01
Detection coverage by channel

Telegram is the priority. Others work too.

DetectionTelegramWhatsAppDiscordWebChat
Silent drop
VPN failureTelegram-specific
Watchdog cascade
Loop storm
Injection attack
Config costorchesis verify
Token tracking
Crystal phaseΨ_α per request
Install

Start in 5 minutes. No credit card. No account.

# 1. Install
pip install orchesis

# 2. Start with Telegram monitoring
orchesis init --with-telegram --with-injection-shield

# 3. Connect OpenClaw (one line)
"proxy": { url: "http://localhost:8080", enabled: true }
orchesis verify

✓ Proxy running · Telegram monitor active · Injection Shield active
Read the docs →★ Star on GitHub
GitHub ↗PyPI ↗OpenClaw guide ↗MIT license · self-hosted · no telemetry
Frequently asked questions

Common questions

Why is my OpenClaw Telegram bot not receiving messages?

The most common causes are silent webhook failures, VPN disconnection during Telegram long-polling, and Telegram rate limiting after a loop storm. Orchesis monitors all three continuously and sends a Telegram alert with the specific cause within 90 seconds of the drop.

Does OpenClaw Telegram work with VPN in Russia?

Yes, but VPN instability is the leading cause of silent bot failures. When VPN rotates or reconnects, Telegram long-polling drops without an error visible in OpenClaw logs. Orchesis detects the polling gap and alerts you with a reconnect command before users notice.

How does Orchesis detect Telegram silent drops?

Orchesis maintains a baseline of expected message delivery rate per channel. When actual delivery falls below baseline for 90 seconds, it sends a Telegram alert with the channel, timestamp, and last successful delivery time. No false positives from normal quiet periods.

What is the OpenClaw watchdog cascade problem?

When multiple OpenClaw agents share one OAuth profile, a token refresh by one agent invalidates all others. Each agent gets a 401 error, triggers the watchdog, and restarts. All agents restart simultaneously, flooding the LLM API and creating a cost spike. Issue #43178 documents a case with 18 agents and $636/month in waste.

Does Orchesis work with WhatsApp and Discord too?

Yes. Orchesis monitors all traffic between your OpenClaw agent and the LLM API regardless of channel. Telegram, WhatsApp, Discord, and WebChat are all covered by the same proxy. Channel-specific detection patterns apply per channel type.

What happens if Orchesis goes down?

Your agents fall back to direct API calls automatically. Orchesis is not in the critical path. If the proxy is unavailable, OpenClaw routes directly to the LLM provider. Zero downtime risk to your bot.

Is Orchesis free?

Yes. MIT license. Self-hosted. No telemetry. No vendor lock-in. No usage limits.

Your bot went silent 8 minutes ago.

You don't know yet.

Install Orchesis — it's free →