Skip to content

README.md

Latest commit

 

History

History
190 lines (151 loc) · 5.87 KB

README.md

File metadata and controls

190 lines (151 loc) · 5.87 KB

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.
⚡