What You’ll Need+
Before installing Clairo, make sure you have:
✅ A Mac running macOS 11 (Big Sur) or newer
✅ Slack, installed as a desktop app (not used through a web browser)
✅ At least 8 GB of RAM (16 GB is better if you can)
You’ll also need one extra piece of free software so Clairo has an AI “brain” to work with — covered in Step 2 below. It only takes a few minutes.
Step 1: Check What Kind of Mac You Have+
This helps you pick the right installer later on.
1. Click the Apple icon in the top-left corner of your screen.
2. Choose About This Mac.
3. Look at the line that says Chip (or Processor):
• If it says Apple M1, M2, M3, or M4 → you have Apple Silicon
• If it says Intel → you have an Intel Mac
Keep this in mind for the next step.
Step 2: Install the AI Software (Choose One)+
Clairo needs a companion app that actually runs the AI. Pick one of the three options below — we’ve ordered them from easiest to more advanced.
Option A — 9router (easiest, recommended)
1. Open the Terminal app (press ⌘Space, type “Terminal”, hit Enter).
2. Run:
npm install -g 9router
(If npm isn’t found, install Node.js free from nodejs.org first, then try again.)
3. Start 9router:
9router
Leave this Terminal window open — closing it turns 9router off.
4. In your browser, go to localhost:20128 to open the 9router dashboard.
5. Click the Providers tab and connect a provider — to keep everything private, connect a local provider like Ollama or LM Studio rather than a cloud AI service.
6. In Clairo’s Settings, use the address http://localhost:20128.
Good to know: 9router doesn’t run the AI itself — it connects Clairo to whichever provider you choose. If you connect a cloud provider instead of a local one, your conversations will leave your Mac.
Option B — LM Studio (simple visual app, great for Apple Silicon)
1. Download LM Studio from lmstudio.ai and drag it into Applications.
2. Open LM Studio and click the Discover tab.
3. Search for and download:
lmstudio-community/gemma-4-E4B-it-MLX-4bit (Apple Silicon) or gemma-3-4b-it-GGUF (Intel) — about 7 GB.
4. Click the Local Server tab, then Start Server. Leave LM Studio open in the background.
5. In Clairo’s Settings, use the address http://localhost:1234.
Option C — Ollama (lightweight, works on any Mac)
1. Download and install Ollama from ollama.com.
2. Open Terminal and run:
ollama pull llama3.1:8b
3. Ollama runs automatically in the background once installed.
4. In Clairo’s Settings, use the address http://localhost:11434.
Step 3: Install Clairo+
1. Download the Clairo installer for your chip:
• Apple Silicon Mac: Clairo_aarch64.dmg
• Intel Mac: Clairo_x64.dmg
(Not sure which? Check Step 1 above.)
2. Double-click the downloaded file to open it.
3. Drag the Clairo icon into the Applications folder.
4. Open Clairo from your Applications folder — its icon appears in the menu bar at the top-right of your screen.
Step 4: Give Clairo Permission to Read Slack+
Clairo needs one special permission so it can see what’s happening in your Slack conversations. This is a one-time setup.
1. When you first open Clairo, your Mac will likely ask for permission automatically — click Open System Settings if prompted. If it doesn’t ask, go to System Settings → Privacy & Security → Accessibility yourself.
2. Click the + button.
3. Find and select Clairo (in your Applications folder), then click Open.
4. Make sure the switch next to Clairo is turned ON.
That’s it — Clairo can now read Slack conversations on your screen.
Step 5: Set Up Clairo (First Time Only)+
1. Click the Clairo icon in your menu bar, then click the gear icon to open Settings.
2. Under AI Backend, enter the address matching what you installed in Step 2:
• 9router → http://localhost:20128
• LM Studio → http://localhost:1234
• Ollama → http://localhost:11434
3. Under Model, pick the model you downloaded earlier. Clairo finds it automatically as long as the app or Terminal window from Step 2 is still open and running.
How to Use Clairo+
1. Open Slack and click into the conversation you want help with.
2. Press ⌃A on your keyboard — the Clairo popup appears.
3. Choose an action: Evaluate (tells you whether the message needs a reply), Draft (writes a suggested reply), Summarize (sums up the conversation), Rewrite (changes the tone), Ask (ask a question about the thread), or Refine (tweak a reply you’ve written).
4. Once you’re happy with the text, click Insert — Clairo places it into Slack’s message box for you.
5. Review it, then press Send yourself. Clairo never sends messages on its own — you’re always in control.
Troubleshooting+
The popup doesn’t show up when I press ⌃A
Make sure Clairo is open (check the menu bar for its icon). Click the menu bar icon once, then try the shortcut again. Another app might be using the same shortcut — check Clairo’s Settings to confirm.
Clairo says it “can’t read Slack”
Double check the permission from Step 4 is turned on. Make sure you’re using the Slack desktop app, not Slack in a browser. Click directly into the Slack conversation first, then try again. If you just installed Clairo, try quitting and reopening it once.
Clairo says “AI backend not reachable”
9router: make sure the Terminal window running 9router is still open, and a provider is connected in the dashboard’s Providers tab.
LM Studio: make sure the app is open and you clicked Start Server in the Local Server tab.
Ollama: it should run automatically — try reopening Terminal and running ollama list to confirm it’s working.
Double-check the address in Clairo’s Settings matches: 9router :20128, LM Studio :1234, Ollama :11434.
No models show up in the list
9router: check that a provider is connected in the dashboard’s Providers tab — the model list comes from there.
LM Studio: confirm you clicked Start Server (not just downloaded the model).
Ollama: run ollama list in Terminal to confirm the model downloaded successfully.
Try the refresh button inside Clairo’s Settings.
What You’ll Need+
Before installing Clairo, make sure you have:
✅ A PC running Windows 10 (64-bit) or newer
✅ Slack, installed as a desktop app (not used through a web browser)
✅ At least 8 GB of RAM (16 GB is better if you can)
You’ll also need one extra piece of free software so Clairo has an AI “brain” to work with — covered in Step 2 below. It only takes a few minutes.
Step 1: Check Your Windows Version+
Clairo needs 64-bit Windows. Nearly every PC sold since 2010 qualifies, but it is worth a look.
1. Press the Windows key and type About your PC, then press Enter.
2. Find the line that says System type.
3. It should read 64-bit operating system, x64-based processor.
If it says 32-bit, Clairo will not run on this PC.
Step 2: Install the AI Software (Choose One)+
Clairo needs a companion app that actually runs the AI. Pick one of the three options below — we’ve ordered them from easiest to more advanced.
Option A — 9router (easiest, recommended)
1. Open PowerShell (press the Windows key, type “PowerShell”, hit Enter).
2. Run:
npm install -g 9router
(If npm isn’t found, install Node.js free from nodejs.org first, then try again.)
3. Start 9router:
9router
Leave this PowerShell window open — closing it turns 9router off.
4. In your browser, go to localhost:20128 to open the 9router dashboard.
5. Click the Providers tab and connect a provider — to keep everything private, connect a local provider like Ollama or LM Studio rather than a cloud AI service.
6. In Clairo’s Settings, use the address http://localhost:20128.
Good to know: 9router doesn’t run the AI itself — it connects Clairo to whichever provider you choose. If you connect a cloud provider instead of a local one, your conversations will leave your PC.
Option B — LM Studio (simple visual app)
1. Download LM Studio from lmstudio.ai and run the installer.
2. Open LM Studio and click the Discover tab.
3. Search for and download gemma-3-4b-it-GGUF — about 7 GB.
4. Click the Local Server tab, then Start Server. Leave LM Studio open in the background.
5. In Clairo’s Settings, use the address http://localhost:1234.
Option C — Ollama (lightweight)
1. Download and install Ollama from ollama.com.
2. Open PowerShell and run:
ollama pull llama3.1:8b
3. Ollama runs automatically in the background once installed.
4. In Clairo’s Settings, use the address http://localhost:11434.
Step 3: Install Clairo+
1. Download the installer: Clairo_x.x.x_x64-setup.exe
2. Double-click the downloaded file.
3. Windows may show a SmartScreen warning because the app is new. Click More info, then Run anyway.
4. Follow the installer, then open Clairo from the Start menu — its icon appears in the system tray at the bottom-right of your screen, next to the clock.
Unlike on macOS, Clairo needs no special permission on Windows. Once it is running, it can read Slack straight away.
Step 4: Set Up Clairo (First Time Only)+
1. Click the Clairo icon in your system tray, then click the gear icon to open Settings.
2. Under AI Backend, enter the address matching what you installed in Step 2:
• 9router → http://localhost:20128
• LM Studio → http://localhost:1234
• Ollama → http://localhost:11434
3. Under Model, pick the model you downloaded earlier. Clairo finds it automatically as long as the app or PowerShell window from Step 2 is still open and running.
How to Use Clairo+
1. Open Slack and click into the conversation you want help with.
2. Press Ctrl+Alt+A on your keyboard — the Clairo popup appears.
3. Choose an action: Evaluate (tells you whether the message needs a reply), Draft (writes a suggested reply), Summarize (sums up the conversation), Rewrite (changes the tone), Ask (ask a question about the thread), or Refine (tweak a reply you’ve written).
4. Once you’re happy with the text, click Insert — Clairo places it into Slack’s message box for you.
5. Review it, then press Send yourself. Clairo never sends messages on its own — you’re always in control.
Troubleshooting+
The popup doesn’t show up when I press Ctrl+Alt+A
Make sure Clairo is running (look for its icon in the system tray, next to the clock — you may need to click the arrow to show hidden icons). Another app might be using the same shortcut — check Clairo’s Settings to confirm.
Clairo says it “can’t read Slack”
Make sure you’re using the Slack desktop app, not Slack in a browser. Click directly into the Slack conversation first, then try again.
If Slack is running as Administrator but Clairo is not, Windows blocks Clairo from reading it. Close Slack and reopen it normally, or run Clairo as Administrator too.
Clairo says “AI backend not reachable”
9router: make sure the PowerShell window running 9router is still open, and a provider is connected in the dashboard’s Providers tab.
LM Studio: make sure the app is open and you clicked Start Server in the Local Server tab.
Ollama: it should run automatically — try reopening PowerShell and running ollama list to confirm it’s working.
Double-check the address in Clairo’s Settings matches: 9router :20128, LM Studio :1234, Ollama :11434.
No models show up in the list
9router: check that a provider is connected in the dashboard’s Providers tab — the model list comes from there.
LM Studio: confirm you clicked Start Server (not just downloaded the model).
Ollama: run ollama list in PowerShell to confirm the model downloaded successfully.
Try the refresh button inside Clairo’s Settings.