配置文件设置目录

安装指南

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

什么是

配置文件设置目录是一个可执行的 Openclaw Skills 工作流，它会读取 profile_request，识别其 setting_key，计算 review_item，并创建或更新本地业务产物。该工作流在一次运行中结合识别与下游处理，因此无需手动连接各个阶段即可获得结果。
交付为可选项：配置 SMTP 或 HTTP 端点即可执行声明的外部操作并接收交付回执。未配置交付时，此技能会在本地存储业务记录，且不会联系任何外部服务。

应用场景

将收到的配置文件设置请求转换为治理审核事项。
将识别与审核工作流作为单个操作运行。
未配置外部交付时，在本地保存业务产物。
通过已配置的 SMTP 或 HTTP 交付发送或提交审核事项。
检查交付状态，包括
sent
、
delivered
、
failed
unconfigured
。

工作原理

从提供的输入 JSON 中读取上游 profile_request。
运行识别阶段以计算 setting_key。
将识别结果传递给下游阶段并计算 review_item。
在明确提供的输出目录下创建或更新本地 governance_review_item 产物。
如果已配置 SMTP 或 HTTP 交付，则执行声明的操作并返回交付回执；否则，将记录保留在本地，不联系任何外部服务。

配置指南

使用 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。对于 HTTP 注册或提交，请设置 CLAWHUB_DELIVERY_ENDPOINT，并可选设置 CLAWHUB_DELIVERY_API_KEY。必须明确提供交付目标、凭据和收件人。未提供这些信息时，工作流将在本地运行；交付错误会导致退出码非零。

数据架构

该工作流使用 JSON 输入，并生成两阶段业务结果。examples/expected.json 描述了输出结构；运行时路径和回执标识符不包含在该示例中。
数据元素 作用
profile_request 识别阶段使用的上游输入
setting_key 根据请求计算出的标识符
review_item 下游业务结果
governance_review_item 在 --output-dir 下创建或更新的本地业务产物
delivery 在适用时描述实际交付结果的回执
代码库按以下方式组织实现和来源信息：
scripts/upstream/：识别阶段实现（operation.py、validation.py 和 config.json）。
scripts/downstream/：交付阶段实现，包括 deliver_effect。
scripts/run.py：完整工作流运行器。
source-map.json：两个提取阶段的来源信息。
examples/request.json 和 examples/expected.json：示例输入和预期输出结构。

高级特性

在一个可执行工作流中结合上游识别与下游业务处理。
支持可选的 SMTP 消息交付以及 HTTP 注册或提交。
通过回执报告交付结果，包括 sent、delivered、failed 或 unconfigured 状态。
未配置交付目标时，默认仅进行本地处理。
使用明确的运行时配置设置交付目标和凭据。
包含各阶段专用的验证与配置文件，以及来源信息。

name: Profile Setting Directory description: >- Choose a profile setting key. Then it executes the downstream business step: Create a profile-setting review item. 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 Profile Setting Directory — 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 (profile_request) and computes the identification result (setting_key).
Deliver — feeds the identification result into the downstream operation, computes the business result (review_item), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: governance_review_item.
Real delivery — when a delivery target is configured, performs the declared business action (governance_review_item) 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
工作区访问权限比较器
指标趋势计算器