telegram-bot-manager

# Telegram Bot Manager

## Quick Start

### Setup a new Telegram bot

1. **Create bot via BotFather**
   - Message @BotFather on Telegram
   - Use `/newbot` command
   - Follow prompts for bot name and username
   - Copy the bot token (format: `1234567890:ABCdefGHIjklMNOpqrsTUVwxyz`)

2. **Configure in OpenClaw**
   - Add token to OpenClaw config
   - Enable Telegram plugin
   - Set up pairing mode for DM access

### Validate bot configuration

```bash
# Test Telegram API connectivity
curl -I https://api.telegram.org

# Check bot token validity
curl -s "https://api.telegram.org/bot<YOUR_TOKEN>/getMe"
```

## Common Workflows

### Troubleshooting connectivity issues

When api.telegram.org is unreachable:

1. **Check network access**
   ```bash
   curl -I -m 10 https://api.telegram.org
   ```

2. **Verify DNS resolution**
   ```bash
   nslookup api.telegram.org
   ```

3. **Test alternative endpoints**
   ```bash
   curl -I https://telegram.org
   ```

### Configuring OpenClaw Telegram integration

See [OPENCLAW_CONFIG.md](references/OPENCLAW_CONFIG.md) for detailed configuration steps.

### Bot token security

- Never commit bot tokens to version control
- Store tokens in environment variables or secure config files
- Rotate tokens if compromised
- Use different tokens for different environments (dev/prod)

## Bot Commands Reference

Common Telegram bot commands for BotFather:

- `/newbot` - Create a new bot
- `/mybots` - Manage your bots
- `/setdescription` - Set bot description
- `/setabouttext` - Set about text
- `/setuserpic` - Set bot profile picture
- `/setcommands` - Set bot commands
- `/token` - Generate new token
- `/revoke` - Revoke current token
- `/setprivacy` - Configure privacy mode

## Webhook vs Polling

### Webhook (Recommended for production)
- Bot receives updates via HTTP POST
- Requires public HTTPS endpoint
- More efficient for high-volume bots

### Polling (Good for development)
- Bot continuously checks for updates
- Simpler setup, no public e...

# Telegram Bot Manager Skill

A comprehensive skill for managing Telegram bots in OpenClaw. This skill provides tools, scripts, and documentation for setting up, configuring, and troubleshooting Telegram bot integrations.

## Features

- **Bot Setup Automation**: Scripts to automate bot configuration
- **Connectivity Testing**: Tools to test Telegram API access
- **Webhook Management**: Complete guide for webhook setup
- **Troubleshooting**: Common issues and solutions
- **Security Best Practices**: Token management and security guidelines

## Quick Start

### 1. Install the Skill

```bash
clawhub install telegram-bot-manager
```

### 2. Get Bot Token

1. Open Telegram and search for `@BotFather`
2. Send `/newbot` command
3. Follow the prompts to create your bot
4. Copy the bot token

### 3. Run Setup

```bash
python3 telegram-bot-manager/scripts/setup_bot.py
```

Or manually:

```bash
export TELEGRAM_BOT_TOKEN="your-bot-token"
python3 telegram-bot-manager/scripts/setup_bot.py
```

### 4. Test Your Bot

```bash
python3 telegram-bot-manager/scripts/test_bot.py
```

## Skill Contents

### Scripts

- **setup_bot.py**: Automated bot setup and configuration
- **test_bot.py**: Comprehensive bot testing and validation
- **package_skill.py**: Package skill for ClawHub distribution

### References

- **OPENCLAW_CONFIG.md**: Detailed OpenClaw configuration guide
- **WEBHOOK_SETUP.md**: Complete webhook setup instructions

## Usage Examples

### Basic Bot Setup

```bash
# Run the setup wizard
python3 telegram-bot-manager/scripts/setup_bot.py

# Follow the prompts to enter your bot token
# The script will configure OpenClaw automatically
```

### Testing Connectivity

```bash
# Test with environment variable
export TELEGRAM_BOT_TOKEN="1234567890:ABCdefGHIjklMNOpqrsTUVwxyz"
python3 telegram-bot-manager/scripts/test_bot.py

# Or pass token directly
python3 telegram-bot-manager/scripts/test_bot.py "1234567890:ABCdefGHIjklMNOpqrsTUVwxyz"
```

### Manual Configuration

Edit your Ope...