architecture
FreeReferences Serverless OpenClaw architecture. Covers network design, CDK stack structure, DynamoDB data model, API protocols, and container design.
The English summary is being prepared. Showing the original description.
Shows project progress, phase completion status, test coverage, and deployment info. Use when checking what has been implemented, what remains, or current operational state.
The English summary is being prepared. Showing the original description.
Run score Not tested
See how to installReview the instructions the agent will receive before you install.
Full progress details: docs/progress.md
git log --oneline -10
| Phase | Description | Status |
|---|---|---|
| Phase 0 | Docs + project setup | Complete |
| Phase 1 (10/10) | MVP — Fargate + Gateway + Web + Telegram | Complete |
| Phase 2 | Lambda agent migration | Complete |
1-1 Project init, 1-2 NetworkStack + StorageStack, 1-3 Container, 1-4 Gateway Lambda, 1-5 API Gateway, 1-6 Cognito, 1-7 Compute, 1-8 Web UI, 1-9 Telegram, 1-10 Integration tests/documentation
runEmbeddedPiAgent())AGENT_RUNTIME feature flag: fargate | lambda | bothAll GitHub issues #2–#9 closed: P1-P5 cold start, #7 zstd, #8 CPU configurable, #9 OpenClaw version pin
AGENT_RUNTIME=both # Fargate (long sessions) + Lambda (quick queries)
| Suite | Count |
|---|---|
| Unit tests | 233 |
| E2E tests (CDK synth) | 35 |
| Total | 268 |
Run tests:
npm run test # Unit tests
npm run test:e2e # E2E (CDK synth)
See docs/deployment.md for full deployment guide.
| Resource | Value |
|---|---|
| AWS Region | ap-northeast-2 |
| HTTP API | https://2msk3i79v6.execute-api.ap-northeast-2.amazonaws.com |
| WebSocket | wss://wkw2xo5011.execute-api.ap-northeast-2.amazonaws.com/prod |
| CloudFront | https://dpw7grkq1m9vw.cloudfront.net |
| Cognito User Pool | ap-northeast-2_r6wLZ95dd |
| ECR | 779411790546.dkr.ecr.ap-northeast-2.amazonaws.com/serverless-openclaw |
SecretsStack → NetworkStack → StorageStack → {AuthStack, ComputeStack} → ApiStack → WebStack + MonitoringStack + LambdaAgentStack
make task-status # ECS Fargate task status
make task-logs # Tail container logs
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
References Serverless OpenClaw architecture. Covers network design, CDK stack structure, DynamoDB data model, API protocols, and container design.
The English summary is being prepared. Showing the original description.
References cold start optimization history and techniques. Covers Docker image optimization, Fargate CPU tuning, SOCI lazy loading, and Lambda Bedrock discovery fix. Use when optimizing startup performance.
The English summary is being prepared. Showing the original description.
Loads Serverless OpenClaw project context. Provides background knowledge needed for development including project overview, tech stack, architecture decisions, and data models.
The English summary is being prepared. Showing the original description.
References Serverless OpenClaw cost optimization guidelines. Validates that no resources exceeding the cost target ($1/month) are created during implementation. Use when writing CDK stacks or making infrastructure changes.
The English summary is being prepared. Showing the original description.
Deploys Serverless OpenClaw CDK stacks to AWS. Handles SecretsStack parameter injection, full/individual stack deployment, and Docker image push.
The English summary is being prepared. Showing the original description.
Development workflow guide. Covers build, test, lint, format commands, package structure, Git hooks, TDD methodology, and coding conventions. Use when setting up dev environment, running tests, or following project conventions.
The English summary is being prepared. Showing the original description.