Event Watcher

Overview

Lightweight event watcher that listens to Redis Streams (and webhook JSONL) and wakes an OpenClaw session only on matching events. No events → no agent wake → no token spend.

Core Capabilities

1. Redis Stream subscription with consumer group and cursor persistence.
2. Webhook JSONL ingestion via webhook_bridge.py.
3. Filtering via JSON rules (supports AND/OR + regex).
4. Deduplication with TTL (configurable).
5. Retry on failed delivery.
6. Session routing via sessions_send or agent_gate.
7. Structured logging + counters for received/matched/delivered/failed.

Recommended Usage (Agent Guidance)

Channel permissions

• Ensure the target Slack channel is allowed in openclaw.json (channels allowlist / groupPolicy). If the bot can’t post, nothing will deliver.