Problem: You Want AI That Actually Does Things
You've heard about AI assistants that can control your computer, manage emails, and automate tasks. But every guide assumes you know how to use a Terminal or write code.
You'll learn:
- How to install OpenClaw without typing commands
- How to connect it to WhatsApp, Telegram, or Discord
- How to give it your first task in under 15 minutes
Time: 15 min | Level: Beginner (zero coding required)
What Is OpenClaw?
OpenClaw is a personal AI assistant that runs on your computer and connects to messaging apps you already use. Unlike ChatGPT or Claude, OpenClaw can actually do things - like organizing files, sending emails, or managing your calendar - all through simple chat messages.
What makes it different:
- Everything stays on your computer (privacy-first)
- Control it from WhatsApp, Telegram, or Discord
- No monthly subscription (you bring your own AI key)
- Open-source and free
Real example: Text "Unsubscribe me from promotional emails" and OpenClaw goes through your inbox and does it.
Before You Start
What You Need
Required:
- A computer (Windows, Mac, or Linux)
- Internet connection
- A messaging app account (WhatsApp, Telegram, or Discord - we'll use Telegram in this guide)
Optional but recommended:
- An AI service account (free options available):
- Google AI Studio (free tier includes Gemini)
- Anthropic Claude (free trial)
- OpenAI ChatGPT (costs money, but powerful)
Time commitment: First install takes 10-15 minutes. Setting up messaging takes another 5 minutes.
Solution
Step 1: Download the Installer
For Windows:
- Go to openclaw.ai
- Click the big "Download for Windows" button
- Save the file (it's called something like
OpenClaw_Installer.exe) - Wait for download to finish (file size is about 150MB)
For Mac:
- Go to openclaw.ai
- Click "Download for macOS"
- Save the
.dmgfile to your Downloads folder - Wait for download to complete
Expected: You'll see a file in your Downloads folder with "OpenClaw" in the name.
If it fails:
- Download blocked: Your browser might warn you. Click "Keep" or "Download anyway"
- Mac security warning: We'll handle this in the next step
Step 2: Run the Installer
Windows:
- Find the downloaded
.exefile in your Downloads - Double-click it
- Windows might show "Windows protected your PC" - click "More info" then "Run anyway"
- Click "Yes" when asked "Do you want to allow this app to make changes?"
- The installer window opens - click "Next" through the screens
- Click "Install"
Mac:
- Find the downloaded
.dmgfile - Double-click to open it
- Drag the OpenClaw icon to the Applications folder
- Open Applications and find OpenClaw
- Right-click OpenClaw and choose "Open"
- Click "Open" on the security warning (only needed first time)
What you'll see: A terminal window (black or white screen with text) will open. This is normal - OpenClaw is setting itself up.
Expected: After 30-60 seconds, you'll see text like "OpenClaw installation complete" and a prompt asking questions.
If it fails:
- "Unverified Developer" (Mac): Go to System Settings → Privacy & Security → scroll down → click "Open Anyway"
- "Command not found" (Windows): Close and reopen PowerShell
- Installation freezes: Close the window, restart your computer, try again
Step 3: Answer the Setup Questions
The installer will ask you questions. Here's what to answer:
Question 1: "Do you want to use Quick Start?"
- Answer: Type
yesand press Enter - Why: This uses safe defaults so you don't need to configure everything manually
Question 2: "Which AI provider do you want to use?"
- Answer: Type
google(for free option) oranthropic(for Claude) - Why: Google Gemini has a generous free tier perfect for testing
Question 3: "Do you have an API key?"
- If yes: Paste your key (we'll show you how to get one below)
- If no: Type
no- OpenClaw will guide you to get one
Question 4: "Which messaging platform?"
- Answer: Type
telegram(easiest for beginners) - Alternatives:
whatsapp,discord, orskip(use web interface only)
What you'll see: OpenClaw will show progress messages like "Installing dependencies..." and "Configuring gateway..."
Expected time: 2-5 minutes for all setup questions.
Step 4: Get Your Free AI Key (Google Gemini)
If you don't have an AI key yet, here's how to get Google's free one:
- Open your browser and go to aistudio.google.com
- Click "Sign in" with your Google account
- Click "Get API key" in the top menu
- Click "Create API key"
- Click "Copy" on the key that appears (looks like:
AIzaSyD...)
Now go back to OpenClaw:
- When it asks "Paste your API key:", right-click and paste
- Press Enter
Expected: OpenClaw will say "API key verified" and continue setup.
If it fails:
- "Invalid key": Make sure you copied the entire key with no extra spaces
- "Quota exceeded": You hit the free tier limit - try again tomorrow or use a different Google account
Step 5: Connect to Telegram
First, set up your Telegram bot:
- Open Telegram on your phone or computer
- Search for
@BotFather(it's an official Telegram account with a checkmark) - Start a chat and type
/newbot - BotFather asks "What's your bot's name?" - type anything you like (example:
My OpenClaw Assistant) - BotFather asks for a username - it must end in "bot" (example:
my_openclaw_bot) - BotFather gives you a token (looks like:
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz) - Copy this token - you'll need it next
Now connect OpenClaw:
- Go back to the OpenClaw setup window
- When it asks "Paste your Telegram bot token:", paste the token from BotFather
- Press Enter
- OpenClaw will say "Telegram bot connected"
Expected: You'll see "Setup complete! Your OpenClaw is ready."
If it fails:
- "Invalid token": Make sure you copied the entire token from BotFather
- Connection failed: Check your internet connection
- Bot not responding: Try sending
/startto your bot in Telegram
Step 6: Start Talking to OpenClaw
Option A: In Telegram (recommended for beginners)
- Open Telegram
- Search for the bot username you created (example:
@my_openclaw_bot) - Open the chat and click "Start" at the bottom
- Type your first message:
Hello!
Expected: OpenClaw responds within 5-10 seconds with something like "Hi! I'm your OpenClaw assistant. How can I help?"
Option B: In your web browser
- In the OpenClaw window, type:
openclaw dashboard - Your browser opens to
http://127.0.0.1:18789/ - You'll see a chat interface - type your message there
Try these first commands:
What can you do?- Shows what OpenClaw can help withTell me a joke- Simple test that doesn't need special permissionsWhat files are on my desktop?- Tests file access (may ask for permission)
Step 7: Give OpenClaw Its First Real Task
Start with something simple that proves it works:
Easy tasks:
Create a file on my desktop called test.txt with the text "OpenClaw works!"What's the weather today?(if you gave location permission)Remind me in 5 minutes to check if this worked
Medium tasks (once you're comfortable):
Find all PDF files on my desktop and move them to a folder called PDFsUnsubscribe me from newsletters I haven't opened in 3 monthsSummarize the last 10 emails from [sender name]
What you'll see: OpenClaw will:
- Confirm what you want: "I'll create a file called test.txt on your desktop. Proceed?"
- You reply:
yes - It does the task and reports back: "Done! Created test.txt on your desktop."
If it asks for permissions: Click "Allow" or "Yes" - this is normal for first-time tasks.
Verification
Test that everything works:
Send a message to your bot in Telegram
- Expected: Response within 10 seconds
Ask it to do something:
What's today's date?- Expected: Correct answer with current date
Check the web dashboard: Type
openclaw dashboardin terminal- Expected: Browser opens showing chat interface
You should see:
- Messages sending and receiving in Telegram
- Web dashboard loads at
http://127.0.0.1:18789/ - OpenClaw responds to simple questions
If something doesn't work:
- No response in Telegram: Check the terminal window for errors
- Dashboard won't load: Type
openclaw gateway statusto check if it's running - OpenClaw says "I don't have permission": You need to grant file access (it will ask)
What You Learned
Key points:
- OpenClaw runs on your computer, not in the cloud
- You control it through regular chat apps (no special software needed)
- It needs an AI key (free options available) to be smart
- First-time setup takes 15 minutes, then it's always ready
Important limits to know:
- Free AI keys have usage limits (Google: 60 requests/minute)
- OpenClaw can only access files you give it permission to
- Your computer needs to be on for OpenClaw to work
- Some tasks require additional setup (like email access)
Privacy note: Everything happens on your computer. Your messages don't go to OpenClaw's servers - they go directly to the AI service you chose (Google, Anthropic, etc.).
Common Issues and Fixes
OpenClaw stops responding
Check if it's running:
openclaw gateway status
Restart it:
openclaw gateway restart
"I hit my free tier limit"
Google's free tier resets daily. Options:
- Wait 24 hours
- Create another Google account and get a new key
- Switch to a paid AI service
Bot says "I can't do that"
OpenClaw needs permissions for certain tasks:
- File access: You'll see a system popup - click "Allow"
- Email/calendar: Requires additional setup (beyond this guide)
- Some tasks require "skills" to be installed
Next Steps
Now that OpenClaw works:
Learn what it can do:
- Check the Skills documentation for pre-built tasks
- Ask it:
What skills do you have?
Connect more services:
- Link your Google Calendar
- Connect to your email
- Set up file monitoring
Advanced (when ready):
- Install additional skills from the dashboard
- Set up automation rules
- Connect multiple messaging apps
Get help:
Troubleshooting Quick Reference
| Problem | Quick Fix |
|---|---|
| Terminal closes immediately | Right-click installer → "Run as Administrator" (Windows) |
| Mac says "damaged and can't be opened" | Go to System Settings → Privacy & Security → Open Anyway |
| Can't find OpenClaw after install | Search your computer for "OpenClaw" |
| Telegram bot doesn't respond | Restart gateway: openclaw gateway restart |
| Dashboard shows "Connection refused" | Check if gateway is running: openclaw gateway status |
| Setup asks for Node.js | The installer should include it - try restarting installer |
Still stuck? The OpenClaw community is friendly to beginners:
- Discord: discord.gg/openclaw
- Reddit: r/openclaw
- Don't be shy - everyone started where you are!