OpenClaw Setup

How to use planning-with-files with OpenClaw.

What This Integration Adds

Workspace skill: .openclaw/skills/planning-with-files/
Full templates, scripts, and reference documentation
Cross-platform support (macOS, Linux, Windows)

OpenClaw supports three skill locations (in precedence order):

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

Installation (Workspace, recommended)

Copy the skill to your project:

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

# Copy the OpenClaw skill to your workspace
cp -r planning-with-files/.openclaw/skills/planning-with-files skills/

# 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
cp -r planning-with-files/.openclaw/skills/planning-with-files ~/.openclaw/skills/

# Clean up
rm -rf planning-with-files

Verify Installation

# Check OpenClaw status and loaded skills
openclaw status

Usage

Start an OpenClaw session in your project directory
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
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

2.4 KiB Raw Permalink Blame History