@dengxuan1/openclaw-taskboard

Task management plugin for OpenClaw agents. Create, delegate, track, and report on tasks with dependency management, automatic unblocking, and progress reporting.

Install

openclaw plugins install @dengxuan1/openclaw-taskboard

Or for bundled installations, add taskboard to your plugins.allow and plugins.entries in ~/.openclaw/openclaw.json.

Tools

| Tool | Description | | ----------------- | ------------------------------------------------------------------------------------- | | task_create | Create a task with title, type, priority, assignee, deadline, and parent task support | | task_list | List and filter tasks by status, assignee, priority, type, or parent | | task_update | Update status, progress, assignee; record errors; auto-block on max retries | | task_dependency | Add dependencies between tasks with cycle detection (DAG validation) | | task_report | Generate progress reports; detect overdue tasks; compare against last report |

Task Types

| Type | Label | | --------------- | ------------------------ | | content-ops | Content Ops / 自媒体运营 | | side-business | Side Business / 副业探索 | | open-source | Open Source / 开源开发 | | other | Other / 其他 |

Features

• Dependency DAG — Tasks can depend on each other. Cycles are rejected. When a dependency completes, blocked tasks are automatically unblocked.
• Auto-block on failure — Tasks that fail more than maxRetries (default: 3) are automatically marked as blocked.
• Progress tracking — 0-100% progress with auto-done when hitting 100%.
• Overdue detection — Tasks past their deadline are flagged in reports.
• Smart reporting — task_report compares against lastReportedAt to only show changes since the last report.
• File locking — Concurrent writes are serialized via process-scoped file locks.
• Crash safe — Atomic writes via temp-file + rename pattern.

Configuration

In ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "taskboard": {
        "enabled": true,
        "storePath": "~/.openclaw/taskboard"
      }
    }
  }
}

| Option | Default | Description | | ----------- | ----------------------- | ---------------------------- | | storePath | ~/.openclaw/taskboard | Directory to store task data |

Data Model

Tasks are stored as JSON in {storePath}/tasks.json:

{
  id: string;           // UUID-based (task-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
  title: string;
  description: string;
  type: TaskType;
  status: "pending" | "assigned" | "in_progress" | "review" | "done" | "blocked" | "cancelled";
  priority: "low" | "medium" | "high" | "urgent";
  assignee?: string;    // Agent ID (e.g. "claude", "qwen")
  parentTaskId?: string;
  dependencies: string[];
  deadline?: string;    // YYYY-MM-DD
  progress: number;     // 0-100
  history: Array<{ timestamp, action, by, note? }>;
  retryCount: number;
  maxRetries: number;   // Default: 3
  errorLog: string[];
}

License

MIT