OpenClaw入门：第20讲：Webhook集成，实现外部系统的双向通信

大家好，我是正在实战各种AI项目的程序员晚枫。

今天学习Webhook集成，让OpenClaw能够接收外部系统的通知，实现真正的双向通信。

什么是Webhook？

Webhook是一种HTTP回调机制。当某个事件发生时，服务器主动向指定的URL发送HTTP请求。

工作流程

外部系统 ──事件触发──▶ 发送HTTP POST ──▶ OpenClaw Gateway
                                      ↓
                                  处理请求
                                      ↓
                                  执行相应操作

典型应用场景

场景	触发源	动作
Git代码推送	GitHub/GitLab	自动部署、通知审查
订单支付完成	支付平台	发送确认消息
服务器告警	监控系统	紧急通知管理员
表单提交	网站	自动回复、数据录入

配置Webhook接收

基础配置

{
  "webhooks": {
    "enabled": true,
    "port": 18790,
    "path": "/webhook",
    "secret": "your-webhook-secret",
    "handlers": [
      {
        "name": "github_push",
        "source": "github",
        "event": "push",
        "action": "notify_deployment"
      }
    ]
  }
}

实战案例

案例1：GitHub自动通知

GitHub配置：

进入仓库 Settings → Webhooks
Add webhook
Payload URL: http://your-server:18790/webhook/github
Content type: application/json
Secret: 你的密钥
选择事件：Just the push event

安全验证

Signature验证

{
  "webhooks": {
    "handlers": [{
      "verifySignature": true,
      "signatureHeader": "X-Hub-Signature-256",
      "signatureSecret": "${WEBHOOK_SECRET}"
    }]
  }
}