clawtime
Install, configure, start, and troubleshoot ClawTime — a private self-hosted webchat UI for OpenClaw with passkey (Face ID) auth, Piper TTS voice, and 3D avatar. Requires Cloudflare tunnel for HTTPS (passkeys need a real domain). Use when the user wants to install ClawTime on a new machine, configure the tunnel, register a passkey, set up TTS, start/stop the server, or diagnose errors. Triggered by requests like "install clawtime", "set up clawtime", "start clawtime", "clawtime isn't working", "register passkey", "device auth issue".
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/bewareofddog/clawtime-setupWhat This Skill Does
ClawTime is a sophisticated private web-based interface for your OpenClaw agent, designed to provide a secure, personal dashboard accessible from any browser or mobile device. By leveraging WebAuthn protocols, it enables high-security passkey authentication (such as Face ID or Touch ID), ensuring that only you can access your agent. The skill integrates seamlessly with your existing OpenClaw gateway via WebSockets and supports advanced features like Piper TTS for lifelike voice interaction and customizable 3D avatar rendering. This skill bridges the gap between your local terminal-based agent and a modern, feature-rich web dashboard.
Installation
To deploy ClawTime, start by ensuring Node.js v22+ is installed on your host machine. Clone the repository into your projects directory and run npm install --legacy-peer-deps. Because passkeys require a secure origin, you must set up a Cloudflare Tunnel. Follow the instructions to log in to the cloudflared CLI, create a tunnel named 'clawtime', and update your ~/.cloudflared/config.yml to route your domain traffic to localhost:3000. You must also whitelist your domain in the OpenClaw gateway configuration using the openclaw config patch command to ensure the WebSocket connection is authorized. Once configured, launch the server with the necessary environment variables, specifically defining your PUBLIC_URL and security tokens. Finally, start the tunnel using cloudflared tunnel run clawtime.
Use Cases
ClawTime is ideal for users who want to move beyond terminal-only interaction with OpenClaw. It serves as a personal mobile portal for controlling your agent while away from your primary desktop. It is specifically designed for users prioritizing security, allowing you to gate-keep your AI agent with biometric hardware keys. Additionally, users who wish to customize their agent's voice response using Piper TTS will find this skill provides the necessary hooks for real-time audio generation and playback.
Example Prompts
- "Install ClawTime and set up the Cloudflare tunnel for me."
- "I'm having trouble with my passkey; how do I re-register my device on ClawTime?"
- "Start the ClawTime server with Piper TTS enabled for my agent, Beware."
Tips & Limitations
Always ensure your PUBLIC_URL matches the domain in your Cloudflare dashboard exactly, as mismatches will prevent the WebAuthn flow from initiating. When configuring Piper TTS, exercise extreme caution with the TTS_COMMAND environment variable; ensure your inputs are sanitized to avoid potential shell injection. If you encounter issues with the UI loading, verify that your OpenClaw gateway is running and that the allowedOrigins setting in your config reflects your custom domain. Remember that this skill requires an active Cloudflare Tunnel connection to function properly from outside your local network.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-bewareofddog-clawtime-setup": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-read, code-execution