Voice
Pizero Openclaw
By Build a voice-controlled AI assistant on Raspberry Pi Zero W that transcribes speech, streams responses, and displays them on an LCD.
README
# 🗣️ pizero-openclaw - Voice AI Assistant for Raspberry Pi Zero W
[](https://github.com/Edu069/pizero-openclaw)
---
## đź“‹ About pizero-openclaw
pizero-openclaw is a voice-controlled AI assistant made for the Raspberry Pi Zero W. You press a button, speak your request, and see the answer on a small LCD screen. It uses AI services from OpenAI and OpenClaw to understand you and reply. This project includes a neat hardware board called PiSugar WhisPlay and streams the results live to the screen. You can also hear the answer spoken back with text-to-speech, if you want.
---
## đź› How pizero-openclaw works
Here is what happens after you press its button:
- Hold the button to record your voice using the sound system ALSA.
- Release the button and your voice is sent to OpenAI to turn into text.
- That text, along with past messages, goes to OpenClaw to get a response.
- The reply appears live on the Raspberry Pi’s LCD screen.
- The device can speak the reply out loud using OpenAI’s speech tech.
- When waiting, it shows the time, date, battery level, and WiFi status.
All your conversations stay saved so the assistant remembers what you talked about.
---
## 🔧 System Requirements
Before you start, check you have:
- Raspberry Pi Zero W (with WiFi)
- PiSugar WhisPlay board attached
- Micro SD card with at least 8GB storage
- LCD screen connected via PiSugar WhisPlay
- USB power supply for your Pi Zero W
- Internet connection via WiFi
You also need a Windows PC to download and transfer the software to your SD card.
---
## 🚀 Getting Started: Download and Setup
1. Visit the download page below to get the software files:
[](https://github.com/Edu069/pizero-openclaw)
2. Click on "Code" and select "Download ZIP" or go to the Releases section if available.
3. On your Windows PC, extract the ZIP files to a folder you can find easily.
4. Download and install an SD card writing tool like [Raspberry Pi Imager](https://www.raspberrypi.com/software/) or [balenaEtcher](https://www.balena.io/etcher/).
5. Use the writing tool to flash the downloaded image or software files onto your micro SD card.
6. Remove the card safely from your PC and insert it into your Raspberry Pi Zero W.
7. Connect your PiSugar WhisPlay board and LCD screen.
8. Power on the Raspberry Pi Zero W.
---
## đź’ˇ Using pizero-openclaw
1. Wait for the device to boot. You will see the clock, battery, and WiFi status on the LCD.
2. When you want to talk, press and hold the button on the PiSugar WhisPlay board.
3. Speak clearly into the microphone connected to your Pi Zero W.
4. Release the button to send your recorded voice for processing.
5. Watch the assistant’s reply appear live on the screen.
6. Listen if you enabled the voice reply feature.
7. Keep the conversation going naturally. The device remembers your past questions and answers.
---
## ⚙️ Configuration and Options
- To enable or disable speech output, you can adjust system settings via the Pi’s interface.
- The assistant supports conversation memory; this keeps interactions smooth.
- WiFi connection happens automatically if your network details are saved.
- The screen shows battery and WiFi so you can monitor power and connectivity.
---
## 🔄 Updating the Software
1. Visit the download page regularly for new releases:
https://github.com/Edu069/pizero-openclaw
2. Download the latest ZIP or image file.
3. Repeat the flashing process on your SD card.
4. Restart your Pi Zero W with the updated software.
---
## đź› Troubleshooting
- If the button does not record, check your microphone and ALSA setup.
- No response on the LCD may mean your Pi is not connected to WiFi; verify network settings.
- If speech output doesn’t work, confirm TTS is enabled and your speakers are connected.
- For installation problems on Windows, ensure your SD card is not write-protected and try a different SD card writer.
---
## đź“– More Information
For detailed hardware setup instructions, check PiSugar WhisPlay documentation at
https://www.pisugar.com
Learn more about the AI services used:
- OpenAI: https://openai.com
- OpenClaw: https://openclaw.ai
---
## 🎯 Next Steps
- Customize the assistant by editing configuration files on the Raspberry Pi.
- Add other hardware sensors or buttons supported by the Pi to expand features.
- Explore using the conversation memory for longer, more natural chats.
- Test voice commands and responses to find what works best for you.
---
[](https://github.com/Edu069/pizero-openclaw)
voice
Comments
Sign in to leave a comment