References Serverless OpenClaw architecture. Covers network design, CDK stack structure, DynamoDB data model, API protocols, and container design.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
serithemage/serverless-openclaw1962026년 3월 29일 업데이트
무료GitHub에 공개
troubleshoot
Troubleshoots common issues. Covers CDK deploy failures, Docker build errors, Lambda agent issues, test failures, and OpenClaw compatibility. Use when encountering errors during development or deployment.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
serithemage/serverless-openclaw스타 196(GitHub 196 + cccskills 0)
실행 점수 미검증
설치 방법 보기포함된 파일(1)
- SKILL.md6.2 KB
SKILL.md(원문)
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
Troubleshooting
Problem to investigate: $ARGUMENTS
Full references:
- docs/deployment.md §10 — Deployment troubleshooting
- docs/lambda-migration-journey.md — Deployment Obstacles section
Common Issues & Solutions
CDK / Synth
| Problem | Cause | Solution |
|---|---|---|
Cannot find asset during cdk synth | packages/web/dist/ missing | Run cd packages/web && npx vite build first |
CDK Bootstrap version mismatch | Outdated bootstrap | Run cdk bootstrap |
ROLLBACK_FAILED on SecretsStack | AwsCustomResource partial failure | aws cloudformation delete-stack --stack-name SecretsStack --deletion-mode FORCE_DELETE_STACK, then redeploy |
ECR repository already exists | CDK trying to create existing repo | Use --force delete or Repository.fromRepositoryName() |
| Cross-stack export removal error | Stack import in use | Use --exclusively flag + SSM decoupling pattern |
Docker Build
| Problem | Cause | Solution |
|---|---|---|
TS error with openclaw dynamic import | Static analysis of dynamic path | Use variable path: const mod = await import(/* @vite-ignore */ path) |
OCI manifest push error | Default buildx provenance | Add --provenance=false flag to docker buildx build |
npm ci fails (husky postinstall) | prepare script runs in container | npm pkg delete scripts.prepare && npm ci |
Lambda Agent
| Problem | Cause | Solution |
|---|---|---|
Cannot find package | Package installed globally, not in LAMBDA_TASK_ROOT | Install in $LAMBDA_TASK_ROOT, not /usr/local |
exports map resolution failure | Node ESM named exports | Use file:// URL import: import(\file://${path}`)` |
| Bedrock discovery timeout (56s) | Auto-discovery scans all regions | Set bedrockDiscovery.enabled: false in OpenClaw config |
extensionAPI not found | Not in exports map | Use file:// URL: import(\file://${ocRoot}/dist/extensionAPI.js`)` |
OpenClaw Compatibility
| Problem | Cause | Solution |
|---|---|---|
| v2026.2.14 breaks: scope error | Default-deny scope system, device pairing required | Pin to v2026.2.13 (fastest compatible) |
operator.write stripped | Missing device pairing in v2026.2.14+ | Use v2026.2.13 or implement device pairing |
device field validation fails | Empty publicKey/signature strings | Omit device field entirely (it's Optional) |
client.mode: "operator" invalid | Not a valid Literal type | Use "backend" or "node" |
Tests
| Problem | Cause | Solution |
|---|---|---|
vi.mock variable not in scope | Hoisting moves mock above variable declaration | Use vi.hoisted() for variables referenced in mocks |
| E2E tests run with unit tests | Default vitest include matches all .test.ts | Exclude **/*.e2e.test.ts in vitest.config.ts |
workspace:* not resolved | pnpm syntax used in npm workspace | Use "*" for workspace dependencies |
AWS / IAM
| Problem | Cause | Solution |
| -------------------------------------------------- | --------------------------------- | ------------------------------------------------------------------- | ---------------------------------- |
| launchType + capacityProviderStrategy conflict | Cannot specify both in RunTask | Remove launchType, use capacityProviderStrategy only |
| Lambda env var {{resolve:ssm-secure:...}} fails | Not supported for Lambda env vars | Pass SSM path as env var, resolve at runtime via resolveSecrets() |
| ECS Task new secret inaccessible | Execution role not updated | Add ssm:GetParameters to execution role policy |
| Empty env vars from .env | export $(cat .env | xargs) silently sets empty | Verify with ${#VAR} length check |
리뷰
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
댓글
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
같은 저장소의 스킬
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.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
serithemage/serverless-openclaw1962026년 3월 29일 업데이트
context
무료Loads Serverless OpenClaw project context. Provides background knowledge needed for development including project overview, tech stack, architecture decisions, and data models.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
serithemage/serverless-openclaw1962026년 3월 29일 업데이트
cost
무료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.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
serithemage/serverless-openclaw1962026년 3월 29일 업데이트
deploy
무료Deploys Serverless OpenClaw CDK stacks to AWS. Handles SecretsStack parameter injection, full/individual stack deployment, and Docker image push.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
serithemage/serverless-openclaw1962026년 3월 29일 업데이트
dev
무료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.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
serithemage/serverless-openclaw1962026년 3월 29일 업데이트