Meetup Planner

一款智能助手，帮助您发现、跟踪并不错过任何符合您兴趣的活动。

一次性初始设置

重要提示：安装本技能后，Agent 将自动从 BOOTSTRAP.md 执行引导初始化流程。

引导流程包括：

1. 检查是否具备网页搜索与爬取能力
2. 收集您的活动偏好信息
3. 配置自动化每日搜索（可选）
4. 创建工作区目录结构

若您尚未具备搜索/爬取能力，我将提示您提供所需工具。

本技能的功能

完成设置后，本技能将：

1. 每日搜索：若已启用，每天早晨自动按您的个人资料搜索匹配的活动
2. 活动发现：利用可用的搜索与网页抓取工具，在全网范围内查找活动
3. 活动跟踪：保存新发现的活动，并以结构化方式呈现供您审核
4. 智能提醒：为已确认的活动分别在开始前 24 小时和 2 小时设置通知
5. 偏好管理：随时更新您的兴趣标签与搜索条件

首次使用设置

当您首次运行本技能时，我将依据 BOOTSTRAP.md 引导您完成全部设置流程。

该设置流程为交互式且友好型：

1. ✅ 检查网页搜索与爬取能力
2. 🎯 通过自然对话了解您的活动偏好
3. ⏰ 配置自动化每日搜索（可选）
4. 📁 创建具备正确权限的工作区目录结构

整个设置过程仅需 2–3 分钟。若您尚未安装搜索/爬取工具，我将提示您提供相应工具。

使用方法

初次运行

运行 meetup-planner 技能以启动设置流程

日常操作

设置完成后，本技能将：

• 每天早晨自动执行活动搜索
• 将结果保存至 events.json
• 将新发现的活动整理后呈现供您审核
• 持续跟踪您感兴趣的活动

当您发现感兴趣的活动时

请告知我：“我对 [活动名称] 感兴趣”，我将为您执行以下操作：

• 将其状态标记为“已确认”
• 向您发送注册链接
• 设置事件开始前 24 小时与 2 小时的提醒

支持的命令

• update preferences — 修改您的活动偏好
• show upcoming — 展示所有正在跟踪的活动
• remove event [name] — 停止跟踪某项活动
• pause search — 暂停每日自动化搜索
• resume search — 恢复每日自动化搜索

数据存储

本技能维护以下文件：

• user-preferences.json — 您的活动偏好配置
• events.json — 所有已发现及正在跟踪的活动
• event-reminders.json — 已调度的提醒事项

技术细节

必需能力：

• 网页搜索能力（任意搜索工具或技能均可）
• 网页爬取/抓取能力（任意抓取工具或技能均可）

调度机制：

• 使用系统 cron 任务（或等效机制）执行每日搜索
• 使用定时任务管理事件提醒

隐私说明

所有数据均本地存储于您的设备中。除通过已配置的 API 搜索新活动外，您的偏好设置与已跟踪活动不会上传至任何其他位置。

数据传输与外部 API 使用

本技能会发起外部网络请求，用于搜索与抓取活动信息。具体调用的服务取决于您已安装的搜索/爬取工具。

向外发送的数据包括：

• 根据您的偏好生成的搜索查询字符串（例如：“AI meetup San Francisco February 2026”）
• 待抓取的活动页面 URL
• 您的 IP 地址（由操作系统网络栈自动发送）
• 您所使用的搜索/爬取工具所需的认证凭据（如 API Key 等）

不会发送的数据包括：

• 您的完整偏好配置文件
• 活动注册状态或历史记录
• 个人备注或手动修改内容
• 其他已跟踪的活动信息

用途说明：发现符合您兴趣的公开活动，并提取结构化的活动详情。

数据最小化实践

• 仅传输完成任务所必需的最少数据
• 所有凭据仅通过 HTTPS 安全传输
• 不采集任何遥测数据、分析数据或使用行为追踪
• 除您已配置的搜索/爬取工具外，不向任何其他服务发送数据

Agent 指令

重要提示：安装本技能后，请务必先通过 BOOTSTRAP.md 完成引导初始化，再进行首次使用。

当本技能被调用时：

阶段 0：检查引导状态（必须首先执行）

在执行任何其他操作之前，请先检查引导是否已完成：

# 检查引导配置文件是否存在
cat ~/.openclaw/workspace/meetup-planner/config.json 2>/dev/null

若该文件不存在，或其中 bootstrapComplete: false：

• 向用户说明：“👋 欢迎使用 Meetup Planner！我需要先为您完成几项基础配置，全程仅需几分钟。”
• 严格按 BOOTSTRAP.md 的步骤顺序执行全部操作
• 在引导流程完成前，不得进入阶段 1 / 2 / 3

若该文件存在，且其中 bootstrapComplete: true：

• 引导已完成，可根据用户当前请求进入对应阶段：
  • 请求“search now” → 进入阶段 2（每日搜索流程）
  • 请求“show upcoming” → 进入阶段 3（活动确认与跟踪）
  • 请求“update preferences” → 重新执行 BOOTSTRAP.md 中的偏好收集流程
  • 无明确请求 → 主动询问：“您想做什么？我可以为您搜索活动、展示即将举行的活动，或更新您的偏好设置。”

阶段 1：设置

全部设置均由 BOOTSTRAP.md 定义与驱动。详见阶段 0。

阶段 2：每日搜索流程

1. 加载偏好配置：

   • 读取 ~/.openclaw/workspace/meetup-planner/user-preferences.json
   • 解析用户的兴趣主题、地理位置、偏好的活动类型等字段

2. 执行活动搜索：

   • 调用您已配置的搜索工具或技能，按偏好条件搜索活动
   • 构造搜索查询时建议采用如下格式：
     • “{topic} meetup {location} {current_month}”
     • “{topic} conference {location} upcoming”
     • “{topic} workshop {location}”
   • 针对用户所有感兴趣的主题，分别执行多次搜索

3. 提取活动详情：

   • 对每个高相关性搜索结果，调用您已配置的抓取工具或技能，抓取对应活动页面
   • 提取字段包括：活动名称、日期、时间、地点、描述、注册链接、费用
   • 重点关注 Eventbrite、Meetup.com、Luma、各类会议官网等平台

4. 过滤与保存：

   • 加载现有活动列表：~/.openclaw/workspace/meetup-planner/events.json
   • 剔除重复项及不符合筛选条件的活动
   • 将新活动追加写入该文件
   • 每条新活动应包含字段：{id, name, date, time, location, url, description, cost, added_date, status: "new"}

5. 向用户呈现结果：

   • 以清晰易读的方式格式化展示新活动的关键信息
   • 主动询问：“我找到了 X 项符合您兴趣的新活动，是否需要我为您逐一介绍？”
   • 可逐条或以列表形式分享活动详情
   • 对每项活动，单独询问用户是否感兴趣

阶段 3：活动确认与跟踪

1. 当用户表达兴趣时：

   • 在 events.json 中将该活动状态更新为 "interested"
   • 提供注册链接：“这是注册链接：{url}”
   • 提示：“请在完成注册后告诉我！”

2. 当用户确认已注册时：

   • 在 events.json 中将该活动状态更新为 "registered"
   • 在 ~/.openclaw/workspace/meetup-planner/reminders.json 中添加提醒记录：

     {
       "event_id": "abc123",
       "event_name": "...",
       "reminders": [
         {"time": "24_hours_before", "sent": false},
         {"time": "2_hours_before", "sent": false}
       ]
     }
     

   • 确认回复：“很好！我将在活动开始前 24 小时和 2 小时分别提醒您。”

阶段 4：提醒系统

1. 检查待触发提醒（每小时执行一次）：

   • 加载 ~/.openclaw/workspace/meetup-planner/reminders.json
   • 比对当前时间与活动起始时间
   • 若距离活动开始还有 24–25 小时，且 24 小时提醒尚未发送：
     • 向用户通知：“提醒：{event_name} 明天 {time} 开始！地点：{location}”
     • 将该 24 小时提醒标记为 sent: true
   • 若距离活动开始还有 2–3 小时，且 2 小时提醒尚未发送：
     • 向用户通知：“注意啦！{event_name} 将在 2 小时后 {time} 开始，是时候准备了！”
     • 将该 2 小时提醒标记为 sent: true

2. 活动结束后清理：

   • 活动日期过后，将其状态更新为 "past"
   • 可选询问：“{event_name} 参加得如何？需要我帮您寻找类似活动吗？”

阶段 5：持续支持的命令

请响应用户提出的以下指令：

• “update preferences” / “change preferences”：重新执行偏好收集流程
• “show upcoming”：展示所有状态为 "interested" 或 "registered" 的活动
• “show new events”：展示所有状态为 "new" 且尚未审核的活动
• “remove event [name]”：从跟踪列表中移除指定活动
• “pause search”：暂停每日自动化搜索（更新配置）
• “resume search”：恢复每日自动化搜索
• “search now”：立即执行一次搜索流程
• “list past events”：列出所有已结束的活动

错误处理

• 若技能安装失败：提供手动安装说明及 GitHub 仓库链接
• 若 API 密钥无效：提示用户校验并输入新的密钥
• 若搜索无返回结果：尝试更宽泛的关键词，或推荐其他潜在兴趣方向
• 若 cron 配置失败：提供按需手动触发搜索的能力
• 若活动页面抓取失败：降级为仅展示原始搜索结果链接
• 始终保障数据安全：未经备份，绝不覆盖 events.json 或 preferences.json

文件结构

~/.openclaw/workspace/meetup-planner/
├── user-preferences.json    # 用户的活动偏好配置
├── events.json              # 所有已发现及正在跟踪的活动
├── reminders.json           # 已调度的提醒事项
├── config.json              # 技能配置（cron 调度等）
└── backups/                 # 数据文件的自动备份目录