Mosaic cuts through team and market noise so you can focus on what matters. It connects to your Slack, Notion, Gmail, Drive, and market data, then answers strategy and operating questions from the context your team already has.

• macOS or Linux terminal
• Node.js 20+
• npm
• OpenAI API key
• Hyperspell account and API key
• Slack workspace where you can authorize Mosaic
• Data sources connected in Hyperspell, such as Slack, Notion, Gmail, or Google Drive

npm install -g getmosaic
mosaic configure

mosaic configure walks you through setup:

• installs and configures OpenClaw
• registers the Mosaic plugin
• saves your Hyperspell API key
• saves your OpenAI API key
• optionally saves your Tavily API key for web search
• opens the Mosaic Slack connect page so you can authorize Slack

mosaic start

Then mention Mosaic in Slack:

@Mosaic what’s happening in sales?
@Mosaic summarize recent customer feedback
@Mosaic what should we do better?

During mosaic configure you'll connect:

• Hyperspell — sign up at hyperspell.com, then connect Slack, Notion, Gmail, and Google Drive from their dashboard
• OpenAI — API key from platform.openai.com/api-keys
• Slack — authorize via the connect page that opens automatically
• Tavily — optional web search, free key at tavily.com

Mosaic searches across all of them automatically.

mosaic configure # Set up Mosaic (run this first)
mosaic start     # Start Mosaic
mosaic stop      # Stop Mosaic
mosaic status    # Show connected channels

npm install -g getmosaic@latest
mosaic start

mosaic start syncs the installed OpenClaw plugin when the npm package has changed.

mosaic stop
npm uninstall -g getmosaic
rm -rf ~/.openclaw/extensions/mosaic
npm install -g getmosaic
mosaic configure
mosaic start

To add a new tool:

1. Create src/tools/your-tool.ts
2. Add it to src/tools/registry.ts
3. Rebuild: npm run build

No other changes needed.