Todoist 任務管理器
透過將推理過程、進度紀錄和狀態更新直接同步至 Todoist,讓您的代理對長時間執行的任務有完全的可見性——全部由 OpenClaw Ultra 自動化。
核心系統總覽
此系統將 Todoist 轉變為代理的透明化儀表板。每個複雜任務都會在 Todoist 中建立一個項目,包含完整計畫、即時子步驟評論和自動狀態轉換。您隨時知道您的代理在做什麼以及卡在哪裡。
| 系統層 | 核心功能 | 輸出結果 |
|---|---|---|
| 任務建立層 | 自動建立附帶完整代理推理計畫的 Todoist 任務 | 在正確專案/分區中被追蹤的任務 |
| 進度串流層 | 即時的子步驟完成以任務評論方式紀錄 | 按時間順序的執行紀錄 |
| 狀態管理層 | 自動將任務移動至進行中 / 等待中 / 完成 分區 | 視覺化的管道狀態 |
| 健康監控層 | 定期心跳檢查以偵測停滯或失敗的任務 | 及時的停滯任務警報 |
| 報告層 | 每日任務完成摘要與執行指標 | 一天結束的生產力報告 |
前置需求
| 項目 | 需求 |
|---|---|
| OpenClaw Ultra | 已安裝並運行中 |
| Todoist 帳號 | 免費或 Pro 方案,具有 API 存取權限 |
| Todoist API Token | 從 Todoist 設定 > 整合 取得 |
| 專案 ID | 建立一個專案(例如「OpenClaw Tasks」)並複製其 ID |
步驟 0 — 取得 Todoist API 憑證
在代理可以同步任務之前,您需要 API 存取權限。
操作步驟
- 前往 Todoist 設定 > 整合
- 複製您的 API Token
- 建立一個名為 「OpenClaw Tasks」 的新專案
- 在內部建立 3 個分區:🟡 進行中、🟠 等待中、🟢 已完成
- 記下專案 ID 和分區 ID(點擊每個分區時可在 URL 中看到)
步驟 1 — 讓代理建立同步腳本
不需要安裝 Skill,直接請 OpenClaw 自行建立整合腳本。
即用提示詞
我要你為自己的運行建立一個基於 Todoist 的任務可見性系統。
首先,在 'scripts/' 資料夾中建立三個 bash 腳本:
1. todoist_api.sh — Todoist REST API 的 curl 包裝器
2. sync_task.sh — 建立或更新任務,使用 section_ids 來區分進行中、等待中、已完成
3. add_comment.sh — 將進度紀錄作為評論發佈到任務上
使用這些憑證:
- Token: [你的 Todoist API token]
- 專案 ID: [你的專案 ID]
- 分區 ID: 進行中 [id], 等待中 [id], 已完成 [id]
建立完成後,透過建立測試任務來驗證腳本是否正常運作。腳本結構(自動生成)
代理會生成呼叫 Todoist REST API 的腳本:
- todoist_api.sh — 通用的 GET/POST 包裝器
- sync_task.sh — 在正確的分區中建立任務,並將計畫寫入描述
- add_comment.sh — 將執行紀錄附加為評論
INFO
無需手動編碼。代理處理腳本建立,只需貼上含您憑證的上述提示詞即可。
步驟 2 — 啟用任務可見性模式
告知代理今後對每個複雜任務都使用 Todoist。
提示詞
從現在起,對我給你的每個複雜任務:
1. 開始前,在「🟡 進行中」建立一個 Todoist 任務
- 任務名稱:目標的簡要摘要
- 描述:你的完整執行計畫(逐步說明)
2. 每完成一個子步驟,呼叫 add_comment.sh 記錄:
- 完成了什麼
- 關鍵結果或決策
- 遇到的任何阻礙
3. 任務完成時,移動到「🟢 已完成」
4. 如果被阻礙並等待我,移動到「🟠 等待中」並說明原因
從處理這個任務開始:[你的第一個複雜任務]步驟 3 — 單次任務同步(手動模式)
針對仍需追蹤的快速臨時任務。
提示詞
在 Todoist 中追蹤此任務:
任務:[描述]
計畫:[簡要步驟]
優先順序:[高/中/低]
建立在「🟡 進行中」中,並在我給你更多指示時更新它。步驟 4 — 啟用心跳監控
透過定期檢查任務進度來防止靜默失敗。
提示詞
設定心跳監控例程:
每 30 分鐘,檢查「🟡 進行中」中的所有 Todoist 任務:
- 對每個任務,驗證最後評論是否在 25 分鐘內
- 如果任何任務超過 30 分鐘沒有新評論,標記為停滯
- 透過 [Telegram / Email] 通知我:任務名稱、距上次更新的時間、可能原因
同時在下午 6 點執行每日檢查:
- 摘要今天移至「🟢 已完成」的所有任務
- 列出仍在「🟠 等待中」的任務及其時間長度
- 報告每個完成任務的平均評論數步驟 5 — 自動調解停滯任務
讓代理在任務靜默時自行恢復或升級。
提示詞
當任務被標記為停滯(超過 30 分鐘無更新)時:
1. 檢查任務的原始計畫是否可以恢復
2. 如果可以,發佈恢復評論並繼續
3. 如果不行,移至「🟠 等待中」並說明需要什麼
4. 如果停滯超過 2 小時,直接向我發送訊息進行升級最終工作流邏輯
您下達任務 → 代理建立附帶計畫的 Todoist 任務 →
子步驟評論即時串流 → 狀態自動更新 →
心跳監控健康狀態 → 您隨時在 Todoist 中查看完整可見性實用技巧
- 使用描述性的任務名稱,讓 Todoist 清單一目了然
- 開啟 Todoist 時先檢查「🟠 等待中」分區——那是代理需要您的地方
- 搭配 自動會議紀錄 工作流自動建立後續任務
- 每週歸檔「🟢 已完成」分區以保持看板整潔