sendook-openclaw

📧 预配置邮箱的自动化收发助手

办公榜 #35

基于 Sendook 平台的纯文档型邮件自动化技能,支持预配置收件箱的安全读写与回复,通过明确 Scope 限制和附件安全警告,助力 AI Agent 高效处理邮件通信。

收藏
11.6k
安装
3.4k
版本
v1.1.0
CLS 安全性认证2026-05-13
点击查看完整报告 >

使用说明

Sendook OpenClaw 是一款专为 AI Agent 设计的邮件自动化技能,通过调用 Sendook 平台 API 实现预配置收件箱的邮件读取、搜索、发送与回复功能。该技能采用纯文档型架构,仅提供 TypeScript 和 cURL 示例代码,无实际可执行脚本,从根本上消除了代码注入和远程代码执行风险。

核心用法围绕邮件生命周期管理展开。开发者可通过环境变量配置 SENDOOK_API_KEY 和 SENDOOK_INBOX_ID,利用提供的 SDK 示例或 REST API 直接操作收件箱。功能涵盖消息列表检索(支持正则搜索)、单条消息获取、线程(Thread)管理、新邮件发送及回复。特别值得注意的是,附件发送功能内置严格的安全警告,要求必须获得用户明确授权后方可读取本地文件,并明确禁止访问工作目录外的敏感路径。

该技能的显著优势在于其清晰的安全边界设计。文档明确声明功能仅限于消息操作,严禁创建或删除收件箱、管理域名及配置 Webhook,有效防止权限越界。同时提供了完善的错误处理示例和 HTTP 状态码说明表,帮助开发者优雅处理 400/401/404/429 等常见异常。环境变量配置方式符合最小权限原则,建议使用仅针对目标收件箱授权的 API 密钥。

然而,该技能也存在一定局限性。首先,功能范围严格受限,无法满足需要动态管理收件箱或配置域名的场景。其次,虽然技能本身安全,但实际运行依赖第三方 npm 包 @sendook/node,文档未提供版本锁定建议,存在供应链攻击风险。此外,作为 T3 来源(个人开发者账号)的项目,长期维护稳定性和安全更新频率存在不确定性。

适用群体主要包括:需要为 AI Agent 集成邮件收发能力的开发者、构建自动化客服或通知系统的工程师、以及已部署 Sendook 基础设施的企业用户。特别适合那些对安全性要求较高、希望避免复杂邮件服务器配置的团队。

使用风险方面,除上述第三方依赖风险外,还需注意 API 密钥的安全存储,避免通过日志泄露 SENDOOK_API_KEY。附件功能虽有人工确认要求,但具体实现仍取决于开发者代码质量,不当处理可能导致敏感文件泄露。此外,Sendook API 存在速率限制(429 错误),生产环境需实现退避重试机制以确保稳定性。

安全解读

核心用法

Sendook-openclaw 是一个面向 OpenClaw 平台的纯文档型 Skill,用于让 AI 代理读取和发送邮件。核心功能包括:列取/搜索邮件、获取单封邮件详情、查看对话线程、发送新邮件、回复邮件,以及带附件发送。所有操作均通过调用 Sendook 官方 REST API 完成,开发者可选择官方 Node.js SDK 或直接使用 curl 进行集成。

关键限制:该 Skill 严格限定为消息级操作——仅能操作预配置的单个收件箱,无法创建/删除收件箱、管理域名、配置 webhook 或管理 API 密钥。这种设计有意缩小攻击面,符合最小权限原则。

显著优点

1. 零代码执行风险:纯 Markdown + JSON 元数据,无可执行脚本,静态分析得分 95/100
2. API 端点可信:所有网络调用均指向官方域名 api.sendook.com,TLS 1.2+ 加密,无第三方服务

3. 权限申请克制:仅需 SENDOOK_API_KEY 和 SENDOOK_INBOX_ID 两个环境变量,无过度索权

4. 功能边界清晰:文档反复强调操作限制,降低误用风险

5. 代码示例完整:提供 TypeScript SDK 和 curl 两种调用方式,覆盖读取、发送、回复、附件等完整场景

6. 安全提示到位:附件操作章节明确要求用户确认,禁止读取敏感路径(~/.ssh、/etc 等)

潜在缺点与局限性

  • 来源可信度有限:由个人开发者(obaid)维护,GitHub 仓库活跃度未知,trust_level 评定为 T3(社区级)
  • 功能范围狭窄:无法管理收件箱生命周期,企业级多租户场景需配合其他工具
  • 无内置重试机制:文档展示基础错误处理,但无指数退避、熔断等生产级 resilience 模式
  • 依赖外部服务:完全依赖 Sendook 平台可用性,无离线降级能力
  • 审计日志外部化:邮件操作日志存储在 Sendook 服务端,Skill 本身无本地审计能力

适合人群

  • 需要 AI 代理自动化处理客户支持邮件的中小团队
  • 已使用 Sendook 邮件服务的现有用户
  • 对代码执行风险极度敏感、偏好纯文档型 Skill 的安全优先用户
  • 快速原型开发场景,需要数小时内搭建邮件自动化工作流

常规风险

  • API 密钥泄露:SENDOOK_API_KEY 以环境变量形式配置,若 workspace 权限配置不当可能导致横向泄露
  • 邮件滥发:获取发送权限的代理可能被诱导发送钓鱼或垃圾邮件,建议配合 Sendook 平台的发送速率限制和审核机制
  • 附件路径遍历:虽然文档有安全提示,但实际执行仍依赖调用方的路径校验实现
  • 供应商锁定:深度绑定 Sendook 生态,迁移成本较高

sendook-openclaw 内容

手动下载zip · 2.9 kB
SKILL.mdtext/markdown
请选择文件