🇨🇳 中文

ClawdBot Setup Guide: Build Your Personal AI Assistant in 30 Minutes

Learn how to set up ClawdBot, an open-source AI agent that runs 24/7 on your computer. This step-by-step guide covers installation, Telegram integration, and automating emails, scheduling, and reminders.

Bruce

ClawdBotAI AgentAI AssistantOpen SourceAutomationAnthropicClaude

AI Guides

2030  Words

2026-01-25


ClawdBot personal AI assistant setup guide

What If You Had a 24/7 AI Assistant?

Picture this scenario:

While you are still asleep, your AI assistant has already finished these tasks:

  • Sorted through the 50 emails that came in overnight, flagging only 3 that need your personal reply
  • Booked your flight for next week’s business trip and completed online check-in
  • Summarized updates from all the newsletters you follow into a single morning briefing

When you wake up and check your phone, your AI assistant sends you a message: “Good morning! You have an important meeting at 3 PM today. I have prepared the meeting materials for you.”

This is not science fiction. This is what ClawdBot is already doing for thousands of users. By the end of this guide, you will have your own AI assistant up and running in about 30 minutes.


What Is ClawdBot?

The Short Version

ClawdBot is an open-source AI agent that runs 24/7 on your own computer, handling tasks like email management, scheduling, and reminders through messaging apps like Telegram and WhatsApp. Built by Austrian engineer Peter Steinberger, it has earned 9,000+ GitHub stars as of January 2026.

How It Actually Works

ClawdBot is an AI agent that lives on your machine. Think of it as an extremely capable digital employee:

  • It has eyes – it can browse websites and read files
  • It has hands – it can operate your computer, click buttons, and fill out forms
  • It has memory – it remembers everything you have told it
  • It never sleeps – it is available around the clock

ClawdBot vs. ChatGPT

FeatureChatGPTClawdBot
CapabilitiesConversation and advice onlyConversation plus task execution
MemoryForgets after the session endsRemembers everything permanently
AccessWeb interface onlyTelegram, WhatsApp, Discord, Slack, iMessage
Data ownershipRuns on third-party serversRuns on your own machine, data stays local

In short: ChatGPT is an advisor that gives suggestions. ClawdBot is an assistant that gets things done.

ClawdBot vs. Claude Code

If you have heard of Claude Code, you might wonder how it compares. They are both powered by Claude but serve very different purposes:

FeatureClaude CodeClawdBot
PublisherAnthropic (official)Community open-source project
Target usersSoftware developersEveryone
Primary useCoding, debugging, refactoringEmail, scheduling, research, reminders
InterfaceTerminal / command lineMobile messaging apps
RuntimeOn-demand, start and stop24/7 background service
MemoryCurrent session onlyPersistent, learns over time

A simple analogy:

  • Claude Code = a programmer sitting next to you, helping you write code
  • ClawdBot = a personal secretary, on call 24/7 to handle everything else

If you are a developer, you can use both – Claude Code for coding, ClawdBot for life management. If you are not a developer, ClawdBot is the one for you.

Who Built It?

ClawdBot is an open-source project created by Austrian engineer Peter Steinberger and an active community of contributors. The project is hosted on GitHub with 9,000+ stars as of January 2026.

“Open source” means the code is completely public. You can use it for free, inspect it, and modify it however you like.


What Can ClawdBot Do? Real-World Examples

Email Management

You say: “Check my inbox, unsubscribe from all promotional emails, and give me a list of the important ones.”

ClawdBot does:

  1. Opens your Gmail
  2. Scans through every email
  3. Promotional email? Clicks the unsubscribe button
  4. Important email? Adds it to the list
  5. Sends you a summary: “Here are 5 emails that need your attention”

Restaurant Reservations

You say: “Book a table for 4 at the Italian place downtown tomorrow at 7 PM.”

ClawdBot does:

  1. Opens the restaurant’s booking page
  2. Selects tomorrow evening, 7 PM, party of 4
  3. Fills in your contact details
  4. Submits the reservation
  5. Reports back: “Done! Confirmation sent to your phone”

Research Tasks

You say: “Research the latest trending AI tools and put together a report for me.”

ClawdBot does:

  1. Opens various tech websites and publications
  2. Searches for the latest AI tool news
  3. Reads articles and extracts key points
  4. Organizes everything into a clear report
  5. Saves it to your computer

Schedule Management

You say: “Remind me in 3 days to call John about the partnership deal.”

ClawdBot does:

  1. Records the reminder
  2. Three days later, proactively messages you: “Hey! Do not forget to call John today about the partnership deal.”

Smart Home Control

You say: “The forecast says it will get cold tonight. Turn on the heater at home.”

ClawdBot does:

  1. Checks the weather forecast
  2. Connects to your smart home system
  3. Adjusts the thermostat
  4. Confirms: “Heater is on. Your home will be warm when you arrive”

How ClawdBot Works Under the Hood

Here is a simplified diagram of the architecture:

┌─────────────┐    Send message   ┌─────────────┐
│             │ ─────────────────→│             │
│  Your Phone │                   │  ClawdBot   │
│ (Telegram)  │ ←─────────────────│ (Your Mac)  │
│             │   Return results  │             │
└─────────────┘                   └──────┬──────┘
                                         │ Calls AI brain
                                  ┌─────────────┐
                                  │   Claude    │
                                  │  (AI brain) │
                                  └─────────────┘

The flow is straightforward:

  1. You send a message via your phone (Telegram, WhatsApp, etc.)
  2. ClawdBot receives it and sends it to the AI brain (Claude) for reasoning
  3. Claude decides what actions to take, and ClawdBot executes them on your computer
  4. ClawdBot reports the results back to you through your messaging app

This type of AI – one that can reason autonomously and execute actions – is called an AI agent. It represents one of the most important trends in AI development.


Prerequisites

Before starting the installation, you need a few things:

A Computer That Stays On

ClawdBot needs to run 24/7, so you need a machine that can stay powered on.

OptionProsConsBest for
Mac MiniLow power, stable, compactUpfront costUsers with budget
Old spare computerFreeHigher power consumptionUsers with spare hardware
Cloud server (VPS)No hardware to manageMonthly feesCloud-savvy users
NASAlready runs 24/7Setup can be trickyUsers who own a NAS

An AI API Key

ClawdBot needs an AI model to think with. Claude is recommended for the best results.

How to get one:

  1. Sign up at console.anthropic.com
  2. Add a payment method
  3. Generate an API key

Cost: Approximately $20-100/month depending on usage.

A Messaging App

You need a channel to communicate with ClawdBot.

Supported platforms:

  • Telegram (recommended – easiest to set up)
  • WhatsApp
  • Discord
  • Slack
  • iMessage (Mac only)

Step-by-Step Installation Guide

This walkthrough uses Mac + Telegram as the example setup.

Step 1: Open Terminal

  1. Press Command + Space on your Mac
  2. Type “Terminal”
  3. Press Enter to open the Terminal app

You will see a window with a blinking cursor. This is where you will type commands.

If you want to learn more about terminal tools, check out our terminal tools guide.

Step 2: Install ClawdBot

Copy and paste this command into Terminal, then press Enter:

curl -fsSL https://clawd.bot/install.sh | bash

What this does:

  • Downloads the installation script from the ClawdBot website
  • Automatically installs ClawdBot on your machine

Wait 1-2 minutes. Once installation completes, the setup wizard will launch automatically.

Step 3: Configuration Wizard

The wizard will walk you through the setup:

Select language

  • Choose “English”

Select AI model

  • Choose “Anthropic” (Claude)

Enter API key

  • Paste your Claude API key from the prerequisites step

Select messaging channel

  • Choose “Telegram bot”

Step 4: Create a Telegram Bot

Next, you need to create a bot on Telegram.

Open Telegram and search for @BotFather

BotFather is Telegram’s official tool for creating bots.

Send the /newbot command

BotFather will ask you a few questions:

  • Q: What name do you want for your bot?

  • A: Anything you like, e.g., “My AI Assistant”

  • Q: Choose a username for your bot (must end with “bot”)

  • A: Something like “myai_helper_bot”

Copy the bot token

After creation, BotFather will give you a long string like this:

7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

This is your bot token. Copy it.

Search for @userinfobot on Telegram

Send it any message, and it will reply with your user ID – a number like 123456789.

Return to Terminal and enter these values

Paste the bot token and user ID into the setup wizard.

Step 5: Start ClawdBot

Once configuration is complete, run:

clawdbot start

You should see output like:

✓ ClawdBot is running
✓ Connected to Telegram
✓ Ready to receive messages

Congratulations! Your AI assistant is now live.

Step 6: Send Your First Message

Open Telegram, find your newly created bot, and send your first message:

Hello!

If everything is working, it will reply.


3 Commands Every New User Should Try

After installation, try these three things to experience what ClawdBot can do:

Introduce Yourself

My name is Alex. I work as a product manager in San Francisco.
I like coffee and start work at 9 AM every day.
Please call me "boss" from now on.

ClawdBot will remember all of this and use it to personalize future interactions.

Give It a Simple Task

Search for "best AI tools in 2025" and
organize the results into a list for me.

Watch how it breaks down the task and delivers results.

Set a Reminder

Remind me to drink water tomorrow at 9 AM.

The next morning at 9 AM, ClawdBot will proactively send you a message.


Advanced Features

Once you are comfortable with the basics, explore these power-user capabilities:

Connect More Tools

ClawdBot supports 50+ tool integrations:

  • Gmail – email management
  • Google Calendar – schedule management
  • GitHub – repository management
  • Spotify – music control
  • Smart home devices – lights, thermostat, and more

Teach It New Skills

ClawdBot can learn custom skills, similar to the Claude Code Skill system:

I want to teach you a new skill:
Every morning at 8 AM, check the weather forecast.
If rain is expected, remind me to bring an umbrella.

It will remember this skill and run it automatically every day.

Run Multiple Assistants

You can run multiple ClawdBot instances, each specialized for a different domain:

  • One for email management
  • One for research
  • One for scheduling

Frequently Asked Questions

How Much Does It Cost?

Total: approximately $20-150/month. The software itself is free – the main cost is the AI API.

ItemCost
ClawdBot softwareFree (open source)
Computer / server$0-50/month depending on your setup
Claude API~$20-100/month
Total~$20-150/month

Is My Data Secure?

Yes. ClawdBot runs entirely on your own machine. All data stays local and is never uploaded to third-party servers.

Do I Need to Know How to Code?

No. The entire setup process involves copying and pasting a few commands. No programming knowledge is required.

Does It Support Multiple Languages?

Yes. You can chat with ClawdBot in any language that Claude supports, including English, Chinese, Japanese, Spanish, and many more.

What Happens If My Computer Shuts Down?

ClawdBot requires your machine to be running. If you shut down, the assistant goes offline. This is why a dedicated always-on device (like a Mac Mini or a VPS) is recommended.


Important Considerations

Keep these points in mind when using ClawdBot:

  1. Monitor costs: AI API usage is billed per request. Set a monthly spending cap to avoid surprises
  2. Be security-conscious: Since ClawdBot can operate your computer, avoid giving it access to sensitive operations
  3. Protect privacy: Although data stays local, be mindful of what personal information you share with any AI system

Summary

ClawdBot is a true AI agent that goes beyond conversation to actually get things done:

  • Always on – runs 24/7, never needs a break
  • Persistent memory – remembers everything you tell it
  • Action-oriented – does not just advise, it executes
  • Fully private – runs on your hardware, your data stays yours
  • Free and open source – no software license fees, just API costs

If you have ever wanted to experience what having a personal AI assistant feels like, ClawdBot is an excellent place to start.



Further Reading


Last updated: January 2026 | Based on the latest version of ClawdBot

Comments

Join the discussion — requires a GitHub account