Task Manager - OpenClaw Integration

A fully-featured Todoist clone with unlimited reminders and AI-powered scheduling, designed to work seamlessly with OpenClaw as a local tool via tool calls.

Features

• ✅ Unlimited reminders (no 5 reminder limit like Todoist)
• ✅ AI-powered scheduling based on your routine
• ✅ Holiday and comp-off awareness
• ✅ Recurring tasks (daily, weekly, monthly, weekdays)
• ✅ Priority levels (LOW, MEDIUM, HIGH, URGENT)
• ✅ Projects and labels
• ✅ Batch operations
• ✅ JSON persistence
• ✅ Flask REST API
• ✅ Stdio mode for OpenClaw tool calls

How It Works

OpenClaw agent communicates with the Task Manager through tool calls. The agent executes the task manager as a local tool and exchanges JSON-RPC 2.0 messages via stdin/stdout.

┌─────────────────────────────────────────────────────────────────┐
│  OpenClaw Agent                                                 │
│                                                                 │
│  ┌─────────────┐                                                │
│  │  Tool Call  │ ──────► Executes: python3 main.py stdio        │
│  │  Request    │                                                │
│  └─────────────┘                                                │ 
│        │                                                        │
│        ▼                                                        │
│  ┌─────────────┐                                                │
│  │   stdin     │ ──────► JSON-RPC request                       │
│  └─────────────┘                                                │
│                                                                 │
│  ┌─────────────┐                                                │
│  │  stdout     │ ◄────── JSON-RPC response                      │
│  └─────────────┘                                                │
│        │                                                        │
│        ▼                                                        │
│  ┌─────────────┐                                                │
│  │ Tool Result │ ◄────── Task Manager processes request         │
│  └─────────────┘                                                │
└─────────────────────────────────────────────────────────────────┘

Quick Start

Stdio Mode (How OpenClaw calls the Task Manager)

OpenClaw executes the task manager and communicates via stdin/stdout:

python3 main.py stdio

The tool expects JSON-RPC 2.0 formatted requests on stdin and outputs responses on stdout.

Example Tool Call Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_task",
    "arguments": {
      "title": "Review Q1 report",
      "project": "Work",
      "priority": "HIGH",
      "due_date": "2026-03-15"
    }
  }
}

Example Tool Call Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "✅ Task created: Review Q1 report (ID: abc123...)"
}

Tool Discovery

OpenClaw can discover available tools:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

Response:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "tools": [
      {
        "name": "create_task",
        "description": "Create a new task with optional due date, priority, and project",
        "parameters": { ... }
      },
      ...
    ]
  }
}

API Mode (Alternative)

Start the Flask API server:

python3 main.py serve 5000

Then OpenClaw can make HTTP requests to http://localhost:5000.

API Endpoints

Method	Endpoint	Description
GET	/api/tools	List all available tools
GET	/api/tasks	List tasks with filters
POST	/api/tasks	Create a task
POST	/api/tasks/batch	Batch create tasks
POST	/api/tasks/<id>/complete	Complete a task
POST	/api/tasks/<id>/reminder	Set a reminder
GET	/api/schedule	Get today's schedule
GET	/api/schedule/suggestions	Get AI schedule suggestions
POST	/api/routine	Update routine settings
POST	/api/holidays	Add a holiday
POST	/api/comp-off	Add a comp-off day
GET	/api/projects	List all projects

Documentation

For comprehensive documentation including architecture details, the development journey, and lessons learned, see docs/notes.md.

Logging

All logs are stored in ~/.openclaw/workspace/logs/:

~/.openclaw/workspace/logs/
├── main.log          # Main application logs
├── task_manager.log  # Task management logs
├── scheduler.log     # AI scheduling logs
├── reminder.log      # Reminder system logs
└── tools.log         # OpenClaw tool logs

These logs contain the complete OpenClaw agent interaction history and are useful for debugging.

Installation

1. Clone the repository:

   git clone https://github.com/sanchit339/TaskAgent.git

2. Navigate to the project directory:

   cd TaskAgent

3. Install dependencies:

   pip install -r requirements.txt

4. Run tests:

   python -m pytest -v

License

This project is licensed under the MIT License. See the LICENSE file for details.