How to Set Up OpenClaw AI on Mac in Under 10 Minutes (Step-by-Step)

I was skeptical when people said OpenClaw takes 10 minutes to set up. I timed myself. It took 12 minutes and 40 seconds, including the WhatsApp connection. Here is exactly how to do it.

Most open-source AI tools have a setup process that feels like defusing a bomb. Dependencies, configuration files, environment variables, Docker containers — by the time you finish, you have forgotten why you wanted the tool in the first place. OpenClaw is refreshingly different. The onboard wizard handles almost everything.

Part 1: Install OpenClaw

Open your terminal. If you have never opened a terminal before, press Command + Space, type "Terminal", and hit Enter. Then type the following command and press Enter:

This installs OpenClaw globally on your machine. It takes about 30 to 60 seconds depending on your internet speed. When it finishes, you will see a confirmation message. If you get a permission error, add "sudo" before the command and enter your Mac password when prompted.

Part 2: Run the Setup Wizard

Still in your terminal, type:

The onboard wizard is genuinely good. It walks you through each step with clear prompts and sensible defaults. Here is what it asks you:

The entire setup happens in your terminal — the onboard wizard makes it surprisingly painless.

Part 3: Connect WhatsApp

WhatsApp integration is the feature that drew me to OpenClaw, and the setup is simpler than I expected. During the channel selection step (or afterwards by running openclaw channel add whatsapp), the terminal displays a QR code.

Open WhatsApp on your phone. Go to Settings, then Linked Devices, then Link a Device. Scan the QR code on your terminal screen. Done. OpenClaw now appears as a linked device, and you can message it like any other contact.

Part 4: Connect Telegram

Telegram is the most reliable OpenClaw integration in my testing. The setup requires creating a Telegram bot first, which takes about 2 minutes:

1. Open Telegram and search for @BotFather
2. Send /newbot and follow the prompts to name your bot
3. BotFather gives you an API token — copy it
4. Paste the token into the OpenClaw wizard when it asks for your Telegram credentials
5. Send a message to your new bot in Telegram — it should respond immediately

That is it. Your Telegram bot is now powered by whichever AI model you connected. Every message you send gets processed by the AI and responded to in the same chat. It feels like texting a very smart friend who never sleeps.

Part 5: Your First Real Tasks

Now that OpenClaw is running and connected to at least one messaging platform, try these starter tasks to see what it can do:

Troubleshooting Common Issues

• WhatsApp disconnects: This happens occasionally. OpenClaw usually reconnects automatically within a minute. If not, run openclaw channel reconnect whatsapp.
• Slow responses: Usually an API-side issue, not OpenClaw. Check your model provider's status page. Switching to a faster model (like GPT-4o mini) helps for quick tasks.
• Permission errors on install: Run the npm install command with sudo prefix. If that does not work, fix your npm permissions using the official Node.js guide.
• Telegram bot not responding: Make sure you sent a message to the bot first — Telegram bots cannot initiate conversations. Also check that your API key is valid.

FAQ