How to Set Up Clawdbot on Your Machine: A Beginner’s Guide

Step-by-step for installing and configuring

So, you’ve heard the hype, seen the lobster emojis on Twitter, and decided you want your own personal “Jarvis.” Maybe you’ve even bought a Mac Mini specifically for this purpose.

Setting up Clawdbot (now frequently referred to as OpenClaw) is a rite of passage for the modern developer. It’s not as simple as downloading an app from the App Store, but it’s also not as scary as building a kernel from scratch. Think of it like setting up a high-end coffee station: it takes a bit of assembly and a few specialized parts, but once it’s running, you’ll wonder how you lived without it.

This guide will walk you through the process of getting Clawdbot live on your machine, from the first terminal command to your first chat on Telegram.

1. The Pre-Flight Checklist

Before we touch the terminal, we need to make sure your “hardware” and “software” are ready. Clawdbot is a long-running process, so where you put it matters.

• The Machine: You can run this on your main laptop (Mac, Windows with WSL2, or Linux). However, because Clawdbot is meant to be an “always-on” assistant, most people prefer a dedicated machine like an old laptop or a Mac Mini that stays plugged in.
• The Runtime: You need Node.js 22 or higher. If you have an older version, the bot simply won’t wake up. You can check your version by typing node -v in your terminal.
• The Brain (API Keys): Clawdbot is the body; it needs a brain to think. You’ll need an API key from a provider. The most common choice is Anthropic (Claude), but it also supports OpenAI and Google Gemini.
• The Voice (Messaging App): You need a way to talk to the bot. Most beginners start with Telegram because it’s the easiest to set up, but Discord and WhatsApp are also options.

2. The One-Line Install

The creators of OpenClaw have made the initial installation remarkably smooth. They provide a script that handles the heavy lifting detecting your OS, checking dependencies, and pulling the latest code.

Open your terminal and paste this command:

curl -fsSL https://openclaw.ai/install.sh | bash

What is this doing?

It’s reaching out to the official OpenClaw server, grabbing the installation script, and running it. If you’re on a Mac, it might ask for your password to install system-level tools. Once it finishes, it will launch the Interactive Onboarding Wizard. This is where the real setup begins.

3. Navigating the Onboarding Wizard

Once the script finishes, your terminal will transform into a colorful menu. Use your arrow keys and the spacebar to make selections.

Choosing Your Mode

You’ll be asked to choose between QuickStart and Manual.

• Pick QuickStart. It configures safe defaults for you. You can always go back and tweak the advanced settings later once you know the bot is working.

Connecting the Brain (The LLM)

Next, the bot will ask who its provider should be.

1. Select Anthropic or Google. (Note: Anthropic’s Claude 3.5 Sonnet is currently the community favorite for this bot because of its high “agentic” reasoning).
2. Paste your API Key. If you chose Anthropic, go to the Anthropic Console, generate a key, and paste it here.
3. Choose a model. If you’re worried about costs, choose a “Faster” or “Flash” model. If you want the most power, choose the “Strongest” option.

Setting Up the Voice (Telegram)

This is the part that feels like magic. The wizard will ask how you want to chat.

1. Select Telegram.
2. The wizard will tell you to find @BotFather on Telegram. This is the official Telegram account for making bots.
3. In your chat with BotFather, type /newbot. Give it a name (like “MyClawdbot”) and a username.
4. BotFather will give you a Token (a long string of letters and numbers). Copy that and paste it back into your terminal.

4. Giving the Bot “Hands” (Skills)

After the chat is linked, Clawdbot will ask if you want to install Skills.

Think of Skills as the bot’s ability to interact with the world. By default, it can see your files and run terminal commands. But if you want it to check your calendar, manage your Gmail, or search the web, you need to enable those specific modules.

• For your first time, I recommend skipping extra skills or just choosing “Web Search.”
• You can add skills later by simply telling the bot: “Install the Gmail skill” once it’s up and running.

5. The “Always-On” Secret: The Daemon

If you close your terminal window right now, the bot will die. To make it a true 24/7 assistant, you need to install it as a Daemon (a background service).

In the wizard, it will ask: “Would you like to install the gateway as a background service?”

Select Yes. This ensures that if your computer restarts or the app crashes, Clawdbot will automatically pick itself up and start running again without you doing anything.

6. Testing the Connection

Now for the moment of truth. Open Telegram on your phone or desktop and find the bot you just created with BotFather.

Send it a simple message:

“Hello! What files can you see right now?”

The bot should respond, listing the files in its “workspace” (usually a folder it created during setup). If it replies, congratulations you have a live AI agent running on your hardware.

7. Safety First: The “Digital Cage”

Before you go off and give your bot the keys to your entire digital life, we need to talk about security. Since Clawdbot can run terminal commands, you should be careful about what you let it do.

• Use a Dedicated Folder: By default, Clawdbot only looks at a specific “workspace” folder. Don’t point it at your entire hard drive unless you really trust the model.
• The “Human-in-the-Loop” Rule: You can configure Clawdbot to ask for permission before running any “destructive” commands (like deleting files). I highly recommend keeping this on.
• Use a Separate Account: Many power users create a separate, “burner” Google account for their bot. That way, if the bot makes a mistake, it only affects the bot’s email and calendar, not your primary ones.

8. Common Troubleshooting

If things aren’t working, don’t panic. Here are the three most common fixes:

1. “0 Tokens Used” Error: This usually means your API key is wrong or you’ve run out of credits on Anthropic/OpenAI. Double-check your billing dashboard.
2. The Bot isn’t responding on Telegram: Run the command openclaw doctor in your terminal. This is a built-in diagnostic tool that checks if the “Gateway” (the middleman) is actually running.
3. Permission Denied: If the bot can’t read your files, you may need to grant your Terminal “Full Disk Access” in your Mac/Windows system settings.

Conclusion

Setting up Clawdbot is the first step toward a new way of working. You’ve moved away from the “Chat” era of AI and into the “Agent” era. You now have a system that doesn’t just answer questions, but performs tasks while you sleep. Start small ask it to organize a folder of messy screenshots or summarize your morning emails and as you get more comfortable, start adding the more complex skills.