Documentation
Everything you need to get started with Wingsy
Getting Started
Requirements
Windows 10 or later. OpenClaw installed and running on your machine or a server.
Download and install
Download from wingsy.ai, run the installer, click "More info → Run anyway" if Windows shows a security warning.
Create your account
Sign up at wingsy.ai, confirm your email, then open the Wingsy app and log in.
Add credits
Go to wingsy.ai/dashboard, top up credits via Stripe. Minimum £10.
Enter your OpenClaw URL
Enter the URL where your OpenClaw agent is running, e.g. http://localhost:18789
Start talking
Click the mic button and start talking to your agent.
FAQ
What is OpenClaw?
OpenClaw is an open source AI agent platform. Wingsy gives your existing OpenClaw agent a face and a voice.
Where do I get OpenClaw?
Visit openclaw.ai to download and set up OpenClaw.
Why does Windows show a security warning?
Wingsy is not yet code signed. Click "More info" then "Run anyway" to proceed. This is safe.
Why can't I hear anything?
Check your system audio output. Make sure your volume is not muted.
Why is the mic not working?
Make sure Wingsy has microphone permissions. Check Windows Settings → Privacy → Microphone.
How do I change my voice?
Go to wingsy.ai/dashboard and select Female (Katie) or Male (Ronnie) under Voice. Changes take effect next time you open Wingsy.
How do I upload a custom avatar?
Go to wingsy.ai/dashboard and upload a .vrm file under Custom Avatar. Changes take effect next time you open Wingsy.
What does it cost?
Wingsy charges per minute of usage. STT costs 2p/min, TTS costs 5p/min. There's no subscription.
Do credits expire?
No. Credits never expire.
Troubleshooting
App won't connect to my OpenClaw agent
Check the URL you entered during setup is correct and that OpenClaw is running. Log out and log back in to update the URL.
No audio / Ash isn't speaking
On Windows, make sure ffplay is installed (part of ffmpeg — download at ffmpeg.org). On Mac, no extra software is needed. Check your system volume and audio output device in System Settings. Try restarting Wingsy. If the issue persists, check that your Cartesia API key is valid at cartesia.ai.
Avatar not loading
If your custom avatar fails to load, Wingsy will fall back to the default avatar. Check your .vrm file is valid.
Mac says Wingsy is damaged and can't be opened
This is a macOS security warning for apps from unidentified developers. Wingsy is safe to run. To fix it, open Terminal and run: xattr -cr /Applications/Wingsy.app Then try opening Wingsy again.
Can't reach OpenClaw on a remote server?
If your OpenClaw runs on a VPS or remote machine, you'll need Tailscale to connect securely. Download it at tailscale.com, add both machines to your network, and use your Tailscale IP as the OpenClaw URL during Wingsy setup.
Support
Need help? Email us at support@wingsy.ai