Grok Bot 例程：怎么定时运行、用 Webhook 触发，以及出问题怎么办

Grok Bot 的例程是什么

用 xAI 的话说，例程“告诉一个 Bot 什么时候运行一个工作流程：按时间表，或者在某件事发生时”。它属于某一个 Bot，用这个 Bot 的记忆和技能，结果发在这个 Bot 的对话里。

• 定时：用自然语言写，比如“每个工作日早上 8:00”“每 2 小时”，按设置里的时区计算。
• 事件：Slack 触发；GitHub、Linear、Sentry 或 PagerDuty 的事件；发到 Bot 自己邮箱的邮件；或 Webhook 调用。
• 新建的例程不会马上运行，而是等到下一个预定时间；想立刻跑一次用“Test”。
• 例程在 Bot 的云端电脑上运行，你合上笔记本它也照常执行。
• 每次运行（包括测试）都会消耗你的 Grok Bot 用量。

怎么在 Grok Bot 里创建例程

1. 让负责这件事的 Bot 来设置

   在桌面端打开那个 Bot 的对话，说清楚要做什么、什么时候做：输入从哪里来、要什么结果、哪些步骤要你批准、某个来源缺失时怎么办。在手机上，打开 Bot 的资料页，在“Routines”下点“Add routine”，把以“Set up a routine to”开头的消息写完发出去。

   # 在负责这件事的 Bot 的对话里直接说
   设置一个例程：每个工作日早上 7:00 整理我隔夜的 Gmail，
   给紧急的邮件起草回复，把清单发给我。什么都不要发出去。
   
   设置一个例程：每周日下午 6:00 查看下周的 Google 日历，
   标出冲突和排得太满的日子，给我发一份周一计划。
   
   设置一个例程：工作日每 2 小时查看 Slack 的 #launch 频道，
   找出关于价格的问题，起草回答等我批准。

2. 检查“When to run”和时区

   打开例程，看“When to run”确认保存下来的时间；不对就点“Edit”描述怎么改。时区在“Settings”里“Bot”下面的“Timezone”。“Auto-detect”跟随你当前电脑的时区，如果工作属于别的时区，就固定选一个。

3. 先测试一次

   在桌面端打开例程，点“Test”。运行期间显示“Running…”，结果出现在 Bot 的对话里。测试会做真实操作，比如改文件、使用网站，所以凡是会写入或发出的步骤都要设成需要你批准。没有“Test”按钮的例程，可以让 Bot 在对话里用安全的输入先做一次。

4. 暂停、恢复或删除

   桌面端：点 Bot 的名字，打开“Details”，用例程那一行的开关；或者打开例程点“Pause”或“Resume”。手机上：从 Bot 资料页打开例程，关掉“Active”；左滑那一行可以删除。删除无法撤销。

来源：xAI 的 Grok Bot 文档《Skills and routines》

怎么用 Webhook 触发例程

Webhook 让别的服务来启动例程，比如你的店铺收到退款申请时，或者有人提交了报名表时。

1. 加上触发器

   让 Bot 给这个例程加一个 Webhook 触发器。

2. 复制地址和密钥

   在桌面端打开例程，找到“Webhook”区域：“POST to”（地址）、“key”（密钥）和“header”（完整的 Authorization 头），点一下就能复制。

   # 从例程的 Webhook 区域（桌面端）复制 "POST to" 和 "key"
   curl -X POST "https://<例程里的 POST to 地址>" \
     -H "Authorization: Bearer <key>" \
     -H "Content-Type: application/json" \
     -d '{"order": "1042", "status": "refund requested"}'
   
   # 返回 200 = 已开始运行（结果看 Bot 的对话）
   # 其他返回 = 没有开始运行

3. 发送 POST 并看返回

   发一个 HTTP POST，把密钥放在 Authorization: Bearer <key> 里。可以带 JSON 正文，Bot 会连同例程的指令一起收到。返回 200 表示已经开始运行，不代表已经完成。其他任何返回都表示没有开始运行：确认例程没有暂停，并且用的是当前的密钥。

Slack、GitHub 等事件触发

• Slack：可以在 Bot 被提到时、出现某个词或短语时、有人对消息加表情时、或任何消息时触发，监听一个频道或整个 Slack。先在拥有这个 Bot 的 Cursor 账号上连接 Slack。
• GitHub、Linear、Sentry 和 PagerDuty：这些工具里的事件可以启动例程；它们通过 Cursor 账号的集成运行，可能需要单独连接。
• 邮件：发到 Bot 自己邮箱的邮件可以启动例程。
• 只有新的动态才会触发。触发条件尽量收窄：监听一个很热闹的频道里的每条消息，用量会消耗得很快。

Grok Bot 例程的上限

Grok Bot 例程不运行？逐项检查

• 从来没运行过：新例程要等下一个预定时间。点“Test”立刻跑一次。
• 被暂停了：桌面端那一行的开关是关的，或手机上“Active”是关的。你长时间不在时，Grok Bot 也可能自己暂停例程。
• 时间不对：看“When to run”，再检查“Settings > Bot”里的“Timezone”。“Auto-detect”会跟着你当前用的电脑走。
• Slack 触发没反应：消息必须是新的、在被监听的频道里、并且包含匹配的短语。
• Webhook 没有启动运行：返回不是 200 就说明没启动。检查例程是否暂停、密钥是否是当前的。
• 因为频率上限失败：收窄触发条件或放宽时间间隔，然后用“Test”或重新发送 Webhook 再跑一次。xAI 还把一些因共享的 Grok Bot 上限导致的失败列为已知问题，这类失败不会自动重试。
• 用量用完了：每次运行都消耗每周用量。暂停不需要的例程、放宽间隔。在 The X Subscription 上，超出部分从预付额度扣；在旧版 Cursor 套餐上，开启了按需用量才会继续。
• “Sync failed”：xAI 的例程文档没有说明这个错误。打开例程检查时间和触发条件，点“Test”试一次；如果一直失败，在应用里联系 Grok Bot 支持。

xAI 官方示例里的例程点子

这些来自 xAI 文档里的使用场景；每一个都只起草，发出去之前等你批准。

给你的编程 agent 也安排例程

Grok Bot 的例程适合 Gmail、Slack、Notion 里的工作。如果工作在代码仓库里，Crewmark 能给你自己的 Claude Code 或 Codex 同样的节奏：一个有岗位、量化目标、工作时间和心跳的 AI 员工，心跳把它叫醒去看板领下一个任务。

1. 在你的 agent 上雇一个员工

   在 Claude Code 或 Codex 对话里运行设置命令，这个对话就成了员工。参见什么是 AI 员工。

2. 设置工作时间和心跳

   在你选的时间段里每 15 到 240 分钟醒一次，通宵也行。参见如何让 Claude Code 主动工作和 Codex 定时任务。

3. 对比各个个人 Agent

   参见 Grok Bot 指南和个人 AI Agent 对比。

常见问题