安装指南

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

什么是

Face Transform 是一项 OpenClaw 技能，可通过图像 URL 使用 AceDataCloud 的 Face API 套件。其七个 API 支持人脸检测（每张检测到的人脸可提供 90 多个关键点）、人像美化、年龄和性别变换、人脸交换、卡通风格处理以及活体检测。
对于开发者，此技能为这些人脸处理工作流提供了实用接口，无需自定义 API 集成。配置 AceDataCloud 服务密钥，向相应端点提交请求，并在工作流中使用返回结果。这些 Openclaw Skills 依赖外部图像处理 API；目前这些端点处于 Alpha 阶段，因此接口可能会发生变化。

应用场景

提取面部特征点，并分析图像中的一张或多张人脸。
应用人像效果，例如磨皮、美白、瘦脸和放大眼睛。
为每张人脸指定目标年龄，预览变老或变年轻后的样貌。
使用文档规定的性别值变换面部性别特征。
将目标图像中的人脸替换为源图像中的人脸。
将人像转换为卡通风格图像。
检查人脸图像看起来是否来自真人，而非印刷照片或屏幕照片。

工作原理

安装此技能，并通过 OpenClaw Gateway 环境提供 AceDataCloud 服务 API 密钥。
选择与任务相符的端点，例如 POST /face/analyze 或 POST /face/cartoon。
提交所需的图像 URL 及端点专属参数。人脸交换需要分别提供源图像和目标图像的 URL。
API 处理请求并返回结果。默认情况下，Face API 会同步返回结果；人脸交换还支持通过 callback_url 可选地使用 webhook 交付结果。
对于人脸分析，请检查响应中的面部特征点坐标数组。对于变换，请根据应用需要使用返回结果。

配置指南

安装官方技能，并确认 ClawHub 发布者为 @acedatacloud。
登录 AceDataCloud Applications，打开 General application，确认 Face Transform 的访问权限、余额和当前价格。复制服务 API 密钥，或在 Manage Keys 下创建单独的密钥。请勿将 platform-... 管理令牌用作服务密钥。
如果 API 访问受到限制，请允许工作流所需的路由。Quick Start 示例需要 /face/analyze。
将服务密钥添加到 OpenClaw Gateway 主机上的 ~/.openclaw/.env，然后重启 Gateway 并开启新会话。若要直接在终端测试，请在该 shell 中导出密钥。

Add this line to ~/.openclaw/.env on the Gateway host:

ACEDATACLOUD_API_TOKEN=your_api_key_here

Or set it for a direct terminal test:

export ACEDATACLOUD_API_TOKEN="your_api_key_here"

Quick Start: detect faces and retrieve keypoints

curl -X POST https://api.acedata.cloud/face/analyze
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN"
-H "Content-Type: application/json"
-d '{"image_url":"https://cdn.acedata.cloud/lrbtcn.jpg"}' 切勿将 API 密钥放入提示词或提交 .env 文件。如果工作流返回任务 ID，请查询同一任务的进度，而不要再次提交相同的计费请求。

数据架构

请求使用发送到 AceDataCloud 端点的 JSON 请求体。大多数路由需要 image_url；人脸交换则需要 source_image_url 和 target_image_url。
Endpoint 必填字段 可选字段和行为
POST /face/analyze image_url mode（0 表示所有人脸，1 表示最大的人脸）、face_model_version（建议使用 3.0）、need_rotate_detection（0 或 1）。返回面部关键点数组，例如 nose、mouth、left_eye、right_eye、眉毛和 contour，坐标格式为 {x, y}。
POST /face/beautify image_url smoothing、whitening、face_lifting 和 eye_enlarging，每项均可设置为 0 到 100。
POST /face/change-age image_url、age_infos age_infos 是由 { "age": number } 条目构成的数组，每张人脸对应一项。
POST /face/change-gender image_url、gender_infos gender_infos 是由 { "gender": 0 or 1 } 条目构成的数组；0 表示男性变女性，1 表示女性变男性。条目可以包含 face_rect。
POST /face/swap source_image_url、target_image_url 可选的 webhook 交付参数 callback_url，以及以秒为单位的 timeout（默认值为 120）。
POST /face/cartoon image_url 将人像转换为动画或卡通风格。
POST /face/detect-live image_url 检查人脸图像看起来是否描绘了真人。
技能文档未指定本地输出目录或持久化文件格式；结果由 API 响应提供。元数据将此技能标识为 face-transform，发布者/作者为 acedatacloud，版本为 1.0，许可证为 Apache-2.0。

高级特性

人脸分析可为每张检测到的人脸返回 90 多个关键点，并支持多张人脸；使用
mode
分析所有人脸或仅分析最大的人脸。
人脸美化提供独立的 0–100 控件，可调节磨皮、美白、瘦脸和放大眼睛效果。
年龄和性别变换接受按人脸区分的数组，因此可以为图像中的每张人脸分别提供参数。
人脸交换会区分源人脸和目标图像，并支持通过
callback_url
可选地异步使用 webhook 交付结果。
分析支持模型版本设置以及可选的旋转人脸检测。
可通过 AceDataCloud 的 Allowed APIs 设置限制 API 访问；请启用工作流所需的每个路由。
所有 API 目前均处于 Alpha 阶段。为获得最佳效果，请使用清晰可见、正面朝向的人脸，并在提交请求前确认当前价格和访问权限。

name: face-transform description: Analyze and transform faces via AceDataCloud API. Use when detecting face keypoints, beautifying portraits, aging/de-aging faces, swapping genders, replacing faces between photos, creating cartoon avatars, or detecting liveness. Provides 7 specialized face APIs. license: Apache-2.0