Todoist タスクマネージャー
エージェントの推論、進捗ログ、ステータス更新をTodoistに直接同期し、長時間実行タスクの完全な可視性を実現します — OpenClaw Ultraで自動化。
コアシステム概要
このシステムはTodoistをエージェントの透明性ダッシュボードに変えます。複雑なタスクごとにTodoistアイテムが作成され、完全な計画、リアルタイムのサブステップコメント、自動ステータス遷移が記録されます。エージェントが何をやっているか、どこで詰まっているかをいつでも把握できます。
| システム層 | コア機能 | 出力結果 |
|---|---|---|
| タスク作成層 | エージェントの推論計画を含むTodoistタスクを自動作成 | 正しいプロジェクト/セクションで追跡されるタスク |
| 進捗ストリーミング層 | サブステップ完了をリアルタイムでタスクコメントとして記録 | 時系列の実行ログ |
| ステータス管理層 | In Progress / Waiting / Done セクション間でタスクを自動移動 | ビジュアルパイプラインステータス |
| ヘルスモニタリング層 | 停滞または失敗したタスクの定期ハートビートチェック | ブロックされたタスクへのタイムリーなアラート |
| レポート層 | 実行メトリクス付きの日次タスク完了サマリー | 日終生産性レポート |
前提条件
| 項目 | 要件 |
|---|---|
| OpenClaw Ultra | インストール済み＆稼働中 |
| Todoist アカウント | APIアクセスが可能なFreeまたはProプラン |
| Todoist API トークン | Todoist設定 > 連携 から取得 |
| Project ID | プロジェクトを作成（例："OpenClaw Tasks"）してIDをコピー |
ステップ 0 — Todoist API認証情報を取得
エージェントがタスクを同期する前に、APIアクセスが必要です。
操作手順
- Todoist設定 > 連携 に移動
- API トークンをコピー
- "OpenClaw Tasks" という名前の新しいプロジェクトを作成
- 内部に3つのセクションを作成: 🟡 In Progress、🟠 Waiting、🟢 Done
- Project IDとSection IDを控える（各セクションをクリックした際のURLに表示）
ステップ 1 — エージェントに同期スクリプトを構築させる
スキルをインストールする代わりに、OpenClaw自身に統合スクリプトを作成させます。
そのまま使えるプロンプト
Todoistベースのタスク可視性システムを構築してください。
まず、'scripts/' フォルダに3つのbashスクリプトを作成してください：
1. todoist_api.sh — Todoist REST API用のcurlラッパー
2. sync_task.sh — In Progress、Waiting、Doneのsection_idsでタスクを作成または更新
3. add_comment.sh — タスクに進捗ログをコメントとして投稿
以下の認証情報を使用：
- Token: [あなたのTodoist APIトークン]
- Project ID: [あなたのプロジェクトID]
- Section IDs: In Progress [id], Waiting [id], Done [id]
作成後、テストタスクを作成してスクリプトが動作することを確認してください。スクリプト構造（自動生成）
エージェントはTodoist REST APIを呼び出すスクリプトを生成します：
- todoist_api.sh — 汎用GET/POSTラッパー
- sync_task.sh — 説明欄に計画を含めて正しいセクションにタスクを作成
- add_comment.sh — 実行ログをコメントとして追記
INFO
手動コーディングは不要です。エージェントがスクリプト作成を処理します。上記のプロンプトに認証情報を貼り付けるだけです。
ステップ 2 — タスク可視性モードを有効化
今後の複雑なタスクごとにTodoistを使うようエージェントに指示します。
プロンプト
今後、私が与えるすべての複雑なタスクについて：
1. 開始前に、"🟡 In Progress" にTodoistタスクを作成
- タスク名：目標の簡単な要約
- 説明：完全な実行計画（ステップバイステップ）
2. 各サブステップ完了時に、add_comment.sh を呼び出して以下を記録：
- 実施内容
- 主要な結果または判断
- 発生したブロッカー
3. タスク完了時に "🟢 Done" に移動
4. ブロックされて待ち状態の場合は "🟠 Waiting" に移動し、理由を説明
このタスクから始めてください：[最初の複雑なタスク]ステップ 3 — ワンオフタスク同期（手動モード）
追跡が必要なアドホックタスク用。
プロンプト
このタスクをTodoistで追跡：
Task: [説明]
Plan: [簡単な手順]
Priority: [high/medium/low]
"🟡 In Progress" に作成し、追加の指示に従って更新してください。ステップ 4 — ハートビート監視を有効化
タスクの進捗を定期的にチェックし、サイレントフェイルを防止。
プロンプト
ハートビート監視ルーチンを設定：
30分ごとに、"🟡 In Progress" のすべてのTodoistタスクをチェック：
- 各タスクについて、最後のコメントが25分以内であることを確認
- 30分以上新しいコメントがないタスクは停滞としてフラグ付け
- [Telegram / メール] で通知：タスク名、最終更新からの経過時間、原因の可能性
毎日午後6時にもチェックを実行：
- 本日 "🟢 Done" に移動したすべてのタスクをサマリー
- "🟠 Waiting" に残っているタスクを経過時間付きで一覧表示
- 完了タスクあたりの平均コメント数をレポートステップ 5 — 停滞タスクの自動リコンサイル
タスクがサイレントになった場合に、エージェントに回復またはエスカレーションさせます。
プロンプト
タスクが停滞フラグを受けた場合（30分以上更新なし）：
1. タスクの元の計画が再開可能か確認
2. 可能であれば、回復コメントを投稿して続行
3. 不可能な場合は "🟠 Waiting" に移動し、必要なものを説明
4. 2時間以上停滞している場合は、直接メッセージでエスカレーション最終ワークフローロジック
タスクを指示 → エージェントが計画付きTodoistタスクを作成 →
サブステップコメントがリアルタイムでストリーミング → ステータスが自動更新 →
ハートビートがヘルスを監視 → Todoistでいつでもフル可視性を確認実践的な使用のヒント
- 説明的なタスク名を使用して、Todoistリストを一目で把握できるようにする
- Todoistを開いたらまず "🟠 Waiting" セクションを確認 — ここにエージェントからの依頼がある
- 自動議事録 ワークフローと組み合わせて、フォローアップタスクを自動作成
- ボードをクリーンに保つため、"🟢 Done" セクションを週次でアーカイブ