区域发布规划器

安装指南

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

什么是

区域发布规划器是一套可执行的业务工作流，用于将 rollout_request 转换为计算出的 deployment_region、下游的 recorded_region，以及本地的 deployment_brief_record 工件。它将识别和传送阶段整合在一个可运行的技能中，适用于可重复的部署规划和区域发布操作。
作为 Openclaw Skills 的一部分，它默认支持仅本地执行，同时通过 SMTP 或 HTTP 注册端点提供可选的真实传送功能。存在传送配置时，工作流会执行声明的操作并返回回执；否则不会联系任何外部服务，并将业务结果保留在本地。

应用场景

将传入的发布请求转换为选定的部署区域。
生成本地部署简报记录，用于审计或下游处理。
通过配置的 HTTP 端点注册或提交部署区域记录。
通过配置的 SMTP 服务器发送发布结果。
在没有传送目标或凭据时运行安全的仅本地测试。
将确定性的区域发布工作流集成到 Openclaw Skills 自动化中。

工作原理

运行器从提供的输入 JSON 文件中读取上游 rollout_request。
identify 阶段验证请求并计算 deployment_region 结果。
下游 deliver 阶段使用该结果并计算 recorded_region。
工作流在明确提供的输出目录下创建或更新 deployment_brief_record。
如果 SMTP 配置可用，该技能可以使用配置的主机和邮件设置发送业务消息。
如果配置了 HTTP 传送端点，该技能可以注册或提交记录，并可选择使用 API 密钥进行身份验证。
运行器返回完整的两阶段输出，其中包括 delivery 回执，其状态可能为 sent、delivered、failed 或 unconfigured。
传送错误会产生非零进程退出码，而未配置传送目标时，工件会保留在本地且不会发出外部请求。

配置指南

确保 Python 可用，并从技能目录运行工作流。
提供上游请求 JSON 文件和输出目录。
运行默认的仅本地工作流：
python scripts/run.py --input examples/request.json --output-dir ./workspace
要启用 SMTP 传送，请在运行前配置主机和任何可选设置：
export CLAWHUB_SMTP_HOST="smtp.example.com"
export CLAWHUB_SMTP_PORT="587"
export CLAWHUB_MAIL_FROM="rollouts@example.com"
export CLAWHUB_SMTP_USERNAME="username"
export CLAWHUB_SMTP_PASSWORD="password"
python scripts/run.py --input examples/request.json --output-dir ./workspace
要启用 HTTP 注册或提交，请配置端点和可选的 API 密钥：
export CLAWHUB_DELIVERY_ENDPOINT="https://example.com/api/deployments"
export CLAWHUB_DELIVERY_API_KEY="your-api-key"
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_host、smtp_port 和 from_addr 的 SMTP 对象，也可以包含用于 HTTP 传送的端点对象。请将凭据和收件人保存在运行时环境或明确的配置中，而不要硬编码。使用 examples/expected.json 查看预期的输出结构；运行时路径和回执标识符不包含在该示例中。

数据架构

该工作流围绕上游请求、两个计算出的业务结果、一个本地工件和可选的传送回执组织数据。
数据元素 作用
rollout_request 从提供的请求 JSON 文件读取的上游输入。
deployment_region 根据发布请求计算出的识别阶段结果。
recorded_region 从已识别区域派生出的下游业务结果。
deployment_brief_record 在 --output-dir 下创建或更新的本地业务工件。
delivery 描述实际传送状态的回执，例如 sent、delivered、failed 或 unconfigured。
仓库结构：
scripts/run.py — 完整的工作流运行器。
scripts/upstream/operation.py — 上游识别实现。
scripts/upstream/validation.py — 上游输入验证。
scripts/upstream/config.json — 上游阶段配置。
scripts/downstream/ — 下游传送实现，包括用于实际传送的 deliver_effect。
source-map.json — 两个提取阶段的来源映射。
examples/request.json — 随附的上游输入示例。
examples/expected.json — 完整两阶段输出结构示例。
workspace/ 或其他用户选择的输出目录 — 生成的本地业务工件位置。
传送元数据在运行时通过 CLAWHUB_SMTP_HOST、可选的 SMTP 变量、CLAWHUB_DELIVERY_ENDPOINT、可选的 API 密钥或明确的 --delivery-config 文件提供。没有传送元数据时，该技能会在本地记录结果，不会联系外部服务。

高级特性

单工件执行结合了识别、业务计算、本地持久化和可选传送。
同时支持 SMTP 消息传送以及 HTTP 注册或提交操作。
为传送主机、端口、发送者身份、凭据、端点和 API 密钥提供环境变量配置。
接受明确的 --delivery-config 文件，用于可重复的部署专用配置。
默认使用仅本地模式，减少开发和测试期间意外产生外部副作用的风险。
返回结构化传送回执，以区分成功、失败和未配置结果。
使用非零退出码，使 shell 脚本和自动化流水线能够发现传送失败。
分离上游和下游实现，同时通过
source-map.json
保留来源信息。
适用于需要可审计工件和受控实际操作的 Openclaw Skills 工作流。

name: Regional Rollout Planner description: >- Select a rollout region. Then it executes the downstream business step: Register a deployment region. 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 Regional Rollout 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 (rollout_request) and computes the identification result (deployment_region).
Deliver — feeds the identification result into the downstream operation, computes the business result (recorded_region), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: deployment_brief_record.
Real delivery — when a delivery target is configured, performs the declared business action (deployment_brief_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
批次分配规划器
发布分支规划器