这段时间 OpenClaw 的热度大家有目共睹群里天天有人问怎么接入微信、怎么部署本地模型但我发现一个容易被忽略的需求怎么让智能体自己收发邮件。很多人的第一反应是直接调 Gmail API 或者网易邮箱的 API但实际上有一个更轻、更通用的方案就是给 OpenClaw 装一个基于 himalaya 的邮件 Skill。我在本地 Mac mini 上完整跑通了这个流程也踩了几个很典型的坑这里把整个思路、代码和排错过程都整理出来。1. 为什么选 himalaya 而不是直接调各家邮箱 API先说结论如果你只是想让 OpenClaw 在本地跑起来并且能读邮件、回邮件、按条件搜索邮件himalaya 是当前性价比最高的选择。它不挑邮箱服务商不需要申请开发者应用更不需要处理 OAuth 的各种回调。himalaya 本身是一个用 Rust 写的命令行邮件客户端它支持的协议是 IMAP 和 SMTP。这两个协议是邮件领域的事实标准国内外的邮箱服务商基本全都兼容。也就是说你只要有一个邮箱账号和它的 IMAP/SMTP 授权码就能让 OpenClaw 通过 himalaya 完成读信和发信。我之前也试过直接写 Python 脚本调用 Gmail API但那个流程实在太重了。你要去 Google Cloud Console 创建项目、启用 Gmail API、配置 OAuth 同意屏幕、下载 credentials.json然后还要处理 token 刷新。如果邮箱换成 QQ 邮箱或者 Outlook整套流程又要重来一遍。而 himalaya 的配置就是一个 TOML 文件把服务器地址、端口、账号、授权码填进去就完事了。还有一个很现实的因素是 OpenClaw 的 Skill 机制。Skill 的本质就是把一个具体能力封装成智能体可以调用的工具模型只需要知道这个工具能做什么、怎么用不需要关心底层实现。himalaya 是纯命令行工具输出是结构化的文本文案OpenClaw 的脚本层可以直接捕获它的 stdout 然后丢给模型去理解这个链路天然就是通的。我个人的建议是如果你是自用、内网部署或者折腾阶段不要一上来就引入重型 SDK先用 himalaya 把邮件能力打通后面真有高并发或复杂的邮件处理需求再考虑替换。2. 环境准备与安装路径上的细节我本地环境是 Mac mini 配了 DockerOpenClaw 跑在容器里面。himalaya 这个工具需要装到 OpenClaw 容器内或者装到宿主机上然后通过卷挂载让它能在容器里被调用。两种方式我都试过最顺手的是直接装进容器并在构建镜像时固定版本。安装命令很简单官方提供了一个安装脚本但国内网络环境执行 curl 脚本经常超时。我更推荐直接从 GitHub Releases 页面下载编译好的二进制文件。你需要注意你容器的基础架构Mac 上如果是 Docker Desktop容器一般是 linux/arm64但如果你是 x86 的服务器就要选 amd64 的包。# 下载 himalaya 0.9.0 版本示例实际请以官方仓库为准 wget https://github.com/pimalaya/himalaya/releases/download/v0.9.0/himalaya-linux-amd64.tar.gz tar -xzf himalaya-linux-amd64.tar.gz mv himalaya /usr/local/bin/ himalaya --version这里有个容易踩的坑OpenClaw 的 Skill 脚本在执行命令时PATH 环境变量不一定包含/usr/local/bin。尤其是你通过 Docker 部署 OpenClaw 时容器里的 cron 或者特定服务的环境变量可能被裁剪过。最好的做法是在 Skill 脚本里写死 himalaya 的绝对路径或者直接在脚本开头 export PATH。我测试时发现一个更隐蔽的问题OpenClaw 容器内的默认用户未必是 root可能是普通用户。如果你用 root 权限安装了 himalaya但 OpenClaw 进程以普通用户运行执行时可能会遇到配置目录权限不足的问题。himalaya 默认会去$HOME/.config/himalaya/config.toml找配置所以你得确保这个配置文件对 OpenClaw 的运行用户是可读的。我最终的做法是在 Dockerfile 里预留了这一步RUN wget https://github.com/pimalaya/himalaya/releases/download/v0.9.0/himalaya-linux-amd64.tar.gz \ tar -xzf himalaya-linux-amd64.tar.gz \ mv himalaya /usr/local/bin/ \ mkdir -p /home/appuser/.config/himalaya \ chown -R appuser:appuser /home/appuser/.config/himalaya3. 邮箱授权配置与 IMAP/SMTP 协议参数himalaya 的配置是所有环节里最需要耐心的。你需要在~/.config/himalaya/config.toml里至少配置一个账户指定它的 IMAP 和 SMTP 服务器信息。这里不建议直接使用邮箱的登录密码而是要去邮箱服务商那里开启 IMAP/SMTP 服务并生成一个专用的授权码。拿 QQ 邮箱举例你在设置里开启 IMAP/SMTP 服务后会得到一串授权码这个授权码才是配置里要填的密码。Gmail 的话如果你没有开启两步验证可以直接用应用专用密码但如果你用了 OAuth 相关的设置反而会绕晕。配置文件的完整样子[accounts.work] email yournameqq.com display-name Your Name backend.type imap backend.host imap.qq.com backend.port 993 backend.encryption tls backend.login yournameqq.com backend.auth.type password backend.auth.password 你的授权码 message.send.backend.type smtp message.send.backend.host smtp.qq.com message.send.backend.port 465 message.send.backend.encryption tls message.send.backend.login yournameqq.com message.send.backend.auth.type password message.send.backend.auth.password 你的授权码这里有个细节希望你注意IMAP 的端口一般用 993对应的加密方式是 TLS。但有部分服务商用的是 143 端口的 STARTTLS。如果你配置 993 连不上可以试试 143 并且把 encryption 改成 starttls。SMTP 这边QQ 邮箱和网易邮箱一般用 465 端口加上 TLS而 Gmail 除了 465 之外也支持 587 端口的 STARTTLS。我的经验是优先选择 465 TLS因为 STARTTLS 在部分网络环境下会被干扰导致握手失败。配置完成后先用命令行做一次自检himalaya account list himalaya envelope list -a work -s 5如果能看到邮件列表说明 IMAP 部分没问题。再测试发送himalaya message send --account work --to testexample.com --subject test --body hello这一步能跑通说明 SMTP 也通了。注意不要急着在 Skill 里调用先在终端里确认基础能力后面排查问题会省很多时间。授权码过期是另一个高频问题。很多邮箱的授权码不会永久有效比如部分企业邮箱会强制定期重置。一旦 Skill 突然报错说认证失败优先怀疑授权码过期重新生成一份更新到配置里就行。4. Skill 目录结构与 skill.toml 的编写思路OpenClaw 的 Skill 机制我理解下来本质上就是一个“行为包”。一个 Skill 目录里包含一个skill.toml元数据文件以及若干脚本或资源。skill.toml的作用是告诉 OpenClaw 这个技能叫什么、作用是什么、如何被触发而脚本则是真正执行动作的逻辑。针对 himalaya 邮件技能我设计的 Skill 结构如下himalaya-skill/ ├── skill.toml ├── scripts/ │ ├── list_emails.sh │ ├── send_email.sh │ └── search_email.sh └── prompts/ └── instructions.mdskill.toml里最关键的是描述怎么写。OpenClaw 的模型会根据描述来决定是否调用这个 Skill所以描述要包含足够的触发关键词同时说明它能做什么。name himalaya-mail description 通过 himalaya 命令行工具收发邮件。当用户要求查看收件箱、发送邮件、搜索邮件时使用。包含 list、send、search 子命令。 version 1.0.0 author yourname这个描述不需要写得太长但要把触发条件说清楚。我见过有人把整个使用手册塞进 description结果模型反而抓不住重点。描述的作用是路由不是教程。真正的使用教程应该放在prompts/instructions.md里模型调用 Skill 后会读取这个文件来理解具体怎么操作。scripts/list_emails.sh的功能很简单封装了 himalaya 的列表命令同时管理默认账户和分页参数。#!/bin/bash ACCOUNT${1:-work} PAGE_SIZE${2:-10} export PATH/usr/local/bin:$PATH himalaya envelope list --account $ACCOUNT --page-size $PAGE_SIZE这里我特意允许脚本接收两个参数这样模型可以根据用户的需求动态调整要拉取的邮件数量。如果你把页码写死成 10用户说“看最近 50 封邮件”时模型就不知道怎么处理了。Skill 脚本的参数设计同样重要要预留足够的灵活性。scripts/send_email.sh需要处理更多参数因为发送邮件至少涉及收件人、主题和正文。命令行传参时如果正文里有空格、换行或特殊字符容易出问题。我的方案是把正文写入临时文件再用命令替换的方式传给 himalaya。#!/bin/bash TO$1 SUBJECT$2 BODY_FILE$3 ACCOUNT${4:-work} if [ ! -f $BODY_FILE ]; then echo Error: body file not found exit 1 fi BODY$(cat $BODY_FILE) export PATH/usr/local/bin:$PATH himalaya message send \ --account $ACCOUNT \ --to $TO \ --subject $SUBJECT \ --body $BODY在模型调用场景里正文内容往往很长如果直接作为命令行参数传入很容易超过 shell 的参数长度限制或者被特殊字符干扰。所以我想了个办法OpenClaw 的脚本执行环境一般会先落一个临时文件再调用脚本执行。我在send_email.sh里只接收文件路径这样能最大程度避免各种转义问题。5. 从收件箱到洞察添加邮件检索与摘要能力只做收发其实还不够。实际使用中你会发现用户更常问的是“帮我看看有没有老王发的邮件”“上周那封关于合同的邮件在哪”。这种情况下你不可能让模型把收件箱里所有邮件都拉下来一条条找太慢了。所以需要给 Skill 增加一个搜索功能让 himalaya 帮我们过滤。himalaya 的envelope list支持一定的过滤机制比如按时间范围或按发件人。你可以封装专门的脚本#!/bin/bash # search_email.sh FROM$1 DATE$2 ACCOUNT${3:-work} SEARCH_CMDhimalaya envelope list --account $ACCOUNT if [ -n $FROM ]; then SEARCH_CMD$SEARCH_CMD --from $FROM fi if [ -n $DATE ]; then SEARCH_CMD$SEARCH_CMD --since $DATE fi export PATH/usr/local/bin:$PATH eval $SEARCH_CMD这里用 eval 是有点风险但参数来源是模型生成的大多数情况下不会遇到恶意指令。如果你不放心可以改成数组拼接再执行我为了示例简洁用了 eval实际部署建议用更严谨的写法。搜索能力加上之后还有一个进阶玩法让模型对邮件做摘要。模型本身天然擅长总结文本所以这一步不需要额外脚本只需要在prompts/instructions.md里告诉模型“先搜索邮件再对邮件正文进行分析总结”。核心链路是搜索 - 过滤 - 读取正文 - 模型总结。读取邮件正文需要调用 himalaya 的message read命令。这里有个坑himalaya 默认读出来的邮件内容可能包含 MIME 编码信息比如quoted-printable或base64编码的中文乱码。你需要在脚本里做解码或者让 himalaya 直接输出纯文本部分。实测下来0.9 版本对大部分纯文本邮件处理得还不错但碰到 HTML 邮件时输出会比较乱。解决方案是调整 himalaya 的配置让它读取时优先返回 text/plain 部分的 content。6. 把 Email Skill 接入 OpenClaw 工作流的三个层次装好 Skill 只是第一步真正能用起来需要处理好接入方式。我根据实用程度把接入分成三个层次你可以根据自己的需求选择。第一层次是手动触发。用户在和 OpenClaw 对话时说“查看我的收件箱”模型判断这个请求匹配 himalaya-mail Skill就执行脚本并把结果返回给用户。这个层次的接入不需要额外开发只需要把 Skill 目录放到 OpenClaw 指定的加载路径下即可。部署后最好重启一下 OpenClaw 服务让 Skill 清单刷新。第二层次是自动化触发。比如每天上午十点自动拉取未读邮件并生成摘要。这种场景下你可以不依赖用户主动对话而是通过 OpenClaw 的定时任务或者外部 cron 触发 Skill。你需要额外写一个调度脚本定时调用 OpenClaw 的接口或直接运行底层脚本模块。需要特别注意的是定时任务里一定要设置好环境变量和 PATH否则 himalaya 可能找不到。第三层次是事件驱动。比如收到特定发件人的邮件后自动触发后续动作比如写入数据库、更新任务列表。这个层次需要你监听邮箱或邮件推送服务把事件转换成 OpenClaw 的触发条件复杂度更高但如果做成了自动化体验会很完整。我的建议是不要一上来就追求第三个层次。先把手动触发跑通再逐步加自动摘要和定时巡检一步步来。7. 实测排错遇到 OpenClaw 调用 Skill 却找不到 himalaya 的完整排查链路我在部署过程中遇到最典型的一个问题就是 Skill 脚本明明在终端里执行正常但 OpenClaw 一调用就报command not found。这里分享一下完整排查思路对新手应该很有帮助。第一步确认 OpenClaw 运行环境的用户和 shell。终端是你自己登录的用户但 OpenClaw 的服务可能跑在 systemd、Docker 或其他进程管理器下环境变量完全不同。我直接用ps aux | grep openclaw查看进程的用户发现是openclaw这个系统用户而不是我的日常用户。第二步验证 himalaya 的安装位置是否在 systemd 或 Docker 的 PATH 里。我执行了sudo -u openclaw which himalaya结果为空。虽然 himalaya 在/usr/local/bin下但那个用户的 PATH 没有包含/usr/local/bin导致找不到命令。解决办法是在 Skill 脚本里显式指定全路径或者把路径加到系统级 PATH 配置里。第三步检查配置文件权限。即使命令找到了himalaya 读取配置时如果权限不足也会报错。我把配置文件所在目录的权限调成了 755配置文件本身是 644确保所有用户都可以读。第四步测试过程中还遇到一个隐藏坑OpenClaw 调用脚本时的工作目录不是固定的。如果你的脚本里用了相对路径去读取某个文件很可能会因为工作目录不同而失败。所有涉及路径的地方都建议用绝对路径或者基于脚本所在目录动态计算。经过这四步问题基本都解决了。如果你还遇到IMAP connection error那就不是 Skill 的问题而是网络连不上邮箱服务器。国内服务器连 Gmail 经常会遇到这种情况可以考虑换用国内邮箱或者在网络层做相应配置。8. 收尾一个让邮件 Skill 更好用的细节最后分享一个实用细节。himalaya 输出的日期格式默认可能是 RFC 2822 风格的比如Tue, 25 Jun 2024 10:00:00 0800。这种格式直接丢给模型模型能看懂但如果你想让邮件列表在终端里更好看或者让 OpenClaw 在返回结果时更简洁可以在脚本里把日期转换成YYYY-MM-DD HH:MM格式。转换可以用 date 命令做到formatted_date$(date -d $raw_date %Y-%m-%d %H:%M)但这里要注意macOS 自带的 date 和 Linux 的 date 参数不一致-d在 mac 上是无效的。如果你在 Mac 上直接测试脚本没问题但部署到 Linux 容器后反而报错大概率就是 date 命令的兼容性问题。稳妥的写法是先用python3做日期解析或者干脆不做转换让模型自己处理日期格式。实测下来大模型对 RFC 2822 格式的日期理解得很好所以这个转换其实可有可无我最后选择了不做转换省去一层兼容性麻烦。邮件自动化这个方向真正玩起来之后价值还是很大的。你可以让 OpenClaw 帮你盯着某个邮箱的特定邮件也可以让它定时整理周报素材。结合 himalaya 这种轻量工具和 OpenClaw 的灵活 Skill 机制你不用被任何单一邮箱服务商绑定整个流程链路清晰可控遇到问题也能一步步排查到底。