clawface

# Clawface — 3D Avatar Chat A self-contained web UI with a 3D avatar, chat, and TTS voice. You do NOT need a browser — you start an HTTP server and give the user a URL to open in their own browser. ## Install After the downloads above complete, the tools directory at `~/.openclaw/tools/clawface/` will contain: - `runtime/` — sherpa-onnx TTS runtime (platform-specific binary + libs) - `models/` — TTS voice model The web assets are bundled in `{baseDir}/dist/`. No further configuration is needed — serve.js finds the TTS runtime and models automatically. ## How to start Run this command: ```bash node {baseDir}/bin/serve.js \ --dist {baseDir}/dist \ --tools-dir ~/.openclaw/tools/clawface \ --port 18794 \ --gateway-url "ws://127.0.0.1:${OPENCLAW_GATEWAY_PORT:-18789}" \ --gateway-token "$OPENCLAW_GATEWAY_TOKEN" \ --identity-file ~/.openclaw/identity/device.json ``` The server prints a URL like `http://localhost:18794` to stdout. Tell the user: **"Avatar ready at http://localhost:18794"** — they open it in their browser. ## Security - **Credentials never reach the browser.** The server authenticates to the gateway via a WebSocket proxy (`/ws`). The gateway token and device private key stay server-side — the browser only receives a proxy URL. - The `--gateway-token` and `--identity-file` arguments are used exclusively by serve.js to authenticate the upstream gateway connection. ## Important - Do NOT try to open a browser yourself. Just start the server and return the URL. - The server is zero-dependency Node.js — no `npm install` required. - TTS is built in — the server calls sherpa-onnx directly, no separate TTS skill needed. ## Stopping Kill the `node` process to stop the server.