@waffo/pancake-plugin

Pancake 支付 webhook 官方插件，支持 OpenClaw 与 Hermes 两条投递链路。接收 Pancake 平台的支付、订阅、退款事件，自动通过飞书/Telegram/Slack 等 IM 渠道通知商户。

安装 & 配置（一键）

npx -p @waffo/pancake-plugin openclaw-setup

交互式向导会自动完成：

1. 安装插件到 ~/.openclaw/extensions/pancake
2. 扫描已有 Agent，选择通知目标（飞书/Telegram/Slack 等）
3. 选择运行模式（test/prod）
4. 写入 openclaw.json 配置

手动安装

如果需要手动配置，参考以下步骤：

安装插件：

mkdir -p ~/.openclaw/extensions/pancake && cd ~/.openclaw/extensions/pancake \
  && npm pack @waffo/pancake-plugin \
  && tar xzf *.tgz --strip-components=1 && rm *.tgz \
  && npm install --omit=dev

编辑 ~/.openclaw/openclaw.json：

{
  "plugins": {
    "allow": ["pancake"],
    "entries": {
      "pancake": {
        "enabled": true,
        "config": {
          "mode": "test",
          "agentId": "feishu-ou_xxxxxxxxxxxxxxxx"
        }
      }
    },
    "installs": {
      "pancake": {
        "source": "local",
        "spec": "@waffo/pancake-plugin",
        "installPath": "~/.openclaw/extensions/pancake",
        "version": "0.3.0"
      }
    }
  }
}

agentId 决定通知发送到哪个 IM 渠道，格式为 {channel}-{target}：

| agentId 示例 | 通知渠道 | |---|---| | feishu-ou_xxx | 飞书 | | telegram-123456 | Telegram | | slack-U0xxx | Slack | | discord-9876 | Discord |

在 OpenClaw 管理界面「代理」页面可以找到你的 Agent ID。

获取 Webhook URL

重启 OpenClaw 后，启动日志会输出永久 Webhook URL：

[pancake] ============================================================
[pancake] Pancake plugin ready!
[pancake] Webhook URL: https://relay.waffo.ai/webhook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
[pancake] This URL is permanent — configure it once in Pancake Dashboard.
[pancake] ============================================================

配置 Pancake Dashboard

1. 登录 Pancake Dashboard
2. 进入 Settings → Webhooks
3. 粘贴上一步获取的 Webhook URL
4. 勾选要接收的事件类型
5. 保存

配置一次，永不过期。插件重启后 URL 不会变。

通知效果

收到支付事件后，IM 渠道自动收到通知：

Pancake 支付通知
📦 订单完成 (支付成功)
商品: Pancake Pro Plan
金额: 49.00 USD
买家: [email protected]
时间: 2026-04-14T12:30:00Z
事件ID: PAY_xxx

支持的事件

| 事件 | 说明 | |---|---| | order.completed | 订单支付成功 | | subscription.activated | 新订阅激活 | | subscription.payment_succeeded | 订阅续费成功 | | subscription.updated | 订阅信息变更 | | subscription.canceling | 订阅取消中（到期后失效） | | subscription.uncanceled | 取消已撤回 | | subscription.canceled | 订阅已取消 | | subscription.past_due | 订阅欠费（续费失败） | | refund.succeeded | 退款成功 | | refund.failed | 退款失败 |

Hermes Agent 安装

Pancake Webhook 同样支持 Hermes Agent（需要 2026-04-10 之后的版本）。

一键安装（推荐）

npx -p @waffo/pancake-plugin hermes-setup

向导自动完成：

1. 检查 Hermes 版本（旧版自动升级）
2. 启用 webhook platform
3. 选择投递渠道（飞书/Telegram/Slack/Discord 等 12 个平台）+ 填写 chat_id
4. 订阅 pancake 路由
5. 重启 Hermes gateway
6. 后台启动 Cloudflare Tunnel（自动安装 cloudflared）
7. 自动注册 Waffo Relay
8. 输出永久 Webhook URL

也支持 CLI 参数跳过交互：

npx -p @waffo/pancake-plugin hermes-setup --platform feishu --chat-id oc_xxxxxxxx

辅助命令：

hermes-setup --url    # 查看永久 URL
hermes-setup --stop   # 停止后台 tunnel

手动安装

1. 启用 webhook platform — 编辑 ~/.hermes/config.yaml，末尾添加：

platforms:
  webhook:
    enabled: true
    extra:
      host: "0.0.0.0"
      port: 8644
      secret: "INSECURE_NO_AUTH"

2. 订阅 Pancake 路由：

hermes webhook subscribe pancake \
  --prompt 'Pancake 支付通知
📦 事件: {eventType}
商品: {data.productName}
金额: {data.amount} {data.currency}
买家: {data.buyerEmail}
时间: {timestamp}
事件ID: {eventId}' \
  --deliver feishu \
  --deliver-chat-id <YOUR_CHAT_ID> \
  --secret INSECURE_NO_AUTH

--deliver 支持：feishu、telegram、slack、discord、wecom、dingtalk、whatsapp、matrix、mattermost、signal、email、sms。

3. 重启 gateway：

hermes gateway restart

4. 启动 Tunnel + 注册 Relay：

cloudflared tunnel --url http://localhost:8644
# 拿到 tunnel URL 后注册到 Relay
curl -X POST https://relay.waffo.ai/register \
  -H "Content-Type: application/json" \
  -d '{"pluginId":"<UUID>","targetUrl":"https://xxx.trycloudflare.com/webhooks/pancake"}'

Hermes 通知效果

Hermes 会让 Agent 智能加工后投递：

📦 order.completed
Auto Setup Test · $49.00 USD
买家：[email protected]
时间：04-15 02:30 CST
事件 ID：PAY_xxx

工作原理

Pancake → Waffo Relay (Vercel) → Cloudflare Tunnel → Agent → IM 通知

| 环节 | OpenClaw | Hermes | |------|---------|--------| | Agent | OpenClaw 插件接收 + gateway send RPC 投递 | 内置 webhook adapter + Agent 智能加工 + 跨平台投递 | | Tunnel | 插件内置自动启动 | 向导后台启动 | | Relay | 插件内置自动注册 | 向导自动注册 | | 安装方式 | openclaw-setup | hermes-setup |

Agent Tools (OpenClaw)

| Tool | 说明 | |---|---| | pancake_query_events | 查询最近的支付/订阅/退款事件 | | pancake_status | 插件状态和统计信息 | | pancake_retry_event | 手动重试失败的事件 |

完整配置项 (OpenClaw)

| 选项 | 默认值 | 说明 | |---|---|---| | mode | test | Pancake 环境（test 或 prod） | | agentId | — | 通知目标 Agent ID（必填） | | logLevel | info | 日志级别（debug/info/warn/error） | | tunnel.enabled | true | 是否自动启动 Cloudflare Tunnel | | tunnel.type | quick | Tunnel 类型（quick 免费随机 / named 稳定域名） | | tunnel.namedTunnelToken | — | Named Tunnel token（type=named 时必填） | | tunnel.port | 18789 | OpenClaw Gateway 端口 |

开发

npm install
npm test          # 运行测试
npm run build     # 编译 TypeScript
npm run dev       # watch 模式