OpenClaw 状态显示器资料包

这里集中放置 OpenClaw 实时状态显示器这一期视频相关的资料。第一版提供公开文档、接口说明和可学习复刻的代码包，所有公开文件都已移除个人 Wi-Fi、服务器 IP、会话日志和私有运行环境信息。

快速入口

资料	说明	下载
公开版 Roadmap	项目阶段、当前状态、后续计划，已移除敏感信息	下载 TXT
公开版开发摘要	关键开发过程、调试记录、协作方式	下载 TXT
公开版协议说明	云端接口、ESP32 拉帧方式、刷新策略	下载 TXT
公开版代码包	ESP32 MicroPython、屏幕驱动、云端 FastAPI 服务示例	下载 ZIP

复刻前你需要知道

这个项目不是一个“插上就能用”的商品，而是一个硬件 DIY 原型。它适合想了解 AI 辅助硬件开发、ESP32、电子墨水屏和个人自动化的人。

如果你只是想看效果，建议先看项目页：OpenClaw 实时状态显示器。

如果你想自己复刻，至少需要准备：

• 一块 ESP32-S3 开发板
• 一块 Waveshare 2.9 寸黑白电子墨水屏
• 能连接 ESP32 和屏幕的杜邦线
• 一个可访问的云端状态服务
• 基本的串口烧录/上传能力

接线参考

墨水屏接口	ESP32-S3 引脚
VCC	3V3
GND	GND
DIN	GPIO11
CLK	GPIO12
CS	GPIO10
DC	GPIO9
RST	GPIO8
BUSY	GPIO7

软件组成

模块	作用
ESP32 MicroPython 程序	连接 Wi-Fi，轮询云端帧接口，刷新电子墨水屏
FastAPI 状态服务	读取 OpenClaw 状态，生成中文活动信息
Pillow 位图渲染	在服务器端把中文界面渲染成 128x296 的 1-bit 原始帧
PM2	托管云端状态服务，让它常驻运行

常见问题

为什么不用 ESP32 直接画中文？

ESP32 上的 MicroPython 字体能力有限，直接画中文会明显增加复杂度。当前方案把中文渲染放到云端完成，ESP32 只负责下载二进制画面并显示，稳定性更好。

为什么不是服务器主动推送到屏幕？

当前方案是 ESP32 主动通过 Wi-Fi 拉取画面。这样网络结构更简单，家里设备不需要暴露端口，云端服务只要提供一个普通 HTTP 接口即可。

为什么每 3 秒检查一次？

3 秒足够让状态变化比较及时，又不会让电子墨水屏过于频繁刷新。客户端还会比较新旧画面，内容没变时不会刷屏。

局部刷新有没有做？

做过区域变化观察，但当前正式版暂时没有启用。真实任务变化主要集中在主状态和详情区，全屏有变化才刷新已经能满足当前演示和使用。

这个项目能直接商用吗？

当前版本更像一个可工作的原型，还需要外壳、供电、稳定性测试和更完整的安装流程，才能变成普通用户开箱即用的产品。

后续会补充

• 成品照片
• 更完整的安装步骤
• 外壳和供电方案