ECINT-6556: add alerts webhook listener skill#401
Open
gulshngill wants to merge 3 commits intomainfrom
Open
Conversation
Skill that sets up a local HTTP server to receive Nansen smart alert webhook payloads. Includes HMAC-SHA256 signature verification (sha256= prefixed), body size limits, localhost-only binding, and public tunnel setup via ngrok (recommended) or localtunnel (fallback). Tested end-to-end with live alerts — verified signature format, tunnel stability, and auto-disable recovery. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
OpenClaw Gateway webhooks aren't publicly reachable, so mark skill as local Claude Code only until OpenClaw exposes public webhook ingress. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
When OPENCLAW_GATEWAY_URL is set, the webhook server forwards verified alert payloads to the local OpenClaw Gateway /hooks/agent endpoint, triggering an agent turn for each alert. Supports Bearer token auth via OPENCLAW_AUTH_TOKEN. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
nansen-alerts-webhook-listenerthat sets up a local HTTP webhook server to receive Nansen smart alerts in real-timesha256=prefixed), 1 MB body limit, localhost-only binding, and graceful shutdownOPENCLAW_GATEWAY_URLis set, the server forwards verified payloads directly to the local OpenClaw Gateway/hooks/agentendpoint, triggering an agent turn per alert — no polling, real-time pushTest plan
common-token-transferalert (USDC >$10 on Ethereum)x-nansen-signatureheader format issha256=<hex>— signature verification works after stripping prefix🤖 Generated with Claude Code