人工智能AI 應用Agent 記憶AI AgentRAG后端前端dsh-plugin【免費下載鏈接】mem9Unlimited memory for OpenClaw項目地址https://gitcode.com/gh_mirrors/me/mem9點擊查看免費下載mem9 是為 AI Agent 提供持久記憶的開源服務而mem9 Webhook能讓你的系統(tǒng)在記憶新增、刪除或跨 Space 路由的瞬間收到實時推送無需反復輪詢。這篇指南帶你從零配置 Webhook 端點并完整講解事件簽名校驗HMAC-SHA256與signing_secret密鑰輪換的安全最佳實踐。為什么需要 mem9 Webhook 實時推送傳統(tǒng)做法是定時調(diào)用列表接口輪詢記憶變化既浪費配額又存在延遲。mem9 Webhook 采用outbox 主動推送模式事件先落庫、再異步投遞到你的 HTTPS 端點失敗自動指數(shù)退避重試。核心能力一覽? 三類核心事件memory.added、memory.deleted、space_chain.fact_routed? 每次投遞攜帶X-Mem9-Signature簽名可防篡改、防偽造? 失敗重試最長跨天級退避投遞歷史可隨時查詢? 一鍵測試webhook.test與密鑰輪換密鑰只在創(chuàng)建/輪換時返回一次完整設計可見 docs/webhooks-api-design.md?？焖賱?chuàng)建 Webhook 端點3 步完成配置Space 作用域下使用現(xiàn)有X-API-Key請求以下端點Space Chain 作用域改用chain_管理密鑰和/v1alpha2/space-chains/{chainID}/webhooks前綴操作方法與路徑創(chuàng)建POST /v1alpha2/mem9s/webhooks列表 / 詳情GET /v1alpha2/mem9s/webhooks、GET .../{webhookID}更新 / 刪除PATCH、DELETE .../{webhookID}測試 / 輪換密鑰POST .../{webhookID}/test、POST .../{webhookID}/rotate-secret查詢投遞記錄GET /v1alpha2/mem9s/webhook-deliveries創(chuàng)建請求體只需四個字段{ name: Production sync, url: https://example.com/mem9/webhook, enabled: true, events: [memory.added, memory.deleted] }三個關鍵注意點??signing_secret只返回一次——創(chuàng)建和輪換密鑰的響應中才會出現(xiàn)請務必當場保存列表/詳情接口永遠看不到它見 server/internal/webhook/types.go 中的EndpointSecretResponse。生產(chǎn)環(huán)境 URL 必須 HTTPS僅開發(fā)環(huán)境允許localhost/127.0.0.1的 HTTP。帶 userinfo 的地址、私網(wǎng)字面量 IP 都會被拒絕。端點、密鑰、事件、投遞狀態(tài)全部由 mem9 控制面數(shù)據(jù)庫統(tǒng)一管理外部系統(tǒng)不應自行持久化投遞狀態(tài)。三類事件推送mem9 事件模型速覽每個事件只存一份再扇出fan-out給所有訂閱且啟用的端點。事件外層信封結構如下{ id: evt_..., type: memory.added, api_version: 2026-06-08, created_at: 2026-06-08T00:00:00Z, scope: { type: tenant, tenant_id: ... }, data: {} }事件觸發(fā)時機典型用途memory.added直接創(chuàng)建、置頂創(chuàng)建、智能攝取 ADD、Chain 路由寫入成功同步到搜索索引、通知下游系統(tǒng)memory.deleted單條或批量刪除成功清理本地緩存與副本space_chain.fact_routedSpace Chain 事實按策略路由到目標 Space 且寫入成功配額拒絕或寫入失敗不觸發(fā)審計跨 Space 數(shù)據(jù)流事件類型的權威定義在 server/internal/webhook/types.go投遞 HTTP 請求的構造邏輯見 server/internal/webhook/dispatcher.go。投遞失敗怎么辦自動重試與退避策略每次成功投遞2xx 響應會標記為delivered失敗則進入pending重試隊列默認退避節(jié)奏1 分鐘 → 5 分鐘 → 30 分鐘 → 2 小時 → 6 小時 → 之后每 24 小時直到達到最大嘗試次數(shù)轉為failed。你可以通過GET /v1alpha2/mem9s/webhook-deliveries查看每條投遞的狀態(tài)、嘗試次數(shù)與最近一次 HTTP 狀態(tài)碼排查問題不迷路。Webhook 簽名校驗HMAC-SHA256 安全實踐這是新手最容易踩坑的環(huán)節(jié)。mem9 每次投遞會附帶 4 個請求頭請求頭含義X-Mem9-Event-Id事件 ID可用于冪等去重X-Mem9-Event-Type事件類型X-Mem9-Timestamp投遞時間戳Unix 秒X-Mem9-Signature簽名值格式v1hex_hmac_sha256簽名算法是HMAC-SHA256輸入為「時間戳 事件 ID 原始請求體」HMAC-SHA256( signing_secret, timestamp.event_id.raw_body )實現(xiàn)可對照 server/internal/webhook/signer.go接收端按以下步驟校驗校驗X-Mem9-Timestamp與本機時間差在可接受范圍內(nèi)如 ±5 分鐘防重放攻擊用保存的signing_secret按上式重新計算 HMAC以恒定時間constant-time比較兩個簽名避免時序側信道校驗不通過直接返回 401/403不處理請求體。密鑰輪換rotate-secret 安全操作指南 密鑰泄露或團隊輪崗時不要直接刪端點重建會丟失投遞歷史應調(diào)用POST /v1alpha2/mem9s/webhooks/{webhookID}/rotate-secret響應中會返回一次性的新signing_secret舊密鑰立即失效。推薦的操作順序調(diào)用輪換接口立刻把新密鑰寫入你的密鑰管理系統(tǒng)KMS/環(huán)境變量通知你的接收端更新校驗用密鑰若支持雙密鑰過渡期先讓舊密鑰再存活幾秒調(diào)用POST .../{webhookID}/test觸發(fā)一條webhook.test事件端到端驗證簽名鏈路正常在webhook-deliveries中確認新事件delivered輪換完成。路由層對輪換、測試等接口的手可參考 server/internal/handler/webhook.go事件服務層邏輯在 server/internal/webhook/service.go。Space 與 Space Chain兩種作用域別混淆Space Webhook綁定租戶的X-API-Key只觀察該 Space 的事件Space Chain Webhook綁定chain_管理密鑰觀察鏈級事件如space_chain.fact_routed。一個容易忽略的細節(jié)當 Chain 路由寫入在目標 Space 創(chuàng)建記憶時mem9 會同時發(fā)出目標 Space 的memory.added和鏈級事件路由元數(shù)據(jù)則以space_chain.fact_routed單獨下發(fā)——所以下游做冪等時請以X-Mem9-Event-Id去重而不是記憶 ID。常見問題 FAQQ1收到重復事件重試機制可能導致同事件多次投遞請用X-Mem9-Event-Id做冪等鍵。Q2本地開發(fā)能用 HTTP 嗎可以。僅localhost、127.0.0.1、::1在非生產(chǎn)環(huán)境放行 HTTP生產(chǎn)一律 HTTPS。Q3忘記保存 signing_secret 還能找回嗎不能。只能走rotate-secret生成新密鑰并重新配置接收端。小結mem9 Webhook 用「事件落庫 簽名投遞 自動退避重試」三件套把記憶變更的實時同步做成了開箱即用的能力。記住三板斧創(chuàng)建時存好一次性密鑰、接收端恒定時間校驗簽名、輪換后測試事件驗證鏈路。上手資料推薦延伸閱讀 docs/webhooks-api-design.md。贊分享人工智能AI 應用Agent 記憶AI AgentRAG后端前端dsh-plugin【免費下載鏈接】mem9Unlimited memory for OpenClaw項目地址https://gitcode.com/gh_mirrors/me/mem9點擊查看免費下載相關推薦OpenMed 審計報告簽名密鑰輪換指南基于調(diào)用方托管密鑰的 HMAC-SHA256 離線簽名與校驗OpenMed 審計報告簽名密鑰輪換指南基于調(diào)用方托管密鑰的 HMAC SHA256 離線簽名與校驗 OpenMed 為每次脫敏de identificat人工智能NLP醫(yī)療健康數(shù)據(jù)脫敏本地部署大模型AI 應用MCP 服務聯(lián)邦學習Nango Webhook 簽名密鑰輪換實戰(zhàn)基于 rotate-webhook-signing-key 運維手冊的完整指南Nango Webhook 簽名密鑰輪換實戰(zhàn)基于 rotate webhook signing key 運維手冊的完整指南 在 Nango 中每個環(huán)境en后端API網(wǎng)關AI 應用Symfony Mailer Sendgrid Bridge 實戰(zhàn)指南DSN 配置、定時發(fā)送、退訂組與 Webhook 簽名校驗Symfony Mailer Sendgrid Bridge 實戰(zhàn)指南DSN 配置、定時發(fā)送、退訂組與 Webhook 簽名校驗 本篇技術指南圍繞 Symfo后端Web框架創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考