Kujiale 3D Model Upload for Openclaw

A specialized Python skill for automating and validating the multi-step Kujiale OpenAPI 3D model upload pipeline.

violalulu
v1.0.0
Apr 1, 2026
1
801
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install kujiale-3d-model-upload

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install kujiale-3d-model-upload 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 Kujiale 3D Model Upload?

The Kujiale 3D Model Upload skill is a technical automation tool designed to handle the intricate 5-step submission process required by the Kujiale (Manycore) OpenAPI. It manages everything from initial STS credential acquisition to final model submission, providing a reliable bridge between local 3D assets and the Kujiale cloud environment. This skill is optimized for developers building specialized workflows within the Openclaw Skills ecosystem, ensuring that 3D model management is both repeatable and error-free.

Built with Python, this skill addresses common infrastructure hurdles like TLS handshake failures in specific Windows environments by explicitly managing network transport behaviors. It serves as a turnkey solution for developers who need to integrate high-fidelity 3D asset pipelines into their AI coding agents or automated CI/CD processes.

Kujiale 3D Model Upload Use Cases

  • Automating the upload of 3D model ZIP packages to the Kujiale platform for interior design applications.
  • Integrating 3D asset synchronization into a broader Openclaw Skills based automation framework.
  • Conducting end-to-end smoke tests for Kujiale OpenAPI credentials and network connectivity.
  • Troubleshooting model parsing failures by isolating steps in the upload lifecycle.

How Kujiale 3D Model Upload Works

  1. Retrieves temporary Alibaba OSS STS credentials and an upload task ID from the Kujiale STS endpoint.
  2. Executes a binary PUT request to upload the 3D model ZIP package directly to the assigned OSS bucket.
  3. Triggers the server-side model parsing engine to begin validating the uploaded asset.
  4. Enters a polling loop to monitor the parse status, ensuring the model is ready for finalization.
  5. Submits the parsed model data to the tenant catalog, returning a unique brandGoodId for the asset.

Kujiale 3D Model Upload Setup

To get started with this skill in your Openclaw Skills environment, ensure you have Python 3.7+ and follow these steps:

  1. Install the necessary networking and OSS libraries:
pip install requests oss2
  1. Prepare your environment variables by copying the template:
cp .env.example .env
  1. Configure your Kujiale OpenAPI credentials:
export KUJIALE_APP_KEY="your_app_key"
export KUJIALE_APP_SECRET="your_app_secret"
  1. Perform a dry run to verify logic without making network calls:
python kujiale_upload.py --dry-run

Kujiale 3D Model Upload Data Schema & Taxonomy

The skill manages data across the following parameters and metadata fields:

Field Type Description
uploadTaskId String The unique session identifier for the upload process.
filePath String The destination path of the file within the Alibaba OSS structure.
status Integer The current state of the ZIP parse (3 indicates success).
brandGoodId String The final ID assigned to the model after successful submission.
previewImg String A URL pointing to the auto-generated preview image of the 3D model.

Kujiale 3D Model Upload Advanced Features

  • Environment-aware network configuration that disables trust_env to prevent proxy-related TLS issues.
  • Customizable polling intervals and timeouts to accommodate large 3D asset processing times.
  • Local ZIP generation for rapid connectivity testing and workflow validation.
  • Support for both CLI-based execution and programmatic integration within other Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*