🏗️ 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 |
|---|
| INLINECODE0 | ✅ | Path to OpenClaw workspace directory |
Quick Start
CODEBLOCK0
Commands
Config Analyzer
CODEBLOCK1
Health Check
CODEBLOCK2
References
| File | Description |
|---|
| INLINECODE1 | How OpenClaw works end-to-end |
| INLINECODE2 |
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.
- 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 |
|---|
| INLINECODE8 | Audits openclaw.json configuration |
| INLINECODE9 |
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
🏗️ OpenClaw Architect
用于理解、配置、调试和优化OpenClaw部署的权威技能。基于真实生产经验构建。
功能特性
- - 分析配置 — 审计openclaw.json并提出改进建议
- 健康检查系统 — 一条命令验证所有OpenClaw子系统
- 配置模型路由 — 设置主模型、备用链、成本层级
- 构建技能 — SKILL.md格式、CLI设计、发布到ClawHub
- 调试网关问题 — 排查错误、cron故障、会话崩溃
- 优化性能 — 模型选择、成本降低、上下文管理
- 管理定时任务 — 调度、错误处理、重试模式
- 配置记忆系统 — Qdrant、Neo4j、SQLite集成
- 部署基础设施 — Docker、Tailscale VPN、网络配置
- 更新后验证 — 安全升级OpenClaw的检查清单
环境要求
| 变量 | 必需 | 描述 |
|---|
| OPENCLAW_WORKSPACE | ✅ | OpenClaw工作区目录路径 |
快速开始
bash
PY=~/.openclaw/workspace/.venv/bin/python3
分析你的openclaw.json配置
$PY skills/openclaw-architect/scripts/config_analyzer.py
健康检查所有OpenClaw系统
$PY skills/openclaw-architect/scripts/health_check.py
命令
配置分析器
bash
审计当前配置
$PY skills/openclaw-architect/scripts/config_analyzer.py
分析特定配置文件
$PY skills/openclaw-architect/scripts/config_analyzer.py --config /path/to/openclaw.json
健康检查
bash
检查所有子系统
$PY skills/openclaw-architect/scripts/health_check.py
检查特定子系统
$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/architecture-overview.md | OpenClaw端到端工作原理 |
| references/config-reference.md |
所有openclaw.json选项文档 |
| references/skills-guide.md | 构建和发布技能 |
| references/cron-guide.md | Cron任务调度和模式 |
| references/memory-guide.md | 记忆系统配置 |
| references/troubleshooting.md | 常见修复和调试 |
| references/optimization-tips.md | 性能调优指南 |
架构原则
- 1. 大脑优先 — 战略内容 → Mem0/Qdrant/Neo4j/SQLite。Markdown仅用于操作日志。
- 容错设计 — 始终配置2个以上备用模型。测试每个模型是否正常工作。
- 成本感知 — 监控使用量，自动切换层级，在耗尽前发出警报。
- 技能即发布 — 每个可复用模式都成为ClawHub技能。
- 自我监控 — 系统通过cron监控自身健康、运行时间和成本。
- 重复自动化 — 如果发生两次 → 创建cron任务或脚本。
脚本参考
| 脚本 | 描述 |
|---|
| {baseDir}/scripts/configanalyzer.py | 审计openclaw.json配置 |
| {baseDir}/scripts/healthcheck.py |
验证所有OpenClaw子系统 |
输出格式
所有命令输出结构化文本，包含清晰的通过/失败指示和可操作建议。
数据策略
此技能仅读取本地配置文件。不会向外部服务发送任何数据。
由
M. Abidi 构建
LinkedIn · YouTube · GitHub · 预约通话
