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)
• INLINECODE2 — 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:

CODEBLOCK0

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.