Email

SKILL.md

---
name: email
description: Read, search, and forward emails via IMAP/SMTP. Use when checking inbox, finding verification codes, forwarding messages, or any email-related tasks. Supports qsttheory.com mail server.
---

# Email Skill

Read and manage emails via IMAP, send/forward via SMTP.

## Configuration

Mail credentials stored in `~/.config/email/credentials.json`:

```json
{
  "server": "qsttheory.com",
  "username": "leesi",
  "password": "prime_minister_mail",
  "email": "leesi@qsttheory.com"
}
```

## Quick Reference

### List Recent Emails

```bash
python3 ~/.openclaw/workspace/skills/email/scripts/email_client.py list --limit 10
```

### Search for Verification Codes

```bash
python3 ~/.openclaw/workspace/skills/email/scripts/email_client.py search --subject "MiniMax" --extract-code
```

### Forward an Email

```bash
python3 ~/.openclaw/workspace/skills/email/scripts/email_client.py forward --id 1 --to king@qsttheory.com
```

### Read Full Email

```bash
python3 ~/.openclaw/workspace/skills/email/scripts/email_client.py read --id 1
```

## Important Notes

- Username for IMAP login is `leesi` (without domain), not `leesi@qsttheory.com`
- When extracting verification codes, look for 6-digit numbers in the HTML body
- Beware of color codes like `#222222` — they are NOT verification codes
- Verification codes are typically in `<div>` elements with specific styling