← 返回 Skills 市场
cjboy007

Okki Sync Mail

作者 Jaden's built a claw · GitHub ↗ · v2.0.1 · MIT-0
cross-platform ⚠ suspicious
107
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install okki-sync-mail
功能描述
完整的邮件自动化解决方案,集成 OKKI CRM。支持 IMAP 邮件自动捕获、SMTP 发送邮件、dry-run 模式、发送日志、速率限制、定时发送、签名模板、邮件规则、连接池优化、邮件转发等功能。自动同步 inbound/outbound 邮件到 OKKI 创建跟进记录(remark_type=102)。
安全使用建议
This skill mostly does what it says (IMAP/SMTP + OKKI), but take these concrete precautions before installing or providing credentials: - Audit the following files first: discord-review.js, auto-capture.js, scripts/smtp.js, scripts/imap.js, and any files that call child_process.exec/execSync. They handle external network calls and spawn other programs. - Do NOT place global or agent-level secrets in a parent .env. The code attempts to load ../../.env (discord-review.js); supply only a skill-local .env in the skill folder to avoid accidental leakage. - If you don't intend to use Discord review, do not set DISCORD_BOT_TOKEN or configure Discord; otherwise the skill will send email drafts/content to discord.com. The skill does not list DISCORD_BOT_TOKEN in its declared env requirements — this is an undeclared external endpoint. - Run the skill in an isolated/test environment first (use a disposable mailbox and disposable OKKI test credentials). Confirm that --dry-run works and that real sends are blocked until you explicitly approve. - Because the skill spawns python scripts using paths you supply (OKKI_CLI_PATH, VECTOR_SEARCH_PATH), ensure those paths point to audited/trusted scripts; an attacker-supplied path could run arbitrary code. - Consider restricting filesystem access (ALLOWED_READ_DIRS) and network egress for the environment running this skill, or review/modify the code to stop reading parent .env and to require explicit approval before any outbound network call. If you cannot audit the code or are uncomfortable with Discord/external posting or with parent .env access, treat this skill as unsafe to run with production credentials.
功能分析
Type: OpenClaw Skill Name: okki-sync-mail Version: 2.0.1 The bundle is a comprehensive email automation and CRM synchronization tool for OKKI CRM. It is classified as suspicious because it utilizes `execSync` in `auto-capture.js` and `kb-retrieval.js` to execute local Python scripts with arguments derived from external email data (such as domains and search queries) without sufficient sanitization, creating a significant risk of command injection. While the skill includes proactive security instructions in `SKILL.md` to defend against prompt injection and implements path validation for file operations in `scripts/imap.js` and `scripts/smtp.js`, the combination of shell execution, broad file system access, and the transmission of sensitive email content to external APIs (OpenRouter and Discord) constitutes high-risk behavior. No evidence of intentional malice or data exfiltration to unauthorized endpoints was found.
能力评估
Purpose & Capability
Name/description require IMAP/SMTP and OKKI integration; required env vars (IMAP_*, SMTP_*, OKKI_CLI_PATH, VECTOR_SEARCH_PATH) and node/python binaries are coherent with the code (node scripts + python helper scripts). Requiring npm/node/python3 is reasonable given package.json and Python utilities.
Instruction Scope
SKILL.md and included scripts perform broad file and process actions: reading/writing local mail archive paths, running Python OKKI/vector-search scripts, and calling child_process.execSync. The code also posts email drafts/content to an external Discord channel (discord-review.js). Some instructions and files reference many absolute local paths (Obsidian vault, quotation workflow, workspace paths) and cron jobs — which is expected for an email automation tool but increases the surface area. Importantly, the skill's runtime reads .env files and other local files that are outside the skill directory (see discord-review.js's ENV_PATH = ../../.env), and the SKILL.md does not declare all environment variables actually used (e.g., DISCORD_BOT_TOKEN).
Install Mechanism
Registry metadata says 'instruction-only / no install spec', but package.json and package-lock.json are present and SKILL.md shows 'npm install' in Quick Start. The absence of a formal install spec in the manifest is an inconsistency (user will likely need to run npm install manually). No remote download URLs or suspicious installers were found.
Credentials
Declared envs (IMAP_*, SMTP_*, OKKI_CLI_PATH, VECTOR_SEARCH_PATH) are appropriate. However, code also tries to load DISCORD_BOT_TOKEN from a .env two directories up and uses process.env when spawning child processes, and discord-review.js will send email content to discord.com if configured — DISCORD_BOT_TOKEN is not declared in requires.env. Reading a parent .env risks exposing unrelated secrets (agent/system-level) and is disproportionate to a skill that should confine itself to its own config directory.
Persistence & Privilege
Skill is not always:true and is user-invocable (normal). It writes archives and review records to local directories and can be run from cron as documented. The main privilege concern is that configured review/approval pathways (Discord or local review files) can trigger actual sends via scripts/smtp.js; combined with undeclared credential access this increases risk if misconfigured, but the skill itself does not request forced global persistence or modify other skills.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install okki-sync-mail
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /okki-sync-mail 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.0.1
修复:移除 .env.example 中的敏感信息(邮箱地址和路径),使用占位符
v2.0.0
Version 2.0.0 — Major feature expansion and advanced email management. - Added advanced IMAP mailbox management: create, move, delete, list, and flag emails (star/unstar), supporting nested folders and irreversible deletion with a confirmation flag. - Enhanced IMAP search, fetch, and download operations, including filters by date, recentness, read/unread status, and mailbox/folder selection. - Improved SMTP sending: dry-run preview, scheduled (delayed) delivery, HTML support, quoting, reply threading, multi-recipient, multi-attachment, and granular sender/CC configuration. - Expanded documentation with clear configuration instructions and extensive command usage examples. - Integrated automatic email synchronization with OKKI CRM for seamless follow-up (remark_type=102). - Added support for rate limiting, logging, signature templates, mail rules, connection pool optimization, and scheduled task storage.
元数据
Slug okki-sync-mail
版本 2.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Okki Sync Mail 是什么?

完整的邮件自动化解决方案,集成 OKKI CRM。支持 IMAP 邮件自动捕获、SMTP 发送邮件、dry-run 模式、发送日志、速率限制、定时发送、签名模板、邮件规则、连接池优化、邮件转发等功能。自动同步 inbound/outbound 邮件到 OKKI 创建跟进记录(remark_type=102)。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 107 次。

如何安装 Okki Sync Mail?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install okki-sync-mail」即可一键安装,无需额外配置。

Okki Sync Mail 是免费的吗?

是的,Okki Sync Mail 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Okki Sync Mail 支持哪些平台?

Okki Sync Mail 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Okki Sync Mail?

由 Jaden's built a claw(@cjboy007)开发并维护,当前版本 v2.0.1。

💬 留言讨论