# 第 20 章 可靠的自动化：定时、Webhook 与事件触发

Routine 每天醒几十次只回“今日无变化”，额度照扣。**任务缺乏规范极易静默出错**。
- 时区偏差（早 9 点跑在凌晨 3 点）
- 周期误判（默认工作日导致周末漏网）
- 缺少兜底（报错顺着空数据乱改线上）

**两段式架构配 Linux cron 能砍掉 80% 以上空转**。写入边界合同与安全人闸，打通快捷指令和 X 事件流，自动化才能稳定省钱。


![可靠的自动化：定时、Webhook 与事件触发](https://0xkevin.geekfun.fun/info/20-automation.png)

## 触发器选型：到点交付还是等待变化

![触发器选型：到点交付还是等待变化](https://0xkevin.geekfun.fun/info/20-automation-s1.png)

先分清是到点交差还是等新数据。**Bot 与 Grok、Cursor 共享每周额度池**，高频轮询几天就耗尽。

### 订阅与配额限制

The X Subscription（2026-10-12）中 Plus 无 Bot，支持档为 Premium（$30/月或$300/年，4x）、Super（$100/月或$1000/年，15x）、Ultra（$200/月或$2000/年，50x）。

单 Bot 限 50 个 Routine，记录留 20 次，**定时最短间隔 5 分钟**。

### 触发方式与选型

- 定时例程：到点无论有无数据均计费，适合固定日报。
- Webhook：平时零消耗，**仅限带 Bearer 密钥的 POST 请求**。
- 第三方事件（GitHub、Slack 等）：有事件才唤醒，繁忙频道易刷爆额度。
- X 互动（回复 @bot）：无法解析视频帖，同时 @grok 与 @bot 不触发。

**等新数据才处理，一律改用 Webhook 或第三方事件。**

## 例程设计模板：写合同而不是写头衔

提示词只写头衔容易跑崩，**生产例程必须写明执行合同**。

出处见 [《4.3 触发器与自动化：定时、Webhook、在 X 上派活》](https://jcng5q8n0f3z.feishu.cn/wiki/HHmpwgN4qi86e0kgBvAc1156nkg)，需备齐四要素，涵盖数据源、输出格式，以及缺失报错与人工审批策略。

### 编写合同与配置例程

1. **把约束输入输出的合同发给 Bot 并让它记住**；共享 Bot 则写入详情 About 的 Description。
```text
负责范围：监控指定数据源并生成标准化 Markdown 摘要。
允许读取的数据源：工作区目录下的 data/incoming/ 文件夹及指定公开 RSS 链接。
输出格式规范：必须输出包含“标题、核心要点（最多3条）、影响评估、原始链接”的 Markdown 结构，存入 docs/daily/ 目录。
数据异常策略：若数据源无更新或文件为空，仅在工作区追加一行日志“[时间戳] NO_NEW_DATA”，严禁编造或推测新闻内容，严禁在聊天窗口发送刷屏提示。
权限边界：只读外部内容与本地写入。禁止调用外部发帖、转账、发送邮件或删除文件操作。
```
2. 聊天中把工作流存为含自检逻辑的 Skill，直接发指令建定时例程。
```text
每个工作日上午 8:30，运行“晨间资讯归档”Skill。如果数据源没有更新，记录日志后保持沉默。
```
3. 在 Details 的“例程”列表用开关切换 Pause 或 Resume。

   点进面板可改 Instruction、When to run、Webhook，底部支持 Pause/Resume、Test、Edit 与 Delete routine（垃圾桶图标）。

### 上线前干跑测试

例程在云端虚拟机跑真实操作，**所有 Bot 默认共用底层运行环境且无沙箱隔离**，失控会改动真实文件。开启前先在聊天中发指令干跑验证。
```text
针对即将上线的例程“晨间资讯归档”，进行一次干跑验证：
1. 复述你理解的执行触发条件与完整业务流程。
2. 列出本次执行涉及读写操作的路径，以及可能产生风险的 3 个最高风险步骤。
3. 说明如果源文件损坏或格式错误，你的具体兜底动作。
现在不要执行任何实际写文件和网络请求操作，仅输出分析报告。
```

### 锁死安全人闸

前往 Settings 的 Custom Rules（或 Auto-review），**对不可逆动作强制设为手动审批**。

| 拦截指令 | 动作范围 |
|---|---|
| `send` / `post` | 外发消息、邮件或社媒 |
| `buy` / `transfer` | 支付与转账接口 |
| `delete` / `permissions` | 文件数据库删除、权限变更 |

指令触发后系统会弹出审批卡停住执行，持续等待人工确认，绝不自动外发。

## Webhook 接入：移动端与外部流水线打通

出处：[《Grok Bot Webhook + 快捷指令：知识自动入库流水线搭建》](https://jcng5q8n0f3z.feishu.cn/wiki/Kxtxw9gLBiqi0nkhZpCc7le5nrh)

### 凭证与状态

例程选“当 Webhook 被触发时”，**必须点 Save 才会生成地址、密钥与 Header**。v0.68.1 若卡片看不全 URL，**让 Bot 在聊天发链接**复制，密钥勿发公开群。

**返回 200 仅代表云端已启动，不代表执行完毕**。结果去聊天窗口看；非 200 检查例程是否 Paused 与密钥。

### 快捷指令

带分享面板（浏览器等）：
1. 勾选“在共享表单中显示”，接收链接与文本。
2. 用“获取 URL 内容”发 POST，请求头填 `Authorization: Bearer <key>`，JSON 体加 `content` 填快捷指令输入。

```text
接收端 Bot 的配套 Instruction 模板：
收到 Webhook 传入的 JSON 数据后，提取 content 字段中的链接。
如果是普通网页，抓取正文，提炼核心结论与知识点。
整理完成后，以 Markdown 格式追加写入知识库目录下的 inbox.md，包含收录时间、原文链接、核心观点与分类标签。
处理完毕后在聊天中输出一句话确认回执。
```

无分享面板（微信等）：
1. 用“请求文本”接“运行快捷指令”转发。
2. 绑定 iPhone 15 Pro 操作按钮或主屏幕，复制后弹窗提交。

**大文件不能直接塞请求体**。音视频和图片先传网盘换公网 URL 再发给 Bot。

## 增量判断避免空跑：两段式检查架构

![增量判断避免空跑：两段式检查架构](https://0xkevin.geekfun.fun/info/20-automation-s4.png)

巡检每次都跑大模型太费额度，**直接拆成两段**。

1. 用 Linux 自带 cron 做机械巡检。
2. **数据变了**再调 Webhook 叫醒 Bot 处理。

出处：[《Grok Bot 额度再省一点：定时任务极限优化》](https://jcng5q8n0f3z.feishu.cn/wiki/SDr3wRrG5iGmz1kejdTcss0Rned)。

### 1. 解耦原理：闹钟与大脑分工

Grok Bot 背后是常开的 Linux 云电脑。

1. **机械检查**：用 cron 跑脚本对比数据。期间**绝对不要调用任何大模型**，几秒退出不耗用量。
2. **增量唤醒**：有变动发 POST 到本机 Webhook，唤醒 Bot 分析总结。

把 6 个例程中的等待类改完，耗时约 23 分钟，每周少 8 到 10 次空转，延迟从一天降到半小时内。

### 2. 虚拟机落地配置步骤

1. 在 Bot 上添加一条“增量处理中心”例程，触发选 Webhook，**保存好 Webhook URL 和 Bearer 密钥**。
2. 打开终端，在工作区建脚本 `check_update.sh`：

::: details 2. 虚拟机落地配置步骤
```bash
   #!/bin/bash
   # 监测目标 API 或页面是否有增量变化，纯机械对比，严禁调用 LLM

   TARGET_URL="https://api.example.com/v1/feed"
   STATE_FILE="/home/user/workspace/last_state.hash"
   WEBHOOK_URL="https://your-bot-webhook-url.com/api/v1/run"
   WEBHOOK_KEY="Bearer YOUR_SECRET_KEY"

   # 获取最新数据的哈希值或时间戳
   CURRENT_HASH=$(curl -s "$TARGET_URL" | md5sum | awk '{print $1}')

   if [ ! -f "$STATE_FILE" ]; then
       echo "$CURRENT_HASH" > "$STATE_FILE"
       exit 0
   fi

   OLD_HASH=$(cat "$STATE_FILE")

   # 比对是否有变化
   if [ "$CURRENT_HASH" != "$OLD_HASH" ]; then
       echo "检测到数据更新，正在唤醒 Bot..."
       echo "$CURRENT_HASH" > "$STATE_FILE"
       
       # 叫醒 Bot 进行智能分析
       curl -X POST "$WEBHOOK_URL" \
            -H "Authorization: $WEBHOOK_KEY" \
            -H "Content-Type: application/json" \
            -d '{"event": "data_changed", "source": "feed_monitor"}'
   else
       # 无变化，保持沉默，零额度消耗
       echo "无新变化，退出。"
   fi
   ```
:::

3. 终端安装并启动 cron 服务：

```bash
   sudo apt-get update && sudo apt-get install -y cron
   sudo service cron start
   ```

跑 `crontab -e` 设定时（工作日早 9 点到晚 7 点，每 30 分钟检查一次）：

```cron
   */30 9-19 * * 1-5 /bin/bash /home/user/workspace/check_update.sh >> /home/user/workspace/cron_check.log 2>&1
   ```

- **客户端点“更新电脑”会重置系统**：工作区脚本虽在，但 `apt-get` 装的 cron 会被抹掉，更新后必须重装并启动一次。
- **脚本别调大模型 API**：只做轻量检测，把判断交给模型省不下成本，开销全转去 API 计费了。

## 第三方事件与 X 平台联动

### Slack 触发器

Slack 触发器属于例程体系，用前需在账户绑定 Slack，参考[《Routines 帮助》](https://cursor.com/cn/help/grok-bot/routines)。

- **切勿在公开频道设“收到任意消息”触发**，闲聊一天就会耗尽整周额度。
- 仅监听 `#alerts-p0` 或 `#deploy-status` 等专属通知频道。
- 必须带触发前缀，如 `!bot review` 或 `@bot summary`。
- 只响应建立后产生的新消息，不追溯历史。

### X 平台联动边界

v0.70.2 起无需绑个人账号即可搜推文。

在推文下评论 @bot 会通知星标主 Bot 分流，参考[《4.3 触发器与自动化：定时、Webhook、在 X 上派活》](https://jcng5q8n0f3z.feishu.cn/wiki/HHmpwgN4qi86e0kgBvAc1156nkg)。

- 限制：无法解析视频推文；评论同时带 `@grok` 和 `@bot` 会冲突不触发。
- 防注入：**主 Bot 仅允许做摘要、分类与入库，严禁自动发帖、点赞或改动云电脑**，所有对外动作必须退回桌面客户端人工确认。

## 失败兜底与容错策略

![失败兜底与容错策略](https://0xkevin.geekfun.fun/info/20-automation-s6.png)

接口超时或返回空数据易脑补，**Instruction 必须包含异常阻断声明**：

```text
前置校验步骤：
1. 检查抓取到的内容体积。如果内容为空、包含 HTTP 错误码（如 403、404、500）或少于 50 个字符，判定为源不可用。
2. 源不可用时，立刻终止后续分析流程。
3. 在 workspace/logs/routine_errors.log 中追加一行错误记录，格式：[ISO时间戳] [任务名] SOURCE_UNAVAILABLE [原因]。
4. 不得在公开聊天窗口发送报警消息，不得使用过往缓存伪造新数据，直接以退出状态结束本次 run。
```

Webhook 异常排查：
1. **401**：Header 查 `Authorization: Bearer <key>`，防多出空格换行或用了旧 Key。
2. **404**：核对 URL 完整性，防桌面端误删注销。
3. **429**：超并发上限，**必须增加重试队列与指数退避**。
4. **未执行**：检查是否被 **Paused**，或手机端 **Active** 开关被关。

**日志落盘防刷屏**：仅审批拦截才弹卡片通知；摘要写入 `docs/reports/YYYY-MM-DD.md`，单行日志追加到 `workspace/run.log`。

## 监控与日常维护

桌面端在 **Details**、手机端在配置文件里看例程，**Failed** 能点开看报错堆栈。

每周查 **Usage & Billing**（v0.70.2 修复了用量显示），消耗陡增说明有例程在空转或重试。

每周五固定花 15 分钟清理例程。
1. 调出 `workspace/run.log` 看实际产出。
2. 连续 7 天无增量的例程先 **Pause**。
3. 停跑两周无依赖再 **Delete routine**，**删除不可撤销且 Webhook 同步失效**。

## 容易踩的坑

- **工作日机制**：设“每天 8 点”常被当成工作日。全天候任务**提示词必须写明“包含周六和周日”**。
- **时区偏差**：建 Routine 先去 Settings -> Bot -> Timezone 查时区。云端默认 UTC，设 9 点会跑在深夜。
- **加号建 Bot 失效**：侧边栏（+）新建容易卡死，不跑就**让成熟 Bot 对话派生新 Bot**。
- **凭证未保存**：配 Webhook **必须点底部 Save 签发**，直接切走页面会导致密钥未生成。
- **系统更新重置**：“更新电脑”（Update computer）会初始化镜像，`apt-get` 装的 cron 会丢，**更新后进终端查 cron**。
- **密钥泄露**：别把 Webhook 密钥贴进普通聊天。误发后**立刻删消息并在例程重置**。
- **Test 真实执行**：点 **Test** 会消耗用量并改动文件，**严禁在生产数据上测试**。

## 做完怎么验收

1. 桌面端看 When to run 里的英文计划（如“Every day at 8:00 AM CST”），对准本地时区与周末。
2. 新例程等下个周期才跑，看 Next run 时间准不准。
3. 把数据源改名或留空，点 Test 跑一次，确认输出“数据源异常”日志且平稳停住，没瞎编信息。
4. 注入发邮件、发帖或删目录指令，**确认操作被拦截并弹卡片**，没直接向外发包。
5. 终端用 curl 向 Webhook 发 POST 请求：
```bash
   curl -i -X POST "你的_WEBHOOK_URL" \
        -H "Authorization: Bearer 你的_KEY" \
        -H "Content-Type: application/json" \
        -d '{"test": "ping"}'
   ```
检查 **1 秒内收到 200 状态码**，30 秒内客户端里 Bot 变 Running 并输出回执与结构化结果。

## 延伸阅读

- 相关章节：[第 8 章 技能与例程：把一次成功变成每天自动跑](https://0xkevin.geekfun.fun/part1/08-skills-routines)
- 相关章节：[第 10 章 额度与成本：让一周用量撑满一周](https://0xkevin.geekfun.fun/part1/10-usage)
- 官方文档：[《Cursor Help: Routines》](https://cursor.com/cn/help/grok-bot/routines)
- 社区原文：[《4.3 触发器与自动化：定时、Webhook、在 X 上派活》](https://jcng5q8n0f3z.feishu.cn/wiki/HHmpwgN4qi86e0kgBvAc1156nkg)
- 社区原文：[《Grok Bot Webhook + 快捷指令：知识自动入库流水线搭建》](https://jcng5q8n0f3z.feishu.cn/wiki/Kxtxw9gLBiqi0nkhZpCc7le5nrh)
- 社区原文：[《Grok Bot 额度再省一点：定时任务极限优化》](https://jcng5q8n0f3z.feishu.cn/wiki/SDr3wRrG5iGmz1kejdTcss0Rned)
