architecture
Central documentation and principle guide for the Serverless OpenClaw architecture.
Install
mkdir -p .claude/skills/architecture-serithemage && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/18663" && unzip -o skill.zip -d .claude/skills/architecture-serithemage && rm skill.zipInstalls to .claude/skills/architecture-serithemage
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
References Serverless OpenClaw architecture. Covers network design, CDK stack structure, DynamoDB data model, API protocols, and container design.Key capabilities
- →Reference VPC/network design documents
- →Access CDK stack structure details
- →Review DynamoDB schema information
- →Understand API protocols
- →Consult security model documentation
How it works
The skill provides access to architectural design documents for the Serverless OpenClaw system. It retrieves information on network design, CDK stacks, DynamoDB models, and API protocols.
Inputs & outputs
When to use architecture
- →Reviewing serverless architecture
- →Checking CDK stack structure
- →Understanding DynamoDB schemas
About this skill
Architecture Reference
Design Documents
- architecture.md — VPC/network, security groups, CDK stacks, DynamoDB schema, API protocols, security model
- implementation-plan.md — Detailed design based on MoltWorker reference
- cold-start-optimization.md — Cold start optimization (Phase 1 complete, Phase 2 in progress)
Core Architecture Principles
- Cost minimization: No NAT Gateway, no ALB, no Interface Endpoints
- Serverless-first: Lambda (events), Fargate Spot (long-running), DynamoDB (PAY_PER_REQUEST)
- Single responsibility: 7 separate Lambdas, 9 separate CDK stacks
- Layer separation: API Gateway → Lambda → Bridge → OpenClaw Gateway
- Protocol translation: Lambda(HTTP) ↔ Bridge ↔ OpenClaw Gateway(JSON-RPC 2.0 WebSocket)
AGENT_RUNTIME Feature Flag
Controls which agent backend handles requests:
| Value | Behavior |
|---|---|
fargate | Route all agent requests to Fargate container (Phase 1 mode) |
lambda | Route all agent requests to Lambda agent (Phase 2 mode) |
both | Smart routing via classifyRoute(): reuse running Fargate, honor /heavy//fargate hints, default to Lambda, fallback to Fargate on Lambda failure |
See architecture.md §12 for full Lambda architecture details and smart routing rules.
Lambda Data Flow (Phase 2)
Client → API Gateway (WS/REST) → Gateway Lambda → Lambda Agent Function
→ runEmbeddedPiAgent()
→ OpenClaw in-process
CDK Stacks (9 total)
SecretsStack + NetworkStack → StorageStack → {AuthStack, ComputeStack} → ApiStack → WebStack + MonitoringStack + LambdaAgentStack
When not to use it
- →When the user needs to implement changes directly
Limitations
- →Provides reference information only, does not perform actions on the architecture
- →Limited to the documented Serverless OpenClaw architecture
- →Does not provide real-time status or operational data
How it compares
This skill centralizes access to specific architectural documentation, unlike manually searching through various files for design details.
Compared to similar skills
architecture side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| architecture (this skill) | 0 | 4mo | No flags | Beginner |
| database-admin | 1 | 3mo | No flags | Advanced |
| hybrid-cloud-architect | 2 | 3mo | No flags | Advanced |
| step-functions | 1 | 6mo | Review | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by serithemage
View all by serithemage →You might also like
database-admin
sickn33
Expert database administrator specializing in modern cloud databases, automation, and reliability engineering. Masters AWS/Azure/GCP database services, Infrastructure as Code, high availability, disaster recovery, performance optimization, and compliance. Handles multi-cloud strategies, container databases, and cost optimization. Use PROACTIVELY for database architecture, operations, or reliability engineering.
hybrid-cloud-architect
sickn33
Expert hybrid cloud architect specializing in complex multi-cloud solutions across AWS/Azure/GCP and private clouds (OpenStack/VMware). Masters hybrid connectivity, workload placement optimization, edge computing, and cross-cloud automation. Handles compliance, cost optimization, disaster recovery, and migration strategies. Use PROACTIVELY for hybrid architecture, multi-cloud strategy, or complex infrastructure integration.
step-functions
itsmostafa
AWS Step Functions workflow orchestration with state machines. Use when designing workflows, implementing error handling, configuring parallel execution, integrating with AWS services, or debugging executions.
cloud-architect
Harmitx7
Production AWS cloud architecture mastery. Service selection (ECS Fargate vs Lambda vs EC2, RDS vs Aurora vs DynamoDB), Terraform IaC patterns with HCL examples, VPC networking design, IAM least privilege, Secrets Manager, CloudWatch observability, cost optimization, and multi-environment AWS Organi
alibaba-network-architect
Raishin
Design Alibaba Cloud network topology — VPC peering, CEN for multi-VPC/multi-region connectivity, Express Connect for private circuits, SLB/ALB/NLB/CLB load balancer selection, and Smart Access Gateway for branch offices.
multi-cloud-architecture
wshobson
Design multi-cloud architectures using a decision framework to select and integrate services across AWS, Azure, and GCP. Use when building multi-cloud systems, avoiding vendor lock-in, or leveraging best-of-breed services from multiple providers.