A professional-grade face detection skill utilizing the Tencent Cloud IAI API to extract precise facial coordinates, attributes, and quality metrics from images.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tencentcloud-faceid-detectface
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tencentcloud-faceid-detectface using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Tencent Cloud FaceID DetectFace?
The tencentcloud-faceid-detectface skill is a powerful integration for Openclaw Skills that connects AI agents to Tencent Cloud's robust facial recognition infrastructure. It allows for the automated analysis of images to identify human faces, providing essential data such as bounding box coordinates (X, Y, Width, Height) and sophisticated attribute detection including gender, age, and even emotional expression.
This skill is designed for developers who need reliable facial metadata for security, user profiling, or digital asset management. By supporting both local file uploads (with automatic Base64 conversion) and direct URL inputs, it offers maximum flexibility for cloud-based or local-first AI workflows.
Tencent Cloud FaceID DetectFace Use Cases
- Detecting the presence and count of human faces within a single image (up to 120 faces).
- Extracting facial attributes such as age, gender, beauty scores, and the presence of masks or glasses.
- Evaluating the quality of face images for database entry, checking for blurriness, lighting, and occlusions.
- Automating image cropping or centering by obtaining precise facial coordinates.
- Identifying head orientation (Pitch, Roll, Yaw) for pose analysis.
How Tencent Cloud FaceID DetectFace Works
- The skill receives an image input via a local file path, a Base64 encoded string, or a public URL.
- It authenticates with the Tencent Cloud API using provided SecretID and SecretKey environment variables.
- The image is processed through the IAI DetectFace interface based on specified parameters like maximum face count and required attributes.
- The API returns a structured JSON payload containing facial coordinates, attribute details (if requested), and quality scores.
- The AI agent parses this data to perform downstream tasks or report findings to the user.
Tencent Cloud FaceID DetectFace Setup
Prerequisites
- Python 3.6+
- Tencent Cloud API Secret ID and Secret Key
Installation
First, install the required SDK:
pip install tencentcloud-sdk-python
Environment Configuration
Set your credentials as environment variables:
export TENCENTCLOUD_SECRET_ID="your_secret_id"
export TENCENTCLOUD_SECRET_KEY="your_secret_key"
Tencent Cloud FaceID DetectFace Data Schema & Taxonomy
The skill returns a comprehensive JSON object detailing the detected faces and image metadata:
| Key | Description |
|---|---|
FaceCount |
Total number of faces detected in the image. |
FaceInfos |
An array containing location (X, Y, Width, Height) and attributes for each face. |
FaceAttributesInfo |
Nested data including Gender (0-100), Age, Expression, and Beauty scores. |
FaceQualityInfo |
Metrics for Score, Sharpness, Brightness, and Completeness. |
ImageWidth/Height |
Dimensions of the processed image. |
Tencent Cloud FaceID DetectFace Advanced Features
- Multi-face detection support for up to 120 individual faces in a single request.
- Rotation detection (NeedRotateDetection) to handle images with non-standard orientations.
- High-precision quality filtering, recommending images with a score > 80 for database storage.
- Detailed facial accessory detection, specifically tracking masks and glasses for compliance or safety monitoring.
- Comprehensive head pose estimation using Pitch, Yaw, and Roll angles.
SKILL.md
Loading
Related Openclaw Skills
Health Data Reviewer
A non-diagnostic health data organizer that synthesizes wearable exports and personal logs into structured summaries.
QR Code Generation and Recognition
A technical skill to generate customized, template-based QR codes and recognize data from images using the JisuAPI.
Retention Drop Checker
A diagnostic tool designed to pinpoint why short-form videos lose viewers and provide actionable script improvements.
Baidu ERNIE 5.0 Integration
A comprehensive integration guide for connecting Baidu ERNIE 5.0 thinking models to Clawdbot using the Qianfan platform.
Code Documentor Skill
An automated documentation engine that generates professional READMEs, API references, and code comments across multiple programming languages.
Task Progress Report
A specialized skill for tracking and reporting the status of long-duration AI agent tasks through automated summaries and detailed markdown logs.
Featured*
