Grok Bot のルーティン：Bot のスケジュール設定、Webhook での起動、トラブル対処

Grok Bot のルーティンとは

xAI の説明では、ルーティンは「1 つの Bot に、ワークフローをいつ実行するかを伝えるもの。スケジュールで、または何かが起きたときに」です。ルーティンは 1 つの Bot に属し、その Bot の記憶とスキルを使い、結果をその Bot のチャットに投稿します。

• スケジュール：「every weekday at 8:00 AM」や「every 2 hours」のような普通の言い回しで、設定のタイムゾーンに従います。
• イベント：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」を選んで修正内容を伝えます。タイムゾーンは設定の Bot にある Timezone 欄です。自動検出はパソコンのタイムゾーンを使うので、仕事が別の地域のものなら固定のタイムゾーンを選びましょう。

3. 一度テストする

   デスクトップでルーティンを開き、「Test」を選びます。実行が終わるまで「Running…」と表示され、結果は Bot のチャットに表れます。テストでもファイルの変更やサイトの利用など実際の作業が行われるので、書き込みや送信をするものはあなたの承認の後ろに置いておきましょう。Test ボタンのないルーティンでは、安全な入力を使ってチャットで一度その仕事をするよう Bot に頼みます。

4. 一時停止、再開、削除

   デスクトップでは、Bot の名前をクリックして「Details」を開き、ルーティンの行のスイッチを使うか、ルーティンを開いて「Pause」か「Resume」を選びます。スマートフォンでは、Bot のプロフィールからルーティンを開いて「Active」をオフにします。行をスワイプすると削除できます。削除は取り消せません。

出典：xAI の Grok Bot ドキュメント「Skills and routines」

Webhook でルーティンを起動する方法

Webhook を使えば、ほかのサービスからルーティンを開始できます。たとえば、返金の依頼があったときにあなたのストアから、誰かが登録したときにフォームから起動できます。

1. トリガーを追加する

   ルーティンに Webhook トリガーを追加するよう Bot に頼みます。

2. URL とキーをコピーする

   デスクトップでルーティンを開き、Webhook セクションを見つけます。POST to（URL）、key（シークレット）、header（Authorization ヘッダー全体）があります。欄をクリックするとコピーできます。

   # ルーティンの Webhook セクション（デスクトップ）から "POST to" と "key" をコピー
   curl -X POST "https://<ルーティンの POST to の URL>" \
     -H "Authorization: Bearer <key>" \
     -H "Content-Type: application/json" \
     -d '{"order": "1042", "status": "refund requested"}'
   
   # 200 = 実行が始まった（結果は Bot のチャットで確認）
   # それ以外 = 実行は始まっていない

3. POST を送って応答を読む

   キーを Authorization: Bearer <key> として HTTP POST を送ります。JSON の本文を含めることもでき、Bot はルーティンの指示と一緒にそれを受け取ります。200 は実行が始まったことを意味し、終わったことではありません。それ以外の応答は実行が始まっていないことを意味します。ルーティンが一時停止していないか、現在のキーを使っているかを確認しましょう。

Slack、GitHub などのイベントトリガー

• Slack：Bot がメンションされたとき、ある語句が現れたとき、誰かがメッセージにリアクションしたとき、またはすべてのメッセージで起動します。1 つのチャンネルでも Slack 全体でも設定できます。先に、Bot を所有する Cursor アカウントで Slack を接続してください。
• GitHub、Linear、Sentry、PagerDuty：これらのツールのイベントからルーティンを開始します。これらのトリガーは Cursor アカウントの連携を通じて動き、個別の接続が必要な場合があります。
• メール：Bot 専用のアドレスに送られたメールからルーティンを開始できます。
• 実行を始めるのは新しいアクティビティだけです。トリガーは絞り込みましょう。活発なチャンネルをすべてのメッセージで監視すると、利用量があっという間に減ります。

Grok Bot のルーティンの上限

Grok Bot のルーティンが動かない？確認ポイント

• 一度も実行されない：新しいルーティンは次の予定時刻を待っています。すぐに動かすには「Test」を選びます。
• 一時停止している：デスクトップでは行のスイッチがオフ、スマートフォンでは「Active」がオフになっています。しばらく離れていたあと、Grok Bot が自分でルーティンを一時停止することもあります。
• 時刻が違う：「When to run」を読み、設定 > Bot の Timezone を確認します。自動検出は使っているパソコンに従います。
• Slack のトリガーが起動しなかった：メッセージは新しく、監視対象のチャンネルにあり、一致する語句を含んでいる必要があります。
• Webhook で実行が始まらなかった：200 以外の応答は、始まっていないことを意味します。ルーティンが一時停止していないか、キーが最新かを確認しましょう。
• レート制限で実行が失敗した：トリガーを絞るかスケジュールの間隔を広げ、「Test」か Webhook の再送でもう一度実行します。xAI は、共有の Grok Bot 上限による失敗も既知の問題として挙げており、これらは自動で再試行されません。
• 利用量が尽きた：すべての実行が週ごとの利用量を消費します。不要なルーティンは一時停止し、スケジュールの間隔を広げましょう。The X Subscription では超過分はプリペイドのクレジットから、従来の Cursor プランではオンにしていれば従量課金から使われます。
• 「Sync failed」：xAI のルーティンのドキュメントにはこのエラーの説明がありません。ルーティンを開いてスケジュールとトリガーを確認し、「Test」を実行します。失敗が続く場合は、アプリから Grok Bot のサポートに連絡してください。

xAI 自身の例にもとづくルーティンのアイデア

xAI のドキュメントの活用例より。どれも仕事を下書きし、何かを外に出す前にあなたの承認を待ちます。

コーディングエージェントにもルーティンを

Grok Bot のルーティンは、Gmail、Slack、Notion にある仕事に向いています。仕事がコードリポジトリにあるなら、Crewmark があなたの Claude Code や Codex に同じリズムを与えます。職種、数字の目標、勤務時間、そしてボードから次の issue を取るために起こしてくれるハートビートを持つ AI 社員です。

1. あなたのエージェントで社員を雇う

   Claude Code か Codex の会話でセットアップコマンドを実行すると、その会話が社員になります。AI 社員とはをご覧ください。

2. 勤務時間とハートビートを設定する

   選んだ時間帯に、夜間も含めて 15〜240 分ごとに起きて働きます。Claude Code を能動的に動かす方法と Codex の予定タスクをご覧ください。

3. パーソナルエージェントを比較する

   Grok Bot ガイドとパーソナル AI エージェントの比較をご覧ください。

よくある質問