核心用法
CaduceusMail 是一个面向 OpenClaw 的企业级邮件与 DNS 自动化技能,采用"本地固定版本"架构设计。它不依赖运行时 npm 拉取,而是将经过审计的 caduceusmail 发布包以 vendored 形式内置,通过 SHA-512 完整性校验后解压到隔离缓存目录执行。
典型工作流:
1. 诊断:doctor 命令验证环境完整性
2. 初始化:bootstrap 完成 M365 设备登录流与 DNS 基线配置
3. 日常运行:bootstrap --skip-m365-bootstrap 跳过认证步骤直接执行
4. 通道管理:provision-lane/verify-lane/retire-lane 管理子域邮件通道(支持 reply/no-reply 模式)
显著优点
- 供应链安全:运行时零网络代码获取,SHA-512 锁定 + 只读权限控制,消除 npm 供应链攻击面
- 最小权限隔离:仅转发 CaduceusMail/OpenClaw/M365/Cloudflare 必需变量,默认阻断外部脚本解析
- 审计友好:所有状态写入
~/.caduceusmail/intel,机器可读产物支持合规追踪 - 无头部署:设备代码流支持 VPS/SSH 无浏览器场景,通过 OpenClaw 网关/浏览器钩子完成交互
潜在局限
- 环境门槛:需预装 bash/node/python3/jq,且依赖 7 个敏感环境变量(Entra/Cloudflare 凭证)
- 权限激进:需要 Microsoft Graph 应用角色、Exchange RBAC、Cloudflare DNS 变异权限,误配置风险高
- 云锁定:深度绑定 M365 + Cloudflare 生态,迁移成本显著
- 单点维护:vendored 版本需手动跟进上游安全更新
适合人群
- 运维团队需自动化管理 M365 Exchange + Cloudflare DNS 的中小企业
- 对供应链安全有强要求、拒绝运行时依赖拉取的安全敏感组织
- 具备 Entra ID 与 Cloudflare API 管理经验的 DevSecOps 工程师
常规风险
- 凭证泄露:7 个环境变量含高权限密钥,注入方式不当(如日志、进程列表)可导致横向移动
- DNS 漂移:自动化 DNS 变更若缺乏变更审批流程,可能造成邮件路由中断
- 权限膨胀:"least-privilege"仅为建议,实际配置易因便利起见授予过度 Graph/Exchange 角色
- 版本滞后:固定版本若长期不审计更新,可能累积未修复漏洞