Cloud Mode (cloud:true)
Cloud Errors and Troubleshooting
Diagnose cloud authentication, contract, capacity, and runtime issues quickly.
Common Cloud Error Codes
CLOUD_ACTION_FAILEDCLOUD_AUTH_FAILEDCLOUD_BILLING_LIMIT_REACHEDCLOUD_BROWSER_PROFILE_BUSYCLOUD_BROWSER_PROFILE_DISABLEDCLOUD_BROWSER_PROFILE_NOT_FOUNDCLOUD_BROWSER_PROFILE_PROXY_UNAVAILABLECLOUD_BROWSER_PROFILE_SYNC_FAILEDCLOUD_CAPACITY_EXHAUSTEDCLOUD_CONTRACT_MISMATCHCLOUD_CONTROL_PLANE_ERRORCLOUD_INTERNALCLOUD_INVALID_REQUESTCLOUD_MODEL_NOT_ALLOWEDCLOUD_PROXY_REQUIREDCLOUD_PROXY_UNAVAILABLECLOUD_RATE_LIMITEDCLOUD_RUNTIME_MISMATCHCLOUD_RUNTIME_UNAVAILABLECLOUD_SESSION_CLOSEDCLOUD_SESSION_NOT_FOUNDCLOUD_SESSION_STALECLOUD_UNSUPPORTED_METHOD
Troubleshooting Checklist
- Verify
OPENSTEER_MODE=cloud(or constructorcloud: true). - Verify API key and auth scheme.
- Confirm contract version is
v3. - Check control-plane health endpoint before retrying.
- For rate limits, honor
Retry-Afterwhen returned.
Notes
Opensteer.from(page)is unsupported in cloud mode.uploadFile,exportCookies, andimportCookiesare unsupported in cloud mode because they depend on local filesystem paths.opensteer.agent({ mode: 'cua' })is supported in cloud mode afterlaunch(). CUA actions execute against the active cloud CDP page.
Covered Features
api:GET /healthenv:OPENSTEER_API_KEYenv:OPENSTEER_MODE
