Automate Telegram with Hermes Agent
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.
Please make sure there is always a human in the loop.
Post to Telegram in Seconds
Terminal
# Install the skill
npx skills add gitroomhq/postiz-agent
# 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 | Description |
|---|---|---|
__type | string | 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 Hermes Agent?
Hermes Agent is an open-source AI agent framework by Nous Research — “the agent that grows with you.” It's a flexible platform for building and running AI agents that can execute real-world tasks.
Grows With You
Hermes Agent learns and adapts to your workflows over time. The more you use it, the better it understands your social media strategy and content style.
Open-Source Framework
Built by Nous Research, Hermes Agent is fully open-source. Customize and extend it to fit your exact social media automation needs.
Tool Execution
Schedule recurring tasks with cron jobs. Hermes Agent can post to your Telegram channels on a schedule without you having to ask each time.
How Postiz Works with Hermes Agent
When you install Postiz Agent globally, Hermes Agent automatically discovers it by reading the bundled SKILL.md file. This file tells Hermes Agent what commands are available, what environment variables are needed, and how to send Telegram messages with the right integration.
- ✓Install Postiz Agent globally with npx skills add
- ✓Hermes Agent discovers Postiz through tool execution framework
- ✓POSTIZ_API_KEY must be set in environment
- ✓All Postiz commands become available as agent tools
- ✓Works with any compatible LLM backend
Install Postiz
# Install the Postiz skill
npx skills add gitroomhq/postiz-agent
# Set your API key
export POSTIZ_API_KEY=your_api_key
# Hermes Agent discovers Postiz
# through its tool execution framework
hermes tools listTelegram Posting with Hermes Agent
Message Hermes Agent from any platform — it reads the Postiz skill, discovers your Telegram integration, and handles the entire messaging workflow autonomously.
From Any Chat App
Hermes Agent reads Postiz commands throu...
Send a message to Hermes Agent 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
Hermes Agent: 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-123Scheduled & Proactive
Cron jobs for recurring channel content
Hermes Agent supports cron-based heartbeat tasks. Set up a recurring job that sends daily updates to your Telegram channel automatically — no manual trigger needed.
hermes-config.yaml
scheduled_tasks:
- name: daily_social_posts
schedule: "0 9 * * 1-5"
prompt: |
Check ~/content/posts for new
.txt files. For each one, read
the content and schedule a post
to Telegram for today at noon.
Move posted files to
~/content/published.Why Hermes Agent + Postiz for Telegram
Hermes Agent makes Postiz a natural fit for your Telegram workflow. The agent discovers all available commands and autonomously chains them together.
- ✓Open-source and fully customizable for your Telegram workflow
- ✓Grows and adapts to your content strategy over time
- ✓Tool execution framework discovers Postiz commands automatically
- ✓Scheduled tasks for hands-free daily posting
- ✓Cross-post to Telegram + other platforms in a single conversation
- ✓Works with any LLM backend — not locked to a single provider
SKILL.md (auto-discovered)
---
name: postiz
description: Social media automation
CLI for scheduling posts across
30+ platforms including Telegram
metadata:
hermes-agent:
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"
doneStart posting to Telegram
Install Postiz Agent and automate your Telegram channel messaging with AI-powered scheduling and delivery.
Ready to get started?
Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.
Open-source social media scheduling tool
