by @leoninnovates

The Only Guide You Need
to Set Up OpenClaw

From zero to your own AI assistant. Free. No fluff.

Get Your Custom Setup Plan โ†’

What Is OpenClaw?

Not a chatbot. Not a search engine. An AI agent that takes action. You give it goals, it delivers results, it improves. Like having your own company working for you โ€” on any computer you already have.

Credit: Alex Finn โ€” the best unbiased OpenClaw breakdown on YouTube

๐Ÿš€

From Chatbot to Employee

This isn't a search engine. You give it goals, it takes action, delivers results, and improves. It's a self-improving employee, not a glorified Google.

๐Ÿ’ฌ

Lives Where You Live

Telegram, WhatsApp, Discord โ€” text your agent like texting a friend. Say "go build me this app" and it starts building on your computer.

โšก

Works 24/7 Autonomously

It has agency. It decides what to do, monitors the web, acts without being asked. Like having your own company working for you.

๐Ÿ”“

Open Source & Customisable

Not a walled garden. Use any AI model, any tool, customise everything. It's completely open source.

Your Custom Setup Plan

Answer 4 quick questions and get a personalised install plan.

What device are you on?

This determines your install commands.

๐ŸŽMac
๐ŸชŸWindows
๐ŸงLinux
โ˜๏ธVPS

Monthly AI budget?

This determines which AI model we recommend.

๐Ÿ†“Free
๐Ÿ’ฐโ‚ฌ20โ€“50/mo
๐Ÿš€Unlimited

What do you want to connect?

Select all that apply.

โœˆ๏ธTelegram
๐Ÿ“ฑWhatsApp
๐ŸŽฎDiscord
๐Ÿ’ผSlack

What will you use it for?

Helps us tailor your setup recommendations.

๐Ÿง Personal Assistant
๐Ÿ“ŠBusiness
๐Ÿ’ปCoding
โšกAll of the Above

Step-by-Step Install

Everything you need, in order. Click to expand each step.

01 Install Node.jsโ–ผ

OpenClaw runs on Node.js. You need version 18 or higher.

Mac:

brew install node

Windows: Download from nodejs.org and run the installer.

Linux:

sudo apt install nodejs npm
โš ๏ธ If you get "command not found" for brew on Mac, install Homebrew first: brew.sh
02 Install OpenClawโ–ผ

One command. That's it.

npm install -g openclaw
โš ๏ธ Permission error on Mac/Linux? Try: sudo npm install -g openclaw
03 Run First Setupโ–ผ

Initialise your workspace and configuration:

openclaw setup

This creates your workspace directory and configuration files. Follow the prompts. You can also run openclaw onboard for a more interactive guided setup.

04 Add Your AI Model (OAuth Recommended)โ–ผ

Recommended: Anthropic Claude via OAuth. This locks your cost to a flat rate ($20โ€“$200/mo) instead of unpredictable API bills that can hit $300โ€“500/mo. Here's how:

1. Get a Claude Pro ($20/mo) or Max ($100โ€“$200/mo) plan at claude.ai/pricing

2. Install Claude Code in your terminal: npm install -g @anthropic-ai/claude-code

3. Run claude and log in โ€” select "Claude account with subscription"

4. It opens your browser โ€” click Authorize and copy the OAuth token

5. Run openclaw config โ†’ select your machine โ†’ model โ†’ Anthropic โ†’ paste your OAuth token

6. Ask your agent: "Remove any API keys while keeping my OAuth token" to clean up

Full OAuth walkthrough โ€” takes about 10 minutes

โšก Note on bans: Some people report Anthropic banning OAuth usage with third-party tools. In practice, most people aren't getting banned. If you do โ€” just make another account or switch to OpenAI. The savings are worth the small risk.

Alternative providers:

OpenAI (GPT-5): OpenAI actively encourages OAuth usage with OpenClaw. $20/mo. Smart model but doesn't finish tasks as reliably as Claude Opus โ€” gets stuck about 80% of the time on complex goals.

Budget options: Chinese models (Kimmy K2.5, MiniAX) via Open Router for ~$10/mo. Not as good, but functional.

Free: Open Router free models or Google Gemini free tier. Limited but enough to get started.

โš ๏ธ API keys can run up huge bills fast. OpenClaw is a token-heavy tool โ€” it needs tokens to think, read, plan, respond, and build. One conversation can burn through thousands of tokens. OAuth with a flat-rate plan is the move.
05 Connect Telegram (Start Here)โ–ผ

Telegram is the easiest channel โ€” connect this first, then set up everything else from within the conversation.

1. Open Telegram and search for @BotFather

2. Send /newbot and follow the prompts

3. Copy the bot token BotFather gives you

4. Paste that token into your OpenClaw agent โ€” it'll configure itself automatically

5. Message your new bot in Telegram. You're live.

โš ๏ธ Make sure you message your bot first โ€” Telegram bots can't initiate conversations.
06 Connect WhatsAppโ–ผ

WhatsApp uses a bridge connection. Setup involves scanning a QR code from your terminal.

Check the official docs for the latest WhatsApp setup guide โ€” it updates frequently.

07 Connect Discordโ–ผ

1. Go to Discord Developer Portal

2. Create a new application and bot

3. Copy the bot token

4. Invite the bot to your server with the generated OAuth2 URL

5. Add the token to your OpenClaw config

08 Send Your First Messageโ–ผ

Start the gateway:

openclaw gateway start

Open Telegram and message your bot. It should respond within seconds. You're live.

Once Telegram is working, you can set up other connections (WhatsApp, Discord) by simply asking your agent to help you connect them. It'll walk you through it.

If it doesn't respond โ€” check the terminal for error messages. Most common issue: API key or OAuth not configured correctly.

09 Make It Yoursโ–ผ

OpenClaw uses markdown files to define your AI's personality and behaviour:

SOUL.md โ€” Who your AI is. Its tone, personality, how it talks. Write this like you're describing a person.

AGENTS.md โ€” Operating rules. How it should handle memory, group chats, proactive behaviour.

USER.md โ€” Who you are. Context about you so the AI can be more helpful.

These files live in your workspace: ~/.openclaw/workspace/

๐Ÿง  Pro tip: Brain dump then reverse prompt. Dump everything about you โ€” goals, ambitions, interests, daily workflows, career info โ€” into your agent. Then ask: "Based on what you know about me, what are 10 workflows and automations you can implement for me right now?" This is the most powerful exercise in all of AI.

๐Ÿ“ Daily journals for memory: Have your agent create daily journal entries logging everything you discuss. This dramatically improves its memory over time. Just say: "Every day, create a journal entry and log anything important we discuss."

โš ๏ธ Skills safety: Don't blindly install other people's skills from ClawHub. Instead โ€” send your agent the link to a skill and say "Check this out and build your own version." That way you know it's safe. If your agent does something well, say "Turn that into a skill." If it does something poorly, say "Figure out a better way and write a skill for yourself."

Model Guide

Which AI brain should you use? Here's the honest breakdown.

Claude Sonnet 4.6

Anthropic ยท Pro Plan ($20/mo)

Best for: Great balance of smart and affordable. Default on Pro plan. Handles most tasks well.

$20/mo (Pro Plan)

GPT-5 / 5.4

OpenAI ยท $20/mo (Plus)

Best for: Arguably the smartest model available. OpenAI actively encourages OAuth usage. But โ€” it gets stuck on complex tasks ~80% of the time. You can stub its toe and it rolls over. Claude crawls across the finish line with a broken leg.

$20/mo (Plus) ยท OAuth encouraged

Chinese Models

Kimmy K2.5 / MiniAX via Open Router

Best for: Ultra-budget option. ~$10/mo. Not as good as Claude or GPT, but still lets you leverage the most powerful AI tool on Earth for almost nothing.

~$10/mo

Local Models

Ollama / LM Studio / Nvidia Neotron

Best for: The future. 100% private, free, no one can take it away. Currently needs $4K+ hardware (DGX Spark) for good performance. In ~6 months, $1-2K hardware will run Opus-level models locally.

โ‚ฌ0 (hardware cost only)

Security & Risks

Real talk. No fear-mongering, just what you need to know.

๐Ÿ”‘

API Keys = Passwords

Your API keys give access to paid AI services. Never share them, never commit them to Git, never screenshot them in public.

๐Ÿ 

Runs Locally

OpenClaw runs on your machine. Your conversations go directly to your AI provider โ€” not through a middleman's server.

๐Ÿ“ก

What Data Goes Where

Messages โ†’ your machine โ†’ AI provider (Anthropic/OpenAI/Google). That's it. No OpenClaw server in between.

โš™๏ธ

Tool Permissions

OpenClaw can run commands on your machine. Review what tools you enable. Start conservative, expand as you get comfortable.

๐Ÿ–ฅ๏ธ

Local vs VPS

Local: Your laptop. Easy but turns off when you close it. VPS: Always-on server. Runs 24/7 but needs basic server security (SSH keys, firewall).

๐Ÿง 

Be Careful What You Prompt

This is the #1 thing. Personal accountability. OpenClaw only does what you ask it to do. It won't randomly leak your photos on Facebook or tweet your passwords โ€” unless you tell it something that implies it should. Before every prompt, think: could this cause something I don't want? That's literally the whole security model. The vast majority of the millions of people using OpenClaw have never had a single security issue. Be mindful. That's it.

๐Ÿ›ก๏ธ

My Setup

I run OpenClaw on my local Mac with Anthropic Claude Opus 4.6. Telegram as primary channel. Conservative tool permissions. OAuth integration for Claude.

Resources

Everything else you might need.

๐Ÿ“–Official Docs ๐Ÿ™GitHub ๐Ÿ’ฌDiscord Community ๐ŸงฉClawHub (Skills)

๐Ÿ“บ Recommended Videos

๐Ÿ”ง Something Broken?

Don't panic. OpenClaw is just a folder on your computer with markdown files. Here's how to fix 100% of issues:

Open Claude Code or Codex in your OpenClaw folder and say:

My OpenClaw isn't working. Please go in and see why.

The AI agent goes through your config files and finds the issue. 99% of the time it's a config issue from someone editing files manually. This fixes it every time.