Setup & Installation

Install Todo using the ClawHub CLI or OpenClaw CLI:

clawhub install todo

If the CLI is not installed:

npx clawhub@latest install todo

Or install with OpenClaw CLI:

openclaw skills install todo

View on ClawHub · View on GitHub

What This Skill Does

Todo is a Productivity & Workflow skill for OpenClaw by agenticio.

Todo: Offload the weight. Keep the momentum.

Core Philosophy

  1. Capture pressure before it turns into anxiety.
  2. Surface momentum, not accumulated guilt.
  3. Recommend one clear next step, not an overwhelming list.
  4. Let cold tasks move into review, where the user can delay, archive, or let go.

Runtime Requirements

  • Python 3 must be available as python3
  • No external packages required

Storage

All data is stored locally only under:

  • ~/.openclaw/workspace/memory/todo/items.json
  • ~/.openclaw/workspace/memory/todo/stats.json
  • ~/.openclaw/workspace/memory/todo/archive.json

No external sync. No cloud storage. No third-party task APIs.

Item Types

  • task: A concrete action.
  • project: A multi-step outcome that should be broken into next actions.
  • commitment: A promise or obligation to someone else.
  • follow_up: Something that needs to be checked on, nudged, or revisited.
  • reminder: A lightweight remember-later item.

Item Traits

  • tiny: 2-5 minute action with low friction.
  • hot: Fresh, recently captured, or recently touched.
  • cold: Stale item that should move into review unless urgent.
  • blocked: Cannot move forward yet.
  • waiting: Pending someone else.

Key Workflows

  • Capture: add_item.py --title "..." with inferred metadata.
  • What Next: what_next.py returns 1 Top Pick and 2 Backups, each with a humanized prefix and short reason.
  • Daily Sync: daily_sync.py summarizes completed work and mental weight released.
  • Weekly Review: weekly_review.py revives, delays, archives, or lets go of cold items.

Scripts

Script Purpose
add_item.py Capture a new item into the system
what_next.py Recommend the best next action
update_item.py Update status and metadata
daily_sync.py Summarize progress and mental weight released
weekly_review.py Review, delay, archive, or let go of cold items
archive_item.py Move an item into archive
refresh_scores.py Recalculate hot/warm/cold scores
init_storage.py Initialize local storage files

Version History

Latest version: 3.0.1

First published: Mar 7, 2026. Last updated: Mar 11, 2026.

4 versions released.

Frequently Asked Questions

Is Todo free to use?
Yes. Todo is a free, open-source skill available on the OpenClaw Skills Registry. You can install and use it at no cost, and the source code is publicly available for review and contribution.
What platforms does Todo support?
It runs on any platform that supports OpenClaw, including macOS, Linux, and Windows. As long as you have the OpenClaw runtime installed, Todo will work seamlessly across operating systems.
How do I update Todo?
Run openclaw skills update todo to get the latest version. OpenClaw will download and apply the update automatically, preserving your existing configuration.
Can I use Todo with other skills?
Yes. OpenClaw skills are composable — you can combine Todo with any other installed skill in your workflows. This allows you to build powerful multi-step automations by chaining skills together.