Install OpenBots Next on your Mac
There is no app to download.
One line builds OpenBots Next on your own Mac.
Every step that sends, changes or clicks waits on a card you approve. Read each card before you approve it.
18 cards · scroll down18 cards, in order
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
Your Mac and Xcode
An Apple Silicon Mac that can run your Xcode. Xcode 16.3 needs macOS 15.2 or later.
Full Xcode 16.3 or later. Command Line Tools alone cannot build it.
is where it must be.
Open Xcode once, so it finishes its own setup.
Claude's noteYour macOS version is under Apple menu → About This Mac. Xcode is free in the App Store.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
Your own certificate
The app is built and signed with your own Apple Development certificate. There is no way around it.
It is free: a Personal Team is enough.
In Xcode
Add your Apple account and select your team.
Makes the certificate.
Keep it: updates use the same one. A new certificate can make macOS ask for permissions again.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
Claude Code
Installs Claude Code · paste in Terminal
curl -fsSL https://claude.ai/install.sh | bash Anthropic's own installer. An npm or Homebrew install is refused.
Checks that it is there
ls -l ~/.local/bin/claude A Claude Pro or Max plan. An API key, a Team or an Enterprise login is not accepted.
Node.js too, from Homebrew or nodejs.org.
Claude's noteTerminal is in Applications → Utilities. Copy from this page or the README, on your Mac.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
Gmail, Google Calendar or Google Drive?
Your Google Client ID goes into the app when it is built.
You can add it later.
Quit the app, then run the Google line (card 8). The ID is added to the rebuilt app; nothing else changes.
Claude's noteNot sure? Start without Google.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
Only if you want Gmail, Google Calendar or Google Drive
Your own Google sign-in
Use a separate Google account.
Give it only what you want bots to see.
In your browser
- A Google Cloud project
- Turn on three APIs
- Consent screen: Testing, you as test user
- A Desktop client
- Its ID into the install line (card 8)
- The JSON file into the app (card 10)
Keep that JSON file private: it holds the secret.
You may see
unverified appThis is your own app, so continue.
Every click: docs/guides/google-setup.md
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
the one linePaste in Terminal
env -i HOME=/nonexistent PATH=/usr/bin:/bin:/usr/sbin:/sbin \
/usr/bin/curl -q -fsSL https://raw.githubusercontent.com/LorenzoColombani/openbots/main/install.sh | sh Claude's noteIt is one command over several lines: copy all of it.
When it is built, the app opens.
It builds only the published release and checks every file. If none is out yet, it stops: No published release yet.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
Only if you want Gmail, Google Calendar or Google Drive
With Google · instead of the one line
env -i HOME=/nonexistent PATH=/usr/bin:/bin:/usr/sbin:/sbin \
/usr/bin/curl -q -fsSL https://raw.githubusercontent.com/LorenzoColombani/openbots/main/install.sh \
| OPENBOTS_GOOGLE_OAUTH_CLIENT_ID=1234-abcd.apps.googleusercontent.com sh replace with your Client ID, all of it
Your command · paste in Terminal
This page keeps your ID nowhere and sends it nowhere.
Installed without an ID? Quit the app and run this line. Updates keep the ID.
Switching to another Google client also needs OPENBOTS_REPLACE_GOOGLE_CLIENT_ID=1: docs/guides/google-setup.md
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
Two sign-ins, then hello
In OpenBots Next
Settings → General & Claude Code
- Check for a new Claude version Sign in for compatibility checks First sign-in, with your Pro or Max account.
- Check compatibility sign-in Retry compatibility checks Up to six short test requests. Needs Node.
- Sign in with Claude Check Claude Second sign-in, for your bots.
- Press + New and say hello.
Your own Terminal login is not touched.
Everything beyond chat is off until you turn it on for that bot.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
Only if you want Gmail, Google Calendar or Google Drive
Connect Google in the app
Pick the JSON file. Then sign in as the separate account, within five minutes. Turn Google on per bot, under Access.
Reading mail, drafts, Calendar, Drive: no card. Sending a mail: a card every time.
Seven days: Google ends the sign-in of an app in Testing. Then sign in again.
Updates keep your Google setup.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
Approval cards
The switch lets a bot read. The card asks before it acts.
Control Chrome cards everything, reading included.
A card shows exactly what will be sent, run or clicked.
Nothing guarantees a bot is not fooled: a mail or web page can try to steer it. Outside text is marked untrusted: less risk, not none.
Read each card before you approve it.
A bot cannot turn on its own connectors, hiring or Control this Mac.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
Control this Mac
A trial
It lets a bot look at your screen, click and type. What it needs: docs/CONNECTORS.md
The first action of a reply waits on a card. On it, Allow for this turn lets the rest of that reply go on without asking again.
While any card is open, no screen action runs, so a bot cannot press Approve for you.
After 64 rounds in one reply, the bot asks on a card to keep going. Deny ends the reply and keeps what it wrote.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
macOS will ask
Asked only when a feature first needs it: Automation for Mail, Messages, Contacts, Notes and Chrome; Calendars for Calendar; Contacts for names in the Messages chat picker; Accessibility and Screen Recording for Control this Mac.
Full Disk Access, for your Messages history, is never asked. Add OpenBots Next yourself, then quit and reopen it.
You can refuse or withdraw any of them.
If your Mac asks whether the Google helper may use your Keychain, allow it.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
In Terminal
Get Xcode, open it once, then run the line again.
Make it (card 3), then run the line again.
Quit the app, then run the line again.
The log is in ~/
Put in the Client ID, not the secret.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
In the app
It could not confirm your subscription
Only a claude.ai Pro or Max login counts.
Install Claude Code with Anthropic's line (card 4).
This build needs a new Google Desktop OAuth client before the account can be connected.
Built without a Client ID: see card 8.
A connector says something is missing
Its row in Settings → Connectors & Skills says what, and how to fix it.
Settings reports on Claude Code
Follow it. A new version must pass the app's checks before it is used.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
At Google
Create a Desktop app client (card 6).
Pick the right file, or rebuild with its ID (card 8).
Start again; finish within five minutes.
Enable it in APIs & Services → Library.
Access denied at Google
Add the account as a test user.
Worked for a week, then stopped
The Testing sign-in expired. Sign in again.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
What stays on your Mac
Your bots' files, in your home folder.
The app's records and its own Claude sign-in.
Google keys: your Mac's Keychain, not iCloud. PRIVACY.md is a draft, not yet reviewed by a lawyer.
What leaves your Mac is what you switch on.
Update checks go to GitHub. Nothing goes to the developer. Bots stop when the app closes.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md
Updating
Press Update now in the app. Your data is kept.
It checks the signed release, builds it on your Mac, and installs when you quit. It keeps one previous copy.
On 1.0.2 or older: run the one line once (card 7). Going back to before 1.1 is not supported.
- Keep Xcode and your certificate.
- Google: sign in again every seven days.
To remove it, follow Remove completely in docs/INSTALL.md: the app, its data, the previous copy and the build log. Copy out your bots' files first.
Read each card before you approve it.
Prepared by an AI (Claude) from the OpenBots v1.1 docs
Full docs: README and docs/INSTALL.md