Back to Registry
View Author Profile
Official Verified
Bee Push Email Skill
Skill by canihojr
skill-install — Terminal
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/canihojr/bee-push-email-skillOr
name: bee-push-email description: Push email notifications via IMAP IDLE + Himalaya + OpenClaw agent. Detects new emails in real-time and triggers the agent to process and notify the user. Use when: setting up email push notifications, configuring IMAP watcher, installing bee-push-email system, testing email connectivity, checking system dependencies, viewing email-push config, troubleshooting IMAP IDLE watcher, or managing the imap-watcher systemd service. Also handles uninstall/cleanup of the bee-push-email system. Trigger on beemail commands: /beemail, /beemail_start, /beemail_stop, /beemail_status, /beemail_test, /beemail_reply, /beemail_reply_off, /beemail_reply_ask, /beemail_reply_on. Also: start watcher, stop watcher, watcher status, email push status, registrar comandos, comandos no aparecen, beemail no funciona en telegram. emoji: 📧 requirements: bins: - python3 - systemctl - openclaw
Email Push — IMAP IDLE → OpenClaw Agent → User Notification
Real-time email monitoring: IMAP IDLE detects new emails, triggers OpenClaw agent to process and notify the user via their active channel.
Security & Permissions
The agent MUST explicitly inform the user of all actions below and obtain approval before starting installation. Do not proceed without confirmed user consent.
What this skill installs (requires root)
| Action | Path / Target | Notes |
|---|---|---|
| System user | imap-watcher (useradd -r) | Service runs as this non-root user |
| Python venv | /opt/imap-watcher/ | Isolated env, not system-wide |
| pip package | imapclient (inside venv only) | Not installed system-wide |
| Watcher script | /opt/imap-watcher/imap_watcher.py | Copied from skill directory |
| systemd unit | /etc/systemd/system/imap-watcher.service | Enabled + started, restarts on boot |
| Config file | /opt/imap-watcher/watcher.conf | chmod 600, owner imap-watcher only |
| Log file | /var/log/imap-watcher.log | chmod 640, owner imap-watcher |
External downloads (requires user awareness)
| What | From | Condition |
|---|---|---|
himalaya binary | github.com/pimalaya/himalaya/releases/latest/ | Only if not already installed |
| Method | curl | tar into /usr/local/bin/ | Writes a system binary |
Credentials accessed
| Credential | Source | Usage |
|---|---|---|
| IMAP email password | Provided by user at install time | IMAP IDLE connection |
Telegram botToken | Read from ~/.openclaw/openclaw.json | Registers /beemail* commands via Telegram API (setMyCommands) |
The bot token is never stored by this skill.
Auto-reply behaviour
By default, the agent is instructed not to reply to email senders. This prevents exposing that the system is active and avoids phishing/spam risks. The allow_auto_reply field in watcher.conf controls this:
Metadata
AI Skill Finder
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skill Add to Configuration
Paste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-canihojr-bee-push-email-skill": {
"enabled": true,
"auto_update": true
}
}
}Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.