clawpm

What This Skill Does

ClawPM is a sophisticated, JSON-first task and project management engine designed specifically for the OpenClaw AI agent ecosystem. Unlike traditional project management tools that rely on bloated web interfaces, ClawPM integrates directly into your local filesystem, treating your project folders as first-class citizens. By managing state through a local ~/clawpm/ directory, it provides high-performance, programmable task tracking that excels at handling multi-project workflows, subtask hierarchies, and automated task lifecycle management. It is designed to be the "brain" of your agent's project workspace, ensuring that task status and research logs remain persistent and queryable.

Installation

To integrate ClawPM into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/malphas-gh/clawpm

Once installed, initialize your workspace by running clawpm setup. This prepares your local directory structure, including your portfolio configuration and work logs. You can verify the installation status at any time by running clawpm setup --check.

Use Cases

ClawPM is ideal for developers and researchers who operate across multiple repositories. It shines in scenarios requiring rapid context switching between projects, such as managing a personal portfolio of coding projects, tracking research progress, or handling sub-projects within a larger development effort. Because it auto-initializes git repositories, it is particularly effective for those who already have existing codebases and want to add task management capabilities without modifying the project's source code.

Example Prompts

1. "Check the current project status and tell me if I have any blocked tasks in the active context."
2. "I'm starting a new documentation project in this directory; initialize it and add a task titled 'Draft architecture overview' with a subtask for 'Database schema'."
3. "List all my projects and help me switch context to the 'data-processor' project so I can mark task 104 as done."

Tips & Limitations

To maximize efficiency, utilize the clawpm use command to set a persistent project context; this avoids needing to pass the project name with every command. Remember that ClawPM assumes local files are the source of truth, so ensure your work directories are accessible. Be aware that the done command prevents closing a parent task if incomplete subtasks remain; use the --force flag only when you are certain that subtask completion is not required for the parent's status. For automation, always lean on the default JSON output to allow downstream scripts or AI agents to parse data programmatically.