openclaw-architect

# 🏗️ 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

```bash
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
```bash
# 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
```bash
# 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

1. **Brain-First** — Strategic content → Mem0/Qdrant/Neo4j/SQLite. Markdown = operational logs only.
2. **Fault-Tolerant** — Always configure 2+ fallback models. Test each one works.
3. **Credit-Aware** — Monitor usage, auto-switch tiers, alert before exhaustion.
4. **Skills = Publishing** — Every reusable pattern becomes a ClawHub skill.
5. **Self-Monitoring** — System watches its own health, uptime, costs via cron.
6. **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](https://www.agxntsix.ai)

[LinkedIn](https://www.linkedin.com/in/mohammad-ali-abidi) · [YouTube](https://youtube.com/@aiwithabidi) · [GitHub](https://github.com/aiwithabidi) · [Book a Call](https://cal.com/agxntsix/abidi-openclaw)