#email

Email Reader

Classify hiring emails and sync job status.

openclaw skills install @wanghong5233/wanghong5233-offerpilot-email-reader

Email Reader Skill

Activate when user asks:

If user provides sender/subject/body:
- Call POST http://127.0.0.1:8010/api/email/ingest
- Body:
  - {"sender":"<sender>","subject":"<subject>","body":"<body>"}
Parse response:
- show classification.email_type
- show company / interview_time if exists
- show related_job_id + updated_job_status if job status was updated
If user asks for history:
- Call GET http://127.0.0.1:8010/api/email/recent?limit=20
- summarize top items
If user asks to pull unread inbox:
- Call POST http://127.0.0.1:8010/api/email/fetch
- Body: {"max_items":10,"mark_seen":false}
- Return fetched_count / processed_count.
If user asks heartbeat trigger/status:
- Status: GET http://127.0.0.1:8010/api/email/heartbeat/status
- Trigger once: POST http://127.0.0.1:8010/api/email/heartbeat/trigger
- Start scheduler: POST http://127.0.0.1:8010/api/email/heartbeat/start
- Stop scheduler: POST http://127.0.0.1:8010/api/email/heartbeat/stop
- Notify test: POST http://127.0.0.1:8010/api/email/heartbeat/notify-test
For OpenClaw cron integration:
- Recommend this exact cron payload message:
  - Use email-reader skill to trigger one email heartbeat run, then summarize fetched_count, processed_count, interview invites, and notification status.
- This keeps OpenClaw heartbeat and backend /api/email/heartbeat/trigger on the same execution path.

Ingest:
- curl -sS -X POST "http://127.0.0.1:8010/api/email/ingest" -H "Content-Type: application/json" -d '{"sender":"hr@example.com","subject":"面试邀请","body":"请于明天下午参加面试"}'
Recent:
- curl -sS "http://127.0.0.1:8010/api/email/recent?limit=20"
Fetch unread:
- curl -sS -X POST "http://127.0.0.1:8010/api/email/fetch" -H "Content-Type: application/json" -d '{"max_items":10,"mark_seen":false}'
Heartbeat status:
- curl -sS "http://127.0.0.1:8010/api/email/heartbeat/status"
Heartbeat trigger:
- curl -sS -X POST "http://127.0.0.1:8010/api/email/heartbeat/trigger"
Heartbeat start:
- curl -sS -X POST "http://127.0.0.1:8010/api/email/heartbeat/start"
Heartbeat stop:
- curl -sS -X POST "http://127.0.0.1:8010/api/email/heartbeat/stop"
Notify test:
- curl -sS -X POST "http://127.0.0.1:8010/api/email/heartbeat/notify-test" -H "Content-Type: application/json" -d '{"message":"OfferPilot test"}'
Suggested OpenClaw cron message:
- Use email-reader skill to trigger one email heartbeat run, then summarize fetched_count, processed_count, interview invites, and notification status.

Never send emails automatically.
If classification confidence is low or type is irrelevant, clearly tell user uncertainty.
For malformed input or API failure, surface exact error and ask whether to retry.