compound-engineering-openclaw-maintenance

Maintenance baseline for running the Every Compound Engineering plugin on OpenClaw.

This repo tracks the maintenance layer only, not the plugin source itself.

What this repo contains

• install and update script for Compound Engineering on OpenClaw
• health check script
• skill audit script
• local integration smoke test
• maintenance docs and troubleshooting notes
• version and update baseline files

Repo layout

.maintenance/
docs/
scripts/
tests/
README.md

Quick start

From the repo root:

bash scripts/update-compound-engineering-openclaw.sh
bash scripts/health-check.sh
bash scripts/audit-skills.sh
bash tests/skill-integration-test.sh

What each script does

scripts/update-compound-engineering-openclaw.sh

• installs or updates the OpenClaw extension via the official compound-plugin CLI
• ensures compound-engineering is in plugins.allow
• ensures plugins.entries.compound-engineering.enabled = true
• restarts the OpenClaw gateway

scripts/health-check.sh

• checks openclaw and bun
• verifies extension files exist
• verifies allowlist and enabled state in ~/.openclaw/openclaw.json
• runs a simple openclaw status smoke test
• writes a JSON report to .maintenance/reports/latest-health-check.json

scripts/audit-skills.sh

• checks a core set of required skills exists
• compares manifest skill entries against actual folders on disk
• writes a JSON report to .maintenance/reports/latest-skill-audit.json

tests/skill-integration-test.sh

• runs health check and skill audit first
• verifies key skill files exist
• runs another openclaw status smoke test
• writes a JSON report to .maintenance/reports/latest-skill-integration-test.json

Docs

• setup and usage: docs/compound-engineering-openclaw.md
• troubleshooting: docs/compound-engineering-openclaw-troubleshooting.md

Notes

• generated health and audit reports are ignored via .gitignore
• scripts now resolve the repo root dynamically, so the repo can live outside ~/.openclaw/workspace
• GitHub Actions only does a lightweight shell smoke check, because the full runtime checks require a real local OpenClaw installation, Bun, and an installed compound-engineering extension

CI

This repo includes a GitHub Actions workflow at .github/workflows/shell-smoke.yml that:

• verifies the expected repo files exist
• runs bash -n against shell scripts in scripts/ and tests/
• checks executable bits on the main scripts