What makes MotuArt Color Engine notable?

1.7K downloads. Trust evidence available

How should MotuArt Color Engine be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

MotuArt Color Engine

AI portrait grading, skin-tone correction, identity-preserving smoothing, mask export, approved clothing replacement, professional AI Headshots generation, and ID/passport/headshot/avatar production through the MotuArt Color Engine HTTP API. Use for retouching portraits, normalizing skin tone, expor

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.7k

Updated

Oct 10, 2026

Version

1.0.9

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.7K downloadsadoption · observed Oct 10, 2026
Latest release: 1.0.9release · observed Aug 12, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17795ep8yhs009f8px48emmp98a2mxc:motu-color-engine

Install using `clawhub skill install s17795ep8yhs009f8px48emmp98a2mxc:motu-color-engine` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/chancipher/motu-color-engine before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-chancipher-motu-color-engine/snapshot"

Documentation

CLAWHUB

151,425 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: motu-color-engine
description: AI portrait grading, skin-tone correction, identity-preserving smoothing, mask export, approved clothing replacement, professional AI Headshots generation, and ID/passport/headshot/avatar production through the MotuArt Color Engine HTTP API. Use for retouching portraits, normalizing skin tone, exporting mattes, replacing clothing, preparing identity references and generating professional headshot candidates, cropping to ID/passport/visa specs, replacing ID-photo backgrounds, checking compliance, optimizing uploads, or creating print sheets. Triggers include portrait grading, skin tone, retouch, skin mask, outfit replacement, AI headshots, professional headshot, business portrait, corporate portrait, LinkedIn photo, ID photo, passport photo, visa photo, background swap, print sheet, 调色, 肤色, 磨皮, 蒙版, 人像调色, AI形象照, 职业形象照, 商务形象照, 企业头像, 换装, 证件照, 裁剪, 换底, 合规检查, 排版, 一寸, 二寸.
---

# Motu Color Engine

Use Motu Color Engine to process portrait images through the hosted HTTP API. Prefer the bundled scripts in `scripts/` over hand-written `curl` calls unless the user explicitly needs raw API details.

The engine preserves identity. Do not describe it as slimming, reshaping, face swapping, or changing facial structure. Skin smoothing only softens pores and blemishes inside detected skin regions. Cropping repositions and pads to a spec; it never stretches or compresses the face.

## Setup

- Require `curl` and `python3`.
- Read `MCE_API_BASE` from the environment; default is `https://mce.motu.art`.
- Read `MCE_API_KEY` from the environment; send it only as `X-API-Key`.
- If the key is missing, direct the user to `https://mce.motu.art/account` (English: `/en/account`) to sign in by email and create one. Ask them to export it securely in their own environment; do not ask them to paste the full key into chat.
- Never hard-code, print, log, commit, or expose API keys in browser/client code. The full key is shown once and can be rotated or revoked from the account page.
- Request only the scopes needed: `catalog:read` for portrait/ID discovery, `portrait:process` for grading/smoothing/masks, `id-photo:process` for ID-photo workflows, `outfit:process` for outfit replacement, and `headshot:process` for private AI Headshots projects and generation. An ID package with an outfit needs both `id-photo:process` and `outfit:process`.
- Processing calls consume account credits; catalog discovery does not. Surface `402 insufficient_credits` instead of retrying.
- Check service health with `curl -sS "${MCE_API_BASE:-https://mce.motu.art}/v1/health"` when diagnosing connectivity.

## Choose The Workflow

- Use `scripts/grade.sh` when the user wants color grading, skin-tone correction, a film/commercial look, or grading plus optional crop.
- Use `scripts/smooth.sh` when the user wants smoothing only with no color or white-balance change.
- Use `scripts/portrait-lighting.sh` when the user wants visibly more dimensional portrait lighting, a br

_meta.json

{
  "ownerId": "kn7b98pvjtsm6a4bw8gd87ttbs8a3ycc",
  "slug": "motu-color-engine",
  "version": "1.0.9",
  "publishedAt": 1786518916479
}

references/api.md

# MotuArt Color Engine — API reference

Base URL: `$MCE_API_BASE` (default `https://mce.motu.art`).
Auth: create a key at `https://mce.motu.art/account` (English: `/en/account`), then send
`X-API-Key: $MCE_API_KEY` (or `Authorization: Bearer $MCE_API_KEY`) on private and
processing endpoints. `/v1/health` and public Headshots discovery endpoints do not need
a key. The full key is displayed once; store it securely and rotate or revoke it from
the account page if exposed.

Scopes:
- `catalog:read` — styles, crop specs and approved outfits.
- `portrait:process` — process, smooth and mask.
- `id-photo:process` — crop, id-pack, id-check, optimize and print-sheet.
- `outfit:process` — standalone outfit replacement. Also required in addition to
  `id-photo:process` or `portrait:process` when those requests include `outfit_id`.
- `headshot:process` — private AI Headshots projects, reference preparation,
  generation, candidates, post-processing, and exports. See `headshots-api.md`.

Successful processing calls consume account credits; catalog requests do not. A `402`
response uses `detail.code="insufficient_credits"` and includes `required`, `available`,
and whether the request included outfit replacement.

## GET /v1/health
Liveness/version. No key required.

## GET /v1/styles
Returns `{ styles: [{id, name, kind, name_zh, ...}], composite_separator, bases, flavours }`.
`kind` is `base` or `flavour`. Combine as `<flavour><composite_separator><base>`
(default separator `@`), e.g. `kodak_gold@motu_korean_id`.

## POST /v1/process  (multipart/form-data)
Grade an image. Fields:
- `file` (required) — image upload (JPG/PNG/WebP, ≤ ~15 MB).
- `style` — style id (default `motu_korean_id`).
- `strength` — look intensity, default `1.0` (0–~1.5).
- `smooth_strength` — optional M15 pro skin smoothing, `0`–`1`. Omitted/`0` leaves skin
  texture untouched (default). Softens pores/blemishes only; never reshapes the face.
- `smooth_texture_retain` — optional, `0`–`1` (default `0.35`), how much natural
  texture to keep on top of the smoothing. Only used when `smooth_strength` > 0.
- `portrait_lighting_style` — optional M17 light-sculpting preset:
  `natural_dimension`, `soft_luminous`, or `studio_definition`. Omit it and all
  `portrait_lighting_*` fields to keep the existing grading output unchanged.
- `portrait_lighting_strength` — optional `0`–`1`; omitted uses the selected preset's
  calibrated strength. Supplying this without a style uses `natural_dimension`.
- `portrait_lighting_face_light_balance`, `portrait_lighting_subject_separation`,
  `portrait_lighting_local_contrast`, `portrait_lighting_skin_protection`, and
  `portrait_lighting_highlight_protection` — optional advanced overrides, each `0`–`1`.
- `output_format` — `png` (default) | `jpeg` | `webp`.
- `quality` — 1–100 for lossy formats (default 90).
- `max_long_edge` — cap working long edge (default 1024; server ceiling applies).
- `mask` — `true` to also return a mask inline (base64).
- `mask_kind` — mask

references/crop-specs.md

# MotuArt Color Engine — crop specs overview (M16 purpose crop)

The live catalog is authoritative — run `scripts/crop-specs.sh` (or `GET
/v1/crop/specs`) to list current ids/sizes. This is a quick orientation to the
three categories and the shipping specs.

## Three categories

- **id_photo** — official ID/passport/visa/license photo standards. Fixed pixel size
  + physical `width_mm`/`height_mm` + `dpi` (embedded on save, so exports print at the
  right physical size). Most declare a `bg_colors` palette for background replacement
  (换底) since these documents require a specific solid background. ID-photo specs may
  also include `compliance`, `upload`, and `print` metadata used by `id-pack`,
  `id-check`, upload optimization, and print-sheet layout.
- **portrait** — professional/editorial portrait framings (headshot to full body).
  Pixel-only, no print standard, no background palette (original background kept).
- **avatar** — square social-avatar framing. Pixel-only, no background palette.

Pass only a `spec` id — the engine auto-detects the face/head and positions it to
that spec's `head_ratio` (crown-to-chin as a fraction of output height) and margins;
you never draw a crop box by hand.

## id_photo specs (fixed background palette, mostly white/blue/red)

| id | Use | Size | Print |
| --- | --- | --- | --- |
| `one_inch` | 简历/证件 general 1-inch | 295×413px | 25×35mm@300dpi |
| `two_inch` | Standard 2-inch | 413×579px | 35×49mm@300dpi |
| `small_two_inch` | Small 2-inch (passport/visa common) | 413×531px | 35×45mm@300dpi |
| `small_one_inch` | Driver's license / some certificates | 260×378px | 22×32mm@300dpi |
| `big_two_inch` | Diploma (blue background common) | 413×626px | 35×53mm@300dpi |
| `id_card_cn` | CN ID card / social security card (GA 461) | 358×441px | 26×32mm@350dpi |
| `shanghai_compulsory_education_cn` | 上海义务教育入学免冠证件照 | 272×354px | 20×26mm@350dpi |
| `college_graduation_image_cn` | 大学生毕业图像信息采集免冠证件照 | 480×640px | 41×54mm@300dpi |
| `national_k12_student_status_cn` | 全国中小学生学籍电子版照片 | 358×441px | 26×32mm@350dpi |
| `passport_cn` | CN passport / HK-Macau-Taiwan permit / CN visa | 390×567px | 33×48mm@300dpi |
| `us_visa` | US visa 2×2 | 600×600px | 51×51mm@300dpi |
| `schengen_visa` | Schengen/UK visa | 413×531px | 35×45mm@300dpi |
| `japan_visa` | Japan visa | 531×531px | 45×45mm@300dpi |
| `canada_visa` | Canada visa/immigration | 590×826px | 50×70mm@300dpi |
| `china_visa` | China visa printed photo | 390×567px | 33×48mm@300dpi; digital upload uses a separate crop |
| `us_passport_printed` | US passport (paper application) | 600×600px | 51×51mm@300dpi |
| `japan_passport` | Japan passport | 413×531px | 35×45mm@300dpi |
| `canada_passport_printed` | Canada passport (paper application) | 590×826px | 50×70mm@300dpi |
| `uk_passport_printed` | UK printed passport photo | 413×531px | 35×45mm@300dpi |
| `uk_visa` | UK visa or permission digital photo | 600×750px minimum | JPG/JPEG, 50KB–6MB |
| `malaysia_passport_photo` / `malaysia_evisa`

references/headshots-api.md

# AI Headshots API

Use this reference for the staged professional-headshot workflow. Use
`scripts/headshots.sh` for normal operation instead of assembling requests manually.

## Authentication and ownership

Send an account API key with the `headshot:process` scope:

```http
X-API-Key: $MCE_API_KEY
```

`Authorization: Bearer $MCE_API_KEY` is also accepted. The account user becomes the
owner of every project and private asset. Another account receives a not-found response
instead of access to that data. Server environment keys are not sufficient without a
user identity.

These discovery endpoints are public:

- `GET /v1/headshots/catalog?locale=en`
- `GET /v1/headshots/showcases?locale=en`
- `GET /v1/headshots/showcases/{showcase_id}?locale=en`
- `GET /v1/headshots/scenes/{scene_id}?locale=en`

Supported published locales are `en`, `zh-CN`, `ja-JP`, `ko-KR`, `th-TH`, `vi-VN`,
`ms-MY`, `id-ID`, and `fil-PH`. Short content-language aliases are accepted where documented.

## Workflow

Keep the identifiers returned by each stage:

```text
project_id -> preview_id -> reference_id -> job_id -> candidate_id
                                                   -> render_id -> export_id
```

Do not submit generation before the user has reviewed and confirmed the reference
preview. Generation consumes credits; preparation and discovery do not.

## Prepare a reference

### Create or restore a project

`POST /v1/headshots/projects` is multipart form data:

- `image` — required JPG, PNG, or WebP, subject to the service upload limit.
- `scene_id` — optional live scene id.
- `entry_source` — normally `direct_upload`, or `scene_gallery` when a scene led to the upload.

Do not combine `entry_source=direct_upload` with `scene_id`. Use `scene_gallery` when sending
a scene id; `scene_gallery` requires one.

Use `POST /v1/headshots/projects/{project_id}/source` with an `image` part to replace
the source while preserving the project history. Use `GET /v1/headshots/projects/{id}`
to restore a project, `GET /v1/headshots/projects` to list projects, and `DELETE` on the
project resource to remove it and its private derivatives.

### Inspect the source

`POST /v1/headshots/projects/{project_id}/inspect` returns practical eligibility:

```json
{"eligible": true, "status": "ready", "reasons": [], "warnings": []}
```

Stop when `eligible` is false. Surface warnings before creating a preview.

Set the garment catalog preference with
`POST /v1/headshots/projects/{project_id}/garment-preference`:

```json
{"garment_preference": "female"}
```

The value is `male`, `female`, or `null` to clear it. This selects catalog variants; it
does not infer or alter gender identity.

### Grade, smooth, and crop the reference preview

`POST /v1/headshots/projects/{project_id}/previews` accepts JSON:

```json
{
  "skin_base_id": "motu_business_neutral",
  "smoothing_strength": 0.2,
  "crop_spec_id": "profile_4x5",
  "crop_anchor": "auto",
  "crop_rotation": 0
}
```

- `skin_base_id` — allowed po

Github ReposUpdated 15h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.