Ravenclaw

# Ravenclaw Operations Skill

**Category:** Email Automation / Communication

**Description:** Operate the Ravenclaw Email Bridge — send emails, schedule future emails, check inbox, and manage email workflows. Forward POP3 emails to Discord webhooks with scheduled sending capabilities.

**Maintainer:** Ibrahim Qureshi (@ibrahimq21)

**Tags:** email, discord, webhook, automation, smtp, pop3, scheduled

---

## Capabilities

- Send immediate emails via SMTP
- Schedule emails for future delivery
- Check inbox and unread emails
- Trigger manual email checks
- View scheduled email queue
- Cancel scheduled emails
- Health checks and statistics

---

## Requirements

### Local Setup (for direct operation)

**Ravenclaw must be running:**
```bash
# Start Ravenclaw bridge
cd path/to/ravenclaw
python ravenclaw.py

# Default port: 5002
```

**Environment variables:**
- `RAVENCLAW_URL` (optional): Custom URL for Ravenclaw API (default: `http://localhost:5002`)

### Community Sharing

For users to use this skill:
1. They must have Ravenclaw installed locally
2. Ravenclaw must be running
3. Configuration via environment or `RAVENCLAW_URL`

---

## Commands

### Send Email

Send an immediate email.

**Pattern:**
```
send email to [recipient] with subject [subject] and body [body]
```

**Example:**
```
send email to manager@company.com with subject "Leave Request" and body "I would like to take leave tomorrow."
```

**Parameters:**
- `recipient` (required): Email address
- `subject` (required): Email subject line
- `body` (required): Email content

**API Call:** `POST /send`

---

### Schedule Email

Schedule an email to be sent at a specific time.

**Pattern:**
```
schedule email to [recipient] with subject [subject] and body [body] at [time]
```

**Example:**
```
schedule email to hr@company.com with subject "Leave Application" and body "Requesting leave for next Monday" at "2026-02-23T09:00:00"
```

**Parameters:**
- `recipient` (required): Email address
- `subject` (required): E...

# Ravenclaw Operations Skill

**OpenClaw Skill for Ravenclaw Email Bridge Management**

---

## What This Skill Does

This skill lets you operate the [Ravenclaw Email Bridge](https://github.com/ibrahimq21/ravenclaw) through natural language commands:

- Send emails via SMTP
- Schedule emails for future delivery
- Check inbox and unread emails
- View and cancel scheduled emails
- Monitor system health

---

## Installation

### For OpenClaw Users

1. This skill comes pre-installed with OpenClaw
2. Configure Ravenclaw URL (optional):
   ```bash
   export RAVENCLAW_URL="http://localhost:5002"
   ```

### For Community Sharing

1. Copy the `ravenclaw/` folder to your OpenClaw skills directory:
   ```
   ~/.openclaw/skills/  # Linux/Mac
   %USERPROFILE%\.openclaw\skills\  # Windows
   ```

---

## Quick Start

### 1. Start Ravenclaw

```bash
cd /path/to/ravenclaw
python ravenclaw.py
```

### 2. Configure .env

```env
EMAIL_HOST=mail.yourdomain.com
EMAIL_USERNAME=your@email.com
EMAIL_PASSWORD=yourpassword
DOMAIN_FILTER=yourdomain.com
```

### 3. Use the Skill

**Natural language commands:**

```
send email to manager@company.com with subject "Leave Request" and body "Taking leave tomorrow"

schedule email to hr@company.com with subject "Leave Application" and body "Requesting Feb 20-24 off" at "2026-02-16T09:00:00"

show inbox
list unread emails
check inbox
show scheduled emails
```

---

## Available Commands

| Command | Description |
|---------|-------------|
| `send email to [to] with subject [sub] and body [body]` | Send immediate email |
| `schedule email to [to] with subject [sub] and body [body] at [time]` | Schedule for future |
| `list scheduled emails` | Show pending scheduled emails |
| `cancel scheduled email [id]` | Cancel a scheduled email |
| `check inbox` | Trigger manual email fetch |
| `show unread emails` | List unread messages |
| `show inbox` | List all emails |
| `ra...