Ews Email
by @guyun94
CLI to manage enterprise Outlook emails via Exchange Web Services (EWS). Use ews-mail.py to list, read, reply, forward, search, send, move, delete emails and...
clawhub install ews-email📖 About This Skill
license: MIT name: ews-email version: 1.2.0 description: "CLI to manage enterprise Outlook emails via Exchange Web Services (EWS). Use ews-mail.py to list, read, reply, forward, search, send, move, delete emails and download attachments." metadata: openclaw: emoji: "📧" requires: bins: ["python3"] pips: ["keyring", "exchangelib"] primaryEnv: "EWS_EMAIL"
EWS Email CLI
A CLI for enterprise Exchange (EWS) email. Use when the user asks about email, inbox, messages, or mail.
Setup
1. 环境变量
在 ~/.openclaw/config.yaml 中配置:
env:
EWS_SERVER: "your-exchange-server.com"
EWS_EMAIL: "you@company.com"
2. 存储密码
#### macOS(自动使用 Keychain,无需额外配置)
pip3 install keyring exchangelib
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py setup
#### Linux 云服务器(无桌面环境)
脚本会自动检测 Linux 无桌面环境,切换到 EncryptedKeyring 后端(AES 加密文件存储)。
# 安装依赖
pip3 install keyring exchangelib keyrings.alt设置 master password 环境变量(用于加解密 EWS 密码)
在 ~/.openclaw/config.yaml 中添加:
env:
KEYRING_CRYPTFILE_PASSWORD: "你自己定义的一个强密码"
#
或在 systemd service / 启动脚本中 export:
export KEYRING_CRYPTFILE_PASSWORD="你自己定义的一个强密码"存储 EWS 密码(会用 AES 加密写入本地文件)
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py setup验证
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py folder-list
重启后只要 KEYRING_CRYPTFILE_PASSWORD 环境变量还在,密码就能正常解密读取,无需重新输入。
3. 验证安装
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py folder-list
SECURITY RULES
setup command.IMPORTANT: Reading Email Content
To read the FULL content/body of an email, you MUST follow these two steps:
1. First run envelope-list to get the message list (this gives you numeric IDs)
2. Then run message-read to get the FULL email body/content
envelope-list only shows subject lines and metadata. It does NOT contain the email body.
You MUST run message-read to get the actual email content. NEVER guess or summarize based on subject alone.
NEVER say you cannot read email content — you CAN, by running message-read.
Script Location
~/.openclaw/skills/ews-email/scripts/ews-mail.py
Commands
List Emails (step 1 — metadata only)
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py envelope-list
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py envelope-list --page 2 --page-size 20
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py envelope-list --folder "Sent"
Read Email Body (step 2 — REQUIRED for content)
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py message-read
Search Emails
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py envelope-list from sender@example.com
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py envelope-list subject keyword
Send / Reply / Forward
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py message-send --to "email" --subject "subject" --body "body"
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py message-send --to "a@x.com" --cc "b@x.com" --subject "Hi" --body "msg"
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py message-reply --body "reply text"
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py message-reply --body "reply text" --all
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py message-forward --to "email" --body "FYI"
Other Commands
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py folder-list
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py message-move "Archive"
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py message-delete
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py attachment-download --dir ~/Downloads
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py flag-add --flag seen
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py flag-remove --flag seen
Tips
envelope-list output.envelope-list first before message-read, message-reply, etc.--page and --page-size to navigate large inboxes.⚙️ Configuration
1. 环境变量
在 ~/.openclaw/config.yaml 中配置:
env:
EWS_SERVER: "your-exchange-server.com"
EWS_EMAIL: "you@company.com"
2. 存储密码
#### macOS(自动使用 Keychain,无需额外配置)
pip3 install keyring exchangelib
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py setup
#### Linux 云服务器(无桌面环境)
脚本会自动检测 Linux 无桌面环境,切换到 EncryptedKeyring 后端(AES 加密文件存储)。
# 安装依赖
pip3 install keyring exchangelib keyrings.alt设置 master password 环境变量(用于加解密 EWS 密码)
在 ~/.openclaw/config.yaml 中添加:
env:
KEYRING_CRYPTFILE_PASSWORD: "你自己定义的一个强密码"
#
或在 systemd service / 启动脚本中 export:
export KEYRING_CRYPTFILE_PASSWORD="你自己定义的一个强密码"存储 EWS 密码(会用 AES 加密写入本地文件)
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py setup验证
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py folder-list
重启后只要 KEYRING_CRYPTFILE_PASSWORD 环境变量还在,密码就能正常解密读取,无需重新输入。
3. 验证安装
python3 ~/.openclaw/skills/ews-email/scripts/ews-mail.py folder-list
📋 Tips & Best Practices
envelope-list output.envelope-list first before message-read, message-reply, etc.--page and --page-size to navigate large inboxes.