Grok Bot 루틴: Bot 일정 잡기, 웹훅으로 실행하기, 문제 해결하기

Grok Bot 루틴이란

xAI의 설명에 따르면 루틴은 “Bot 하나에게 언제 워크플로를 실행할지 알려 주는 것으로, 일정에 따르거나 무언가 일어났을 때 실행돼요.” 루틴은 Bot 하나에 속하고, 그 Bot의 메모리와 스킬을 쓰며, 결과를 Bot의 채팅에 올려요.

• 일정: “every weekday at 8:00 AM”이나 “every 2 hours” 같은 일상 표현으로, 설정에 지정한 시간대를 따라요.
• 이벤트: Slack 트리거, GitHub·Linear·Sentry·PagerDuty 이벤트, Bot 전용 주소로 온 이메일, 웹훅 호출.
• 새 루틴은 만들 때 바로 실행되지 않아요. 다음 예정 시각을 기다려요. 지금 실행하려면 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

웹훅으로 루틴 실행하는 법

웹훅을 쓰면 다른 서비스가 루틴을 시작할 수 있어요. 예를 들어 환불 요청이 들어오면 쇼핑몰이, 누군가 가입하면 신청서가 루틴을 시작하게 할 수 있어요.

1. 트리거 추가하기

   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: 채널 하나 또는 Slack 전체에서 Bot이 멘션될 때, 특정 단어나 문구가 나올 때, 누군가 메시지에 반응할 때, 또는 모든 메시지에 실행돼요. 먼저 Bot을 소유한 Cursor 계정에 Slack을 연결하세요.
• GitHub, Linear, Sentry, PagerDuty: 이 도구들의 이벤트로 루틴을 시작해요. 이 트리거는 Cursor 계정 연동을 거치므로 따로 연결이 필요할 수 있어요.
• 이메일: Bot 전용 주소로 온 이메일로 루틴을 시작할 수 있어요.
• 새 활동만 실행을 시작해요. 트리거는 좁게 잡으세요. 바쁜 채널의 모든 메시지를 지켜보면 사용량이 빠르게 줄어요.

Grok Bot 루틴 제한

Grok Bot 루틴이 안 돌아가나요? 확인할 점

• 한 번도 실행되지 않았다: 새 루틴은 다음 예정 시각을 기다려요. 지금 실행하려면 Test를 고르세요.
• 일시 정지돼 있다: 데스크톱에서는 행 스위치가, 휴대폰에서는 Active가 꺼져 있어요. 오래 접속하지 않으면 Grok Bot이 직접 루틴을 일시 정지하기도 해요.
• 시간이 틀리다: When to run을 읽고 설정 > Bot의 Timezone을 확인하세요. 자동 감지는 지금 쓰는 컴퓨터를 따라요.
• Slack 트리거가 작동하지 않았다: 메시지가 새것이어야 하고, 지켜보는 채널에 있어야 하며, 일치하는 문구가 들어 있어야 해요.
• 웹훅이 실행을 시작하지 않았다: 200이 아닌 응답은 시작되지 않았다는 뜻이에요. 루틴이 일시 정지돼 있지 않은지, 키가 최신인지 확인하세요.
• 속도 제한으로 실행이 실패했다: 트리거를 좁히거나 일정 간격을 넓힌 뒤, Test나 웹훅 재전송으로 다시 실행하세요. xAI는 Grok Bot 공용 한도로 인한 실패도 알려진 문제로 올려 두었고, 이런 실패는 자동으로 재시도되지 않아요.
• 사용량이 바닥났다: 모든 실행이 주간 사용량을 써요. 필요 없는 루틴은 일시 정지하고 일정 간격을 넓히세요. The X Subscription에서는 추가 사용량이 선불 크레딧에서, 기존 Cursor 플랜에서는 켜 두었다면 온디맨드 사용량에서 나가요.
• “Sync failed”: xAI의 루틴 문서에는 이 오류 설명이 없어요. 루틴을 열어 일정과 트리거를 확인하고 Test를 실행하세요. 계속 실패하면 앱에서 Grok Bot 지원팀에 문의하세요.

xAI 예시에서 나온 루틴 아이디어

xAI 문서의 사용 사례에서 가져왔어요. 모두 초안을 만든 뒤, 무언가 내보내기 전에 내 승인을 기다려요.

코딩 에이전트에도 루틴을

Grok Bot 루틴은 Gmail, Slack, Notion에 있는 일에 잘 맞아요. 일이 코드 저장소에 있다면, Crewmark가 내 Claude Code나 Codex에 같은 리듬을 줘요. 직무, 숫자로 된 목표, 근무 시간, 그리고 깨어나서 보드의 다음 이슈를 가져가게 하는 하트비트를 갖춘 AI 직원이에요.

1. 내 에이전트로 직원 채용하기

   Claude Code나 Codex 대화에서 설정 명령어를 실행하면 그 대화가 직원이 돼요. AI 직원이란을 참고하세요.

2. 근무 시간과 하트비트 정하기

   정한 시간 동안 15분에서 240분마다, 밤에도 깨어나요. Claude Code를 능동적으로 만드는 법과 Codex 예약 작업을 참고하세요.

3. 개인 에이전트 비교하기

   Grok Bot 가이드와 개인 AI 에이전트 비교를 참고하세요.

자주 묻는 질문