Webhooks

Trigger actions from external services.

Overview

Webhooks allow external services to trigger OpenClaw actions:

• GitHub notifications
• CI/CD events
• Monitoring alerts
• Custom integrations

Creating Webhooks

# Create a webhook
openclaw webhook create "my-webhook"

This generates a unique URL:

https://your-server/webhook/abc123

Configuration

{
  webhooks: {
    enabled: true,
    endpoints: [
      {
        name: "github",
        secret: "your-secret",
        prompt: "Process this GitHub event: {{payload}}",
        channel: "telegram"
      }
    ]
  }
}

Using Webhooks

GitHub Example

1. Create webhook in OpenClaw
2. Add webhook URL to GitHub repository settings
3. Configure events to trigger

Payload Processing

The webhook payload is available in the prompt:

{
  prompt: "New event: {{payload.action}} on {{payload.repository.name}}"
}

Security

Secret Validation

Validate webhook signatures:

{
  webhooks: {
    endpoints: [
      {
        name: "github",
        secret: "your-github-secret",
        validateSignature: true
      }
    ]
  }
}

IP Whitelisting

Restrict webhook sources:

{
  webhooks: {
    allowedIPs: ["192.30.252.0/22"]  // GitHub IPs
  }
}

Managing Webhooks

# List webhooks
openclaw webhook list

# Delete webhook
openclaw webhook delete my-webhook

# Test webhook
openclaw webhook test my-webhook

See Also

• Automation
• Gateway Security