# How to use Grok Bot: install, first Bot, plugins, routines

> Step-by-step Grok Bot tutorial from the official docs: install and sign in, set up your first Bot, connect a plugin, run a checkable task, add a routine.

- Canonical page: https://www.grokbotwiki.com/guides/getting-started
- Sources checked: 2026-11-21
- Evidence: docs.x.ai's Bots page (no description or Bot settings page for personal Bots) and the forum thread on the missing Description field (staff reply November 20) read November 21, 2026 · docs.x.ai's files and results page (attachment limits) read November 12, 2026 · Steps from the official docs (docs.x.ai, Cursor's docs and help pages, checked October 11, 2026; Cursor's getting-started docs rechecked October 27); docs.x.ai, The X Subscription docs and Cursor help rechecked October 25, 2026 with the changelog through 0.75.5 · x.ai/pricing last read October 14, 2026 · not a recorded run by us · example briefs are original templates · approval expiry rechecked in Cursor's how-to help and the official approvals docs October 29, 2026. Suggested workflows have not been independently tested.
- Publisher: Grok Bot Wiki, an independent guide not affiliated with SpaceXSI, xAI or X.

## The short version

To start using Grok Bot, install the desktop app from x.ai/bot, sign in with the account that holds an eligible plan, rename the first Bot setup creates and give it one job, then ask for one small task you can check. Connect a plugin only when a task needs it, set approvals, and add a routine last.

Each step below follows the official documentation from docs.x.ai and Cursor's docs and help pages, checked on October 11, 2026. Where the two disagree, we say so. We have not recorded our own run of these steps; the example briefs are original templates you should adapt.

| Step | Where in the app | Done when |
| --- | --- | --- |
| 1. Install and sign in | x.ai/bot → Download, then Sign in | The browser confirms sign-in and the app shows your plan |
| 2. Set up your first Bot | Click the Bot's name at the top of its chat, or New chat (+) → Create new Bot | The Bot has a short name and you have told it one job |
| 3. Give it a bounded task | The chat composer | You can check the result against the source |
| 4. Connect a plugin or sign in | Connect Apps in the sidebar, or the Bot's computer | The plugin shows as installed and authorized |
| 5. Set approvals | Approval cards, and Settings → General → Auto-review | Sends, purchases and deletes stop for you |
| 6. Save a skill, then a routine | Ask the Bot; manage under the Bot's routines | A test run produced the result you expected |
| 7. Watch usage | Settings → Usage & Billing | You know your weekly usage and on-demand setting |

Sources: https://docs.x.ai/grok-bot/get-started, https://cursor.com/help/grok-bot/onboarding

## Before you begin

You need an eligible plan. Since October 12, 2026, new customers buy The X Subscription, where Grok Bot is included on Premium ($30 a month), Super and Ultra and on team seats, but not on Free or Plus. Existing plans still work: any paid individual Cursor plan, Cursor Teams, an individual SuperGrok, SuperGrok Plus, SuperGrok Heavy or X Premium+ subscription linked to your Cursor account, or an assigned seat on a self-serve Grok Business plan. Our [plan and pricing guide](https://www.grokbotwiki.com/guides/grok-bot-which-plan) compares them and explains switching.

Grok Bot requires cloud data storage. The getting-started page says accounts using Legacy Privacy Mode must move to a supported Cursor data setting before Grok Bot can start; on a team, an administrator changes it.

Sources: https://docs.x.ai/grok-bot/get-started, https://x.ai/news/x-subscription, https://x.ai/pricing, https://docs.x.ai/x-subscription/grok-bot, https://cursor.com/help/grok-bot/plans, https://cursor.com/help/grok-bot/supergrok

## 1. Install the app and sign in

The desktop app runs on macOS (Apple silicon and Intel), Windows and Linux (x64 and Arm64). Linux builds and the other platforms are under More downloads on x.ai/bot and on Cursor's download page; Cursor's docs add that the installer is also on the Grok Bot page of the Cursor dashboard. Our [platforms guide](https://www.grokbotwiki.com/guides/grok-bot-platforms) shows how to tell which build you need. There is no separate Grok Bot login. SpaceXSI's X Subscription docs say Grok Bot uses the shared xAI sign-in path, which may show Grok or xAI branding, and that signing in does not link or combine your X, Grok or Cursor accounts or switch your plan.

1. Download the app for your computer from x.ai/bot and install it. On a Mac, drag Grok Bot to Applications; on Windows, run the installer.
2. Open Grok Bot and choose Sign in, then finish authentication in the browser window that opens. If your organization uses single sign-on, complete that sign-in.
3. Return to Grok Bot after the browser confirms the sign-in.
4. If your access comes from SuperGrok or X Premium+, first check that you signed in with the Cursor account that should keep it, because a link is permanent. Then choose Link Grok Account: Cursor's help says the access screen opens Get Started with Grok Bot in your browser, and X Premium+ links through the same button by signing in to Grok with that X account.
5. If your company assigned you a seat on a self-serve Grok Business plan, there is nothing to buy or link: sign out, sign back in, and choose Sign in with Grok with the Grok account that holds the seat.
6. Click through the short introduction. The docs say it asks which tools you use to shape suggestions; the answers do not connect anything by themselves.

Sources: https://docs.x.ai/grok-bot/get-started, https://cursor.com/help/grok-bot/onboarding, https://x.ai/bot, https://cursor.com/help/grok-bot/supergrok, https://cursor.com/docs/grok-bot/get-started, https://docs.x.ai/x-subscription/grok-bot-sign-in

## 2. Set up your first Bot

The official sources describe this step differently. Cursor's onboarding help and Cursor's own getting-started docs say Grok Bot sets up your first Bot, named Grok Bot, and opens a chat with it, which matches the 0.51.0 changelog entry (September 14): setup now creates your first Bot for you. The docs.x.ai getting-started page, updated October 9, still describes choosing a suggested teammate from Meet a future teammate, or Create your own. Use whichever your app shows.

Either way, give the Bot a short name, then use your first message to tell it its one job, which sources to use and when to ask for approval, and ask it to remember that. Rename it, or add a label for its job, by clicking its name at the top of the chat. Put the job in chat rather than relying on a settings field: Cursor staff said on October 5 and 9 that the redesigned desktop details pane no longer shows a Bot's instructions, and docs.x.ai's Bots page, read November 21, now says personal Bots no longer have a description or a Bot settings page: to change what a Bot does, tell it in chat. In a second forum thread, Cursor staff wrote on November 20 that the Bot still follows its saved instructions and that you can ask it to show them or to update them. A Team Bot still has a description, which the docs say its owner or a Manager edits under About in the Bot's details. The docs say focused Bots build more useful context than one catch-all Bot. Add more later from New chat (the + button) → Create new Bot when the work splits into distinct roles. Every Bot on your account shares one cloud computer and its logins, so a separate Bot is a separate role, not a separate security boundary; see [the shared-computer guide](https://www.grokbotwiki.com/guides/grok-bot-shared-computer).

Sources: https://cursor.com/help/grok-bot/onboarding, https://cursor.com/docs/grok-bot/get-started, https://x.ai/changelog/bot, https://docs.x.ai/grok-bot/get-started, https://docs.x.ai/grok-bot/faq, https://docs.x.ai/grok-bot/bots, https://forum.cursor.com/t/grok-bot-macos-unable-to-see-or-edit-bot-instructions-or-skills-on-desktop/173803, https://forum.cursor.com/t/grok-bot-description-field-missing-on-ubuntu-desktop/173483

## 3. Give it a first task you can check

Start with a short task that has a clear result and changes nothing outside the chat. The docs say a strong request names the outcome, the sources, the constraints, the deliverable and a review point. Attach a document you already understand, such as meeting notes, so you can judge the answer without learning a new system first. Since 0.71.2 (October 14), one message can carry up to 20 attachments with a 200 MB total, and on 0.70.2 or later files can be up to 250 MB and videos up to 1 GB; the docs' Files and results page, read November 12, now agrees: 20 attachments per message, images 25 MB each with a 200 MB total, other files 250 MB each and video 1 GB each.

Compare the result against the source: one ordinary item, one ambiguous item, and one commitment with no deadline. Then state the lasting preference explicitly, for example the report format you want next time. The brief below is our template; the practice pack on this page has fictional notes and an answer key for it. Our guide to [writing a workflow brief](https://www.grokbotwiki.com/guides/write-a-workflow-brief) goes further.

Editorial template (replace placeholders and review access before running):

```text
Use the attached [document name/version] to create an action register. Return a table with action, named owner, explicit deadline, source passage, and uncertainty. Include only commitments supported by the document. Mark missing owners or dates as unspecified; do not infer them. Then list ambiguous statements that need a human decision. Preserve the original file. Do not contact anyone or create tasks in another app. Finish with the number of commitments found and anything you could not read.
```

Sources: https://docs.x.ai/grok-bot/get-started, https://cursor.com/help/grok-bot/onboarding, https://x.ai/changelog/bot, https://docs.x.ai/grok-bot/files-and-results

## 4. Connect a plugin, or sign in on the computer

When a task needs Gmail, Google Calendar, Slack, Notion or another supported service, connect a plugin. Since version 0.67.0 (October 2) the in-app Marketplace is called Connect Apps; follow a Connect card in chat or open it from the sidebar (on the phone, tap your avatar), add the plugin, and finish the provider's sign-in in your browser. Added means installed, not signed in: check that it is authorized. In chat, type @ to attach a connector to a task. Our [plugins, connectors and MCP guide](https://www.grokbotwiki.com/guides/grok-bot-plugins-mcp) covers the details.

For a website without a plugin, the Bot asks you to take over its computer: open Agent Computer from the conversation, choose the takeover control, sign in yourself, and hand control back. The browser session then stays on your shared computer for every Bot. Avoid pasting passwords or codes into chat, and until Cursor confirms a fix for the October 5 snapshot report (none was posted by October 11), type passwords on the screen yourself rather than through the in-chat form.

Since 0.75.5 (October 23), on Grok Bot 0.75.2 or later, you can instead save logins, cards and contact info under Settings → Vault, on desktop or the phone. Cursor's secrets help says the Bot fills them in to sign in or check out without seeing a saved password, card number or security code, that everything in Vault is available to every Bot on your account, and that Vault is not supported on Shared Bots (formerly Team Bots). docs.x.ai's Vault page, read November 14, now narrows the card part: it says a Bot never sees a saved password, but in chats in the Grok Bot app it can see a saved card's number and security code, which it types at checkout after you tap Pay on the order card. Cursor's getting-started docs, checked October 27, now describe the same order: when a Bot reaches an app that needs a sign-in it uses a login saved in Vault or a connected password manager, or asks you with a Secure Form, and hands you the computer for single sign-on, a passkey or another step a form cannot handle.

Sources: https://docs.x.ai/grok-bot/computer-and-apps, https://cursor.com/help/grok-bot/connect-apps, https://x.ai/changelog/bot, https://docs.x.ai/grok-bot/get-started, https://forum.cursor.com/t/grok-bot-browser-snapshot-shows-a-password-filled-by-the-secure-form-requestuserform-in-plain-text/173748, https://cursor.com/help/grok-bot/secrets

## 5. Set approvals before the Bot can change things

When an action needs approval, the chat shows an approval card with the proposed operation. Allow once lets that action continue, Always allow can save a matching rule, and Deny blocks it. The onboarding help suggests Allow once while you learn how a Bot handles a workflow.

With Auto Review on, Grok Bot checks tool calls and computer actions before they run. Add rules in Settings → General → Auto-review: Ask first rules always stop matching actions for you, and if an Ask first rule and an Allow automatically rule both match, Ask first wins. Since 0.68.0 Settings calls saved rules Custom Rules. Running commands on the computer in front of you is a separate setting whose default is Ask every time. Our [permission boundaries guide](https://www.grokbotwiki.com/guides/permission-boundaries) has a worksheet, and [Is Grok Bot safe?](https://www.grokbotwiki.com/guides/is-grok-bot-safe) covers the rest of the security model.

Two changes in 0.75.5 (October 23) affect this step. An email or Slack message you ask a Bot to send now goes out once Auto-review allows it, while sends from routines and other turns you did not start still wait as drafts; Cursor's email help adds that instructions inside an email the Bot received never count as your permission to send. And after you deny an approval card, the Bot stops and does not try that action again until you send another message.

- [ ] Sending email or messages, purchases, deletions and publishing are behind Ask first rules.
- [ ] Email and Slack drafts stay on. Since 0.75.5 a send you ask for in chat can go out once Auto-review allows it, so keep an Ask first rule for sending if you want to review every message.
- [ ] Execution on Local Computer is Ask every time or Never allow.
- [ ] Nothing signed into the shared computer would be a problem if any of your Bots used it.

Sources: https://docs.x.ai/grok-bot/approvals-security-and-privacy, https://cursor.com/help/grok-bot/onboarding, https://x.ai/changelog/bot, https://cursor.com/help/grok-bot/agent-email

## 6. Save a skill, then add a routine

Once a task produces the result you expect, ask the Bot to save the method as a skill: when to use it, the inputs and access it needs, the steps, how to check the result, what to return, and what needs approval. Private skills are one library shared by all your Bots; type / in the composer to use one. Where Teach a task is available, you can instead record up to ten minutes of your own browser work.

Only then ask the owning Bot for a routine, with the schedule, time zone, input, expected result and what to do when a source is missing. A test run performs real work, so use safe inputs. A new routine waits for its next scheduled time rather than running when created. An approval requested by a routine, a trigger or another Bot expires and the action does not run after about 30 minutes; the official docs and Cursor's how-to help both said so when we checked on October 29. Turn on notifications for Bots that run routines, or choose Always allow for actions you trust. Cursor's routines help warns that an hourly schedule, a short interval or a Slack trigger on a busy channel can use a week of usage in a day. It also sets hourly limits: up to 300 runs an hour across your routines (0.75.5 raised this from 100) and up to 200 for any one routine; a run past either limit fails with Automation run rate limit exceeded. Our guides to [skills and routines](https://www.grokbotwiki.com/guides/skills-vs-routines) and [routines that do not run](https://www.grokbotwiki.com/guides/grok-bot-routines-not-running) go deeper.

Editorial template (replace placeholders and review access before running):

```text
Every weekday at 8:00 AM in [time zone], run the [skill name] skill on [source]. Post a short result in this conversation with source links. Do not send, edit or delete anything outside this chat. If the source is unavailable, empty or unchanged since the last run, say so in one line and do not reuse an earlier result.
```

Sources: https://docs.x.ai/grok-bot/skills-routines-and-automations, https://cursor.com/help/grok-bot/routines, https://cursor.com/help/grok-bot/how-to, https://docs.x.ai/grok-bot/approvals-security-and-privacy, https://x.ai/changelog/bot

## 7. Keep an eye on usage

Every plan includes weekly usage, measured in agent steps and tokens rather than messages. Settings → Usage & Billing shows your included usage and, since 0.63.0, when it resets. When it runs out, work stops unless on-demand usage is enabled, and the On-demand monthly limit is not a hard stop for a run already in progress. Start one Bot on one task, read the meter, and add Bots and routines from there. On The X Subscription the weekly pool is shared with your Grok and Cursor use, extra use is paid from prepaid top-ups, and usage is shown under Usage at grok.com/dashboard. See [why the weekly limit runs out](https://www.grokbotwiki.com/guides/grok-bot-weekly-usage-limit).

Sources: https://cursor.com/help/grok-bot/plans, https://x.ai/changelog/bot, https://docs.x.ai/grok-bot/settings-and-notifications, https://docs.x.ai/x-subscription/usage-limits, https://docs.x.ai/x-subscription/grok-bot

## Quick answers

### Do I need to keep my computer on for Grok Bot to work?

No. Bots work on a persistent cloud computer, and the FAQ says closing the app, laptop or phone does not stop a background turn or a routine. The desktop and mobile apps are clients for that computer.

### Why does my account already have a Bot called Grok Bot?

Setup creates one. Cursor's onboarding help says Grok Bot sets up your first Bot, named Grok Bot, and opens a chat with it, and the changelog for 0.51.0 (September 14) says setup now creates your first Bot for you. Rename it by clicking its name at the top of the chat and give it one job, or add a new Bot from New chat (the + button) → Create new Bot.

### Can I set up Grok Bot on my phone?

Yes, on iPhone, iPad and Android, with the same Cursor account. You can message Bots, create Bots, install plugins and approve drafts from a phone, but editing a routine's schedule or instructions and running a test need the desktop app. See [our platforms guide](https://www.grokbotwiki.com/guides/grok-bot-platforms).

### What should my first task be?

Something small with an answer you can check, that changes nothing outside the chat. The official docs suggest attaching a document and asking for a five-bullet summary that lists every date, decision and open question with a citation. The practice pack on this page gives you notes and an answer key for the same idea.

## Sources

- [Vault and secure sign-in (saved cards, read November 14)](https://docs.x.ai/grok-bot/vault)
- [Get started](https://docs.x.ai/grok-bot/get-started)
- [Create and manage Bots: no description or Bot settings page for personal Bots (read November 21)](https://docs.x.ai/grok-bot/bots)
- [Forum: Description field missing on desktop (staff reply, November 20: ask the Bot to show or update its instructions)](https://forum.cursor.com/t/grok-bot-description-field-missing-on-ubuntu-desktop/173483)
- [Grok Bot overview](https://docs.x.ai/grok-bot/overview)
- [Computer and apps](https://docs.x.ai/grok-bot/computer-and-apps)
- [Approvals, security and privacy](https://docs.x.ai/grok-bot/approvals-security-and-privacy)
- [Skills and routines](https://docs.x.ai/grok-bot/skills-routines-and-automations)
- [Grok Bot for Mobile](https://docs.x.ai/grok-bot/mobile)
- [Grok Bot FAQ](https://docs.x.ai/grok-bot/faq)
- [Settings: usage and billing](https://docs.x.ai/grok-bot/settings-and-notifications)
- [Files and results: attachments](https://docs.x.ai/grok-bot/files-and-results)
- [Cursor docs: get started with Grok Bot](https://cursor.com/docs/grok-bot/get-started)
- [Cursor help: onboarding](https://cursor.com/help/grok-bot/onboarding)
- [Cursor help: link SuperGrok or a Grok Business seat](https://cursor.com/help/grok-bot/supergrok)
- [Cursor help: how-tos (approvals, notifications)](https://cursor.com/help/grok-bot/how-to)
- [Cursor help: connect apps](https://cursor.com/help/grok-bot/connect-apps)
- [Cursor help: routines](https://cursor.com/help/grok-bot/routines)
- [Cursor help: plans and billing](https://cursor.com/help/grok-bot/plans)
- [Cursor help: store secrets securely (Vault)](https://cursor.com/help/grok-bot/secrets)
- [Cursor help: give your Bot an email address (who can send)](https://cursor.com/help/grok-bot/agent-email)
- [SpaceXSI: Introducing The X Subscription (October 12, 2026)](https://x.ai/news/x-subscription)
- [x.ai pricing: The X Subscription plans](https://x.ai/pricing)
- [The X Subscription docs: Grok Bot on The X Subscription](https://docs.x.ai/x-subscription/grok-bot)
- [The X Subscription docs: Grok Bot sign-in](https://docs.x.ai/x-subscription/grok-bot-sign-in)
- [The X Subscription docs: usage limits](https://docs.x.ai/x-subscription/usage-limits)
- [Grok Bot changelog](https://x.ai/changelog/bot)
- [Grok Bot downloads (x.ai/bot)](https://x.ai/bot)
- [Forum: password filled by the Secure Form shown in a page snapshot (staff reply, October 5)](https://forum.cursor.com/t/grok-bot-browser-snapshot-shows-a-password-filled-by-the-secure-form-requestuserform-in-plain-text/173748)
- [Forum: desktop details pane no longer shows a Bot's instructions (staff replies, October 5 and 9)](https://forum.cursor.com/t/grok-bot-macos-unable-to-see-or-edit-bot-instructions-or-skills-on-desktop/173803)
