返回顶部
h

hookpipeWebhook管道

Reliable webhook infrastructure for AI agents. Receive webhooks from Stripe, GitHub, Slack, Shopify, Vercel with signature verification, durable queuing, and automatic retries. Use when: (1) setting up webhook listeners for external services, (2) agent needs real-time events from Stripe/GitHub/Slack, (3) webhooks are being lost during restarts or downtime, (4) need durable event buffering with guaranteed delivery. NOT for: sending outgoing webhooks to customers (use Svix), direct API polling, or

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 0.1.0
安全检测
已通过
138
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

hookpipe

hookpipe — AI代理的Webhook基础设施

hookpipe从外部服务接收webhook,将其持久化排队,并通过自动重试将其传递给您的代理。即使在重启或停机期间,您的代理也不会错过任何事件。

为什么使用这个

没有hookpipe,当您的OpenClaw网关重启或离线时发送的webhook将永久丢失。大多数提供商只发送一次就不再处理。hookpipe位于中间——它始终在线(Cloudflare Workers,300+边缘节点),立即接受webhook,并重试传递到您的网关直到成功。

快速开始

本地开发(在您的机器上接收webhook)

bash
hookpipe dev --port 18789 --provider stripe --secret whsec_xxx

这会创建一个到您OpenClaw网关的安全隧道。将打印的Webhook URL粘贴到您的Stripe仪表板中。无需端口转发,无需暴露IP。

生产环境设置(持久化,重启后保留)

bash

1. 部署hookpipe(一键部署到Cloudflare,或自托管)


2. 配置CLI


hookpipe config set api_url https://your-hookpipe.workers.dev
hookpipe config set token hfskxxx

3. 将提供商连接到您的OpenClaw网关

hookpipe connect stripe \ --secret whsec_xxx \ --to http://localhost:18789/webhook \ --events payment_intent.*

hookpipe返回一个Webhook URL——在Stripe的仪表板中注册它。事件现在被持久化排队,并通过重试传递到您的网关。

内置提供商

bash
hookpipe providers ls

提供商事件使用场景
stripepaymentintent, customer, invoice, charge支付通知
github
push, pullrequest, issues, release | 代码事件,PR审查 | | slack | message, app_mention, reaction | 团队通知 | | shopify | orders, products, customers | 电商事件 | | vercel | deployment, domain | 部署监控 |

查看提供商的事件:

bash
hookpipe providers describe stripe --json

任何其他webhook服务

不限于5个内置提供商。对于任何已经向您的代理发送webhook的服务,使用通用HMAC验证:

bash
hookpipe connect my-service --secret mysigningsecret --to http://localhost:18789/webhook

对于具有非标准签名格式的服务,社区可以使用defineProvider()创建自定义提供商——一个定义验证方法、事件类型和负载模式的单一文件。参见提供商设计指南

核心工作流

Stripe支付提醒

bash
hookpipe connect stripe --secret whsecxxx --to http://localhost:18789/webhook --events paymentintent.payment_failed

代理接收支付失败事件,可以起草后续邮件、创建支持工单或提醒团队。

GitHub PR自动审查

bash
hookpipe connect github --secret ghsecxxx --to http://localhost:18789/webhook --events pullrequest

代理立即接收PR事件,可以审查代码、发表评论或运行检查。

多提供商监控

bash
hookpipe connect stripe --secret whsec_xxx --to http://localhost:18789/webhook --name stripe-prod
hookpipe connect github --secret ghsec_xxx --to http://localhost:18789/webhook --name github-prod
hookpipe connect vercel --secret vsec_xxx --to http://localhost:18789/webhook --name vercel-prod

所有事件通过一个持久化管道流向您的网关。自由重启您的网关——没有任何丢失。

实时监控事件

bash
hookpipe tail --json

事件到达时流式输出。管道到脚本或其他代理:

bash
hookpipe tail --json | jq .event_type

停机期间会发生什么

您的网关在凌晨2:00宕机

Stripe在凌晨2:15发送payment_intent.succeeded
→ hookpipe接受(202),持久化排队

GitHub在凌晨2:30发送push
→ hookpipe接受(202),持久化排队

hookpipe每隔几分钟重试传递(指数退避)

您的网关在早上6:00恢复
→ hookpipe自动传递两个事件
→ 代理处理它们,就像什么都没发生一样

无需手动重放。没有事件丢失。断路器保护您的网关在恢复时不被淹没。

CLI参考

bash
hookpipe connect --secret --to [--events ]
hookpipe dev --port [--provider ] [--secret ]
hookpipe providers ls [--json]
hookpipe providers describe [--json]
hookpipe tail [--json] [--source ]
hookpipe events ls [--json] [--limit ]
hookpipe health [--json]

所有命令支持--json用于结构化输出,--dry-run用于验证。

关键事实

  • - 运行在Cloudflare Workers上——始终在线,$0空闲成本
  • 使用指数退避重试,最长24小时
  • 断路器暂停向不健康目标传递
  • 内置幂等性(无重复传递)
  • Apache 2.0许可证,完全开源
  • GitHub: https://github.com/hookpipe/hookpipe

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 hookpipe-1776163081 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 hookpipe-1776163081 技能

通过命令行安装

skillhub install hookpipe-1776163081

下载

⬇ 下载 hookpipe v0.1.0(免费)

文件大小: 3.69 KB | 发布时间: 2026-4-17 15:02

v0.1.0 最新 2026-4-17 15:02
Initial publish as hookpipe (renamed from hookflare)

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large