OpenClaw Setup

How to use planning-with-files with OpenClaw.

What This Integration Adds

• Workspace skill: skills/planning-with-files/ in your project root
• Full templates, scripts, and reference documentation
• Cross-platform support (macOS, Linux, Windows)

OpenClaw supports three skill locations (in precedence order):

1. Workspace skills (highest priority): <workspace>/skills/
2. Managed/local skills: ~/.openclaw/skills/
3. Bundled skills (lowest priority): shipped with install

Installation (via ClawHub — recommended)

Install directly from the ClawHub marketplace:

claw install othmanadi/planning-with-files

Or download the zip from clawhub.ai/othmanadi/planning-with-files and extract to your workspace skills/ folder.

Installation (Workspace, manual)

Copy from the GitHub repo to your project:

# Clone the repo
git clone https://github.com/OthmanAdi/planning-with-files.git

# Copy the skill files to your workspace
mkdir -p skills/planning-with-files
cp -r planning-with-files/clawhub-upload/* skills/planning-with-files/

# Clean up
rm -rf planning-with-files

Installation (Global)

Install to your local OpenClaw skills directory:

# Clone the repo
git clone https://github.com/OthmanAdi/planning-with-files.git

# Copy to global OpenClaw skills
mkdir -p ~/.openclaw/skills/planning-with-files
cp -r planning-with-files/clawhub-upload/* ~/.openclaw/skills/planning-with-files/

# Clean up
rm -rf planning-with-files

Verify Installation

# Check OpenClaw status and loaded skills
openclaw status

Usage

1. Start an OpenClaw session in your project directory
2. For complex tasks, the skill will guide you to create:
   • task_plan.md — Phase tracking and decisions
   • findings.md — Research and discoveries
   • progress.md — Session log and test results
3. Follow the workflow: plan first, update after each phase

Helper Scripts

From your project root:

# Initialize all planning files
bash skills/planning-with-files/scripts/init-session.sh

# Or on Windows PowerShell
powershell -ExecutionPolicy Bypass -File skills/planning-with-files/scripts/init-session.ps1

# Verify all phases are complete
bash skills/planning-with-files/scripts/check-complete.sh

Configuration (Optional)

Configure the skill in ~/.openclaw/openclaw.json:

{
  skills: {
    entries: {
      "planning-with-files": {
        enabled: true
      }
    }
  }
}

Notes

• OpenClaw snapshots eligible skills when a session starts
• Workspace skills take precedence over bundled skills
• The skill works on all platforms: macOS, Linux, and Windows
• Planning files are tool-agnostic and work across Claude Code, Cursor, and other IDEs