適用於 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 是 Openclaw Skills 的一個強大整合,將 TickTick 任務管理的全部功能直接帶入您的終端機。它允許開發人員和 AI 代理使用流線化的命令列界面以程式化方式創建、更新和組織任務及專案。透過利用 TickTick Open API v1,該技能提供了從簡單任務創建到複雜批次操作的高級命令。

該技能專為速度和自動化而設計,支持多種身份驗證模式,包括適用於伺服器的無頭手動流程。無論您是在構建自動化個人助理,還是只想在編碼時保持工作流,該工具都能彌合開發環境與任務管理器之間的差距。

TickTick CLI 應用場景

  • 透過 Shell 腳本或 CI/CD 流水線自動創建任務。
  • 無需離開終端機或 IDE 即可管理每日待辦事項列表。
  • 執行批次操作,例如在一次調用中放棄多個過時任務。
  • 將 TickTick 任務追蹤整合到自主 AI 代理工作流中。
  • 以 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 進階特性

  • 每個命令都支持完整的 JSON 輸出,以促進 AI 代理的無縫整合。
  • 透過 batch-abandon 命令支持批次操作,最大限度地減少 API 往返並高效處理速率限制。
  • 支持自然語言截止日期處理(例如 "next monday"、"in 7 days")。
  • 自動令牌刷新邏輯,確保無需人工干預的長期持久身份驗證。
  • 在 Openclaw Skills 中支持多標籤管理和優先級過濾,實現精細化任務管理。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Github Stars: 0
forks: 0

精選*