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.
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.
Problem to investigate: $ARGUMENTS
Full references:
| 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 |
| 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 |
| 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`)` |
| 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" |
| 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 |
| 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 |
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.