客户记录字段准备

安装指南

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

什么是

客户记录字段准备是一种可执行的两阶段业务工作流，它读取上游 record_note，计算出 record_field，并使用该结果组装 export_row。它会将生成的业务产物写入明确指定的输出目录下的本地位置。
配置交付后，该技能还可以通过 SMTP 或 HTTP 端点执行声明的操作，并返回交付回执。若未配置交付设置，它将在本地运行，不会联系任何外部服务，因此此 Openclaw Skills 工作流适用于受控的记录准备和报告导出。

应用场景

根据上游
record_note
准备客户记录字段。
根据识别出的字段组装报告导出行。
为下游业务流程创建或更新本地报告产物。
通过明确配置的交付目标发送已配置的消息，或登记、提交记录。
未配置外部交付时，在本地运行工作流。

工作原理

读取并验证上游输入文件，例如 examples/request.json。
运行识别阶段，根据 record_note 计算 record_field。
将识别结果传递给下游阶段，并计算 export_row。
在必需的 --output-dir 下创建或更新本地业务产物。
如果配置了 SMTP 或 HTTP 交付端点，则执行声明的交付操作并返回回执，指出结果，例如 sent、delivered、failed 或 unconfigured。
以非零退出状态报告交付错误；未配置交付时，仅在本地执行操作，不发送任何外部请求。

配置指南

使用 Python 运行工作流，并提供输入文件和明确的输出目录：
python scripts/run.py --input examples/request.json --output-dir ./workspace
若要提供交付配置文件，请添加 --delivery-config：
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，或在交付配置文件中提供端点对象。交付目标、凭据和收件人必须在运行时明确提供。

数据架构

该工作流处理上游输入并生成两阶段结果：
阶段或产物 作用
record_note 由识别阶段读取的上游输入。
record_field 根据输入计算出的识别结果。
export_row 为报告组装的下游业务结果。
本地业务产物 在明确指定的 --output-dir 下创建或更新；效果为 local_reporting_export_append。
delivery 回执 尝试交付时包含；报告实际结果，例如 sent、delivered 或 failed。
仓库文件包括：用于捆绑输入的 examples/request.json、用于展示预期两阶段输出结构的 examples/expected.json、用于识别阶段实现和配置的 scripts/upstream/、用于交付阶段实现的 scripts/downstream/、工作流运行器 scripts/run.py，以及用于记录阶段来源的 source-map.json。预期输出不包含运行时路径和回执标识符。

高级特性

在一个可执行工作流中整合识别、业务结果计算、本地产物创建和可选交付。
支持使用环境变量或交付配置文件进行 SMTP 消息交付。
支持通过已配置的端点和可选 API 密钥进行 HTTP 登记或提交。
未配置交付目标时默认仅在本地运行，避免调用外部服务。
返回包含报告结果的交付回执，并在发生错误时以非零状态退出。
包含彼此分离的上游和下游阶段实现，以及记录来源信息的 source map。

name: Customer Record Field Prep description: >- Prepare a customer record field. Then it executes the downstream business step: Assemble a reporting export row. 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 Customer Record Field Prep — 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 (record_note) and computes the identification result (record_field).
Deliver — feeds the identification result into the downstream operation, computes the business result (export_row), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_reporting_export_append.
Real delivery — when a delivery target is configured, performs the declared business action (local_reporting_export_append) 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
推荐交接读取器

Calendar Handoff Reader