OpenClaw Long-Running Agent Skill

This skill enables AI agents to work on long-running projects across multiple sessions.

Purpose

The longrunning-agent skill provides a structured workflow for:

• Tracking progress across sessions
• Managing task lists with priorities and dependencies
• Making incremental, atomic progress on complex projects
• Ensuring continuity when resuming work

Installation

• Copy this skill directory to your OpenClaw skills folder
• Ensure Claude Code CLI is installed and configured
• Create a project directory with the workflow files

Usage

Initialize a New Project

# Create project directory
mkdir my-project && cd my-project

# Initialize workflow files
claude -p "Initialize this project using the longrunning-agent workflow"

Workflow Files

The skill expects these files in the project directory:

• CLAUDE.md - Project instructions and workflow guide
• task.json - Task list with priorities and dependencies
• progress.txt - Log of work completed
• init.sh - Environment setup script (optional)

Task Format

{
  "tasks": [
    {
      "id": "task-1",
      "description": "Set up project structure",
      "priority": 1,
      "dependencies": [],
      "passes": false
    },
    {
      "id": "task-2",
      "description": "Implement core features",
      "priority": 2,
      "dependencies": ["task-1"],
      "passes": false
    }
  ]
}

Progress Format

[2024-01-15 10:30:00] Started session
[2024-01-15 10:35:00] Completed task: Set up project structure
[2024-01-15 10:40:00] Milestone: Core features implemented

Workflow Steps

• Read Progress - Check progress.txt for recent work
• Select Task - Find next passes: false task with met dependencies
• Initialize - Run init.sh if needed
• Implement - Work on one task incrementally
• Test - Run lint, build, and tests
• Document - Update progress.txt
• Mark Complete - Set passes: true in task.json
• Commit - Make atomic git commit

Best Practices

• Work on ONE task per session
• Make commits after each task completion
• Keep progress.txt concise but informative
• Use dependencies to manage task order
• Test thoroughly before marking passes: true

Integration with Web UI

This skill integrates with the Agent Workflow Web App:

• Tasks sync with the web database
• Progress entries are captured
• Session output is logged
• Git commits are tracked

Templates

Templates for workflow files are in the templates/ directory:

• CLAUDE.md.tpl - Project template
• task.json.tpl - Task list template