저는 TickTick으로 할일 관리를 하고 있습니다. OpenClaw에 TickTick을 연동하여 할일 관리를 해보기 위해 먼저 ClawHub에 등록된 상위 스킬 두 가지를 설치해 보았습니다.
ManuelHettich/ticktickkaiofreitas/ticktick-api
제가 깊게 파고 들지 않아서 그랬을 것이라 생각하지만, 아쉽게도 두 스킬 모두 현재 시점에서는 정상적으로 동작하지 않았습니다. 게다가 TickTick 관련된 모든 스킬이 suspicious patterns detected라고 표시가 돼 있어서 남이 만든 걸 쓰느니, 직접 스킬을 만들어보기로 했습니다.
1. OpenClaw에게 스킬 생성 요청
다음과 같이 프롬프트를 입력했습니다.
“TickTick 일정 관리를 할 수 있는 스킬을 만들어줘. Client ID, Client Secret, OAuth redirect URL을 입력하는 형태로 진행해줘.”
곧 워크스페이스 폴더 하위에 ticktick-skill이라는 폴더를 생성하고, 필요한 SKILL.md와 scripts/ticktick_cli.py 파일을 만들어 주었습니다.
2. TickTick 개발자 앱 등록 및 인증
스킬을 사용하려면 TickTick API 연동을 위한 키가 필요합니다.
- TickTick 개발자 센터 접속: https://developer.ticktick.com/manage/
- 앱 등록: 새 앱을 생성합니다.
- Redirect URL 설정:
OAuth redirect URL항목에http://127.0.0.1:8080/callback을 입력했습니다. (로컬 테스트용이라 아무 주소나 입력해도 상관없는 듯합니다.)
여기서 발급받은 Client ID와 Client Secret을 OpenClaw에게 입력해 주니, 인증을 위한 URL을 안내해 줍니다. 브라우저에서 해당 URL을 열고 로그인을 하면 리다이렉트가 되는데, 이때 주소창에 뜨는 URL(정확히는 그 안의 code 값)을 다시 OpenClaw에게 복사해 주면 인증이 완료됩니다.
3. 문제 발생: 프로젝트 리스트가 비어있다?
설정이 완료되었다는 메시지를 보고 야심 차게 “오늘 일정을 알려줘”라고 요청했습니다. 그런데 돌아온 대답은 “프로젝트 리스트가 비어 있어서(Empty list []) 데이터를 가져올 수 없다”는 것이었습니다.
혹시 무료 계정이라 API 제한이 있나 싶어서, 별도의 파이썬 스크립트를 짜서 직접 API를 호출해 봤는데 역시나 Project List는 빈 값으로 넘어오더군요.
해결 과정: Inbox ID 찾기
리스트 조회는 안 되지만 등록은 될까 싶어서 “일정 등록해 줘”라고 했더니, “Inbox 프로젝트(inboxXXXXXX)”에 정상적으로 등록되었다는 응답이 왔습니다.
여기서 힌트를 얻었습니다. inboxXXXXXX가 바로 제 기본 보관함(Inbox)의 프로젝트 ID였던 겁니다. 이 ID를 가지고 다시 조회를 요청하니 그제야 전체 할 일이 정상적으로 표시되었습니다.
4. 스킬 수정 및 최종 설정
매번 프로젝트 ID를 입력할 수는 없으니, OpenClaw에게 스킬 로직 수정을 요청했습니다.
“내가 TickTick 관련 작업을 요청할 때 projectId를 따로 언급하지 않으면, 디폴트로 ‘inboxXXXXXX’ 값을 참조하도록 스킬을 수정해 줘.”
이렇게 수정한 이후로는 별도로 프로젝트를 지정하지 않아도, 자동으로 제 Inbox를 참조해서 일정 조회나 등록이 아주 잘 되고 있습니다.
참고
TickTick 연동 후 생성된 인증 정보(access token)와 디폴트 프로젝트 ID 등의 설정값은 ~/.ticktick_skill/config.json 파일에 저장되었습니다.
경로가 홈 디렉터리에 바로 노출되어 있어서 조금 거슬리는데, 나중에 기회가 되면 스킬 내부 폴더나 더 적절한 위치로 옮겨주는 작업을 해야 할 것 같습니다.
-> ~/.openclaw/.env 파일로 설정값을 모두 이동시켰고, 스킬에서도 참조하는 코드를 모두 수정해두었습니다.