- name
- email
- description
- AI-powered IMAP email client with semantic search, intelligent triage, and graduated autonomy. Manages email through natural conversation.
- metadata
- {"clawdbot":{"emoji":"📧","requires":{"bins":"[Truncated]"},"permissions":["network:imap","network:smtp"]}}
- user-invocable
- true
# Email Skill
Manage your email through natural conversation with AI-powered intelligence.
## CLI Usage
Run commands via node:
```bash
node ~/projects/clawdbot-email/dist/cli.js <command> [options]
```
## Commands
### List inbox messages
```bash
node ~/projects/clawdbot-email/dist/cli.js inbox
node ~/projects/clawdbot-email/dist/cli.js inbox --limit 20
```
### Read a specific message
```bash
node ~/projects/clawdbot-email/dist/cli.js read <uid>
```
### Semantic search
```bash
node ~/projects/clawdbot-email/dist/cli.js search "project deadlines"
node ~/projects/clawdbot-email/dist/cli.js search "invoices from last month"
```
### List folders
```bash
node ~/projects/clawdbot-email/dist/cli.js folders
```
### Archive message
```bash
node ~/projects/clawdbot-email/dist/cli.js archive <uid>
```
### Delete message (move to trash)
```bash
node ~/projects/clawdbot-email/dist/cli.js delete <uid>
```
### Move message to folder
```bash
node ~/projects/clawdbot-email/dist/cli.js move <uid> Projects
```
### Star/flag message
```bash
node ~/projects/clawdbot-email/dist/cli.js star <uid>
```
### Mark as read
```bash
node ~/projects/clawdbot-email/dist/cli.js mark-read <uid>
```
### Compose and send email
```bash
# Simple send
node ~/projects/clawdbot-email/dist/cli.js send \
--to "recipient@example.com" \
--subject "Hello" \
--body "Email body text"
# Multiple recipients
node ~/projects/clawdbot-email/dist/cli.js send \
--to "a@example.com,b@example.com" \
--cc "c@example.com" \
--bcc "d@example.com" \
--subject "Team Update" \
--body "Meeting notes..."
# Body from stdin
echo "Message body" | node ~/projects/clawdbot-email/dist/cli.js send \
--to "user@example.com" \
--subject "Piped content" \
--stdin
```
### Reply to message
```bash
# Reply to sender
node ~/projects/clawdbot-email/dist/cli.js reply <uid> --body "Thank you for your email"
# Reply all
node ~/projects/clawdbot-email/dist/cli.js reply <uid> --body "Response" --all
```
### Forward message
```bash
node ~/projects/clawdbot-email/dist/cli.js forward <uid> --to "colleague@example.com"
node ~/projects/clawdbot-email/dist/cli.js forward <uid> --to "user@example.com" --body "FYI"
```
### List attachments
```bash
node ~/projects/clawdbot-email/dist/cli.js attachments <uid>
```
### Download attachments
```bash
# Download all attachments
node ~/projects/clawdbot-email/dist/cli.js download <uid>
# Download specific attachment by index
node ~/projects/clawdbot-email/dist/cli.js download <uid> 0
# Download to specific path
node ~/projects/clawdbot-email/dist/cli.js download <uid> --output ./downloads/
```
## Account Management
### List accounts
```bash
node ~/projects/clawdbot-email/dist/cli.js accounts
```
### Add account
```bash
node ~/projects/clawdbot-email/dist/cli.js accounts add \
--imap-host imap.gmail.com \
--email user@gmail.com \
--password "app-password" \
--provider gmail
```
### Remove account
```bash
node ~/projects/clawdbot-email/dist/cli.js accounts remove <account-id>
```
## Settings
### View settings
```bash
node ~/projects/clawdbot-email/dist/cli.js settings
```
### Set autonomy level
```bash
node ~/projects/clawdbot-email/dist/cli.js settings --autonomy L1
```
## Autonomy Levels
| Level | Description |
|-------|-------------|
| L0 | Manual: All actions require confirmation |
| L1 | Assisted: Read auto, writes need confirmation |
| L2 | Supervised: Most auto, sends need confirmation |
| L3 | Autonomous: Full automation (use with caution) |
## Environment Variables
- `EMAIL_CONFIG_PATH` - Config directory path (default: ~/.clawdbot/email)
## Provider Support
- Gmail (imap.gmail.com)
- Outlook (outlook.office365.com)
- iCloud (imap.mail.me.com)
- Yahoo (imap.mail.yahoo.com)
- FastMail (imap.fastmail.com)
- ProtonMail (127.0.0.1 via bridge)
- Any IMAP server
Voir sur GitHub