Automate Telegram with AI Agents

Send messages to channels and groups, share media, schedule posts with precise timing, and automate your Telegram presence — all from the command line or through your AI agent via the Bot API.

Setup Guide ClawHub

Please make sure there is always a human in the loop.

Post to Telegram in Seconds

Terminal

# Install globally
npm install -g postiz

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Find your Telegram integration
postiz integrations:list

# Send a message to your channel/group
postiz posts:create \
  -c "Hello Telegram!" \
  -s "2025-01-15T09:00:00Z" \
  -i "telegram-id"

Telegram-Specific Features

📢

Channel Messaging

Post messages directly to your Telegram channels. Reach all subscribers with announcements, updates, and content.

👥

Group Messaging

Send messages to Telegram groups. Keep your community engaged with scheduled posts and automated content delivery.

🤖

Bot-Powered

Powered by the Telegram Bot API via BotFather. Create a bot, add it to your channel or group, and start posting programmatically.

🖼

Media Sharing

Share images, videos, and documents alongside your messages. Upload media through Postiz and include it in your Telegram posts.

📅

Scheduled Messages

Schedule messages for optimal delivery times with ISO timestamps. Plan your Telegram content calendar in advance.

⚡

Minimal Config

Telegram uses a streamlined setup — just your integration ID handles routing. No complex platform-specific settings required.

How It Works

Set Up Your Telegram Bot

Create a bot using BotFather on Telegram, then add it to your channel or group as an administrator. Connect it to Postiz through the dashboard to get your integration ID.

Bot Setup

# 1. Open Telegram and message @BotFather
# 2. Send /newbot and follow the prompts
# 3. Copy the bot token
# 4. Add the bot to your channel/group
# 5. Make it an admin (for channels)
# 6. Connect in Postiz dashboard

# Then find your integration
postiz integrations:list

# Filter for Telegram
postiz integrations:list | jq \
  '.[] | select(.identifier=="telegram")'

Send Your First Message

Post a message to your Telegram channel or group. The integration ID handles all the routing — no additional settings needed for basic text messages.

First Message

# Simple text message
postiz posts:create \
  -c "Hello from Postiz! 🚀" \
  -i "telegram-id"

# With media attachment
RESULT=$(postiz upload photo.jpg)
MEDIA_URL=$(echo "$RESULT" | jq -r '.path')

postiz posts:create \
  -c "Check out this photo!" \
  -m "$MEDIA_URL" \
  -i "telegram-id"

Schedule Messages

Schedule Telegram messages for future delivery using ISO timestamps. Perfect for content calendars, announcements, and automated updates.

Scheduling

# Schedule a message for tomorrow morning
postiz posts:create \
  -c "Good morning! Here's your daily update." \
  -s "2025-03-02T09:00:00Z" \
  -i "telegram-id"

# Schedule with media
postiz posts:create \
  -c "New product launch tomorrow!" \
  -m "$MEDIA_URL" \
  -s "2025-03-01T18:00:00Z" \
  -i "telegram-id"

Telegram Settings Reference

Telegram uses a minimal configuration. The integration ID handles channel and group routing. Use the --settings flag if you need to specify the platform type explicitly.

Field	Type	Required	Description
`__type`	string	Yes	Must be "telegram" to identify the platform (if using settings)

Telegram's simplicity is a feature — your bot token and channel/group association are configured once in the Postiz dashboard. After that, just use the integration ID to route messages.

Common Configurations

Copy-paste these commands for common Telegram posting scenarios.

Simple Channel Announcement

Terminal

postiz posts:create \
  -c "📢 Big news! We just hit 10k subscribers. Thank you all!" \
  -i "telegram-id"

Scheduled Morning Update

Terminal

postiz posts:create \
  -c "Good morning! Here's your daily market briefing..." \
  -s "2025-03-02T07:00:00Z" \
  -i "telegram-id"

Media Post with Caption

Terminal

# Upload the image first
RESULT=$(postiz upload announcement.jpg)
MEDIA_URL=$(echo "$RESULT" | jq -r '.path')

# Post with media
postiz posts:create \
  -c "Check out our new product design!" \
  -m "$MEDIA_URL" \
  -s "2025-03-01T12:00:00Z" \
  -i "telegram-id"

Multi-Channel Broadcast

Terminal

# Post to multiple Telegram channels at once
postiz posts:create \
  -c "New blog post: How to automate your workflow" \
  -s "2025-03-01T15:00:00Z" \
  -i "telegram-channel-1,telegram-channel-2"

What is OpenClaw?

OpenClaw is the open-source personal AI agent with 145k+ GitHub stars. It runs locally on your machine, connects through apps you already use, and takes real actions on your behalf.

💬

Works Where You Are

Message OpenClaw from WhatsApp, Telegram, Slack, Discord, Signal, iMessage, or 10+ other platforms. No new app to learn.

🧩

Skill-Based Architecture

OpenClaw extends its abilities through Skills — lightweight plugins defined in Markdown files. Postiz is available as a skill on ClawHub.

⏰

Proactive Automation

Schedule recurring tasks with cron jobs. OpenClaw can post to your Telegram channels on a schedule without you having to ask each time.

How Postiz Becomes an OpenClaw Skill

When you install Postiz Agent globally, OpenClaw automatically discovers it by reading the bundled SKILL.md file. This file tells OpenClaw what commands are available, what environment variables are needed, and how to send Telegram messages with the right integration.

✓Install from ClawHub with one command: clawhub install nevo-david/postiz
✓OpenClaw reads the SKILL.md and learns all Postiz commands
✓Eligibility is checked automatically — POSTIZ_API_KEY must be set
✓Skills are loaded on-demand, keeping the agent context clean
✓Works with any LLM backend: Claude, GPT, Gemini, Llama, and more

Install from ClawHub

# Install the Postiz skill
clawhub install nevo-david/postiz

# Or install the CLI globally
npm install -g postiz

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Verify OpenClaw sees it
openclaw skills list --eligible

# Output:
# - postiz: Social media automation
#   CLI for scheduling posts
#   across 30+ platforms

Telegram Posting with OpenClaw

Message OpenClaw from any platform — it reads the Postiz skill, discovers your Telegram integration, and handles the entire messaging workflow autonomously.

🦀

From Any Chat App

WhatsApp, Telegram, Slack, Discord...

Send a message to OpenClaw from your favorite chat app. It runs as a persistent daemon on your machine, so it picks up your message, discovers your Telegram channel via Postiz, and sends the message — all while you go about your day.

WhatsApp / Slack

You: Post "New episode is live!" to
  my Telegram channel, schedule for 3pm

OpenClaw: Got it! Here's what I'll do:
  1. Find your Telegram integration
  2. Schedule for 2025-03-01T15:00:00Z
  3. Post message to your channel

  Done! Your Telegram message is scheduled.
  Post ID: abc-123

🦀

Scheduled & Proactive

Cron jobs for recurring channel content

OpenClaw supports cron-based heartbeat tasks. Set up a recurring job that sends daily updates to your Telegram channel automatically — no manual trigger needed.

openclaw.json (heartbeat)

{
  "heartbeat": [
    {
      "cron": "0 8 * * *",
      "prompt": "Send a good morning
  message to my Telegram channel
  via Postiz. Include today's date
  and a motivational quote. Use
  the telegram-id integration."
    }
  ]
}

Why OpenClaw + Postiz for Telegram

OpenClaw's skill system makes Postiz a natural fit. The agent reads the SKILL.md to understand every available command, then autonomously chains them together for Telegram messaging workflows.

✓Message from WhatsApp to post on Telegram — no terminal needed
✓Cron jobs for hands-free daily channel updates
✓Structured JSON output lets OpenClaw verify each step succeeded
✓Media uploads handled automatically when you mention files
✓Cross-post to Telegram + other platforms in a single conversation
✓Model-agnostic — works with Claude, GPT, Gemini, or open-source LLMs

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Telegram
metadata:
  openclaw:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Telegram
# Minimal settings — integration ID
# handles channel/group routing.
# Bot setup via BotFather.

Also Works with Claude Code

Postiz Agent works as a CLI tool with any AI agent that can execute shell commands — including Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the SKILL.md file to learn all available Postiz commands, then autonomously discovers your Telegram integration, composes your message, uploads any media if needed, and sends it to your channel or group.

Claude Code

> Send an announcement to my Telegram
  channel about our new feature launch,
  include the screenshot, schedule for 3pm

Claude will automatically run:
  postiz integrations:list
  postiz upload ./screenshot.png
  postiz posts:create \
    -c "🚀 New feature launch!
    Check out our latest update..." \
    -m "uploaded-url" \
    -s "2025-03-01T15:00:00Z" \
    -i "telegram-id"

Telegram + Other Platforms

Send a Telegram message and post to social media simultaneously. Each platform gets its own settings.

Terminal

# Post to Telegram and social media simultaneously
postiz posts:create \
  -c "New blog post: How to automate your workflow" \
  -s "2025-03-01T09:00:00Z" \
  -i "telegram-id,twitter-id,linkedin-id"

# Batch schedule a week of daily Telegram updates
for day in 1 2 3 4 5; do
  postiz posts:create \
    -c "Day $day tip: Stay productive!" \
    -s "2025-03-0${day}T08:00:00Z" \
    -i "telegram-id"
done