OpenClaw Setup: From Zero to Running in 30 Minutes

This guide walks you through installing and configuring OpenClaw from scratch. By the end, you’ll have a working AI agent you can talk to via Telegram. No coding experience needed — just follow each step carefully.

What You’ll Need Before Starting

• A computer running Windows, macOS, or Linux (or a cloud server — more on that below)
• An internet connection
• An Anthropic API key (free to create, pay-as-you-go usage)
• A Telegram account (free)
• About 30 minutes

Step 1: Install Node.js

OpenClaw runs on Node.js, a free software platform. If you don’t have it installed:

1. Go to nodejs.org
2. Download the LTS (Long Term Support) version for your operating system
3. Run the installer and follow the on-screen instructions
4. Verify the install by opening a terminal and typing: node --version

You should see a version number like v20.x.x or higher. If you do, you’re good to go.

Step 2: Install OpenClaw

Open your terminal (Terminal on Mac/Linux, PowerShell or Command Prompt on Windows) and run:

npm install -g openclaw

This installs OpenClaw globally on your system, making the openclaw command available anywhere. The download takes 1–3 minutes depending on your connection speed.

Verify the install worked:

openclaw --version

Step 3: Get an Anthropic API Key

OpenClaw uses Claude (by Anthropic) as its AI brain by default. Here’s how to get your API key:

1. Go to console.anthropic.com and create a free account
2. Once logged in, navigate to API Keys in the left sidebar
3. Click Create Key, give it a name like “OpenClaw”, and copy the key
4. Add a payment method (you won’t be charged unless you use it — it’s pay-as-you-go)

Tip: Keep your API key private. Don’t share it or commit it to a public GitHub repo.

Step 4: Initialize OpenClaw

In your terminal, run:

openclaw init

This launches an interactive setup wizard. You’ll be asked:

• Where to create your workspace folder (the default is usually fine)
• Your Anthropic API key (paste it in here)
• Which AI model to use (Claude Sonnet is the default — good balance of speed and quality)

The wizard creates a workspace folder with starter files including SOUL.md (your agent’s personality), USER.md (info about you), and memory files.

Step 5: Set Up Your Telegram Bot

Telegram is the recommended way to chat with your OpenClaw agent. Here’s how to create a bot:

1. Open Telegram and search for @BotFather
2. Send the command: /newbot
3. Follow the prompts: choose a name and a username for your bot (username must end in “bot”)
4. BotFather will give you a bot token — copy it

Now connect it to OpenClaw:

openclaw plugin install telegram

Follow the prompts to enter your bot token. Once configured, your agent will be reachable through your Telegram bot.

Step 6: Start OpenClaw

Launch your agent with:

openclaw start

You should see output indicating the agent is running and connected. Open Telegram, find your bot, and send it a message — something simple like “Hello!” Your agent should respond within a few seconds.

Step 7: Customize Your Agent

Now it’s time to make the agent yours. Open your workspace folder and edit these files:

SOUL.md

This file defines your agent’s personality and behavior. You can tell it to be more formal or casual, give it a name, or define how it should handle certain situations. Edit it in any text editor.

USER.md

Tell your agent about yourself — your name, timezone, preferences, and what you’re working on. The more context you give it, the more helpful it becomes.

AGENTS.md

This file contains operational instructions for your agent — like startup routines, memory guidelines, and how to handle heartbeats.

Optional: Run on a Cloud Server for 24/7 Access

Running OpenClaw on your laptop means it goes offline when you close it. For a truly always-on assistant, consider a cloud VPS:

• DigitalOcean — $4/month Droplet; easy setup, great docs
• Vultr — From $2.50/month; fast global network, competitive pricing

Both platforms offer one-click Ubuntu servers that work perfectly for hosting OpenClaw. See our full Best Hosting for OpenClaw guide for a detailed comparison.

Troubleshooting Common Issues

“openclaw: command not found”

This usually means npm’s global bin directory isn’t in your PATH. Try running npm install -g openclaw again, or check if npm’s bin path is configured correctly for your shell.

Telegram Bot Not Responding

Make sure your OpenClaw process is still running in the terminal. If you closed the terminal, the agent stopped. Use a terminal multiplexer like tmux or run OpenClaw as a background service.

API Key Errors

Double-check the key was entered correctly — no extra spaces. Make sure your Anthropic account has billing set up (even if your usage is within the free tier).

You’re Up and Running!

Congratulations — your OpenClaw agent is live. Here’s what to explore next:

• OpenClaw Commands Reference — all the slash commands and controls
• Installing Skills — add new capabilities to your agent
• Advanced Telegram Setup — groups, notifications, and more

OpenClaw Complete Beginner’s Guide 2026

If you’ve been hearing buzz about AI agents and wondering what OpenClaw actually is — you’re in the right place. This guide covers everything you need to know as a complete beginner: what OpenClaw does, why it’s different from other AI tools, and how to get started without any technical background.

What Is OpenClaw?

OpenClaw is an AI agent platform — think of it as a personal AI assistant that lives on your computer or server and works for you around the clock. Unlike ChatGPT, which you type questions into and get answers from, OpenClaw is designed to do things: send messages, check your email, browse the web, run code, manage files, and connect to dozens of services on your behalf.

The key difference is autonomy. Instead of answering one question at a time, OpenClaw can handle multi-step tasks, remember context across conversations, and even reach out to you proactively when something needs your attention.

Why Use an AI Agent Instead of a Chatbot?

Chatbots are great for quick answers. AI agents are great for actually getting things done. Here’s a simple comparison:

• ChatGPT: “Tell me how to write a follow-up email.” You still have to write and send it yourself.
• OpenClaw: Drafts the follow-up, checks your calendar for availability, and sends the email — all in one go.

OpenClaw is built for people who want an assistant that takes initiative, not just one that answers questions.

Who Is OpenClaw For?

OpenClaw is a great fit for:

• Freelancers and solopreneurs who want to automate repetitive tasks
• Small business owners who need help managing communications and workflows
• Developers and hobbyists who want to build custom automations
• Anyone curious about AI agents and wanting to explore what they can do

You don’t need to know how to code to use OpenClaw. Most tasks can be set up with plain English instructions.

How OpenClaw Works: The Basics

At its core, OpenClaw is software you install on a computer — your own laptop, desktop, or a cloud server. Once installed, it connects to an AI model (like Claude from Anthropic) and gives that AI the ability to use tools: browsing the web, reading and writing files, sending messages, running commands, and more.

You interact with OpenClaw through a chat interface — most commonly Telegram. You send it a message like “Check if I have any unread emails from clients” and it goes off, does the work, and reports back to you.

Key Concepts

• Agent: The AI brain running inside OpenClaw that thinks, plans, and acts
• Skills: Add-on modules that give your agent new abilities (like weather checking or web scraping)
• Channels: How you communicate with your agent — Telegram is the most popular
• Workspace: A folder on your computer where your agent stores its memory and files
• Heartbeats: Scheduled check-ins where your agent proactively reviews tasks without you asking

What Can OpenClaw Actually Do?

Here’s a taste of what OpenClaw can handle out of the box:

• Send and receive Telegram messages on your behalf
• Browse the web and summarize articles or research topics
• Read, create, and edit files on your computer
• Run shell commands and scripts
• Check weather forecasts
• Manage a to-do list or personal knowledge base
• Post to social media (with the right setup)
• Monitor websites for changes
• Answer questions using long-term memory of your preferences

With Skills installed, that list grows considerably. Think of Skills like apps on a smartphone — each one adds new capabilities.

Where Does OpenClaw Run?

You have two main options:

Option 1: Run It on Your Own Computer

The simplest way to start. Install OpenClaw on your Windows, Mac, or Linux machine and it runs as a background service. The downside: it only works when your computer is on and connected to the internet.

Option 2: Run It on a Cloud Server (Recommended for 24/7 Use)

For a truly always-on assistant, most users eventually move to a VPS (Virtual Private Server). A small cloud server from DigitalOcean or Vultr costs as little as $4–$6/month and keeps your agent running around the clock — even when your laptop is closed.

Getting Started: Your First Steps

1. Install Node.js — OpenClaw runs on Node.js, a free runtime available at nodejs.org
2. Install OpenClaw — Run npm install -g openclaw in your terminal
3. Get an API key — OpenClaw works with Claude (Anthropic) by default; sign up at console.anthropic.com
4. Run the setup wizard — Type openclaw init and follow the prompts
5. Connect Telegram — Set up a bot via BotFather and link it to OpenClaw for easy mobile access

For a step-by-step walkthrough of the full installation, check out our OpenClaw Setup Guide.

Is OpenClaw Free?

OpenClaw itself is open-source and free to install. However, it requires an AI model to power the agent — and that typically costs money based on usage. Anthropic’s Claude API charges per token (roughly per word processed). For light personal use, costs are typically a few dollars per month. Heavy business use might run $10–30/month.

Is OpenClaw Safe?

Since OpenClaw runs on your own machine (or your own server), you control your data. Unlike cloud-based AI tools where your conversations are stored on someone else’s servers, OpenClaw keeps everything local. Your workspace files, memories, and conversation logs stay on your hardware.

That said, use good judgment about what you give your agent access to. Start with limited permissions and expand as you get comfortable.

Next Steps

Now that you understand what OpenClaw is and what it can do, it’s time to get hands-on. Here’s where to go next:

• OpenClaw Setup Guide: From Zero to Running in 30 Minutes
• How to Connect OpenClaw to Telegram
• OpenClaw Skills: How to Install and Use Them
• OpenClaw Commands: The Complete Reference

OpenClaw has a learning curve, but it pays off fast. Once your agent is running and tuned to your workflow, it genuinely feels like having a capable assistant who knows your habits and never sleeps.