modbender DMAF Skill
DMAF watches WhatsApp groups, recognizes faces you care about in photos and videos, and backs them up to Google Photos automatically. Setup requires an agent. After that: zero LLM tokens — the pipeline runs on a system cron + Cloud Run with no AI calls. This skill covers setup (one-time) and day-to-day operations.
Architecture
WhatsApp groups → OpenClaw (auto-download) → GCS bucket → Cloud Run Job → Google Photos
~/.openclaw/media/inbound/ every 30m hourly
Key facts:
- Dedup: Firestore; same file never processed twice (key =
sha256(gs://uri)) - Videos: Sampled at 1–2fps, early exit on first match, full clip uploaded
- Config: YAML stored in Secret Manager (
dmaf-config); update withgcloud secrets versions add - Known people: GCS bucket (
gs://your-project-known-people/); one subdir per person
Phase 1 — First-Time Setup
Read references/setup.md for the full step-by-step guide.
Summary of what you'll create:
- GCP project + required APIs
- Service account
dmaf-runnerwith IAM roles - Two GCS buckets: media staging + known people
- Google Photos OAuth token → Secret Manager
- Config YAML → Secret Manager
- Cloud Build + Cloud Run job
- Cloud Scheduler (hourly trigger)
- Firestore composite indexes
- OpenClaw media sync (system cron)
Ask the user for their GCP project ID before starting. All other values can be derived from that.
Phase 2 — Day-to-Day Operations
Read references/ops.md for full operational commands.
Common tasks:
| Task | Command summary |
|---|---|
| Trigger manual scan | gcloud run jobs execute dmaf-scan --region=us-central1 --async |
| Check scan logs | gcloud logging read 'resource.labels.job_name="dmaf-scan"' --limit=30 --freshness=1h |
| Add a person | Upload photos to gs://your-project-known-people/NAME/, then trigger scan |
| Update config | Edit config YAML, gcloud secrets versions add dmaf-config --data-file=config.yaml |
| Force sync now | bash ~/.openclaw/workspace/scripts/dmaf-sync.sh |
| Check sync log | tail -30 /tmp/dmaf-sync.log |
MCP Server (bonus)
DMAF also ships an MCP server for Claude Desktop, Claude Code, and Cursor.
It wraps the same gcloud/gsutil commands as above — useful for users who
don't have OpenClaw. See deploy/mcp-setup.md.
pip install -e ".[mcp]"
DMAF_PROJECT=your-project dmaf-mcp
Installation
# Option A: Install from ClaWHub (recommended)
clawhub install dmaf
# Option B: Copy skill directly from the repo
cp -r deploy/openclaw-skill/ ~/.openclaw/skills/dmaf/