openclaw-spacesuit
A framework scaffold for OpenClaw workspaces.
Metadata
| Field |
Value |
| Name |
spacesuit |
| Version |
0.3.0 |
| Author |
jontsai |
| License |
MIT |
| Category |
framework |
| Tags |
workspace, scaffold, conventions, memory, git-workflow |
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:
- Framework content is wrapped in
<!-- SPACESUIT:BEGIN --> / <!-- SPACESUIT:END --> markers
- On upgrade, only the content between markers is replaced
- Everything outside the markers (your customizations) is preserved
Files Managed
| File |
Base Content |
User Content |
AGENTS.md |
Session protocol, memory, git, safety, priorities |
Channel mappings, tool configs, personal rules |
SOUL.md |
Core personality scaffold |
Personal vibe, human-specific tone |
TOOLS.md |
Tool organization guidance |
Actual tool configs, credentials refs, API details |
HEARTBEAT.md |
Check framework & state tracking |
Specific checks to run |
IDENTITY.md |
— (template only) |
Name, avatar, personality |
USER.md |
— (template only) |
All about your human |
MEMORY.md |
Long-term memory structure |
Project notes, personal context |
SECURITY.md |
Full security baseline |
Contact-specific alert channels |
Makefile |
— (template only) |
Gateway management targets |
Upgrade Path
# See what would change
./scripts/diff.sh
# Apply upgrade
./scripts/upgrade.sh
# Check version
cat skills/spacesuit/VERSION
1---2name: spacesuit3description: openclaw-spacesuit4---5# openclaw-spacesuit67**A framework scaffold for OpenClaw workspaces.**89## Metadata1011| Field | Value |12|-------|-------|13| **Name** | `spacesuit` |14| **Version** | `0.3.0` |15| **Author** | jontsai |16| **License** | MIT |17| **Category** | framework |18| **Tags** | workspace, scaffold, conventions, memory, git-workflow |1920## Description2122The Spacesuit is a batteries-included framework layer for OpenClaw workspaces. It provides:2324- **Session startup protocol** — security-first file loading order25- **Memory system** — daily logs + curated long-term memory with commit discipline26- **Git workflow** — mandatory pre-commit checks, worktree conventions, parallel agent coordination27- **Safety rules** — pre-action checklist, destructive-action guards, stand-down protocol28- **Priority system** — P0–P5 triage for tasks and incidents29- **Cross-platform handoffs** — structured context transfer between Slack/Discord/Telegram30- **Heartbeat framework** — proactive periodic checks with state tracking31- **Decision logging** — mandatory audit trail for architectural decisions32- **Meta-learning framework** — expert-first research methodology (Dunning-Kruger aware)33- **Security baseline** — secret transmission policy, prompt injection defense, data classification3435## Installation3637```bash38# First-time install (creates workspace files with markers)39make init4041# Upgrade existing workspace (replaces only SPACESUIT sections)42make upgrade43```4445## How It Works4647OpenClaw 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**:48491. Framework content is wrapped in `<!-- SPACESUIT:BEGIN -->` / `<!-- SPACESUIT:END -->` markers502. On upgrade, only the content between markers is replaced513. Everything outside the markers (your customizations) is preserved5253## Files Managed5455| File | Base Content | User Content |56|------|-------------|--------------|57| `AGENTS.md` | Session protocol, memory, git, safety, priorities | Channel mappings, tool configs, personal rules |58| `SOUL.md` | Core personality scaffold | Personal vibe, human-specific tone |59| `TOOLS.md` | Tool organization guidance | Actual tool configs, credentials refs, API details |60| `HEARTBEAT.md` | Check framework & state tracking | Specific checks to run |61| `IDENTITY.md` | — (template only) | Name, avatar, personality |62| `USER.md` | — (template only) | All about your human |63| `MEMORY.md` | Long-term memory structure | Project notes, personal context |64| `SECURITY.md` | Full security baseline | Contact-specific alert channels |65| `Makefile` | — (template only) | Gateway management targets |6667## Upgrade Path6869```bash70# See what would change71./scripts/diff.sh7273# Apply upgrade74./scripts/upgrade.sh7576# Check version77cat skills/spacesuit/VERSION78```
kernel8901