arya-reminders

⏰ 波哥大时区自然语言提醒助手

基于 OpenClaw 的西班牙语自然语言提醒工具,自动解析时间创建 cron 任务并同步记录,让 Jaider 轻松管理波哥大时区的日常事务。

收藏
12.4k
安装
3.4k
版本
v0.1.1
CLS 安全性认证2026-05-15
点击查看完整报告 >

使用说明

Arya Reminders 是一款专为 OpenClaw 平台设计的自然语言提醒工具,主要针对西班牙语用户(特别是波哥大时区)提供智能化的定时提醒服务。该 Skill 允许用户通过日常对话式的西班牙语输入(如"明天下午3点提醒我还电费")来创建一次性定时任务,系统会自动解析时间表达式并生成相应的 cron 作业。

核心用法上,用户既可以通过自然语言与 Agent 对话创建提醒,也可以直接调用 create-reminder.sh 脚本手动创建。系统使用 Python 标准库解析时间字符串,支持相对时间(如"45分钟后")和绝对时间(如"周五上午9点")等多种格式。创建的提醒会以 cron 作业形式在隔离会话中执行,确保系统安全性,同时所有提醒记录会自动保存到 memory/reminders.md 文件中,便于后续查阅和管理。

显著优点包括:完全基于 Python 标准库开发,无外部 pip 依赖,避免了供应链攻击风险;无需调用第三方 API,保护用户隐私;使用 OpenClaw 内置的 cron 工具进行任务调度,权限控制严格;代码经过安全审查,无 eval/exec 等危险函数;采用隔离会话执行敏感操作,防止越权访问。

潜在局限性主要体现在:默认硬编码了特定的 Telegram Chat ID(虽可通过环境变量覆盖),在多用户环境下可能造成消息发送混淆;时区默认为 America/Bogota,虽然支持通过 TZ_NAME 覆盖,但默认配置对非该时区用户不够友好;作为个人开发者(staratheris)维护的 T3 来源项目,长期维护稳定性有待观察;目前仅优化支持西班牙语自然语言解析,对其他语言支持有限。

该 Skill 特别适合以西班牙语为母语、位于波哥大时区的个人用户进行日常事务管理,如账单提醒、会议通知、生活琐事等场景。对于需要严格隐私保护的企业环境或多用户共享的工作站,建议谨慎使用或自行部署修改版本。

使用风险方面,主要需注意 cron 任务的累积可能影响系统性能(尽管是一次性任务),提醒内容会明文存储在 markdown 文件中可能泄露隐私信息,以及 Telegram 消息推送依赖外部网络连接。建议用户定期检查 memory/reminders.md 文件大小,及时清理历史记录,并在使用前通过环境变量配置正确的 Chat ID 和时区设置。

安全解读

Arya Reminders 综合评估

核心用法

Arya Reminders 是一款面向 OpenClaw 平台设计的自然语言提醒工具,专为 Jaider(开发者)定制,默认采用 America/Bogota 时区。用户可通过日常西班牙语对话创建一次性提醒,如"Recuérdame pagar la luz mañana a las 3pm"(明天下午3点提醒交电费)。系统解析相对/绝对时间表达式后,生成 cron 任务并记录至本地 memory/reminders.md,全程无需外部 API。

技术实现上,用户输入经 create-reminder.sh 传递至 Python 解析器(--message/--when 长选项),利用 argparsezoneinfo 等标准库完成时间计算与 JSON 配置生成,最终调用系统 cron 工具调度执行。

显著优点

  • 零网络依赖:不发起任何外部请求,数据零离开本地环境,隐私风险极低
  • 供应链安全:仅使用 Python 标准库(argparse、json、re、zoneinfo),无第三方包,CVE 风险为零
  • 架构简洁:功能边界清晰(one-shot 提醒),无动态代码执行(eval/exec/system),代码仅 158 行
  • 时区本地化:默认 Bogotá 时区,对哥伦比亚/拉美用户友好
  • 可审计日志:所有提醒以 Markdown 格式持久化,便于回溯

潜在缺点与局限

  • 输入验证薄弱:Shell 参数传递层缺乏前置校验,虽经 argparse 隔离,仍存在理论命令注入面(风险等级:中)
  • 单时区硬编码:默认 TZ 不可通过自然语言切换,跨国用户需手动覆盖环境变量
  • 功能单一:仅支持一次性提醒,无周期任务、无跨设备同步、无通知渠道扩展(Telegram 集成尚为"未来可选")
  • 硬编码 Chat ID:默认 ARYA_TELEGRAM_CHAT_ID=5028608085 为开发者个人 ID,其他用户必须手动覆盖
  • 无输入容错:时间解析失败时仅抛出 SystemExit,错误提示不够友好

适合人群

  • OpenClaw/Claude 生态西班牙语用户:尤其是哥伦比亚时区(Bogotá)居民
  • 隐私敏感型用户:拒绝云端提醒服务、偏好本地 cron 的极客
  • 轻量需求场景:仅需临时一次性提醒,无需复杂 recurrence 规则

常规风险

| 风险项 | 等级 | 说明 |
|--------|------|------|
| Shell 参数注入 | 中等 | 用户输入经 shell 传递,建议增加长度限制与危险字符过滤(|;`$() 等) |
| 文件权限过度宽松 | 低 | memory 目录默认权限需确认,避免 777 |
| 配置误用 | 低 | 默认 Chat ID 非用户本人,需主动覆盖环境变量 |
| 时区混淆 | 低 | 系统级 TZ 变更可能导致提醒时间偏移 |

安全认证结论

CLS 扫描评定 Grade A / Score 83,雷达维度得分均衡(依赖审计 95、网络分析 90)。虽标记为 T2(可信个人开发者),但代码结构清晰、行为可预测,符合生产环境谨慎部署标准。建议采纳报告中三项低危改进建议后使用。

arya-reminders 内容

手动下载zip · 5.2 kB
create-reminder.agent.mdtext/markdown
请选择文件