Cron Job 안정화 및 Schema 일관성 작업
API를 연동하다 보면 분명히 맞게 보낸 것 같은데 INVALID_REQUEST 에러를 마주할 때가 있습니다. 특히 LLM이나 외부 도구를 통해 페이로드를 생성할 때 필드 하나가 빠지거나 구조가 살짝 틀어지면 디버깅하기 참 까다롭죠.
이런 번거로움을 줄이기 위해 Gateway의 Cron 처리 방식을 개선했습니다. 이제 형식이 조금 어긋나더라도 Gateway가 최대한 유연하게 해석하여 작업을 성공적으로 등록합니다.
필요한 것
섹션 제목: “필요한 것”- Gateway Schema
- CLI 및 UI 접근 권한
빠른 시작
섹션 제목: “빠른 시작”이제 Gateway가 더 똑똑하게 페이로드를 처리합니다. 5분 안에 바뀐 점을 확인해 보세요.
- 페이로드 정규화 활용:
cron.add나cron.update를 호출할 때data나job으로 감싸진 형태도 이제 자동으로 풀어내어(unwrap) 해석합니다. - 필드 자동 추론:
schedule.kind나payload.kind가 누락되어도 안전한 경우라면 Gateway가 알아서 추론합니다. - 기본값 적용:
wakeMode와sessionTarget필드가 비어 있다면 적절한 기본값을 자동으로 채워줍니다. - 일관된 Provider 사용: Discord, Slack, Signal, iMessage를 CLI와 UI 어디서든 동일한 이름으로 사용할 수 있습니다.
문제 해결
섹션 제목: “문제 해결”cron.add에서INVALID_REQUEST에러가 계속 발생하나요? 최신 Gateway 로그를 확인해 보세요. 정규화 로직이 추가되어 이전보다 에러 발생이 훨씬 줄어들었을 거예요.- Control UI에서 작업 개수가 표시되지 않나요?
화면을 새로고침해 보세요. 이제 UI가
jobCount대신 Gateway의jobs필드를 직접 참조하여 정확한 개수를 보여줍니다.
궁금한 점이 더 있다면 AI Setup Assistant에게 물어보세요.
다음 단계
섹션 제목: “다음 단계”OpenClaw Expert
아직 막혀 있나요?
이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.