SPB Git

Repository Public

troubleshooting.md 6.4 KB 177 lines markdown

1<!-- source: https://docs.x.ai/grok-bot/troubleshooting (from https://docs.x.ai/llms-full.txt, retrieved 2026-09-19T05:28:55Z) -->2#### Help34# Troubleshooting56Start with the least destructive step. A Bot's cloud work can continue even7when the desktop or mobile app is disconnected.89## Sign-in does not complete10111. Keep Grok Bot open while authentication runs in your browser.122. Confirm the browser shows a successful Cursor sign-in.133. Return to the app manually if it does not regain focus.144. Try **Get started** or **Sign In with Cursor** again.155. Confirm that your account has Grok Bot access.1617If your organization uses SSO, complete the organization login rather than18signing in with a different personal account.1920An error about Legacy Privacy Mode means the account is using a data mode that21does not permit Grok Bot's required storage. Update the Cursor account data22setting or contact your organization administrator.2324## The computer is still setting up2526Initial setup and an image update can take several minutes. Keep the app open27until **Starting your computer** or **Updating your computer** completes.2829If progress is still changing, wait. If it fails or stops changing:30311. Retry from the error state.322. Restart Grok Bot.333. Check for a Grok Bot app update.344. If the computer remains unreachable, open **Settings → Updates** and choose35   **Update** under **Grok Bot's Computer**.3637## The computer cannot be reached3839Your Bot profiles and saved conversations are not necessarily lost when the40computer is temporarily unreachable.4142Recover in this order:43441. Choose **Retry** or reopen the conversation.452. Restart the Grok Bot app.463. Choose **Recover computer** from the unreachable-computer state when offered47   (the confirmation dialog calls it **Recover Grok Bot's Computer**).484. If recovery is not available, open **Settings → Updates** and choose49   **Update** under **Grok Bot's Computer**. On iPhone and Android, the same50   controls are **Update Computer** and **Reset Computer** under **Settings →51   Bot → Bot Computer**.525. Wait for the replacement computer to become available.536. Use **Reset** only if recovery and update fail and you accept losing recent54   unsynced work.5556**Recover computer** and **Update** preserve durable files and logins.57**Reset** restores the last saved snapshot and can lose recent or unsynced58work.5960## A Bot appears stuck6162* Check the status shown in the sidebar and conversation.63* Open the computer to see whether the Bot is waiting on a page.64* Look for a question, approval, login, CAPTCHA, or secret request.65* Send a short redirect if the current approach is wrong.66* Send a direct “Stop now” message if the work should end.6768A computer-use task already active on that Bot's screen may need to finish or69be redirected before another one can start.7071If usage is exhausted or an on-demand spending limit is reached, review usage72and billing from the account access page or **Usage & Billing** when that73section is available.7475## A website keeps asking for login76771. Take over the computer and sign in yourself.782. Complete two-factor authentication or CAPTCHA.793. Confirm the signed-in page has loaded before returning control.804. Tell the Bot to continue from the current page.8182Do not paste a password or verification code into ordinary chat. Some sites83expire sessions or require verification for each sensitive action; this cannot84always be avoided.8586## A plugin will not install or authenticate87881. Open **Marketplace** from the sidebar, choose **Your plugins**, and confirm89   the plugin is listed under **Installed**.902. Reopen its detail page and choose the authentication action.913. Complete authorization with the intended account in the browser.924. Return to Grok Bot and retry the task.935. Check whether the connector requires an organization-provided variable or94   administrator configuration.9596If authentication was revoked in the source service, remove and reconnect the97plugin.9899## An attachment cannot be read100101Check that:102103* The file is no larger than 25 MB, or 200 MB for video104* No more than six attachments were selected at once on desktop105* The file is not encrypted or password-protected106* The upload finished before sending107* The file type is supported108109Try exporting an unusual format as PDF, CSV, plain text, or an image. Do not110remove document protection if the resulting file would violate your data111policy.112113## A routine did not run114115Open the routine and verify:116117* It is enabled118* Its schedule and time zone are correct119* The owning Bot still exists120* Required plugins remain authenticated121* The computer can reach the source system122* Usage or account access has not been paused123124Inspect recent run history for a failure. Use **Test run** only with safe input;125testing can perform real external actions.126127For an event-triggered routine, confirm the source channel, repository, and128matching rule are still valid.129130## An approval is blocked131132Read the proposed target and arguments. If the card is no longer actionable:1331341. Reject or cancel it if that control is available1352. Send the Bot a replacement instruction1363. Ask it to regenerate the action with the corrected scope137138If an action keeps requiring approval, check **Settings → General → Bot →139Auto-review** for a matching **Ask first** rule, including team rules your140admin requires. **Ask first** rules take precedence over **Allow141automatically** rules.142143## Local computer work is refused144145Cloud-computer work and local-computer work use different permissions. Open146**Settings → General → Bot → Execution on Local Computer** (or the computer's147row under **Settings → Computer → Computers**) and review the policy.148149Keep local access disabled unless the task specifically requires files or150commands on the computer in front of you.151152## Update Grok Bot153154The Grok Bot app and the Agent Computer have separate updates.155156* To update the app, open **Settings → Updates → Check for Updates**. If an157  update is ready, choose **Restart to Update**.158* To rebuild the cloud computer, choose **Update** under **Grok Bot's159  Computer** in the same section.160161Updating the desktop app does not reset the cloud computer.162163## Before contacting support164165Collect:166167* Grok Bot version168* Operating system and version169* The exact error message170* The Bot or routine name171* The approximate time and time zone172* The full request ID or conversation ID if one is shown173* Whether retry, app restart, or updating Grok Bot's computer changed the174  result175176Do not include passwords, one-time codes, private keys, or secret values.177
Files main
Menu

Theme