openclaw-pi-screen

English | 中文

A hardware status monitor for the OpenClaw AI ecosystem. While cultivating your personal "Jarvis" via OpenClaw ("shrimp farming"), it provides a low-power, zero-light-pollution data window for token usage and system metrics.

This is a combination of a 1998 Nokia 5110 (PCD8544 84x48) LCD and a 2026 Raspberry Pi 4. It provides a simple, high-contrast, burn-in-free physical interface.

Features

• Boot Sequence: Displays a boot logo followed by a scrolling human evolution history animation and a tribute to the Crawfish.
• Status Dashboard: Shows real-time version, model, CPU, Memory, remaining tokens, and a bottom scrolling marquee.
• Auto-Start: Includes a systemd service (openclaw-pi-screen.service) for seamless startup.
• Modular Architecture: Refactored into a standardized structure with core logic in src/openclaw_pi_screen.

Hardware Requirements

• Raspberry Pi 4 (Recommended) or Pi 3/2.
• PCD8544 / Nokia 5110 SPI display module.
• 5V power supply & jumper wires.

System Recommendations

• OS: Official Raspberry Pi OS.
• User: When flashing the OS, set the default username to pi. The auto-start service and deployment scripts are optimized for this user path (/home/pi), making the setup significantly smoother.

Wiring (Hardware SPI0)

For the best animation performance without tearing, we highly recommend using the hardware SPI0 pins on your Raspberry Pi GPIO header:

• VCC: 3V3 (Pin 1 or 17) - CRITICAL: Use 3.3V only!
• GND: Any GND pin (e.g., Pin 6)
• DIN (MOSI): GPIO 10 (Pin 19)
• CLK (SCLK): GPIO 11 (Pin 23)
• CE (CS0): GPIO 8 (Pin 24)
• D/C: GPIO 27 (Pin 13)
• RST: GPIO 23 (Pin 16)
• BL (Backlight): GPIO 4 (Pin 7) - Optional

Quick Start

1. Enable SPI

On your Raspberry Pi, run sudo raspi-config, navigate to Interface Options -> SPI and enable it. Reboot your Pi.

2. Install Dependencies

sudo apt-get update
sudo apt-get install -y python3-pip python3-spidev
pip3 install -r requirements.txt

3. Run the Demo

git clone https://github.com/deepjerry-ai/openclaw-pi-screen.git
cd openclaw-pi-screen

# Test the display backend and run the boot sequence
PYTHONPATH=src python3 main.py --demo boot

4. Setup Auto-Start Service (Systemd)

To make the screen run automatically when the Pi boots up:

make install-local

You can check the layout and status of the service using:

make service-status-local