office-cam

name	office-cam
description	Multi-camera system for office/home monitoring. Supports USB webcams (Logitech), WiFi Wyze cameras (RTSP), and ESP32 cameras. Use to check rooms, capture photos on demand, or monitor multiple spaces.
metadata	{"clawdbot":{"emoji":"🎥"}}

Office Cam - Multi-Camera System

Whole-house camera network supporting multiple camera types.

Supported Cameras

Type	Reliability	Setup	Best For
🖥️ USB Webcam	⭐⭐⭐⭐⭐ Instant	Plug & play	Desk, office
📹 Wyze PTZ/v3	⭐⭐⭐⭐⭐ Reliable	RTSP stream	Rooms, garage, shed
📡 ESP32-CAM	⭐⭐⭐ Experimental	ESP-NOW wireless	DIY, battery-powered

Quick Start

# USB Webcam (instant)
~/clawd/skills/office-cam/scripts/capture.sh

# Wyze PTZ (one-time setup required)
~/clawd/skills/office-cam/scripts/wyze-dashboard add
~/clawd/skills/office-cam/scripts/wyze-dashboard capture shed

# ESP32-CAM (ESP-NOW wireless)
# Flash firmware, auto-discovers base station, sends photos wirelessly

---

🖥️ USB Webcam (Logitech)

Most reliable - works instantly.

Basic Capture

cd ~/clawd/skills/office-cam
./scripts/capture.sh /tmp/office.jpg

Motion Detection ⭐ NEW

# Start motion detection (runs continuously)
./scripts/motion-detect.sh

# Captures saved to ~/.clawdbot/motion-captures/
# Automatically triggers when motion detected
# 5-second cooldown between captures

🔥 OVERWATCH Mode (AI Monitoring) ⭐⭐⭐

# Start AI-powered continuous monitoring
./scripts/overwatch start

# Check status
./scripts/overwatch status

# Stop monitoring
./scripts/overwatch stop

What Overwatch does:

• 👀 Monitors webcam 24/7 in background
• 🚨 Detects motion and saves alert
• 🔔 Can trigger notifications (integrate with OpenClaw)
• 💾 Saves motion captures to ~/.clawdbot/overwatch/

Or say: "Start overwatch" or "Keep overwatch"

🤖 SMART OVERWATCH (AI-Escalated) ⭐⭐⭐⭐⭐

# Start smart monitoring (zero cost until trigger)
./scripts/smart-overwatch start

# I will check for triggers and analyze when found

How it works:

1. 👀 Local motion detection (file size comparison, zero API cost, runs always)
2. 🚨 Motion detected → creates trigger file in ~/.clawdbot/overwatch/triggers/
3. 🤖 I detect the trigger → analyze image with vision model (only when motion happens)
4. 👤 Person found? → Send alert & optionally continue watching
5. 📊 No person? → Delete trigger, back to local monitoring

What you can say:

• "Start smart overwatch"
• "Keep watch and tell me if you see anyone"
• "Monitor for people only"
• "Check overwatch triggers" (to manually check for pending analysis)

Cost: Zero until motion detected, then only when I analyze the image

📸 Instant Telegram Photo ⭐⭐⭐⭐⭐

Quick capture and send - the simplest way to check your camera

Just say:

• "Show me the office"
• "What's on camera?"
• "Send me a photo"

What happens:

1. I instantly capture from your webcam
2. Analyze for clear faces/activity
3. Send best image directly to your Telegram

No stream needed - just instant photos when you want them.

🔥 OVERWATCH PRO (Full Control System) ⭐⭐⭐⭐⭐⭐

The complete solution - Telegram alerts, live stream, remote control

# Start the full system
./scripts/overwatch-pro start

# Setup Telegram (one-time)
./scripts/overwatch-pro setup

# Get live stream URLs
./scripts/overwatch-pro stream

# Take manual photo
./scripts/overwatch-pro capture

# Check status
./scripts/overwatch-pro status

# View live log
./scripts/overwatch-pro log

# Stop
./scripts/overwatch-pro stop

Features:

• 🚨 Instant Telegram alerts when motion detected
• 🌐 Live MJPEG stream at http://localhost:8080
• 📱 Auto-refreshes every 2 seconds
• 📸 Saves all captures to ~/.clawdbot/overwatch/
• 🤖 Telegram bot replies - respond to alerts with commands
• 🌅 Morning report (8 AM daily via cron)

Telegram Commands (reply to motion alert):

• analyze - I'll check the image and tell you what I see
• stream - I'll send you the live stream link
• capture - I'll take a fresh photo right now

Network Access:

# Local
http://localhost:8080

# From another device on same network
http://$(hostname -I | awk '{print $1}'):8080

Morning Report (with Photo):

• Auto-generated at 8 AM (America/Denver timezone)
• Sends a fresh morning photo of your office
• Summarizes overnight motion events
• Offers to analyze captures
• Provides quick command reference

Requirements for motion detection:

brew install imagemagick  # For image comparison

---

📹 Wyze Cameras

One-Time Setup:

1. Enable RTSP in Wyze App:

   • Open Wyze app → Camera Settings → Advanced Settings
   • Enable RTSP, set password
   • Copy the RTSP URL

2. Add to system:

   ~/clawd/skills/office-cam/scripts/wyze-dashboard add
   # Enter camera name (e.g., "shed")
   # Enter RTSP URL
   

3. Capture:

   # Single camera
   ~/clawd/skills/office-cam/scripts/wyze-dashboard capture shed
   
   # All cameras
   ~/clawd/skills/office-cam/scripts/wyze-dashboard capture-all
   
   # Quick one-liner (after setup)
   ~/clawd/skills/office-cam/scripts/wyze-capture shed
   

---

📡 ESP32-CAM (ESP-NOW Wireless)

No WiFi router needed! Direct wireless between ESP32s.

Architecture:

┌─────────────────┐      ESP-NOW      ┌─────────────────┐
│  ESP32-CAM      │  ═══════════════► │  ESP32 Base     │◄── USB ──► Mac
│  (Camera Node)  │   (100m range)    │  (Receiver)     │
└─────────────────┘                   └─────────────────┘
        Battery powered                  Plugged into computer

Flashing:

Base Station (plain ESP32, plugged into Mac):

cd ~/clawd/skills/office-cam/firmware/espnow-base
pio run --target upload

Camera Node (ESP32-CAM with camera):

cd ~/clawd/skills/office-cam/firmware/espnow-cam-auto
pio run --target upload

How it works:

1. Base station broadcasts "beacon" every 2 seconds
2. Camera auto-discovers base station
3. Camera captures and sends photo wirelessly
4. Base receives and saves to SD/outputs to serial

Range: 100+ meters (no WiFi needed!)

---

Files

Script	Purpose
capture.sh	USB webcam
wyze-capture	Quick Wyze capture
wyze-dashboard	Multi-cam management
firmware/espnow-base/	ESP32 receiver
firmware/espnow-cam-auto/	ESP32-CAM transmitter

---

Troubleshooting

Wyze "Connection refused":

• Verify RTSP enabled in Wyze app
• Check username/password
• Ensure same WiFi network

ESP32-CAM not connecting:

• Keep within 10 feet for testing
• Check LED: blinking = searching, solid = capturing
• Try resetting both boards

USB webcam not working:

• brew install imagesnap
• System Settings → Privacy → Camera