🏗️ OpenClaw Architect
The definitive skill for understanding, configuring, debugging, and optimizing OpenClaw deployments. Built from real production experience.
Features
- Analyze configurations — audit openclaw.json and suggest improvements
- Health check systems — validate all OpenClaw subsystems in one command
- Configure model routing — set up primary models, fallback chains, cost tiers
- Build skills — SKILL.md format, CLI design, publishing to ClawHub
- Debug gateway issues — troubleshoot errors, cron failures, session crashes
- Optimize performance — model selection, cost reduction, context management
- Manage cron jobs — scheduling, error handling, retry patterns
- Configure memory systems — Qdrant, Neo4j, SQLite integration
- Deploy infrastructure — Docker, Tailscale VPN, networking
- Post-update verification — checklist for safe OpenClaw upgrades
Requirements
| Variable | Required | Description |
|---|---|---|
OPENCLAW_WORKSPACE | ✅ | Path to OpenClaw workspace directory |
Quick Start
PY=~/.openclaw/workspace/.venv/bin/python3
# Analyze your openclaw.json configuration
$PY skills/openclaw-architect/scripts/config_analyzer.py
# Health check all OpenClaw systems
$PY skills/openclaw-architect/scripts/health_check.py
Commands
Config Analyzer
# Audit current configuration
$PY skills/openclaw-architect/scripts/config_analyzer.py
# Analyze a specific config file
$PY skills/openclaw-architect/scripts/config_analyzer.py --config /path/to/openclaw.json
Health Check
# Check all subsystems
$PY skills/openclaw-architect/scripts/health_check.py
# Check specific subsystem
$PY skills/openclaw-architect/scripts/health_check.py --check gateway
$PY skills/openclaw-architect/scripts/health_check.py --check cron
$PY skills/openclaw-architect/scripts/health_check.py --check memory
References
| File | Description |
|---|---|
references/architecture-overview.md | How OpenClaw works end-to-end |
references/config-reference.md | All openclaw.json options documented |
references/skills-guide.md | Building and publishing skills |
references/cron-guide.md | Cron job scheduling and patterns |
references/memory-guide.md | Memory system configuration |
references/troubleshooting.md | Common fixes and debugging |
references/optimization-tips.md | Performance tuning guide |
Architecture Principles
- Brain-First — Strategic content → Mem0/Qdrant/Neo4j/SQLite. Markdown = operational logs only.
- Fault-Tolerant — Always configure 2+ fallback models. Test each one works.
- Credit-Aware — Monitor usage, auto-switch tiers, alert before exhaustion.
- Skills = Publishing — Every reusable pattern becomes a ClawHub skill.
- Self-Monitoring — System watches its own health, uptime, costs via cron.
- Automate Repetition — If it happens twice → cron job or script.
Script Reference
| Script | Description |
|---|---|
{baseDir}/scripts/config_analyzer.py | Audits openclaw.json configuration |
{baseDir}/scripts/health_check.py | Validates all OpenClaw subsystems |
Output Format
All commands output structured text with clear pass/fail indicators and actionable recommendations.
Data Policy
This skill reads local configuration files only. No data is sent to external services.
Built by M. Abidi
LinkedIn · YouTube · GitHub · Book a Call