# Send Digital Clawatar to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "digital-clawatar",
    "name": "Digital Clawatar",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/polucas/digital-clawatar",
    "canonicalUrl": "https://clawhub.ai/polucas/digital-clawatar",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/digital-clawatar",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=digital-clawatar",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/auth.sh",
      "scripts/create-head.sh",
      "scripts/delete-head.sh",
      "scripts/list-resources.sh",
      "scripts/update-head.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "digital-clawatar",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T14:27:19.756Z",
      "expiresAt": "2026-05-09T14:27:19.756Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=digital-clawatar",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=digital-clawatar",
        "contentDisposition": "attachment; filename=\"digital-clawatar-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "digital-clawatar"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/digital-clawatar"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/digital-clawatar",
    "downloadUrl": "https://openagent3.xyz/downloads/digital-clawatar",
    "agentUrl": "https://openagent3.xyz/skills/digital-clawatar/agent",
    "manifestUrl": "https://openagent3.xyz/skills/digital-clawatar/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/digital-clawatar/agent.md"
  }
}
```
## Documentation

### UNITH Digital Humans Skill

Create, configure, update, and deploy AI-powered Digital Human avatars using the UNITH API.

### Quick Overview

UNITH digital humans are AI avatars that can speak, converse, and interact with users. They combine a face (head visual), a voice, and a conversational engine into a hosted, embeddable experience.

Base API URL: https://platform-api.unith.ai
Docs: https://docs.unith.ai

### Prerequisites

The user must supply the following credentials (stored as environment variables):

VariableDescriptionHow to obtainUNITH_EMAILAccount emailRegister at https://unith.aiUNITH_SECRET_KEYNon-expiring secret keyUNITH dashboard → Manage Account → "Secret Key" section → Generate

⚠️ The secret key is displayed only once. If lost, the user must delete and regenerate it.

### Authentication

All API calls require a Bearer token (valid 7 days). Use the auth script:

source scripts/auth.sh

This validates credentials, retries on network errors, and exports UNITH_TOKEN. On failure, it prints specific guidance (wrong key, expired token, etc.).

### Step 1: Choose an Operating Mode

Ask the user what they want the digital human to do. Map their answer to one of 5 modes:

ModeoperationMode valueUse caseOutputText-to-VideotttGenerate an MP4 video of the avatar speaking provided textMP4 fileOpen DialogueocFree-form conversational avatar guided by a system promptHosted conversational URLDocument Q&Adoc_qaAvatar answers questions from uploaded documentsHosted conversational URLVoiceflowvoiceflowGuided conversation flow via VoiceflowHosted conversational URLPluginpluginConnect any external LLM or conversational engine via webhookHosted conversational URL

Complexity spectrum (simple → sophisticated):

Simplest: ttt — just text in, video out. No knowledge base needed.
Standard: oc — conversational with a system prompt. Good for general assistants.
Knowledge-grounded: doc_qa — upload documents, avatar answers from them. Best for support/FAQ.
Workflow-driven: voiceflow — structured conversation paths. Requires Voiceflow account.
Most flexible: plugin — BYO conversational engine. Maximum control.

### Step 2: List Available Faces

bash scripts/list-resources.sh faces

Each face has an id (used as headVisualId in creation). Faces can be:

Public: Available to all organizations
Private: Available only to the user's organization
Custom (BYOF): User uploads a video of a real person (currently managed by UNITH)

Present the available faces to the user and let them choose.

### Step 3: List Available Voices

bash scripts/list-resources.sh voices

Voices come from providers: elevenlabs, azure, audiostack. Present options to the user. Voices have performance rankings — faster voices are better for real-time conversation.

### Step 4: Create the Digital Human

Build a JSON payload file (see references/api-payloads.md for the schema per mode), then:

bash scripts/create-head.sh payload.json --dry-run   # validate first
bash scripts/create-head.sh payload.json              # create

The script validates required fields, checks mode-specific requirements, retries on server errors, and prints the publicUrl on success.

### Step 5 (doc_qa only): Upload Knowledge Document

For doc_qa mode, the digital human needs a knowledge document:

bash scripts/upload-document.sh <headId> /path/to/document.pdf

The script checks file existence/size, uses a longer timeout for uploads, and provides guidance on next steps.

### Step 6: Test and Iterate

The digital human is live at the publicUrl from Step 4. The user should:

Visit the URL and test the conversation
Update configuration as needed (see below)

### Updating a Digital Human

Use the update script to modify any parameter except the face (changing face requires creating a new head):

bash scripts/update-head.sh <headId> updates.json                         # from a JSON file
bash scripts/update-head.sh <headId> --field ttsVoice=rachel              # single field
bash scripts/update-head.sh <headId> --field ttsVoice=rachel --field greetings="Hi!"  # multiple fields

### Listing Existing Digital Humans

bash scripts/list-resources.sh heads           # list all
bash scripts/list-resources.sh head <headId>   # get details for one

### Deleting a Digital Human

bash scripts/delete-head.sh <headId> --confirm     # always use --confirm in automated/agent contexts

This permanently removes the digital human and cannot be undone.

Agent note: Always pass --confirm when calling this script. Without it, the script prompts for interactive input and will hang.

### Embedding

Digital humans can be embedded in websites/apps. See references/embedding.md for code snippets and configuration options.

### Scripts

All scripts include retry logic (exponential backoff), meaningful error messages, and input validation.

ScriptPurposescripts/_utils.shShared utilities: retry wrapper, colored logging, error parsingscripts/auth.shAuthenticate and export UNITH_TOKEN (with 6-day token caching)scripts/list-resources.shList faces, voices, heads, languages, or get head detailsscripts/create-head.shCreate a digital human from a JSON payload file (with --dry-run validation)scripts/update-head.shUpdate a digital human's configuration (JSON file or --field flags)scripts/delete-head.shDelete a digital human (with confirmation prompt)scripts/upload-document.shUpload knowledge document to a doc_qa head

Configuration via environment variables:

UNITH_MAX_RETRIES — max retry attempts (default: 3)
UNITH_RETRY_DELAY — initial delay between retries in seconds (default: 2, doubles each retry)
UNITH_CURL_TIMEOUT — curl timeout in seconds (default: 30, 120 for uploads)
UNITH_CONNECT_TIMEOUT — connection timeout in seconds (default: 10)
UNITH_TOKEN_CACHE — token cache file path (default: /tmp/.unith_token_cache, set empty to disable)

### Detailed API Reference

For full payload schemas, configuration parameters, and mode-specific details:

Read references/api-payloads.md      # Full request/response schemas per mode
Read references/configuration.md     # All configurable parameters
Read references/embedding.md         # Embedding code and options

### Common Patterns

"I want a quick video of someone saying X" → ttt mode, minimal config
"I want a customer support avatar" → doc_qa mode with knowledge docs
"I want an AI sales rep" → oc mode with a sales personality prompt
"I want to connect my own LLM" → plugin mode with webhook URL
"I want a guided onboarding flow" → voiceflow mode with Voiceflow API key

### Information to Collect from the User

Before creating, ask for:

Purpose / use case → determines operating mode
Face preference → list available faces for selection
Voice preference → language, accent, gender, speed priority
Alias → display name for the digital human
Language → speech recognition and UI language (e.g., en-US, es-ES)
Greeting message → initial message the avatar says
System prompt (for oc/doc_qa) → personality and behavior instructions
Knowledge documents (for doc_qa) → files to upload
Voiceflow API key (for voiceflow) → from their Voiceflow account
Plugin URL (for plugin) → webhook endpoint for their custom engine
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: polucas
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-02T14:27:19.756Z
- Expires at: 2026-05-09T14:27:19.756Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/digital-clawatar)
- [Send to Agent page](https://openagent3.xyz/skills/digital-clawatar/agent)
- [JSON manifest](https://openagent3.xyz/skills/digital-clawatar/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/digital-clawatar/agent.md)
- [Download page](https://openagent3.xyz/downloads/digital-clawatar)