Docs / Troubleshooting

Troubleshooting

Start with the symptom that matches you best. These fixes target the hosted dashboard at cloudybot.ai. If many users are affected at once, check status before debugging your account.

Account & login

• 401 / unauthorized on chat or API calls: your session expired. Log out and back in, or refresh the dashboard. API integrators must send a fresh Authorization: Bearer token from POST /api/auth/login.
• Signup stuck on “verify email”: complete the link in your inbox, or ask an admin whether REQUIRE_EMAIL_VERIFY is enabled on your host.
• Password reset loops: use the latest email link only; changing password ends other sessions immediately (by design).
• Browser blocks cookies: allow first-party cookies for cloudybot.ai or try a private window without aggressive blockers.

Chat & threads

• Thread not found (404): pick a thread from the sidebar — bookmarked threadId values from deleted threads fail. Create a new thread via POST /api/threads if integrating.
• 400 missing fields: every POST /chat needs threadId and message. Do not send a mismatched userId in the body.
• 429 rate limit or “out of credits”: you hit plan requests/hour, burst limits, or monthly AI credits. See limits & caps and your usage meter in Settings.
• Context limit exceeded: the thread is too long for one turn. Start a fresh thread, pin only what you need, or ask the agent to summarize to a file in your workspace.
• Empty or cut-off replies: retry once; if streaming dropped mid-answer, recent builds keep partial text — reload history before resending.

Integrations & credentials

• Permission errors (Notion, Sheets, email, calendar): re-share the doc, spreadsheet, or mailbox with the identity CloudyBot uses; confirm the connection in Settings → Connect.
• Token expired / reconnect OAuth: disconnect and reconnect the provider. Long OAuth flows should complete in one sitting.
• Tool says “not configured”: the server or your account lacks the required key — e.g. Notion token per user, or GOOGLE_SERVICE_ACCOUNT_JSON for Sheets on self-hosted installs.
• Saved browser logins fail: update credentials in Connect; they inject at runtime and are not echoed in the chat transcript.

Cloud browser

• 402 subscription required: cloud browser needs a paid plan with browser minutes — see pricing.
• 429 browser minutes exhausted: wait for the monthly reset or upgrade; minutes meter active session time, not idle viewing.
• Captcha or bot walls: some sites block automation. Use manual steps, a different URL, or saved logins where policy allows.
• Session won’t start: end stale sessions from the browser panel, then reconnect. Check remaining minutes on the connect response.

Billing & plans

• Checkout or portal errors: open Settings → Manage subscription (Stripe). For failed charges email billing@cloudaxis.ai with your account email.
• Limits don’t match what you expect: caps come from plans.js for your tier — billing FAQ explains reset timing and bonus credit wallets.

Scheduled tasks & workflows

• Duty did not run: confirm the schedule is enabled, your plan still has cron headroom, and the Specialist has the required skills connected.
• Output landed in the wrong thread: see where results go — pick one thread per workflow.
• Webhook trigger 401/404: use the URL and secret from the duty card; fire a test payload during a maintenance window.

Deep cron debugging: scheduled task troubleshooting · workflow chains: chaining tasks.

Still stuck?

Check status, skim the FAQ, then contact with your account email, what you clicked, and screenshots (redact secrets and API keys). Include a threadId or duty name if support needs to trace a run.