Skip to content
Clawdbot Guide

SMS Setup

Overview

Section titled “Overview”

Send and receive SMS messages through Clawdbot using Twilio as the gateway.

Prerequisites

Section titled “Prerequisites”
  • Clawdbot installed
  • Twilio account with SMS number
  • Webhook-capable server (for receiving messages)

Setup

Section titled “Setup”

  1. Create Twilio Account

    • Sign up at twilio.com
    • Get a phone number with SMS capability
    • Note your Account SID and Auth Token

  2. Configure Clawdbot

    Terminal window
    SMS_ENABLED=true
    TWILIO_ACCOUNT_SID=ACxxxxx
    TWILIO_AUTH_TOKEN=xxxxx
    TWILIO_PHONE_NUMBER=+1234567890

  3. Configure Webhook

    In Twilio Console → Phone Numbers → Your Number:

    • Set Messaging webhook: https://your-server/sms/webhook

  4. Start Clawdbot

    Terminal window
    python -m clawdbot

Configuration

Section titled “Configuration”
.env
SMS_ENABLED=true
TWILIO_ACCOUNT_SID=ACxxxxx
TWILIO_AUTH_TOKEN=xxxxx
TWILIO_PHONE_NUMBER=+1234567890


# Webhook server port
SMS_WEBHOOK_PORT=5000


# Allowed numbers (empty = all)
SMS_ALLOWED_NUMBERS=+1234567890

Costs

Section titled “Costs”

SMS costs vary by country. Check Twilio pricing for rates.

Troubleshooting

Section titled “Troubleshooting”

Not receiving messages?

  • Verify webhook URL is accessible
  • Check Twilio console for errors
  • Confirm phone number is SMS-enabled

Next Steps

Section titled “Next Steps”