Todoist 작업 관리자
에이전트의 추론, 진행 로그, 상태 업데이트를 Todoist에 직접 동기화하여 장시간 실행 작업의 완전한 가시성을 확보하세요 — OpenClaw Ultra로 자동화.
핵심 시스템 개요
이 시스템은 Todoist를 에이전트의 투명성 대시보드로 전환합니다. 모든 복잡한 작업에 대해 Todoist 항목이 생성되어 전체 계획, 실시간 서브스텝 댓글, 자동 상태 전환이 기록됩니다. 에이전트가 무엇을 하고 있는지, 어디서 막혀 있는지 언제든 파악할 수 있습니다.
| 시스템 레이어 | 핵심 기능 | 출력 결과 |
|---|---|---|
| 작업 생성 레이어 | 에이전트의 추론 계획이 포함된 Todoist 작업 자동 생성 | 올바른 프로젝트/섹션에서 추적되는 작업 |
| 진행 스트리밍 레이어 | 서브스텝 완료를 실시간으로 작업 댓글로 기록 | 시간순 실행 로그 |
| 상태 관리 레이어 | In Progress / Waiting / Done 섹션 간 작업 자동 이동 | 시각적 파이프라인 상태 |
| 헬스 모니터링 레이어 | 정체되거나 실패한 작업에 대한 주기적 하트비트 검사 | 차단된 작업에 대한 적시 알림 |
| 리포팅 레이어 | 실행 메트릭이 포함된 일일 작업 완료 요약 | 하루 마감 생산성 리포트 |
전제 조건
| 항목 | 요구 사항 |
|---|---|
| OpenClaw Ultra | 설치 및 실행 중 |
| Todoist 계정 | API 접근이 가능한 Free 또는 Pro 플랜 |
| Todoist API 토큰 | Todoist 설정 > 연동에서 획득 |
| Project ID | 프로젝트 생성 (예: "OpenClaw Tasks") 후 ID 복사 |
단계 0 — Todoist API 인증 정보 획득
에이전트가 작업을 동기화하려면 API 접근이 필요합니다.
조작 단계
- Todoist 설정 > 연동으로 이동
- API 토큰 복사
- **"OpenClaw Tasks"**라는 새 프로젝트 생성
- 내부에 3개 섹션 생성: 🟡 In Progress, 🟠 Waiting, 🟢 Done
- Project ID와 Section ID 기록 (각 섹션 클릭 시 URL에 표시)
단계 1 — 에이전트에게 동기화 스크립트 구축 시키기
스킬을 설치하는 대신 OpenClaw에게 직접 통합 스크립트를 생성하게 합니다.
바로 사용 가능한 프롬프트
Todoist 기반 작업 가시성 시스템을 구축해 주세요.
먼저 'scripts/' 폴더에 3개의 bash 스크립트를 생성하세요:
1. todoist_api.sh — Todoist REST API용 curl 래퍼
2. sync_task.sh — In Progress, Waiting, Done의 section_ids로 작업 생성 또는 업데이트
3. add_comment.sh — 작업에 진행 로그를 댓글로 게시
다음 인증 정보를 사용하세요:
- Token: [Todoist API 토큰]
- Project ID: [프로젝트 ID]
- Section IDs: In Progress [id], Waiting [id], Done [id]
생성 후 테스트 작업을 만들어 스크립트가 작동하는지 확인하세요.스크립트 구조 (자동 생성)
에이전트는 Todoist REST API를 호출하는 스크립트를 생성합니다:
- todoist_api.sh — 범용 GET/POST 래퍼
- sync_task.sh — 설명란에 계획을 포함하여 올바른 섹션에 작업 생성
- add_comment.sh — 실행 로그를 댓글로 추가
INFO
수동 코딩이 필요 없습니다. 에이전트가 스크립트 생성을 처리합니다. 위 프롬프트에 인증 정보를 붙여넣기만 하세요.
단계 2 — 작업 가시성 모드 활성화
앞으로 모든 복잡한 작업에 Todoist를 사용하도록 에이전트에게 지시합니다.
프롬프트
앞으로 제가 주는 모든 복잡한 작업에 대해:
1. 시작 전에 "🟡 In Progress"에 Todoist 작업 생성
- 작업명: 목표의 간략한 요약
- 설명: 전체 실행 계획 (단계별)
2. 각 서브스텝 완료 시 add_comment.sh를 호출하여 다음을 기록:
- 수행 내용
- 주요 결과 또는 결정
- 발생한 차단 요소
3. 작업 완료 시 "🟢 Done"으로 이동
4. 차단되어 대기 중인 경우 "🟠 Waiting"으로 이동하고 이유 설명
이 작업부터 시작하세요: [첫 번째 복잡한 작업]단계 3 — 일회성 작업 동기화 (수동 모드)
추적이 필요한 임시 작업용.
프롬프트
이 작업을 Todoist에서 추적:
Task: [설명]
Plan: [간단한 단계]
Priority: [high/medium/low]
"🟡 In Progress"에 생성하고 추가 지시에 따라 업데이트하세요.단계 4 — 하트비트 모니터링 활성화
작업 진행 상황을 주기적으로 확인하여 무음 실패를 방지합니다.
프롬프트
하트비트 모니터링 루틴을 설정하세요:
30분마다 "🟡 In Progress"의 모든 Todoist 작업을 확인:
- 각 작업에 대해 마지막 댓글이 25분 이내인지 확인
- 30분 이상 새 댓글이 없는 작업은 정체로 플래그
- [Telegram / 이메일]로 알림: 작업명, 마지막 업데이트 후 경과 시간, 가능한 원인
매일 오후 6시에도 실행:
- 오늘 "🟢 Done"으로 이동한 모든 작업 요약
- "🟠 Waiting"에 남아있는 작업을 경과 시간과 함께 나열
- 완료된 작업당 평균 댓글 수 보고단계 5 — 정체 작업 자동 조정
작업이 무음 상태가 되면 에이전트가 복구하거나 에스컬레이션합니다.
프롬프트
작업이 정체 플래그를 받은 경우 (30분 이상 업데이트 없음):
1. 작업의 원래 계획이 재개 가능한지 확인
2. 가능하면 복구 댓글을 게시하고 계속 진행
3. 불가능하면 "🟠 Waiting"으로 이동하고 필요한 사항 설명
4. 2시간 이상 정체된 경우 직접 메시지로 에스컬레이션최종 워크플로우 로직
작업 지시 → 에이전트가 계획이 포함된 Todoist 작업 생성 →
서브스텝 댓글이 실시간으로 스트리밍 → 상태 자동 업데이트 →
하트비트가 헬스 모니터링 → Todoist에서 언제든 전체 가시성 확인실전 사용 팁
- 설명적인 작업 이름을 사용하여 Todoist 목록을 한눈에 파악할 수 있게 하기
- Todoist를 열면 먼저 "🟠 Waiting" 섹션 확인 — 에이전트가 여기서 기다리고 있음
- 자동 회의록 워크플로우와 연계하여 후속 작업 자동 생성
- 보드를 깔끔하게 유지하기 위해 "🟢 Done" 섹션을 주간으로 아카이브