垃圾提醒技能（Waste Reminder Skill）

一款灵活、轻量（Token 高效）的自动化垃圾容器收运提醒技能。

概述

该技能可根据用户自定义的日程，自动触发垃圾收运提醒。全部配置通过简洁的 JSON 文件完成，兼顾最大灵活性与最低 Token 消耗。

工作原理：
技能读取您的配置文件与日程安排，判断当前需发送哪些提醒，并以 AI 助理可解析的格式输出。随后，AI 助理负责将实际消息发送至指定渠道。

输出格式如下：

SEND_TO:recipient_id
CHANNEL:whatsapp
您的消息内容
---

该设计确保配置极简且 Token 高效——本技能无需 API 密钥，也无需直接网络访问权限。

功能特性

• 支持多种容器类型
• 自定义提醒时间（每轮收运最多支持 4 次提醒）
• 灵活的目标设定（群组通知、个人通知、升级提醒）
• 多渠道支持（WhatsApp、Telegram、Discord、Email）——消息由您的 AI 助理代为发送
• 确认机制（用户确认后，对应提醒将停止触发）
• 单一调度文件管理
• Token 高效——生成提醒过程不消耗 AI Token

安装

clawhub install waste-reminder

用户配置流程

安装该技能后，AI 助理将向您发送一份配置模板。您可用任意语言回复——AI 将准确理解并自动转换为标准 JSON 格式！

示例模板（含全部可选项的完整示例）

我想设置垃圾提醒！

我的容器：
- blue：纸类（🔵）
- gray：其他垃圾（⚫）
- orange：塑料（🟠）
- green：园林垃圾（🟢）

提醒时间：
- 18:00：发送至 group_whatsapp（收运日前一天，群组通知）
- 22:00：发送至 group_whatsapp（晚间群组提醒）
- 06:30：发送至 partner_whatsapp（清晨提醒，指定联系人）
- 09:30：发送至 me_telegram（升级提醒，切换不同渠道）

我的联系人：
- group_whatsapp：123456789@g.us
- partner_whatsapp：+31600000001
- me_telegram：222222222

即将收运日期：
- 2026-02-24：orange
- 2026-02-25：gray
- 2026-03-02：blue

AI 将自动将上述内容转换为标准 JSON 格式并完成全部初始化配置。

配置存储路径

该技能的配置文件存放在：
/data/.openclaw/workspace/data/waste-reminder/

文件结构

waste-reminder/
├── config.json      # 容器定义、提醒时间、目标设置
└── schedule.json   # 收运日期及状态记录

完整 config.json 示例（展示全部可选项）

{
  "config_version": "1.0",
  "containers": {
    "blue": {"name": "Paper", "color": "blue", "emoji": "🔵"},
    "gray": {"name": "Residual", "color": "gray", "emoji": "⚫"},
    "orange": {"name": "Plastic", "color": "orange", "emoji": "🟠"},
    "green": {"name": "Garden", "color": "green", "emoji": "🟢"}
  },
  "reminder_times": {
    "18:00": {
      "type": "group",
      "template": "Tomorrow: {container_emoji} {container_name} will be collected!",
      "target": "group_whatsapp"
    },
    "22:00": {
      "type": "group",
      "template": "Not confirmed yet - {container_emoji} needs to go out by 7am!",
      "target": "group_whatsapp"
    },
    "06:30": {
      "type": "personal",
      "template": "⚠️ {container_emoji} put out NOW!",
      "target": "partner_whatsapp"
    },
    "09:30": {
      "type": "escalation",
      "template": "Container still not outside!",
      "target": "me_telegram"
    }
  },
  "targets": {
    "group_whatsapp": {"id": "123456789@g.us", "channel": "whatsapp"},
    "partner_whatsapp": {"id": "+31600000001", "channel": "whatsapp"},
    "partner_telegram": {"id": "111111111", "channel": "telegram"},
    "me_whatsapp": {"id": "+31600000002", "channel": "whatsapp"},
    "me_telegram": {"id": "222222222", "channel": "telegram"},
    "me_discord": {"id": "https://discord.com/api/webhooks/...", "channel": "discord"}
  }
}

完整 schedule.json 示例

{
  "2026-02-24": {
    "orange": {
      "confirmed": false,
      "reminded_18:00": false,
      "reminded_22:00": false,
      "reminded_06:30": false,
      "reminded_09:30": false
    }
  },
  "2026-02-25": {
    "gray": {
      "confirmed": false,
      "reminded_18:00": false,
      "reminded_22:00": false,
      "reminded_06:30": false,
      "reminded_09:30": false
    }
  }
}

Cron 任务配置

请添加一个每 15 分钟执行一次的 Cron 任务：

• 名称：“Waste Reminder Check”
• 执行周期：每 15 分钟
• 脚本路径：/data/.openclaw/workspace/skills/waste-reminder/waste_cron.py

该 Cron 脚本会检查是否需要发送提醒，并输出待发送内容；您的 AI 助理（由 Cron 触发）将读取此输出，并向对应渠道发送实际消息。

用户命令

• 确认已放置：输入 “container is out”
• 查看日程：输入 “waste schedule” 或 “waste status”
• 新增收运：输入 “waste add [date] [container]”
• 移除收运：输入 “waste remove [date] [container]”

文件清单

waste-reminder/
├── SKILL.md           # 本文档
├── waste_reminder.py # CLI 工具（支持手动命令）
└── waste_cron.py      # Cron 脚本（每 15 分钟运行一次）

模板占位符

• {container_emoji} —— 对应容器的 Emoji 表情
• {container_name} —— 对应容器的名称
• {date} —— 收运日期

渠道支持

当前支持的渠道：

• whatsapp —— ID 字段填写手机号或群组 ID
• telegram —— ID 字段填写 Chat ID
• discord —— ID 字段填写 Webhook URL
• email —— ID 字段填写邮箱地址

每个目标（target）均须同时指定 id 和 channel 字段。

目标命名规范

目标名称建议采用“角色 + 下划线 + 渠道”格式：

• group_whatsapp、group_telegram、group_discord
• me_whatsapp、me_telegram、me_discord
• partner_whatsapp、partner_telegram、partner_discord

渠道类型（channel）将自动从目标名称中提取。

许可证

MIT License