透過OpenClaw Ultra將推理流程、進度日誌和狀態更新直接同步到 Todoist，包括即時進度紀錄、狀態更新與透明化儀表板。讓您的代理商能夠全面了解長期運行的任務。
核心系統總覽
此系統將 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 — 將執行紀錄附加為評論
💡 資訊：無需手動編碼。代理處理腳本建立，只需貼上含您憑證的上述提示詞即可。
步驟 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 時先檢查「🟠 等待」部分——代理需要您在那裡完成任務。
- 搭配 自動會議紀錄 工作流程搭配使用，可自動建立後續任務。
- 每週歸檔「🟢 已完成」分區以保持看板整潔
源文出自：https://openclaw.aiondesktop.com/tutorials/zh-cht/17