事件回调规划器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install event-callback-url-complete
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 event-callback-url-complete。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

事件回调规划器是一个可执行的 Openclaw Skills 工作流，可将 subscription_request 转换为 callback_url，然后使用该结果创建或更新代表已记录回调的本地业务对象。它的单一运行程序同时处理识别和后续处理，并返回完整工作流的结构化结果。
默认情况下，该技能在本地运行，不会联系任何外部服务。配置 SMTP 或 HTTP 发送端点，即可执行所声明的实际操作，并接收报告结果的发送回执。这让开发者能够清楚区分本地记录与明确配置的外部发送。

应用场景

处理传入的订阅请求并识别其回调 URL。
为业务工作流创建或更新本地回调注册记录。
配置发送后，将回调注册信息提交到 HTTP 端点。
提供邮件设置后，通过 SMTP 发送与订阅相关的消息。
测试或验证业务对象时，在本地运行工作流且不进行外部调用。

工作原理

从输入 JSON 文件读取上游 subscription_request。
运行识别阶段以计算 callback_url。
将识别结果传递到下游阶段并计算 recorded_callback。
在明确指定的输出目录下创建或更新 subscription_receipt_record。
如果通过环境变量或发送配置文件配置了 SMTP 或 HTTP 发送，则执行所声明的操作，并返回发送回执，结果可能为 sent、delivered 或 failed。否则，在本地保留记录，并报告发送尚未配置。

配置指南

使用 Python 运行工作流，并提供输入文件和输出目录：
python scripts/run.py --input examples/request.json --output-dir ./workspace
若要通过配置文件提供可选的发送设置：
python scripts/run.py --input examples/request.json --output-dir ./workspace --delivery-config delivery.json
对于 SMTP 发送，请配置 CLAWHUB_SMTP_HOST，并按需配置 CLAWHUB_SMTP_PORT、CLAWHUB_MAIL_FROM、CLAWHUB_SMTP_USERNAME 和 CLAWHUB_SMTP_PASSWORD。也可以在发送配置文件中提供包含 smtp_host、smtp_port 和 from_addr 的 SMTP 配置。
对于 HTTP 注册或提交，请设置 CLAWHUB_DELIVERY_ENDPOINT，并可选设置 CLAWHUB_DELIVERY_API_KEY；或者在发送配置文件中提供 endpoint 对象。发送目标、凭据和收件人必须在运行时明确提供。未配置发送时，工作流仅在本地运行。发送错误会导致退出码非零。

数据架构

工作流数据
阶段 输入或结果 用途
上游识别 subscription_request → callback_url 读取请求并识别回调地址。
下游处理 识别结果 → recorded_callback 计算业务结果并创建或更新本地对象。
业务操作 subscription_receipt_record 表示注册或提交操作。
可选发送 delivery 回执 报告已配置的发送结果，例如 sent、delivered、failed 或 unconfigured。
文件和配置
examples/request.json — 随附的上游输入。
examples/expected.json — 完整两阶段输出格式示例；不包含运行时路径和回执标识符。
scripts/upstream/ — 识别实现：operation.py、validation.py 和 config.json。
scripts/downstream/ — 下游发送实现，包括 deliver_effect。
scripts/run.py — 完整工作流运行程序。
source-map.json — 两个提取阶段的来源信息。 --output-dir — 明确选择的本地业务对象保存位置。 --delivery-config — 可选的基于文件的发送配置。

高级特性

在一个可执行工作流中整合识别、下游业务处理、本地对象创建和可选发送。
支持 SMTP 消息发送以及 HTTP 注册或提交操作。
接受来自运行时环境变量或明确配置文件的发送设置。
默认仅在本地运行，未配置发送目标时不会进行外部调用。
配置外部发送后返回发送回执，并通过非零进程退出码报告失败。
包含独立的上游和下游实现，以及用于记录阶段来源的来源映射。

name: Event Callback Planner description: >- Select an event callback address. Then it executes the downstream business step: Register an event callback address. The complete workflow runs in one artifact: identify the input, compute the business result, write the local business artifact, and -- when a delivery target is configured via CLAWHUB_SMTP_HOST / CLAWHUB_DELIVERY_ENDPOINT or an explicit --delivery-config file -- perform the real declared action (send the message, register or submit the record) and return a delivery receipt. Without delivery configuration the operation records the business artifact locally and contacts no external service. version: 1.2.0 Event Callback Planner — complete probe workflow

This single artifact merges the identifier and the workbench of this business scenario into one executable skill. Running it performs the full chain:

Identify — reads the upstream input (subscription_request) and computes the identification result (callback_url).
Deliver — feeds the identification result into the downstream operation, computes the business result (recorded_callback), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: subscription_receipt_record.
Real delivery — when a delivery target is configured, performs the declared business action (subscription_receipt_record) and returns a delivery receipt with the real outcome (sent / delivered / failed / unconfigured).

Run

python scripts/run.py --input examples/request.json --output-dir ./workspace [--delivery-config delivery.json]

The bundled examples/request.json is the upstream input; examples/expected.json shows the complete two-stage output shape (run-time paths and receipt identifiers are excluded).

Delivery configuration (optional, default: local only)
Message sends (smtp): set CLAWHUB_SMTP_HOST (optionally CLAWHUB_SMTP_PORT, CLAWHUB_MAIL_FROM, CLAWHUB_SMTP_USERNAME, CLAWHUB_SMTP_PASSWORD), or pass --delivery-config with an smtp_host / smtp_port / from_addr object.
Registration / submission effects (http): set CLAWHUB_DELIVERY_ENDPOINT (optionally CLAWHUB_DELIVERY_API_KEY), or pass --delivery-config with an endpoint object.

Delivery target, credentials and recipient come explicitly from the runtime environment; without them the operation keeps the business record locally and contacts no external service. Errors are reported through a nonzero exit.

Files

scripts/upstream/ — identify stage implementation (operation.py, validation.py, config.json)
scripts/downstream/ — deliver stage implementation incl. real delivery (deliver_effect)
scripts/run.py — complete workflow runner
source-map.json — source provenance for both extracted stages
账户报告配方规划器
配送要求顾问