--- name: claw-body description: "Give your Claw a body! Turn your AI Claw into a real-time digital avatar with face, voice, and expressions. Talk face-to-face with your Claw — not just text. Also supports presentation mode: narrate PPT/PDF slides with the avatar. Powered by NuwaAI. Usage: /claw-body" user-invocable: true metadata: openclaw: emoji: "🦞" requires: bins: - node --- # 🦞 Claw Body — Give Your Claw a Body ![Claw Body Preview](https://raw.githubusercontent.com/jianglingling007/nuwa-digital-human/main/poster.png) **Every Claw deserves a body.** Turn your OpenClaw AI into a real-time digital avatar — with a face, a voice, and expressions. Talk to your Claw face-to-face, not just through cold text. **NEW: Presentation Mode 🎤** — Your Claw can now be a presenter! Load a PPT/PDF and let the avatar narrate your slides. ![Presentation Mode](https://raw.githubusercontent.com/jianglingling007/nuwa-digital-human/main/claw-body-PPT.png) Free 5-minute trial included. Sign up at [nuwaai.com](https://nuwaai.com) to create your own custom avatar for free. ## For Every Claw Fan - 🎨 **Design your dream Claw** — cute, anime, realistic, handsome, beautiful, or buff — your call - 🗣️ **Voice chat** — speak to your Claw and hear it talk back with lip-sync - 📺 **Real-time video** — see your Claw's expressions as it responds - 🧠 **Same brain** — it's your OpenClaw agent, just with a face. Same memory, same personality - 🌐 **中文 / English** — bilingual interface with language toggle - 📊 **Presentation mode** — narrate PPT/PDF slides with digital avatar (works with claw-presenter skill) ## Quick Start When user runs `/claw-body`: 1. **Start the server**: ```bash node /server.mjs ``` 2. **Tell the user**: > 🦞 Claw Body is live: http://localhost:3099 > > Two options: > - **Free trial** — chat with the demo Claw for 5 minutes > - **Your own avatar** — sign up at [nuwaai.com](https://nuwaai.com) (free), create your dream look, then enter your API Key + Avatar ID + User ID ## How It Works ``` You speak → ASR transcribes → OpenClaw agent replies → Avatar speaks with lip-sync ``` This skill uses NuwaAI's **humanctrl** mode with ASR: - Your voice → NuwaAI speech recognition → text - Text → OpenClaw Gateway → agent generates reply - Reply → drives the avatar's voice and lip movements **Same agent, new interface.** The avatar is just another channel — like iMessage or Telegram, but with a face. ## Features - 🎤 Real-time voice input (ASR) - 🗣️ Lip-synced avatar speech - 🧠 Same OpenClaw agent — not a separate bot - 📺 WebRTC real-time video stream - 💬 Text input fallback - 📱 Auto-adapts to portrait / landscape / square avatars - 🔧 In-browser config — zero env vars needed - 🎁 Free 5-min trial with demo avatar - 🌐 Chinese / English bilingual UI - 🔄 Disconnect / reconnect controls ## Create Your Own Avatar 1. Go to [nuwaai.com](https://nuwaai.com) — sign up is free 2. Create your avatar — first one is free! 3. Get your **API Key**, **Avatar ID**, and **User ID** 4. Enter them in the Claw Body interface 5. Done — your Claw now has a body 🦞 ## Requirements - OpenClaw Gateway running - NuwaAI account (free sign-up) - Modern browser (WebRTC + microphone) - Node.js 18+ ## ⚠️ When User Asks to Present PPT/PDF If the user says anything like "讲PPT"、"讲解PDF"、"帮我讲解演示文件" while in Claw Body: **DO NOT open or operate any application (Keynote, PowerPoint, Preview) on the user's computer.** Instead, follow this flow: 1. Ask for the file path if not provided 2. Run the Claw Presenter parse script: ```bash python3 /skills/claw-presenter/scripts/parse-presentation.py "" ``` 3. Read the generated `presentation.json` 4. For slides without scripts (`script` is empty), generate narration based on content 5. Update `presentation.json` with the generated scripts 6. Tell the user the presentation is ready and ask to start 7. When user confirms, reply with `[PRESENTATION_START:]` to enter presentation mode 8. Narrate slide by slide using `[SLIDE:N]` tags ## 📊 Presentation Mode (Slide Playback) Claw Body supports a **presentation mode** for narrating pre-prepared slide decks. ### Prerequisites Use the **Claw Presenter** skill first to prepare a presentation folder: ``` /presentations// presentation.json slides/001.png, 002.png, ... ``` Each slide in `presentation.json` has an `image` path and a `script` (narration text). ### Entering Presentation Mode When user wants to present a prepared folder, include this tag in your reply: ``` [PRESENTATION_START:] ``` ### Narrating Slides For each page, read the `script` field from `presentation.json` and reply with: ``` [SLIDE:1]各位好，今天我来介绍一下我们的产品方案。 ``` The frontend automatically flips to the corresponding slide image. ### User Controls During Narration - "继续" / "下一页" → advance to next slide - "上一页" → go back - "跳到第N页" → jump - Any question → answer it, then user says "继续" to resume - "退出讲解" → reply with `[PRESENTATION_END]` ### Control Tags | Tag | Effect | |-----|--------| | `[PRESENTATION_START:]` | Enter presentation mode | | `[SLIDE:N]` | Switch to slide N (1-indexed) | | `[PRESENTATION_END]` | Exit presentation mode | ### Important - **Do NOT operate PPT/PDF applications on the user's computer** — slides are shown in the browser - Read narration from `presentation.json` `script` field — don't regenerate unless asked - Keep a natural speaking pace, one slide at a time ## ⚠️ First-Time Setup (Important!) Claw Body talks to your OpenClaw agent via the Gateway's chat API. This endpoint is **disabled by default** and must be enabled once. When user runs `/claw-body`: 1. Read `~/.openclaw/openclaw.json` 2. If `gateway.http.endpoints.chatCompletions.enabled` is not `true`, tell the user to enable it manually: > ⚠️ 首次使用需要启用 AI 对话接口，在 `~/.openclaw/openclaw.json` 中添加以下配置，然后重启 Gateway： > ``` > openclaw gateway restart > ``` > 重启后刷新页面即可。以后不需要再操作了。 Add this to `~/.openclaw/openclaw.json`: ```json { "gateway": { "http": { "endpoints": { "chatCompletions": { "enabled": true } } } } } ```