Webhook Relay Setup Guide

Prerequisites

• A running OpenClaw agent on your local machine or server
• A ClawPulsar account (join the waitlist for early access)
• Active accounts with Stripe, GitHub, and/or Sentry

Step 1: Install the Relay Client

The relay client is a lightweight binary that runs alongside your OpenClaw agent. It opens a persistent, encrypted outbound connection to the ClawPulsar relay server.

Step 2: Connect to Your Agent

Start the relay client and point it at your local OpenClaw agent. The client will register with the ClawPulsar server and establish a secure tunnel.

Save the relay endpoint URL — you will use it to configure each webhook provider.

Step 3a: Configure Stripe Webhooks

Stripe webhooks deliver payment events, subscription changes, disputes, and invoices to your agent.

1. Go to Stripe Dashboard → Developers → Webhooks
2. Click Add endpoint
3. Enter your relay URL: https://wh.clawpulsar.com/r/abc123/stripe
4. Select events to listen to: payment_intent.succeeded, customer.subscription.deleted, etc.
5. Copy the signing secret and add it to your relay configuration for signature verification

Step 3b: Configure GitHub Webhooks

GitHub webhooks deliver repository events like pull requests, issues, deployments, and pushes to your agent.

1. Go to your repository → Settings → Webhooks
2. Click Add webhook
3. Enter your relay URL: https://wh.clawpulsar.com/r/abc123/github
4. Set content type to application/json
5. Choose which events trigger the webhook or select "Send me everything"
6. Set a secret for payload signature verification

Step 3c: Configure Sentry Webhooks

Sentry webhooks deliver error tracking events, issue state changes, and deployment notifications to your agent.

1. Go to Sentry → Settings → Developer Settings → Custom Integrations
2. Create a new internal integration
3. Set the webhook URL to: https://wh.clawpulsar.com/r/abc123/sentry
4. Enable the webhook events you want: issue alerts, error events, etc.
5. Save the client secret for signature verification

Step 4: Verify and Monitor

Once configured, send a test event from each provider to verify the relay is working. The ClawPulsar dashboard shows every webhook received, delivery status, and response times.

Troubleshooting

Webhook not arriving? Check that your relay client is running and connected. Run clawpulsar status to verify.

Signature verification failing? Ensure you copied the signing secret correctly. Each provider has a different format — Stripe uses whsec_, GitHub uses a plain string, Sentry uses a client secret.

Agent not responding? Verify your OpenClaw agent is running and accepting requests on the configured port. Test locally first: curl http://localhost:3000/health