openclaw-spacesuit

A framework scaffold for OpenClaw workspaces.

Metadata

Description

The Spacesuit is a batteries-included framework layer for OpenClaw workspaces. It provides:

• Session startup protocol — security-first file loading order
• Memory system — daily logs + curated long-term memory with commit discipline
• Git workflow — mandatory pre-commit checks, worktree conventions, parallel agent coordination
• Safety rules — pre-action checklist, destructive-action guards, stand-down protocol
• Priority system — P0–P5 triage for tasks and incidents
• Cross-platform handoffs — structured context transfer between Slack/Discord/Telegram
• Heartbeat framework — proactive periodic checks with state tracking
• Decision logging — mandatory audit trail for architectural decisions
• Meta-learning framework — expert-first research methodology (Dunning-Kruger aware)
• Security baseline — secret transmission policy, prompt injection defense, data classification

Installation

# First-time install (creates workspace files with markers)
make init

# Upgrade existing workspace (replaces only SPACESUIT sections)
make upgrade

How It Works

OpenClaw reads hardcoded filenames from the workspace root (AGENTS.md, SOUL.md, etc.). Since we can't change that loading behavior, Spacesuit uses section-based merging:

1. Framework content is wrapped in <!-- SPACESUIT:BEGIN --> / <!-- SPACESUIT:END --> markers
2. On upgrade, only the content between markers is replaced
3. Everything outside the markers (your customizations) is preserved

Files Managed

Upgrade Path

# See what would change
./scripts/diff.sh

# Apply upgrade
./scripts/upgrade.sh

# Check version
cat skills/spacesuit/VERSION