// Guides Phase 2 Lambda Container Migration steps. Pass a specific step number (2-1 through 2-5) to get the goals, deliverables, validation criteria, and detailed design for that step.
References Serverless OpenClaw architecture. Covers network design, CDK stack structure, DynamoDB data model, API protocols, and container design.
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.
Loads Serverless OpenClaw project context. Provides background knowledge needed for development including project overview, tech stack, architecture decisions, and data models.
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.
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.
Guides Phase 1 MVP implementation steps. Pass a specific step number as an argument to get the goals, deliverables, validation criteria, and detailed design for that step.
| name | lambda-migration |
| description | Guides Phase 2 Lambda Container Migration steps. Pass a specific step number (2-1 through 2-5) to get the goals, deliverables, validation criteria, and detailed design for that step. |
| argument-hint | [step-number, e.g. 2-1] |
| allowed-tools | Read, Write, Edit, Bash, Glob, Grep |
Step to implement: $ARGUMENTS
docs/progress.md| Step | Title | Dependencies | Key Deliverables |
|---|---|---|---|
| 2-1 | Lambda Container Image + Handler | None | Dockerfile, handler.ts, session-sync.ts |
| 2-2 | CDK LambdaAgentStack | 2-1 | lambda-agent-stack.ts, ECR, IAM |
| 2-3 | Response Streaming Integration | 2-1, 2-2 | routeMessage update, WS push, Telegram |
| 2-4 | Session Lifecycle Management | 2-1, 2-3 | S3 lifecycle, locking, compaction |
| 2-5 | Fargate Deprecation + Cost Verification | 2-1~2-4 | Feature flag, docs, cost dashboard |
// Use extensionAPI.js — avoids CLI/Gateway initialization
import { runEmbeddedPiAgent } from "openclaw/dist/extensionAPI.js";
S3: s3://{bucket}/sessions/{userId}/{sessionId}.jsonl
Lambda /tmp: /tmp/.openclaw/agents/default/sessions/{sessionId}.jsonl
SessionManager.open(path) → calls loadEntriesFromFile(path)readFileSync, appendFileSync, writeFileSync/tmp// HOME=/tmp → OpenClaw reads /tmp/.openclaw/openclaw.json
process.env.HOME = '/tmp';
// Minimal config (no gateway server needed)
{ "gateway": { "mode": "local" } }
After implementation of each step:
docs/progress.mddocs/architecture.md needs updatingnpm run test && npm run test:e2e