Skip to content
telegram-bot-manager logo

Telegram Bot Manager

telegram-bot-manager

Manage and configure Telegram bots for OpenClaw. Use when setting up Telegram integrations, troubleshooting bot connectivity, configuring bot tokens, or managing Telegram channel/webhook settings. Handles bot registration, token validation, and network connectivity checks for api.telegram.org.

simplefarmer69/ape-claw0installs2stars

SKILL.md

Full skill instructions

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

# 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

    curl -I -m 10 https://api.telegram.org
    
  2. Verify DNS resolution

    nslookup api.telegram.org
    
  3. Test alternative endpoints

    curl -I https://telegram.org
    

Configuring OpenClaw Telegram integration

See 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 endpoint needed
  • Easier to debug locally

See WEBHOOK_SETUP.md for webhook configuration.

Error Handling

Common errors and solutions

"Connection timed out"

  • Check firewall rules
  • Verify proxy configuration
  • Test with different network

"Invalid token"

  • Verify token format (should contain colon)
  • Check for extra spaces or characters
  • Regenerate token if needed

"Bot not responding"

  • Verify bot is not blocked
  • Check bot privacy settings
  • Ensure bot has proper permissions

Testing Your Bot

Manual testing

  1. Search for your bot username on Telegram
  2. Start a conversation with /​start
  3. Test basic commands

Automated testing

Use the test script in scripts/​test_bot.py for automated validation.

References

More skills from simplefarmer69

content-gap-analysis logo
simplefarmer69/ape-claw

content-gap-analysis

Use when the user asks to "find content gaps", "what am I missing", "topics to cover", "content opportunities", "what do competitors write about that I do not", "what topics am I missing", "topics my competitors cover that I lack", or "where are my content blind spots". Identifies content opportu...

2 0
View
afrexai-api-architect logo
simplefarmer69/ape-claw

afrexai-api-architect

Design, build, test, document, and secure production-grade APIs. Covers the full lifecycle from schema design through deployment, monitoring, and versioning. Use when designing new APIs, reviewing existing ones, generating OpenAPI specs, building test suites, or debugging production issues.

2 0
View
things-mac logo
simplefarmer69/ape-claw

things-mac

Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks OpenClaw to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.

2 0
View
wacli logo
simplefarmer69/ape-claw

wacli

Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).

2 0
View
coding-agent logo
simplefarmer69/ape-claw

coding-agent

Delegate coding tasks to Codex, Claude Code, or Pi agents via background process. Use when: (1) building/creating new features or apps, (2) reviewing PRs (spawn in temp dir), (3) refactoring large codebases, (4) iterative coding that needs file exploration. NOT for: simple one-liner fixes (just e...

2 0
View
yahoo-finance logo
simplefarmer69/ape-claw

yahoo-finance

Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.

2 0
View
internal-linking-optimizer logo
simplefarmer69/ape-claw

internal-linking-optimizer

Use when the user asks to "fix internal links", "improve site architecture", "link structure", "distribute page authority", "internal linking strategy", "orphan pages", "site architecture is messy", or "pages have no links pointing to them". Analyzes and optimizes internal link structure to impro...

2 0
View
coda logo
simplefarmer69/ape-claw

coda

General-purpose Coda document manager via REST API v1. Supports listing/creating/updating/deleting docs, managing tables/rows/pages, triggering automations, and exploring doc structure. Requires CODA_API_TOKEN environment variable. Delete operations require explicit confirmation; publishing and p...

2 0
View
backlink-analyzer logo
simplefarmer69/ape-claw

backlink-analyzer

Use when the user asks to "analyze backlinks", "check link profile", "find toxic links", "link building opportunities", "off-page SEO", "who links to me", "I have spammy links", "how do I get more backlinks", or "disavow links". Analyzes backlink profiles to understand link authority, identify to...

2 0
View
obsidian-sync logo
simplefarmer69/ape-claw

obsidian-sync

Sync files between Clawdbot workspace and Obsidian. Run the sync server to enable two-way file synchronization with the OpenClaw Obsidian plugin.

2 0
View
food-order logo
simplefarmer69/ape-claw

food-order

Reorder Foodora orders + track ETA/status with ordercli. Never confirm without explicit user approval. Triggers: order food, reorder, track ETA.

2 0
View
Canvas Skill logo
simplefarmer69/ape-claw

Canvas Skill

Display HTML content on connected OpenClaw nodes (Mac app, iOS, Android).

2 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View