数据清理

安装指南

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

什么是

Data Cleaning 是一款 OpenClaw 技能，可用于检查和清理 CSV 和 XLSX 文件，且不会在未告知的情况下更改数据。在结构检查期间，它会保留原始行号、字面值、空行和公式状态，然后在执行前通过更改示例和影响计数预览拟议规则。
该技能专为可审计、可复现的工作流程而设计，要求用户在应用更改前确认已锁定的预览。Openclaw Skills 用户可以使用它清理电子表格，同时将含义不明确的日期、公式和类型转换交由人工明确审核。

应用场景

在决定需要清理哪些内容之前，检查 CSV 或 XLSX 文件。
应用明确指定的清理规则，并在更改前审核受影响的行和单元格。
当日期格式、公式或类型转换存在歧义或风险时，暂停并请求澄清。
根据相同的文件快照和规则生成可复现的清理结果。
提供清理后的文件，以及审计摘要、实际影响计数和未解决的风险。

工作原理

使用 clean.inspect 检查提供的文件，保留原始行号、字面值、空行和公式状态等结构细节。
定义明确、结构化的清理规则。如果规则含糊不清，或可能影响日期、公式或数据类型，则停止并向用户请求澄清。
使用 clean.preview 生成预览，显示规则、更改示例和预估影响计数。
向用户展示预览并等待明确确认。按原样使用平台签发的 confirmation_token；切勿自行构造或修改它。
使用 clean.execute 提交已确认的操作，并以平台提供的确定性结果作为计数、摘要和校验和的依据。
轮询异步任务，直到任务进入终止状态，然后交付文件、审计摘要、实际影响和任何剩余风险。仅向当前用户提供私有下载链接。

配置指南

在 AI Skills 平台创建账户或登录。
打开产品管理并启用 Data Cleaning。
前往 API Key 管理，为已启用的产品创建密钥。
在 OpenClaw 中安装该技能，并确保 curl 可用，这是技能元数据的要求。
配置所需的 API 密钥并重启 Gateway：
openclaw config set env.DATA_CLEANING_API_KEY "your-platform-api-key"
openclaw gateway restart
AI_SKILLS_API_URL 是用于自定义 API 根地址的可选环境变量。有关任务特定的详细信息，请参阅 API 密钥与定价指南和 HTTP 请求、上传与任务轮询指南。

数据架构

该技能适用于 CSV 和 XLSX 输入，并围绕源文件、明确规则、可审核的预览、用户确认以及生成的任务输出组织每个清理生命周期。所提供的技能文档未指定确切的 API 负载字段或输出文件名。

工作原理

源文件 要检查和清理的 CSV 或 XLSX 文件；结构检查会保留原始行号、字面值、空行和公式状态。
清理规则 定义所请求更改的明确、结构化指令；如有歧义，则需要请求澄清。
预览 执行前供审核的规则、更改示例和影响计数。
confirmation_token 由平台返回的令牌，仅在用户明确批准预览后提交。
任务元数据 用于轮询任务直至完成的异步任务状态和源任务关联信息。
幂等性数据 当网络结果不确定时，重复使用相同的 Idempotency-Key、UUID 和完全相同的输入，以防止重复执行。
结果和文件 由平台计算的输出、审计摘要、实际影响计数、未解决的风险，以及提供给当前用户的私有下载链接。
如果源任务在七天后失效，请重新检查文件。不要用本地重新计算的值替代平台返回的计数、规则摘要或校验和。

高级特性

先预览再执行的流程将检查、拟议更改和确认执行分为
clean.inspect
、
clean.preview
clean.execute
阶段。
通过平台签发的
confirmation_token
强制执行人工审批；代理不得编造或更改该令牌。
确定性的平台结果可保留权威的影响计数、规则摘要和校验和。
异步任务会持续轮询，直到进入终止状态，并可沿其源任务链继续执行。
当网络结果不确定时，幂等重试会重复使用相同的
Idempotency-Key
、UUID 和完全相同的输入。
对相同文件快照应用相同规则，以支持结果可复现。
遇到含义不明确的日期、公式和类型转换时，会请求澄清，而不是猜测并更改。
私有文件下载链接仅提供给当前用户。

name: data-cleaning description: "使用场景: 用户要求检查并按明确规则清洗 CSV/XLSX，先预览变更再确认执行时。" license: MIT-0