Skip to content

MartinLoeper/clawpi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

287 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ClawPi

A Raspberry Pi 5 + 10" touchscreen that acts as a voice-controlled AI dashboard appliance. Say "hey claw", describe what you want, and the OpenClaw gateway builds and displays it — no coding required.

  1. OpenClaw gateway runs on the Pi, generating dashboards on localhost:18789
  2. Kiosk mode (labwc + Chromium) shows them fullscreen on the wired display
  3. Voice wake ("openclaw", "claude", "computer") triggers dashboard creation
  4. Talk mode lets you refine dashboards through continuous conversation
  5. Claude Max powers the AI — just a subscription, no API keys

See docs/vision.md for the full product vision and docs/hardware.md for the hardware setup.


NixOS configuration built on nixos-raspberrypi.

Quick Start

See docs/getting-started.md for prerequisites, initial setup, and first boot instructions. For ongoing deploys, see docs/deployment.md.

Pinned Versions

The flake.lock pins all upstream dependencies. Key versions:

Dependency Pinned revision Gateway version Date
nix-openclaw 5b6654e 2026.3.7 2026-03-07

To update: nix flake update nix-openclaw then redeploy.

Flake Structure

Config Purpose
nixosConfigurations.rpi5 Base deploy (Telegram disabled)
nixosConfigurations.rpi5-telegram Telegram channel enabled
nixosConfigurations.rpi5-telegram-debug Telegram + debug tools (speaker-test, etc.)
nixosConfigurations.rpi5-installer Flashable SD card image

All configs share commonModules. We use nixosSystem (base) instead of nixosSystemFull to avoid RPi multimedia overlay rebuilds — see docs/workarounds.md for rationale.

The OpenClaw gateway runs as a systemd service (openclaw-gateway.service) on port 18789, serving AI-generated dashboards. It is included in all configurations via commonModules. See docs/openclaw.md for details.

Kiosk Specialisation

A kiosk specialisation launches labwc (Wayland compositor) + Chromium in fullscreen mode, auto-logged in as the kiosk system user. The base system remains CLI-only by default. See docs/deployment.md for switching instructions and docs/canvas.md for the design rationale.

ClawPi Overlay Daemon

A custom Go service (clawpi) connects to the OpenClaw gateway WebSocket as a gateway-client and listens for agent lifecycle events (thinking, tool use, responses). It drives Eww overlays rendered as Wayland layer-shell windows on top of the kiosk browser — giving visual feedback like "Thinking..." or "Using: browser" without interrupting the displayed content.

  • Source: pkgs/clawpi/ (Go + Eww config)
  • Service: clawpi.service (systemd user service, kiosk user)
  • Starts with: graphical-session.target (only runs in kiosk mode)
  • Reconnects automatically if the gateway restarts

PinchChat (Web UI)

PinchChat provides a webchat interface for interacting with the OpenClaw gateway from your workstation. See docs/deployment.md for setup instructions.

Documentation

Additional design docs and integration guides live in docs/.

About

NixOS-based kiosk system for Raspberry Pi 5 with OpenClaw AI gateway

Resources

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors