AgentZero Skill

AgentZero is a personal real estate listing tracker. Backend at http://localhost:8000.

Prerequisites

Before using this skill, ensure the following are in place:

Privacy & Email Access

The Daily Email Scan workflow accesses your Gmail inbox. Specifically it:

• Reads envelope metadata (subject, sender, ID) of Redfin alert emails via himalaya envelope list
• Opens Gmail in the openclaw browser to click through listing links (no email body text is read or stored)
• Records processed email IDs and listing URLs in ~/.openclaw//skills/agent-zero/agent_zero_claw_logs/

The scan only runs when explicitly triggered (cron or manual) and is scoped to from:redfin.com emails only.

Key APIs

Responses are JSON Property objects (see field list below).

Workflow: Add a Listing by URL

1. POST /api/listings/agent-suggest with {"url": ""}.
2. On 409 CONFLICT response: the listing already exists. Parse the JSON body for existing_id and existing_title and report to user.
3. On success: the listing is saved as AgentPending. The backend agent will further review i.
4. Log a summary to the daily notes file (see Logging section).

Logging — agent_zero_claw_logs/

After every action (add, refresh, skip), append a summary to:

~/.openclaw/<WORKSPACE>/skills/agent-zero/agent_zero_claw_logs/YYYY-MM-DD.md

Here is the name of your OpenClaw workspace for the specific agent; it can be workspace if it is the default agent; or workspace followed by the agent name.

Create the folder and file if they don't exist.

Format:

## HH:MM — Added listing #38
- **Email:** https://mail.google.com/mail/u/0/#inbox/<thread_id>
- **Title:** 7778 Nanaimo St, Vancouver - 6 beds/3.5 baths
- **URL:** https://www.redfin.ca/...
- **Price:** $2,198,000
- **Status:** AgentPending (agent review running in background)

## HH:MM — Skipped listing
- **Email:** https://mail.google.com/mail/u/0/#inbox/<thread_id>
- **URL:** https://...
- **Reason:** No search profile matches — listing is in Burnaby, all profiles target Vancouver.

The thread_id is the hex ID visible in the Gmail URL after opening the email in the browser.

Workflow: Daily Email Scan (Cron)

This is the workflow for the scheduled daily cron task.

> Requires: himalaya configured with Gmail + openclaw browser running. See Prerequisites above.

Step-by-step

1. Notify your user (via whatever messaging channel is configured): "🏠 AgentZero daily scan starting — checking Redfin emails..."

1. Write scan-start entry to ~/.openclaw//skills/agent-zero/agent_zero_claw_logs/YYYY-MM-DD.md immediately (create file/folder if needed):

```markdown

## HH:MM — Scan started

• Checking Redfin emails...

```

1. Load state file ~/.openclaw//skills/agent-zero/agent_zero_claw_logs/processed_emails.json
• If missing, treat as {"processed_ids": [], "date_counts": {}}
• Format: {"processed_ids": ["57471", ...], "date_counts": {"2026-03-09": 2}}
• processed_ids are himalaya envelope IDs (sequential integers) — used to avoid re-processing emails already handled in previous scans
• Append to log:

```markdown

## HH:MM — Loaded state

• Already processed IDs: 57471, 57457
• Processed today: 1

```

1. Check daily limit: count how many emails were processed today (from date_counts[today]). If ≥ 3, append to log and notify your user:

```markdown

## HH:MM — Skipped scan

• Reason: Daily limit (3) already reached.

```

1. List emails via himalaya:

```bash

himalaya envelope list --output json 2>/dev/null

```

Filter to emails where from.addr contains redfin.com and ID is NOT in processed_ids. Take up to 3 - already_processed_today.

Append to log immediately:

```markdown

## HH:MM — Found N new Redfin email(s)

• Email IDs: 57493, 57490
• Already processed today: 1 (limit: 3)

```

1. For each email:

a. Append to log before opening:

```markdown

## HH:MM — Processing email : ""

• Opening in Gmail...

```

b. Open the email in Gmail via browser (run openclaw browser --browser-profile openclaw start if not already running):

• Navigate to Gmail and search using the subject and sender from the himalaya envelope (e.g. from:listings@redfin.com subject:"")
• Click the matching email to open it

c. For each listing link visible in the email body:

• Skip "Go tour it", "Tour home", "Schedule a Tour", and "View all saved open houses" links — these go to booking pages, not listings
• Skip full address links (e.g. "930 Cambie St, Vancouver, BC, V6B 5X6") — these go to Google Maps
• Click the short property name links (e.g. "7778 Nanaimo St" or "2094 E 7th Ave") — these are the actual Redfin listing links
• Read the final URL from the new tab (e.g. https://www.redfin.ca/bc/vancouver/.../home/200788210)
• Close the tab
• ⚠️ Never construct or guess URLs. Only use URLs extracted directly by clicking through the email. Do not derive URLs from propertyId params or address strings.
• Append to log before submitting:

```markdown

• Found listing URL: https://www.redfin.ca/...
• Submitting to AgentZero...

```

• Submit via Add Listing workflow above (no profile selection needed — agent assigns it)
• Append result to log immediately after each listing (success, skip, or 409)

d. Mark email as processed:

• Update processed_ids in state file with this email ID
• Increment date_counts[today]
• Add agent_zero label in Gmail via himalaya:

```bash

himalaya message copy "agent_zero"

```

• Append to log:

```markdown

• Email marked as processed.

```

1. Append final summary to log:

```markdown

## HH:MM — Scan complete

• Processed N emails, added M listings (K skipped).

```

1. Notify your user with summary and a prompt to review new listings in the frontend:

```

✅ AgentZero scan complete — processed 2 emails, added 3 listings (agent review running in background).

🏡 New listings will appear in Review once the agent finishes: http://localhost:5173/inbox

```

State file location

~/.openclaw//skills/agent-zero/agent_zero_claw_logs/processed_emails.json