A pocket-sized tamagotchi companion for your OpenClaw AI agent. Give your AI a face, a mood, and a home it can live in — right in your pocket.
Built on the Waveshare ESP32-S3-Touch-AMOLED-1.8 with ESP-Brookesia for a native smartphone-style UI.
OpenClaw is an open-source autonomous AI agent that runs locally, executes tasks via LLMs, and connects through messaging platforms. PocketClawd is a dedicated hardware device that turns your OpenClaw instance into a living, breathing pocket companion — think tamagotchi meets AI assistant.
- 🐾 Pet your AI — interact with your OpenClaw through a touchscreen AMOLED display
- 📱 Phone-style UI — ESP-Brookesia provides a native app launcher, status bar, and notifications
- 🔗 Connected — talks to your OpenClaw/OpenClawd AI instance over WiFi
- 🧠 Personality — your AI's mood, status, and personality rendered as a pocket creature
Board: Waveshare ESP32-S3-Touch-AMOLED-1.8
| Spec | Detail |
|---|---|
| MCU | ESP32-S3 (dual-core Xtensa LX7, 240 MHz) |
| Flash | 16 MB Winbond (QIO, 80 MHz) |
| PSRAM | 8 MB (OPI, 80 MHz) |
| Display | 1.8" AMOLED, 368×448, SH8601 QSPI |
| Touch | FT3168 capacitive (FT5x06 compatible, I2C) |
| IO Expander | TCA9554 (I2C 0x20) — LCD reset, touch reset |
| Audio | I2S codec |
| Sensors | IMU, RTC |
See docs/hardware-reference.md for full GPIO pinout and configuration details.
| Component | Version |
|---|---|
| ESP-IDF | 6.0-beta2 |
| ESP-Brookesia | 0.5.x |
| LVGL | 9.x (via esp_lvgl_port) |
| Display Driver | esp_lcd_sh8601 (QSPI) |
| Touch Driver | esp_lcd_touch_ft5x06 |
- ESP-IDF v6.0-beta2 installed
- Waveshare ESP32-S3-Touch-AMOLED-1.8 connected via USB
idf.py set-target esp32s3
idf.py build flash monitorImportant
After idf.py fullclean, always re-run idf.py set-target esp32s3 — the target resets to esp32.
PocketClawd/
├── .agent/ # AI agent skills & suggested skills
│ ├── skills/ # Reusable workflow skills
│ └── SUGGESTED_SKILLS.md # Skill suggestion inbox
├── docs/
│ └── hardware-reference.md # GPIO pinout, init sequences, BSP notes
├── main/
│ ├── CMakeLists.txt # Component registration & REQUIRES
│ ├── idf_component.yml # ESP Component Manager dependencies
│ └── main.cpp # Application entry point
├── AGENTS.md # Agent instructions, known issues, skills table
├── sdkconfig.defaults # PSRAM, flash, LVGL config defaults
├── partitions.csv # Custom partition table
└── CMakeLists.txt # Project root CMake
TBD