moltbot-plugin-2do

Original source / Raw SKILL.md

---
name: moltbot-plugin-2do
description: "Create tasks and send them to 2Do app via email. Use when the user wants to: (1) add, create, or record a task/todo/reminder in any form - e.g. '添加任务', '创建待办', '新建任务', '加个任务', '记录任务', 'add task', 'create todo'; (2) ask to be reminded of something - e.g. '提醒我', '别忘了', '记得', '帮我记一下', 'remind me', 'remember to'; (3) mention something they need to do and want it tracked - e.g. '明天要开会', '周五前交报告', '下午去买菜'; (4) want to add items to a todo list or task manager - e.g. '加到待办', '放到任务列表', '记到清单里'; (5) describe a task with list/tag organization - e.g. '添加到工作列表', '标签是紧急'; (6) mention urgency or importance - e.g. '紧急', '重要', 'urgent', 'important'. Parses natural language (Chinese and English) to extract task title, due date/time, priority, optional list name, and optional tags, then sends a formatted email to the user's configured 2Do inbox."
metadata:
  {"openclaw": {"emoji": "✅", "requires": {"env": ["TWODO_EMAIL", "SMTP_HOST", "SMTP_PORT", "SMTP_USER", "SMTP_PASS"], "bins": ["node"]}}}
---

# 2Do Task Email

Create tasks from natural language and send them to 2Do app via email. Supports both Chinese and English input.

## Execution

### Natural language mode (recommended)

Pass the user's raw message. The script parses task title, due date, priority, list, and tags automatically:

```bash
bash {baseDir}/scripts/send-task.sh --raw "USER_MESSAGE_HERE"
```

### Structured mode

When task components are already extracted:

```bash
bash {baseDir}/scripts/send-task.sh --title "TITLE" --list "LIST_NAME" --tags "TAG1,TAG2"
```

## Parameters

| Parameter | Description | Required |
|-----------|-------------|----------|
| `--raw` | Raw natural language input, auto-parsed | Either --raw or --title |
| `--title` | Task title | Either --raw or --title |
| `--list` | Target list name | No |
| `--tags` | Tags, comma-separated | No |

## Natural Language Patterns

### Task prefixes

Chinese: "添加任务：", "创建待办：", "提醒我：", "记录任务：", "新建任务：", "加个任务："

English: "add task:", "create todo:", "remind me to", "remember to"

No-prefix input is also supported — the entire input becomes the task title.

### Date/time extraction

Relative dates: 今天, 明天, 后天, 大后天

Week days: 周一~周日, 下周一~下周日, 星期X

Specific dates: X月X日/号

Time: 上午/下午/晚上 X点 X分/半

Extracted dates are automatically converted to 2Do's `start()` and `due()` format in the email subject for proper task scheduling.

### List and tag assignment

Chinese: "列表是X", "到X列表", "标签是X和Y"

English: ", list X", ", tag X and Y"

### Priority

Chinese: 紧急(high), 重要(medium), 不急(low)

English: urgent(high), important(medium), low priority(low)

## Output

Success: `✅ 任务已发送到 2Do: {task title}`

Failure: error message with non-zero exit code.

## Configuration

Required environment variables:

- `TWODO_EMAIL` - Recipient email address configured in 2Do
- `SMTP_HOST` - SMTP server (e.g. smtp.gmail.com)
- `SMTP_PORT` - SMTP port (587 for STARTTLS, 465 for SSL)
- `SMTP_USER` - SMTP username
- `SMTP_PASS` - SMTP password (app-specific password recommended)

Optional:

- `TITLE_PREFIX` - Email subject prefix for matching 2Do capture rules (e.g. "2Do:")


---

## Skill Companion Files

> Additional files collected from the skill directory layout.

### README.md

```markdown
# moltbot-plugin-2do

一个 [Moltbot (OpenClaw)](https://docs.openclaw.ai) 插件，通过自然语言创建任务并发送到 [2Do](https://www.2doapp.com) app。

支持所有 Moltbot 消息渠道（QQ、企业微信、Slack、Telegram、WhatsApp、Discord 等），利用 2Do 的 [Email to 2Do](https://www.2doapp.com/kb/category/ios/email-to-2do/44/) 功能自动捕获邮件为任务。

## 功能

- 自然语言意图识别 — 无需固定命令前缀，自然表达即可触发
- 中英文双语解析（中文 + 英文命令前缀）
- 日期/时间提取（明天、下周五、下午3点等）
- 自动设置 2Do 开始时间和截止时间（通过 `start()`/`due()` 格式）
- 优先级识别（紧急/重要/urgent/important）
- 支持指定目标列表和标签
- 支持邮件标题前缀配置（用于精确匹配 2Do 捕获规则）
- 通过 SMTP 邮件发送到 2Do
- 支持所有 Moltbot 消息渠道

## 使用示例

**基本任务：**

> 添加任务：买牛奶

**自然表达（无需固定前缀）：**

> 帮我记一下明天下午3点开会

> 别忘了周五交报告

**英文命令：**

> add task: buy groceries

> remind me to call John tomorrow

**日期/时间（自动设置 2Do 开始/截止时间）：**

> 添加任务：明天下午3点开会

> 添加任务：下周五前提交报告

> 创建待办：3月15号出发

**优先级：**

> 添加任务：修复线上 bug，紧急

> add task: fix production issue, urgent

**指定列表：**

> 添加任务到工作列表：完成项目报告

> add task to shopping list: buy fruits

**指定标签：**

> 添加任务：买菜，标签是家务和购物

> add task: deploy, tag backend and devops

**完整组合：**

> 添加任务：明天完成季度报告，列表是工作，标签是紧急和财务

## 安装与更新

### 前置条件

- Node.js >= 22
- Moltbot (OpenClaw) 已安装
- 2Do app 已配置 Email to 2Do 功能
- 可用的 SMTP 邮箱账户

### 方式一：通过 ClawHub 安装（推荐）

访问 ClawHub 插件页面安装或更新：

[https://clawhub.ai/chuckiefan/moltbot-plugin-2do](https://clawhub.ai/chuckiefan/moltbot-plugin-2do)

按页面提示完成安装即可。后续更新也可通过 ClawHub 页面进行。

### 方式二：通过 Git 手动安装

将项目克隆到 Moltbot 的 skills 目录：

**从 GitHub 安装：**

```bash
cd ~/.openclaw/skills
git clone https://github.com/chuckiefan/moltbot-plugin-2do.git
cd moltbot-plugin-2do
npm install
npm run build
```

**从 Gitee 安装（国内推荐）：**

```bash
cd ~/.openclaw/skills
git clone https://gitee.com/akenz/moltbot-plugin-2do.git
cd moltbot-plugin-2do
npm install
npm run build
```

**更新已安装的插件：**

```bash
cd ~/.openclaw/skills/moltbot-plugin-2do
git pull
npm install
npm run build
```

> 如果同时配置了 GitHub 和 Gitee 远程仓库，可以指定拉取来源：
> - GitHub：`git pull origin master`
> - Gitee：`git pull gitee master`

### 配置

在 `~/.openclaw/openclaw.json` 中添加环境变量：

```json
{
  "skills": {
    "entries": {
      "moltbot-plugin-2do": {
        "enabled": true,
        "env": {
          "TWODO_EMAIL": "[email protected]",
          "SMTP_HOST": "smtp.gmail.com",
          "SMTP_PORT": "587",
          "SMTP_USER": "[email protected]",
          "SMTP_PASS": "your-app-specific-password",
          "TITLE_PREFIX": "2Do:"
        }
      }
    }
  }
}
```

| 环境变量 | 说明 | 必需 |
|---------|------|------|
| `TWODO_EMAIL` | 2Do 中配置的接收邮箱地址 | 是 |
| `SMTP_HOST` | SMTP 服务器地址（如 smtp.gmail.com） | 是 |
| `SMTP_PORT` | SMTP 端口（587 为 STARTTLS，465 为 SSL） | 是 |
| `SMTP_USER` | SMTP 用户名 | 是 |
| `SMTP_PASS` | SMTP 密码（推荐使用[应用专用密码](https://support.google.com/accounts/answer/185833)） | 是 |
| `TITLE_PREFIX` | 邮件标题前缀，用于匹配 2Do 邮件捕获规则（可选） | 否 |

### 可选配置说明

**TITLE_PREFIX**：如果配置了此参数，所有发送的邮件标题会自动添加该前缀。例如设置 `TITLE_PREFIX="2Do:"`，则任务"开会"的邮件标题会变为 `2Do:开会 list(...) tag(...)`。

此功能可以帮助你在 2Do 中设置更精确的邮件捕获规则，只捕获带有特定前缀的邮件，避免其他邮件被误捕获。

### 配置 2Do App

1. 购买并启用 **Email to 2Do** 插件（iOS/Mac 应用内购买）
2. 在 2Do 设置 > Email to 2Do > Add Account 中添加邮箱
3. 配置捕获规则（推荐设置特定发件人规则）

详细指南参考 [2Do Email to 2Do 知识库](https://www.2doapp.com/kb/category/ios/email-to-2do/44/)。

## 项目状态

### 当前版本：v1.0.2

**已完成功能**：

- 核心 MVP 功能
  - 自然语言任务解析（支持多种中文表达方式）
  - 列表指定（"到X列表"、"列表是X"、", list X"）
  - 标签指定（"标签是X和Y"、", tag X and Y"）
  - 2Do 邮件格式构造
  - SMTP 邮件发送（支持 TLS/SSL）

- 2Do 日期/时间集成
  - 任务日期自动转换为 2Do 的 `start()`/`due()` 格式
  - 仅日期时设置截止时间：`due(M-D-YY)`
  - 含时间时同时设置开始和截止时间：`start(M-D-YY Ham/pm) due(M-D-YY Ham/pm)`

- 邮件标题前缀功能
  - 可配置 TITLE_PREFIX 环境变量
  - 自动在邮件标题前添加指定前缀
  - 帮助精确匹配 2Do 邮件捕获规则

- 广泛的意图识别
  - 基于 AgentSkills 规范的 description 触发机制
  - 支持固定前缀触发（添加任务、创建待办、提醒我等）
  - 支持自然表达触发（帮我记一下、别忘了、明天要...等）
  - 无需固定命令格式，自然对话即可创建任务

- 日期/时间提取
  - 相对日期：今天、明天、后天、大后天
  - 星期表达：周一~周日、下周X、星期X
  - 具体日期：X月X日/号
  - 时间：上午/下午/晚上 X点 X分/半
  - 日期+时间组合：明天下午3点

- 中英文双语支持
  - 英文命令前缀：add task、create todo、remind me to、remember to
  - 英文列表和标签：, list X、, tag X and Y
  - 大小写不敏感

- 优先级提取
  - 中文：紧急/加急(高)、重要(中)、不急(低)
  - 英文：urgent(高)、important(中)、low priority(低)

- 测试覆盖
  - 71 个单元测试覆盖核心功能
  - 覆盖日期解析、2Do 日期格式、任务解析、邮件构造等

**代码质量**：
- TypeScript 类型安全
- 完整的文档和使用示例
- 符合 AgentSkills 规范
- MIT 开源协议

### 未来规划

- [ ] 任务确认交互（发送前预览，支持修改后再发送）
- [ ] 批量任务添加（一次解析多个任务）
- [ ] 自定义邮件模板
- [ ] 配置验证命令（测试 SMTP 连接）
- [ ] 发布到 ClawHub 技能市场
- [ ] 国际化支持（i18n）

---

## 开发

```bash
# 安装依赖
pnpm install

# 运行测试
pnpm test

# 构建
pnpm build

# 类型检查
pnpm typecheck
```

## License

[MIT](LICENSE)

```

### _meta.json

```json
{
  "owner": "chuckiefan",
  "slug": "moltbot-plugin-2do",
  "displayName": "Moltbot Plugin 2do",
  "latest": {
    "version": "1.0.2",
    "publishedAt": 1770208869704,
    "commit": "https://github.com/clawdbot/skills/commit/f0270d2ff828fbe43c428779abd97921e8fc48c3"
  },
  "history": [
    {
      "version": "1.0.0",
      "publishedAt": 1770136701109,
      "commit": "https://github.com/clawdbot/skills/commit/52068531547fe5f83ae26e2a5bcf1ff4190a142a"
    }
  ]
}

```

### scripts/send-task.sh

```bash
#!/usr/bin/env bash
set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_DIR="$(dirname "$SCRIPT_DIR")"

# 优先使用编译产物，否则回退到 tsx 开发模式
if [ -f "$PROJECT_DIR/dist/main.js" ]; then
    node "$PROJECT_DIR/dist/main.js" "$@"
else
    npx --prefix "$PROJECT_DIR" tsx "$PROJECT_DIR/src/main.ts" "$@"
fi

```