openclaw-architect
Design, configure, debug, and optimize OpenClaw AI agent deployments. Master guide for gateway configuration, openclaw.json settings, model routing and fallback chains, skills development and publishing, cron job scheduling, memory systems (Qdrant, Neo4j, SQLite), Docker infrastructure, and Tailscale VPN networking. Includes config analyzer that audits your openclaw.json and suggests improvements, plus health checker that validates all OpenClaw subsystems. Built for AI agents — Python stdlib only, no dependencies. Use for OpenClaw setup, gateway debugging, skill building, cron management, model optimization, cost reduction, and infrastructure troubleshooting.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/aiwithabidi/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
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.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-aiwithabidi-openclaw-architect": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
agent-memory
Full AI agent memory stack — Mem0 unified memory engine with vector search (Qdrant) and knowledge graph (Neo4j), plus SQLite for structured data. Complete setup script and tools. Give your OpenClaw agent a real brain with semantic recall, entity relationships, and structured storage.
skill-auditor
Security audit and quarantine system for third-party OpenClaw skills. Use when evaluating, reviewing, or installing any skill from ClawHub or external sources. Automatically triggered before any skill installation.
Model Intel
Live LLM model intelligence and pricing from OpenRouter
deep-search
Multi-tier Perplexity search with Langfuse tracing. Three depth levels: quick (sonar), pro (sonar-pro), deep (sonar-reasoning-pro). Supports focus modes: internet, academic, news, youtube, reddit. Returns AI-synthesized answers with citations. Use for research, comparisons, market analysis, fact-checking. Triggers: search, research, look up, find out, compare, what is, deep search, web research.
amplitude
Amplitude product analytics — track events, analyze user behavior, run cohort analysis, manage user properties, and query funnel/retention data via the Amplitude API. Understand product usage, measure feature adoption, and analyze user journeys. Built for AI agents — Python stdlib only, zero dependencies. Use for product analytics, user behavior tracking, funnel analysis, retention analysis, and cohort segmentation.