openclaw-pm  by 1va7

AI Agent project management enhancement tool

Created 2 months ago
383 stars

Top 74.5% on SourcePulse

GitHubView on GitHub
Project Summary

Summary This project provides configuration upgrade tools for OpenClaw, enhancing AI agents to function as sophisticated project managers. It addresses the limitations of stateless LLMs in real-world scenarios by introducing robust task management, session isolation, and automatic recovery capabilities, benefiting users who require more autonomous and reliable AI agents.

How It Works Version 2 builds upon V1's "memory externalization" (Heartbeat, Memory Flush Protocol, Agential Thinking) by focusing on "self-monitoring." Core V2 features include complex task management via plan files and checkpoints, strict session isolation rules to prevent context confusion, and mandatory recovery/reporting protocols for Gateway restarts. It introduces active "interviewing" for requirement clarification, optimizes execution through parallel processing, and integrates a comprehensive suite of external health check scripts for monitoring and automated recovery.

Quick Start & Requirements

  • Primary Install/Run: Execute npx @1va7/openclaw-pm to configure V2. The tool automatically saves configurations in an OpenClaw workspace or outputs content for manual copying.
  • Prerequisites: Requires an existing OpenClaw workspace. Health check scripts need to be copied to ~/.openclaw/workspace/scripts/ and made executable. Dependencies include the OpenClaw environment, Gateway processes, Feishu WebSocket connections, and message queues.
  • Verification: Run ~/.openclaw/workspace/scripts/quick-diagnose.sh.
  • Links: GitHub repository: https://github.com/1va7/openclaw-pm.

Highlighted Details

  • Complex Task Management: Utilizes plan files (temp/task-name-plan.md) and checkpoints for reliable state tracking across multiple sessions.
  • Session Isolation: Enforces rules to prevent context leakage between different agent sessions.
  • Mandatory Recovery: Gateway restarts trigger immediate status reporting and checks for recovery files (temp/recovery-*.json) and task states.
  • Active Interviewing: Agents proactively clarify ambiguous requirements using structured, multiple-choice questions.
  • Parallel Execution: Optimizes independent tasks and tool calls for significant time savings.
  • Checkpoint Mechanism: Leverages git commit on plan files and checkpoints for complete task state recovery from history.
  • Health Check System: A suite of scripts (scripts/gateway-health-check.sh, scripts/check-unanswered.sh, etc.) provides external monitoring, automated recovery, and diagnostic capabilities.

Maintenance & Community The project originates from "VA7," sharing tuning experience for OpenClaw. No specific community channels (e.g., Discord, Slack) or roadmap links were provided in the README.

Licensing & Compatibility The license type is not specified in the provided README content. Compatibility is primarily with OpenClaw environments.

Limitations & Caveats The tool is designed to address the inherent statelessness and potential instability of LLM agents in production environments. A key limitation is the absence of explicit licensing information, which is crucial for adoption decisions. The project's effectiveness is also tied to the underlying OpenClaw ecosystem.

Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
2
Star History
101 stars in the last 30 days

Explore Similar Projects

Starred by Gagan Bansal Gagan Bansal(Coauthor of AutoGen; Research Scientist at Microsoft Research), Elvis Saravia Elvis Saravia(Founder of DAIR.AI), and
1 more.

agent-framework by microsoft

6.8%
9k
AI agent and multi-agent workflow framework
Created 11 months ago
Updated 1 day ago
Feedback? Help us improve.