How to Install OpenClaw and Connect Telegram: Step-by-Step Beginner Guide

This is Day 2 of the OpenClaw Bootcamp — a 16-day series where you build a real AI agent from scratch. By the end of today, you will have a fully working AI agent running on your machine that you can message from your phone through Telegram.

I recorded a full video walkthrough for this session. If you prefer watching, here it is:

What You Are Building Today

By the end of this session, you will have four things:

• A fully installed OpenClaw agent running locally on your machine
• A live AI system connected to a real language model
• A Telegram bot and personal account connected to your agent
• Your first real back-and-forth conversation with your AI employee

This is not a simulation or a demo. This is a real system you own and control.

Step 1: Install Node.js

Node.js is the only prerequisite. OpenClaw runs on Node, so you need it installed before anything else. Head to the official Node.js website and install the LTS (Long Term Support) version. It takes two minutes.

You can verify the installation by opening a terminal and running node --version. If you see a version number, you are good to go.

Step 2: Run the OpenClaw Installer

OpenClaw ships with an installer and an onboarding wizard that walks you through the initial configuration. The wizard handles your model provider selection, API key setup, and workspace creation. Follow the prompts — it is designed to get you to a working state with minimal friction.

During the onboarding, you will choose your AI model provider (Anthropic, OpenAI, etc.) and enter your API key. This is the model your agent will use for thinking and responding. If you are unsure which to pick, start with whichever provider you already have an API key for.

Step 3: Start the Gateway and Open the Dashboard

Once installation is complete, start the OpenClaw gateway. This is the core process that keeps your agent running and handles all communication between your agent and the outside world. The dashboard gives you a web-based view of your agent's status, conversations, and configuration.

Send a test message through the dashboard to confirm everything is connected. If your agent responds, your system is live.

Step 4: Understand the Workspace

Before connecting Telegram, take a minute to understand your workspace files. OpenClaw creates a directory structure that contains your agent's configuration, memory, and personality files. The key file is your config — this is where model settings, channel configurations, and tool access are defined.

Understanding this structure early saves you hours of confusion later. Everything your agent knows, does, and connects to flows through these files.

Step 5: Connect Telegram

Telegram is the best starting channel for OpenClaw because it is free, fast, and supports both bot and personal account connections. You will set up two things:

• A Telegram Bot — created through BotFather, this gives your agent a dedicated bot account that anyone with the link can message.
• Personal Account Pairing — this connects your agent to your own Telegram account so you can message it directly in a private chat, just like texting a friend.

The combination of both gives you maximum flexibility. Use the bot for public-facing interactions and the personal pairing for your own private access.

Common Setup Errors and Fixes

The most common issues people hit during installation are:

• Wrong Node version — make sure you are on the LTS version, not an older one.
• API key issues — double-check your key is active and has the right permissions in your provider's dashboard.
• Telegram bot token errors — make sure you copy the full token from BotFather, including the colon and everything after it.
• Port conflicts — if the gateway fails to start, check that nothing else is running on the same port.

Security Habits to Build Now

Your agent has access to real APIs and real accounts. Build these habits from day one:

• Never share your API keys or bot tokens publicly
• Use environment variables instead of hardcoding secrets in config files
• Set up allowlists so only approved users can interact with your agent
• Review your agent's actions regularly through the dashboard

What You Have Now

At this point, you have a real AI agent running on your machine. You can message it from your phone. It responds with intelligence. And you fully own and control the entire system. This is the foundation everything else builds on.

In Day 3, we will dive into model selection — comparing cloud vs local models, understanding the tradeoffs, and connecting a fully local model so your agent can run for free on your own hardware.

Need help with your OpenClaw setup? My team at OpenClaw Consult is the #1 ranked consulting team for OpenClaw — we handle setup, troubleshooting, and custom agent builds.