客户简报路由台

安装指南

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

什么是

客户简报路由台是一个单一可执行工作流，将客户联系人识别与后续业务操作结合起来。它读取 routing_request，确定 recipient，计算记录的接收人，并在你指定的目录中创建或更新业务文件。
配置好投递后，该技能可以通过 SMTP 发送消息，或通过 HTTP 端点提交记录，然后返回投递回执。若未配置投递，它将在本地运行，不会联系任何外部服务，因此这个 Openclaw Skills 工作流适用于受控且可审计的路由。

应用场景

将收到的客户简报路由给合适的联系人，并记录路由结果。
准备财务审核消息，同时在配置投递前将业务文件保留在本地。
使用明确配置的 SMTP 服务器发送消息。
将业务记录登记或提交到已配置的 HTTP 投递端点。
使用随附的示例请求测试完整的识别和投递工作流。

工作原理

从提供的输入 JSON 中读取上游 routing_request。
运行识别阶段以计算 recipient。
将识别结果传递给下游阶段，并计算 recorded_recipient。
在明确提供的输出目录下创建或更新本地业务文件。
如果配置了 SMTP 或 HTTP 投递目标，则执行声明的操作，并返回回执；结果可能为 sent、delivered、failed 或 unconfigured。
发生投递错误时，以非零进程退出码报告；未配置目标时，将记录保留在本地，不联系任何外部服务。

配置指南

使用 Python 运行工作流，并提供输入请求和明确的输出目录：
python scripts/run.py --input examples/request.json --output-dir ./workspace
若要从文件提供投递设置，请添加 --delivery-config delivery.json：
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；或者在投递配置文件中提供端点对象。投递目标、凭据和接收人详细信息均需在运行时明确提供。未配置投递时，工作流仅在本地运行。

数据架构

工作流接受上游 JSON 请求并生成两阶段结果。examples/expected.json 记录预期输出结构；该示例不包含运行时路径和回执标识符。
数据或文件 用途
routing_request 识别阶段使用的上游输入。
recipient 由识别阶段选定的联系人。
recorded_recipient 由下游业务操作记录的接收人。
delivery 在适用时描述实际投递结果的回执。
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 目录下。除非配置了投递目标，否则该技能不会联系外部服务。

高级特性

在一个可执行工作流中结合识别和下游投递。
支持可选的 SMTP 消息发送以及 HTTP 登记或提交。
通过运行时环境变量或明确指定的 --delivery-config 文件接受投递设置。
未配置投递时默认仅在本地运行，避免意外的外部调用。
尝试投递时返回报告实际结果的投递回执。
分离上游识别和下游投递实现，并将来源信息记录在
source-map.json
中。

name: Client Brief Routing Desk description: >- Select a contact for a client brief. Then it executes the downstream business step: Send a finance-review message. 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 Client Brief Routing Desk — 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 (routing_request) and computes the identification result (recipient).
Deliver — feeds the identification result into the downstream operation, computes the business result (recorded_recipient), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: controlled_email_send.
Real delivery — when a delivery target is configured, performs the declared business action (controlled_email_send) 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
本地化设置规划器
知识放置规划器