office-cam

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