OpenClaw Webhook 完全指南：接收任意平台事件触发 AI 自动化工作流

// ~/.openclaw/config.json
{
  "webhooks": {
    "enabled": true,
    "port": 3001,
    "basePath": "/webhook",
    "endpoints": [
      {
        "path": "/github",
        "secret": "你设置的github-webhook-secret",
        "handler": "github"
      },
      {
        "path": "/stripe",
        "secret": "whsec_你的stripe-webhook-secret",
        "handler": "stripe"
      },
      {
        "path": "/custom",
        "token": "你自定义的bearer-token",
        "handler": "custom"
      }
    ]
  }
}

## GitHub Webhook 处理规则

### push 事件
- 推送到 main 分支：发 Telegram 通知（推送人 + commit 摘要）
- 推送到 release/* 分支：发告警到 #releases 频道

### pull_request 事件
- opened：AI 分析 diff，生成代码审查要点，发到 Telegram
- merged：汇总本次 PR 的改动，更新项目 CHANGELOG 草稿

### workflow_run 事件
- failure：立刻发告警，包含失败的 step 和错误摘要
- success（main 分支）：发部署成功通知

## Stripe Webhook 处理规则

### payment_intent.succeeded
提取：金额、用户邮箱、订单ID
动作：
1. 更新 Notion 订单数据库状态为「已付款」
2. 发 Telegram 通知：新订单 $金额（用户邮箱）
3. 触发发货流程（POST 到内部 API）

### payment_intent.payment_failed
提取：失败原因、用户邮箱
动作：
1. 发 Telegram 告警（需要人工处理）
2. 记录到错误日志数据库

### customer.subscription.deleted
动作：
1. 发 Telegram 通知（哪个用户取消了，订阅了多久）
2. 标记用户状态为「已取消」

# 服务器监控系统发告警
curl -X POST https://你的openclaw域名/webhook/custom   -H "Authorization: Bearer 你的token"   -H "Content-Type: application/json"   -d '{
    "event": "server_alert",
    "severity": "critical",
    "server": "prod-web-01",
    "metric": "cpu_usage",
    "value": 95.2,
    "threshold": 80
  }'

## 自定义 Webhook 处理规则

### server_alert 事件
- severity=critical：立刻发 Telegram 告警 + @oncall
- severity=warning：记录日志，每小时汇总一次
- 连续 3 次同一告警：升级为 critical

### deploy_complete 事件
- 发部署通知：版本号、环境、耗时、操作人

### backup_failed 事件
- 立刻发告警，标记需要手动干预

# 安装 ngrok
brew install ngrok

# 暴露本地 3001 端口
ngrok http 3001

# 获得临时公网 URL：https://xxxx.ngrok.io
# 在 GitHub/Stripe 填这个 URL + /webhook/github

# 安装 cloudflared
brew install cloudflared

# 创建免费隧道
cloudflared tunnel --url http://localhost:3001

# 获得固定 URL：https://xxx.trycloudflare.com

# GitHub 签名验证示例（OpenClaw 内部处理，无需手动写）
import hmac, hashlib

def verify_github_signature(payload: bytes, signature: str, secret: str) -> bool:
    expected = "sha256=" + hmac.new(
        secret.encode(), payload, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)