適用於 Openclaw 的 Webhook Debugger

一個用於接收、檢查和重放 Webhook Payload 的本地開發工具，旨在實現無縫的 API 整合測試。

chenxuyaun

v1.0.0

Mar 13, 2026

安裝

基本資訊

Skill.md

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。


                  npx clawhub@latest install webhook-debugger

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式

~/.openclaw/skills/

工作區

<project>/skills/

優先級：工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。


                  請幫我使用 Clawhub 安裝 webhook-debugger。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。

想要直接下載？

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 Webhook Debugger？

Webhook Debugger 是 Openclaw Skills 生態系統中的專用工具，旨在消除測試第三方整合的障礙。它允許開發人員建立一個本地接收器來捕獲傳入的 POST 請求，並提供對 Headers、查詢參數和 Payload 主體的全方位可見性。

透過提供驗證簽名和檢查資料結構的本地環境，該工具可確保您的應用程式邏輯在部署到生產環境之前是穩健的。無論您是在處理支付閘道還是 CI/CD 觸發器，此技能都簡化了調試異步事件的複雜任務。

Webhook Debugger 應用場景

在本地調試 Stripe 或 PayPal 支付通知。
在無需遠端部署的情況下測試 GitHub 或 GitLab 儲存庫 Webhook。
檢查來自前端應用程式的原始表單提交和多部分資料。
驗證來自 Zapier 或 Make 等提供商的 API Payload 和安全簽名。
捕獲並分析來自您自己微服務的傳出 Webhook。

Webhook Debugger 運作原理

用戶使用 Openclaw Skills 介面或 CLI 啟動本地監聽器。
該工具綁定到指定的本地連接埠（預設為 3000）並開始監聽傳入的 HTTP 請求。
收到請求後，工具會記錄完整的上下文，包括帶時間戳記的 Headers 和格式化的主體。
開發人員可以透過命令列檢查捕獲的歷史記錄，以驗證資料完整性。
請求可以重放到不同的目標 URL，以便在不重新觸發外部事件源的情況下測試本地服務邏輯。

Webhook Debugger 設定指南

要開始使用 Webhook Debugger，請確保已配置 Openclaw Skills 環境並執行以下命令：

# 在預設連接埠 (3000) 上開始監聽
webhook listen

# 或指定自定義連接埠
webhook listen 8080

# 將您的外部提供商指向您的本地或隧道 URL
webhook listen --url https:\/\/your-tunnel-provider.com\/webhook

Webhook Debugger 資料結構與分類體系

該技能維護本地請求歷史記錄，以允許持久的調試工作階段。資料組織如下：

屬性	描述
請求 ID	每個捕獲的 Webhook 的唯一識別碼
時間戳記	接收的確切日期和時間
協定	Headers、查詢參數和 HTTP 方法 (POST/PUT 等)
Payload	支援 JSON、form-data 和純文字本文格式
歷史記錄	本地儲存，可透過 `webhook show` 或 `webhook list` 檢索