Himalaya — OpenClaw Skill

What This Skill Does

The Himalaya skill gives your OpenClaw agent a full-featured email client that runs entirely in the terminal. Using the himalaya CLI, your agent can list emails in any folder, read message content, compose and send new emails, reply and reply-all, forward messages, search by sender or subject, download attachments, manage flags, move and copy messages between folders, and switch between multiple email accounts.

Himalaya connects directly to your email server via encrypted IMAP and SMTP -- no third-party services are involved. It works with any standard email provider including Gmail, Outlook, Yahoo, Fastmail, ProtonMail (via bridge), and self-hosted servers. Credentials are stored securely using your system keyring, the pass password manager, or a custom command.

This is one of the most powerful productivity skills in the OpenClaw ecosystem. Ask your agent to triage your inbox, draft replies, search for an old thread, or forward important messages to colleagues. It supports JSON output for structured processing and MML (MIME Meta Language) for composing rich emails with attachments. For messaging workflows beyond email, pair it with Slack or BlueBubbles.

Example Prompts

Show me my 10 most recent unread emails and summarize what each one is about

Search my inbox for emails from john@example.com about the Q1 budget

Reply to email #42 saying "Thanks, I'll review the proposal by Friday"

Compose a new email to team@company.com with subject "Sprint Planning" and the notes I just dictated

Download the attachments from that invoice email and save them to ~/Downloads

Move all emails from "Promotions" older than 30 days to the Archive folder

Forward email #15 to my manager with a note saying "FYI - needs your approval"

Switch to my work email account and show the latest messages in the Sent folder

Requirements

Binary dependency: himalaya

• macOS: brew install himalaya
• Config: ~/.config/himalaya/config.toml with IMAP/SMTP credentials
• Credentials: Stored via system keyring, pass, or custom command

Setup on KiwiClaw

Himalaya is pre-installed on all KiwiClaw tenant machines. Configure your email account credentials in the KiwiClaw dashboard under skill settings. IMAP/SMTP server details and authentication are stored securely. Once configured, your agent can manage your email immediately.

Setup Self-Hosted

1. Install Himalaya: brew install himalaya
2. Run the setup wizard: himalaya account configure
3. Or create ~/.config/himalaya/config.toml manually with IMAP/SMTP settings
4. Store passwords securely using pass, system keyring, or a custom command
5. Verify: himalaya envelope list to see your inbox

Related Skills

• Slack -- send team messages when email is too formal
• BlueBubbles -- send quick iMessages instead of emails
• Bear Notes -- save important email content to Bear for reference
• Nano PDF -- edit PDF attachments received via email

FAQ

What can the Himalaya skill do in OpenClaw?

Himalaya lets your OpenClaw agent list and read emails, compose and send new messages, reply and forward, search by sender/subject/keyword, manage folders, download attachments, flag/unflag messages, and support multiple email accounts -- all from the terminal.

What email providers work with Himalaya?

Any provider that supports IMAP/SMTP works with Himalaya, including Gmail, Outlook, Yahoo, ProtonMail (via bridge), Fastmail, and self-hosted mail servers. It also supports Notmuch and Sendmail backends. See the OpenClaw for teams guide for multi-account setups.

How are email credentials stored?

Himalaya supports multiple secure credential storage methods: system keyring, the pass password manager, or a custom command that outputs the password. Credentials are stored locally and never transmitted to third parties.

Is the Himalaya skill safe to use?

The Himalaya skill has been security-vetted by KiwiClaw. It is an open-source Rust CLI that connects directly to your email server via encrypted IMAP/SMTP. No data passes through third-party services.