← 返回 Skills 市场
313
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install esp32-cam-eyes
功能描述
Set up ESP32-S3-CAM modules as visual sensors (eyes) for OpenClaw agents. Covers hardware identification, firmware flashing, WiFi configuration, and HTTP cam...
使用说明 (SKILL.md)
ESP32-CAM Eyes
Give your OpenClaw agent physical eyes using ESP32-S3-CAM modules.
Overview
Each ESP32-CAM module runs a lightweight HTTP server exposing /capture (single JPEG snapshot) and /stream (MJPEG live stream). Once connected to WiFi, the agent can grab images via curl for vision analysis.
Prerequisites
- Hardware: ESP32-S3 development board with camera sensor (Hiwonder, Freenove, or similar)
- Software: macOS or Linux with Python 3 installed
- Tools: PlatformIO CLI (
pip3 install platformio), pyserial (pip3 install pyserial)
Quick Start
- Plug in the ESP32-CAM via USB
- Identify the serial port:
ls /dev/cu.usb*(macOS) orls /dev/ttyUSB*(Linux) - Identify the sensor model (critical — determines firmware config)
- Create PlatformIO project, flash firmware
- Connect to WiFi, test with
curl -o photo.jpg http://\x3CIP>/capture
For the complete step-by-step guide with firmware code, pin definitions, performance benchmarks, and troubleshooting: read references/setup-guide.md.
Key Decision: Sensor Type
The sensor model determines your firmware strategy:
| Sensor | PID | Hardware JPEG | Recommended Format |
|---|---|---|---|
| OV2640 | 0x2640 | ✅ Yes | PIXFORMAT_JPEG directly |
| OV5640 | 0x5640 | ✅ Yes | PIXFORMAT_JPEG directly |
| GC2145 | 0x2145 | ❌ No | PIXFORMAT_RGB565 + software frame2jpg() |
If buying new boards, prefer OV2640 — hardware JPEG is significantly faster.
API Endpoints
Once flashed and connected:
| Path | Function |
|---|---|
/capture |
Single JPEG snapshot |
/stream |
MJPEG live stream |
/ |
Web UI with stream viewer |
Multi-Camera Deployment
Multiple ESP32-CAMs can join the same WiFi network for multi-angle coverage. Bind fixed IPs via router DHCP reservation to avoid IP changes on reboot.
Common Pitfalls
- Wrong sensor ID: Always verify PID before choosing firmware config
- Upload speed: Use 460800 baud, not 921600 (causes flash verification failures on many boards)
- WiFi band: ESP32 only supports 2.4GHz — ensure your router has a 2.4GHz SSID available
- QQVGA is slower than VGA: Counter-intuitive but true due to PSRAM DMA buffer efficiency; use XGA (1024×768) for best speed/quality balance
安全使用建议
This guide appears coherent and linked to its stated purpose, but review the code before flashing: 1) The firmware requires your WiFi SSID/password — avoid hard-coding secrets into repos; prefer entering them locally or using a secure config file. 2) Follow the PlatformIO install in an isolated environment (virtualenv or user install) rather than using --break-system-packages to avoid altering system packages. 3) Be mindful of network exposure: the device runs an HTTP server on port 80, so if you attach it to a network with internet access consider firewall rules, router configuration, or use a private LAN/VLAN to prevent unintended access. 4) Verify device model/PID before choosing firmware (the guide emphasizes this); flashing incorrect configs can brick devices. Overall there is no indication of malicious instructions or external data exfiltration in the provided files.
功能分析
Type: OpenClaw Skill
Name: esp32-cam-eyes
Version: 1.0.0
The skill provides a legitimate and detailed guide for setting up ESP32-S3-CAM hardware as visual sensors for an agent. It includes standard PlatformIO configurations, C++ firmware for an HTTP camera server, and Python snippets for serial port communication to identify hardware sensors. While the instructions involve installing development tools (platformio, esptool) and executing shell commands, these actions are transparently documented and strictly necessary for the stated purpose of flashing and configuring microcontrollers.
能力评估
Purpose & Capability
Name/description (ESP32-CAM setup and HTTP camera server) match the included instructions and firmware source. Required tools (PlatformIO, esptool, pyserial) and steps (serial port detection, flashing, WiFi config) are appropriate for this hardware-focused task.
Instruction Scope
The SKILL.md and setup-guide instruct the agent/user to read local serial output, create and flash firmware, and embed WiFi SSID/password into the source before flashing. Those actions are necessary for flashing and connecting the device, but the guide directs inserting WiFi credentials into code (which has security/privacy implications) and reads /dev serial devices — both are expected for this purpose but worth noting.
Install Mechanism
This is instruction-only (no install spec), so nothing is written by the skill itself. The guide tells users to pip-install PlatformIO/esptool/pyserial and warns that PlatformIO will download a large toolchain (~1.5–2GB). The pip invocation includes --break-system-packages, which can be intrusive on some Linux systems; using a virtualenv or user install is a safer alternative.
Credentials
The skill declares no required environment variables or credentials, which aligns with a local hardware setup. However, the instructions require you to supply your WiFi SSID and password by placing them into the firmware source before flashing — this is necessary for operation but is sensitive and should be handled carefully (don't commit secrets to public repos, prefer runtime config or secure provisioning when possible).
Persistence & Privilege
always is false and the skill is user-invocable only. There is no code that attempts to modify other skills or system-wide agent settings. The skill does not request persistent/privileged presence.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install esp32-cam-eyes - 安装完成后，直接呼叫该 Skill 的名称或使用
/esp32-cam-eyes触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release: complete ESP32-S3-CAM setup guide for giving OpenClaw agents physical vision
元数据
常见问题
ESP32-CAM Eyes 是什么？
Set up ESP32-S3-CAM modules as visual sensors (eyes) for OpenClaw agents. Covers hardware identification, firmware flashing, WiFi configuration, and HTTP cam... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 313 次。
如何安装 ESP32-CAM Eyes？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install esp32-cam-eyes」即可一键安装，无需额外配置。
ESP32-CAM Eyes 是免费的吗？
是的，ESP32-CAM Eyes 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
ESP32-CAM Eyes 支持哪些平台？
ESP32-CAM Eyes 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 ESP32-CAM Eyes？
由 Cavano（@p697）开发并维护，当前版本 v1.0.0。
推荐 Skills