核心用法
HookCatch 是面向开发者的Webhook测试与本地隧道工具,核心功能分为三大模块:
1. Webhook Bin 管理
hookcatch bin create创建专属捕获端点,自动生成https://hookcatch.dev/b/{id}格式的URL- 支持命名、私有加密(PLUS+ tier)、密码保护(4位以上)
hookcatch bin list查看所有bin及请求计数hookcatch bin requests <binId>以JSON或表格格式检索捕获的请求,支持按HTTP方法过滤
2. 本地服务隧道
hookcatch tunnel <port>快速暴露localhost,生成公网URL(如https://hookcatch.dev/tunnel/xyz789)- 支持请求转发到本地端口,便于测试第三方服务回调
3. API Token 生命周期管理
hookcatch token generate生成长期有效令牌,推荐用于自动化场景- 环境变量
HOOKCATCH_API_KEY支持无交互式认证
显著优点
- 零配置隧道:相较ngrok无需复杂注册流程,一行命令即可启动
- 自动化原生:所有命令支持
--format json,与CI/CD和OpenClaw技能无缝集成 - 安全分层:私有bin + 密码双重保护,适合生产级Webhook测试
- 请求重放:
hookcatch replay支持将捕获请求转发至新URL,便于调试
潜在局限
- 免费层限制严格:隧道仅5分钟/会话、3次/天,大型项目需升级PLUS/PRO
- 生态锁定:Webhook URL域名固定为hookcatch.dev,无法自定义CNAME
- Node依赖:需npm安装,对纯Python/Go环境增加依赖负担
- 无持久化存储:Bin数据保留策略未明确,长期调试需自行导出
适合人群
- OpenClaw技能开发者需快速验证Webhook集成
- 全栈工程师调试Stripe/Twilio/GitHub等SaaS回调
- 微服务团队本地联调需临时公网入口
常规风险
- 隧道URL为公开可访问,未加密传输敏感数据存在中间人风险
- API Key硬编码于环境变量或脚本,需配合密钥管理服务
- 免费层会话超时可能导致调试中断,生产环境务必升级付费 tier