Openclaw용 TickTick CLI

OAuth2 인증 및 배치 처리 지원을 통해 TickTick 작업 및 프로젝트를 관리하기 위한 강력한 명령줄 인터페이스입니다.

norickkevorkov
v1.0.0
Feb 9, 2026
0
1.9k
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install ticktick-cli

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 ticktick-cli 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

TickTick CLI란 무엇인가요?

TickTick CLI는 TickTick 작업 관리의 모든 기능을 터미널로 직접 가져오는 Openclaw Skills용 강력한 통합 도구입니다. 개발자와 AI 에이전트가 간소화된 명령줄 인터페이스를 사용하여 프로그래밍 방식으로 작업과 프로젝트를 생성, 업데이트 및 구성할 수 있도록 합니다. TickTick Open API v1을 활용하여 이 스킬은 간단한 작업 생성부터 복잡한 배치 작업에 이르기까지 모든 기능을 위한 고급 명령을 제공합니다.

속도와 자동화를 위해 설계된 이 스킬은 서버를 위한 헤드리스 수동 흐름을 포함하여 다양한 인증 모드를 지원합니다. 자동화된 개인 비서를 구축하든, 코딩 중에 흐름을 유지하고 싶든, 이 도구는 개발 환경과 작업 관리자 사이의 간극을 메워줍니다.

TickTick CLI 활용 사례

  • 쉘 스크립트 또는 CI/CD 파이프라인에서 작업 생성 자동화.
  • 터미널이나 IDE를 떠나지 않고 일일 할 일 목록 관리.
  • 단일 호출로 여러 개의 오래된 작업을 중단하는 것과 같은 대량 작업 수행.
  • 자율 AI 에이전트 워크플로우에 TickTick 작업 추적 통합.
  • 맞춤형 데이터 분석 또는 보고를 위해 JSON 형식으로 작업 데이터 필터링 및 내보내기.

TickTick CLI 작동 원리

  1. 사용자는 OAuth2를 통해 CLI를 인증하며, 이는 사용자 홈 디렉토리에 로컬로 저장되는 액세스 토큰을 보호합니다.
  2. Bun 런타임을 사용하는 스크립트를 통해 명령이 실행되며, 작업, 목록 또는 인증에 대한 인수가 전달됩니다.
  3. CLI는 TickTick Open API v1과 상호 작용하여 사용자 데이터를 가져오거나 생성 또는 수정합니다.
  4. 복잡한 작업의 경우, CLI는 특정 작업 동작을 실행하기 전에 사람이 읽을 수 있는 프로젝트 이름을 고유 ID로 해석합니다.
  5. 결과는 사람이 읽을 수 있는 텍스트 또는 구조화된 JSON으로 반환되어 다른 도구로의 추가 파이핑이 가능합니다.

TickTick CLI 설정 가이드

1. 애플리케이션 등록

TickTick 개발자 센터에서 개발자 앱을 등록하고 리디렉션 URI를 http://localhost:8080으로 설정하여 자격 증명을 얻습니다.

2. 인증

다음 명령을 실행하여 OAuth 흐름을 시작합니다.

bun run scripts/ticktick.ts auth --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET

헤드리스 환경의 경우, --manual 플래그를 추가하여 인증 코드를 복사하여 붙여넣습니다.

3. 연결 확인

Openclaw Skills 통합이 활성화되었는지 확인하기 위해 인증 상태를 확인합니다.

bun run scripts/ticktick.ts auth --status

TickTick CLI 데이터 스키마 및 분류 체계

이 스킬은 설정 및 민감한 자격 증명을 ~/.clawdbot/credentials/ticktick-cli/config.json에 저장합니다. --json 플래그를 통해 반환된 데이터는 TickTick API v1 스키마를 따릅니다.

필드 설명
clientId TickTick OAuth2 클라이언트 ID
accessToken 인증된 요청에 사용되는 Bearer 토큰
priority 우선순위 수준: 없음, 낮음, 중간 또는 높음
status 작업 수명 주기 상태: 보류 중 또는 완료됨
dueDate ISO 8601 형식의 날짜 또는 "today"와 같은 상대적 문자열

TickTick CLI 고급 기능

  • 원활한 AI 에이전트 통합을 위해 모든 명령에 대해 전체 JSON 출력 지원.
  • API 왕복을 최소화하고 속도 제한을 효율적으로 처리하기 위한 batch-abandon 명령을 통한 배치 작업 지원.
  • 자연어 마감일 처리 지원 (예: "next monday", "in 7 days").
  • 사용자 개입 없이 장기적인 지속 인증을 보장하는 자동 토큰 갱신 로직.
  • Openclaw Skills 내에서 세밀한 작업 관리를 위한 다중 태그 지원 및 우선순위 필터링.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*