A high-performance AI skill to generate high-fidelity 3D models from text or image inputs using Tencent Cloud Hunyuan 3D technology.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hy-3d-generation
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 hy-3d-generation 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 Hunyuan 3D Generation?
This skill leverages the Tencent Cloud Hunyuan 3D 3.0 and 3.1 models to enable AI agents to create complex 3D assets automatically. It supports a wide range of generation types including Normal, LowPoly, Geometry, and Sketch, providing versatile outputs for developers using Openclaw Skills.
The skill handles the entire lifecycle from job submission to result polling, ensuring high-quality meshes with PBR materials and customizable polygon counts. It is designed for zero-interaction execution, allowing AI agents to autonomously produce 3D content for games, VR/AR, and industrial design.
Tencent Cloud Hunyuan 3D Generation Use Cases
- Generating 3D game assets from simple text descriptions or concept art.
- Creating rapid prototypes for product designs using sketch-to-3D capabilities.
- Automating the conversion of 2D images into multi-view 3D models for VR/AR applications.
- Developing AI-driven design tools that require high-precision mesh generation and intelligent topology.
How Tencent Cloud Hunyuan 3D Generation Works
- The AI agent identifies a request for 3D model generation based on text or image input.
- The agent executes the main script to submit a task to the Tencent Cloud Hunyuan 3D API endpoint.
- The system automatically handles dependency installation and credential verification from environment variables.
- The skill polls the job status at regular intervals until the 3D model generation is complete, usually within 1 to 5 minutes.
- The agent retrieves the signed URLs for the generated assets and presents the final 3D files and preview images to the user.
Tencent Cloud Hunyuan 3D Generation Setup
To use this skill within the Openclaw Skills framework, you must configure your Tencent Cloud credentials:
- Enable the Hunyuan 3D service in the Tencent Cloud 3D Vision console.
- Obtain your API Key (SecretId and SecretKey) from the Tencent Cloud CAM console.
- Set the following environment variables:
export TENCENTCLOUD_SECRET_ID="your_secret_id"
export TENCENTCLOUD_SECRET_KEY="your_secret_key"
- The skill will automatically install the necessary tencentcloud-sdk-python on its first execution.
Tencent Cloud Hunyuan 3D Generation Data Schema & Taxonomy
The skill manages inputs and outputs using a structured JSON format to ensure compatibility with various Openclaw Skills workflows.
Input Parameters
- prompt: Text description (max 1024 chars).
- image_url / image_base64: 2D source image.
- model: Choice between version 3.0 or 3.1.
- face_count: Target polygon count (10,000 to 1,500,000).
Output Structure
| Field | Type | Description |
|---|---|---|
| job_id | String | Unique task identifier |
| status | String | Current state (success/fail/running) |
| result_files | Array | List of generated file objects (type, url, preview_image_url) |
Note: All generated file URLs are valid for 24 hours.
Tencent Cloud Hunyuan 3D Generation Advanced Features
- Multi-view image support allowing for precise reconstruction from multiple angles (left, right, top, etc.).
- PBR (Physically Based Rendering) material generation for realistic lighting and textures.
- Intelligent topology options including LowPoly mode with triangle or quadrilateral mesh support.
- Asynchronous job management with separate submission and polling scripts for long-running tasks.
- Support for multiple industrial formats including GLB, OBJ, STL, USDZ, and FBX.
SKILL.md
Loading
Related Openclaw Skills
Todoist Task Visibility
A robust Todoist integration for AI agents to create, track, and update tasks with real-time status visibility and progress logging.
iOS View Generator
An AI-powered developer tool that converts UI screenshots into structured, lazy-loaded Objective-C code for iOS development.
News Article Generator
An automated tool that transforms Google search results into structured Markdown articles with downloaded image assets.
Multi-Agent Blueprint
A production-tested architecture for building and orchestrating teams of 5-10 specialized AI agents with cross-agent routing.
Tencent Cloud HunYuan AI Art Generator
A professional AI image generation skill leveraging the Tencent Cloud HunYuan large model for high-quality text-to-image and image-to-image synthesis.
Tencent Cloud Image Face Fusion
A professional-grade face fusion skill that seamlessly merges user faces with template images using high-performance Tencent Cloud AI.
Featured*
