Clawdbot Complete Setup

Complete guide for installing and configuring Clawdbot, a personal AI assistant that runs 24/7 and integrates with messaging channels, Gmail, and browser automation.

Prerequisites

• Node.js ≥22 installed
• npm, pnpm, or bun package manager
• macOS, Linux, or Windows (WSL2 recommended)
• Telegram account (for bot setup)
• Google account (for Gmail integration, optional)
• Composio API key (for Gmail, optional)

Phase 1: Core Installation

Install Clawdbot

npm install -g clawdbot@latest
# or: pnpm add -g clawdbot@latest

Initialize Configuration

clawdbot setup

This creates:

• Config: ~/.clawdbot/clawdbot.json
• Workspace: ~/clawd
• Sessions directory

Configure Gateway

clawdbot config set gateway.mode local
clawdbot config set gateway.bind loopback
clawdbot config set gateway.port 18789

Install Gateway Daemon

clawdbot onboard --install-daemon --non-interactive --accept-risk

This installs the gateway as a background service (LaunchAgent on macOS, systemd on Linux).

Phase 2: Model Configuration

Option A: Google Gemini (Recommended for Cost)

# Set primary model
clawdbot config set agents.defaults.model.primary "google/gemini-3-pro-preview"

# Configure model aliases
clawdbot config set agents.defaults.models."google/gemini-3-pro-preview".alias "gemini"
clawdbot config set agents.defaults.models."google/gemini-3-flash-preview".alias "gemini-flash"

# Add API key
clawdbot config set env.GEMINI_API_KEY "YOUR_GEMINI_API_KEY"

Get API key: https://aistudio.google.com/apikey

Option B: Anthropic Claude

clawdbot config set agents.defaults.model.primary "anthropic/claude-opus-4-5"
# Then configure credentials:
clawdbot models configure

Get API key: https://console.anthropic.com/

Verify Model

clawdbot models list
clawdbot agent --message "Hello" --agent main

Phase 3: Telegram Bot Setup

Create Telegram Bot

1. Open Telegram, search @BotFather
2. Send /newbot
3. Name your bot (e.g., "MyAssistant")
4. Choose username ending in "bot" (e.g., "myassistant_bot")
5. Copy the bot token

Get Your User ID

1. Search @userinfobot or @useridbot on Telegram
2. Start the bot
3. Copy your user ID (numeric)

Configure Telegram Channel

# Add Telegram channel
clawdbot channels add --channel telegram --token "YOUR_BOT_TOKEN"

# Set security (restrict to your user ID)
clawdbot config set channels.telegram.allowFrom '["YOUR_USER_ID"]'
clawdbot config set channels.telegram.dmPolicy "pairing"

Approve Pairing (if needed)

When you first message the bot, you'll get a pairing code. Approve it:

clawdbot pairing approve telegram PAIRING_CODE

Verify Telegram

clawdbot channels status
clawdbot health

Should show: Telegram: ok (@your_bot_name)

Phase 4: Gmail Integration (Composio)

Install Composio SDK

pip3 install composio

Setup Gmail Connection

1. Get Composio API key from https://platform.composio.dev/
2. Connect Gmail account on Composio dashboard
3. Note the connected account ID (starts with ca_)

Create MCP Server

from composio import Composio

composio = Composio(api_key="YOUR_COMPOSIO_API_KEY")

# Create MCP server for Gmail
mcp_server = composio.mcp.create(
    name="clawdbot-gmail-server",
    toolkits=[{"toolkit": "gmail"}],
    allowed_tools=[
        "GMAIL_FETCH_EMAILS",
        "GMAIL_SEND_EMAIL",
        "GMAIL_CREATE_DRAFT",
        "GMAIL_LIST_LABELS",
        "GMAIL_GET_EMAIL"
    ]
)

# Generate user URL
mcp_instance = composio.mcp.generate(
    user_id="clawdbot-user",
    mcp_config_id=mcp_server.id
)

Add Composio to Clawdbot Config

clawdbot config set env.COMPOSIO_API_KEY "YOUR_COMPOSIO_API_KEY"

Alternative: Using gog CLI

# Install gog
brew install steipete/tap/gogcli

# Authorize Gmail
gog auth credentials /path/to/client_secret.json
gog auth add your-email@gmail.com --services gmail

Phase 5: Browser Extension Setup

Install Extension

clawdbot browser extension install

This installs to: ~/.clawdbot/browser/chrome-extension

Load in Chrome

1. Open Chrome → chrome://extensions
2. Enable "Developer mode" (top right)
3. Click "Load unpacked"
4. Select: ~/.clawdbot/browser/chrome-extension
5. Pin the extension to toolbar

Use Extension

1. Open the tab you want to control (e.g., Gmail)
2. Click the Clawdbot extension icon
3. Badge shows "ON" when attached
4. Bot can now control that tab

Browser Status

clawdbot browser status

Should show:

• profile: chrome
• enabled: true
• controlUrl: http://127.0.0.1:18791
• cdpUrl: http://127.0.0.1:18792

Phase 6: Verification & Testing

Check System Status

clawdbot status
clawdbot health
clawdbot doctor

Test Telegram Bot

Message your bot on Telegram:

• "Hello, are you working?"
• "check my last

...