Post to Telegram from Paperclip

Paperclip agents can send and schedule Telegram channel and group messages through Postiz. Install the Postiz skill where the agent runs, add the Postiz bot to your Telegram channel or group and connect it in Postiz, and the agent can publish announcements, links, images, and documents on a schedule.

Setup Guide Paperclip

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

Last updated: September 2026

Post to Telegram in Seconds

Setup, then just ask

# One-time setup
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Then just ask Paperclip:
> Send the launch announcement to my
  Telegram channel tomorrow at 9am

Paperclip: Done! Your Telegram post is scheduled.

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 just by asking Paperclip.

🖼

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 — once connected, Paperclip routes messages to the right channel automatically. No complex platform-specific settings required.

How does Paperclip post to Telegram?

You describe what you want in plain language and Paperclip handles the Postiz calls for you. Here is how a typical conversation goes.

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 and you are ready to go.

Example conversation

> Is my Telegram account connected to Postiz?

Paperclip: Yes — your Telegram account is connected
  and ready. Want me to post something?

Send Your First Message

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

Example conversation

> Draft a Telegram post about our new
  feature launch

Paperclip: Here's a draft for Telegram:
  "We just shipped something big..."
  Want me to add media and schedule it?

Schedule Messages

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

Example conversation

> Yes — add screenshot.png and schedule
  it for tomorrow at 9am

Paperclip: Done! Scheduled on Telegram for
  tomorrow at 9:00 AM.

Telegram Settings Reference

Telegram uses a minimal configuration. Once your bot is connected, Paperclip routes messages to the right channel or group — there is nothing else to set.

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

Example

> Post "Excited to announce our new feature!" to
  Telegram and LinkedIn tomorrow at 9am, then schedule
  a daily tip on Telegram every weekday at 10am

Paperclip: Done! Scheduled:
  - Telegram + LinkedIn: tomorrow 9:00 AM
  - Daily tips on Telegram: Mon-Fri 10:00 AM

Scheduled Morning Update

Example

> What's scheduled on Telegram this week?

Paperclip: 6 posts on Telegram: the announcement tomorrow
  at 9:00 AM and daily tips Mon-Fri at 10:00 AM.
  Want me to move or cancel any of them?

Media Post with Caption

Example

> What's scheduled on Telegram this week?

Paperclip: 6 posts on Telegram: the announcement tomorrow
  at 9:00 AM and daily tips Mon-Fri at 10:00 AM.
  Want me to move or cancel any of them?

Multi-Channel Broadcast

Example

> What's scheduled on Telegram this week?

Paperclip: 6 posts on Telegram: the announcement tomorrow
  at 9:00 AM and daily tips Mon-Fri at 10:00 AM.
  Want me to move or cancel any of them?

What is Paperclip?

Paperclip is an open-source orchestration framework for building “zero-human companies” by hiring and managing teams of AI agents. It handles content, social media distribution, marketing, dev, QA, and more from a single dashboard.

👥

Agent Teams

Paperclip manages teams of AI agents that work together. Assign a content agent, a scheduling agent, and a review agent to your social media workflow.

📊

Single Dashboard

Monitor all your AI agents and their social media tasks from one unified dashboard. Track posts, schedules, and performance in real time.

⚙

Orchestration

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

How Postiz Works with Paperclip

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

✓Install Postiz Agent and set your POSTIZ_API_KEY
✓Paperclip discovers Postiz through tool integration
✓Assign Postiz commands to specialized agents in your team
✓Orchestrate multi-step workflows with approval chains
✓Monitor everything from the Paperclip dashboard

Install Postiz

# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Paperclip discovers Postiz through
# its tool integration system
# and assigns it to agent teams

Telegram Posting with Paperclip

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

📎

From Any Chat App

Paperclip assigns specialized agents to ...

Assign a task to Paperclip from its dashboard. It runs as a long-lived service on your own infrastructure, so it picks up the task, 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

Paperclip: 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

Paperclip supports scheduled heartbeats. Set up a recurring job that sends daily updates to your Telegram channel automatically — no manual trigger needed.

paperclip.yaml (pipeline)

pipelines:
  daily_social:
    schedule: "0 9 * * 1-5"
    agents:
      - role: content_creator
        task: "Draft a Telegram post
          about trending industry topics"
      - role: reviewer
        task: "Review and polish the
          draft for engagement"
      - role: publisher
        task: "Schedule via Postiz
          for today at noon"

Why Paperclip + Postiz for Telegram

Paperclip makes Postiz a natural fit for your Telegram workflow. The agent discovers all available commands and autonomously chains them together.

✓Multi-agent teams for quality Telegram content — draft, review, publish
✓Single dashboard to monitor all social media automation
✓Orchestrated pipelines from content creation to publishing
✓Scheduled pipelines for hands-free daily posting
✓Cross-post to Telegram + other platforms in a single pipeline
✓Open-source — fully customizable agent workflows

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Telegram
metadata:
  paperclip:
    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 works with any AI agent that can run commands or call MCP tools — you ask, the agent does the work. That includes Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the Postiz skill so it knows what it can do, 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: Done! Scheduled on Telegram for
  tomorrow at 9:00 AM.

Telegram + Other Platforms

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

Example

> What's scheduled on Telegram this week?

Paperclip: 6 posts on Telegram: the announcement tomorrow
  at 9:00 AM and daily tips Mon-Fri at 10:00 AM.
  Want me to move or cancel any of them?

What can you ask Paperclip to do on Telegram?

You assign a task in plain language and the agent translates it into Postiz calls with the right Telegram settings. These are prompts people actually give a Paperclip agent for Telegram.

Channel announcement

Ask Paperclip

> Post the new pricing announcement to our
  Telegram channel tomorrow at 9am with the link

Paperclip: Scheduled on Telegram for tomorrow 9:00 AM.

Media message

Ask Paperclip

> Send tutorial.mp4 to the community group with a
  two-line caption tonight at 8pm

Paperclip: Uploaded tutorial.mp4, caption set.
  Scheduled for 8:00 PM.

Cross-post

Ask Paperclip

> Post today's blog summary to Telegram and
  Discord at the same time

Paperclip: Both channels scheduled for 3:00 PM.

What Telegram rules should the agent follow?

Telegram rejects posts that break its limits, so the agent needs these constraints up front. Put them in the task or in your Paperclip agent's instructions.

✓Telegram is connected through a bot. Add the Postiz bot to your channel or group, ideally as an admin, then connect that channel in Postiz.
✓Text messages are limited to 4,096 characters; media captions to 1,024 characters. Ask the agent to shorten captions on media posts.
✓Telegram has no extra Postiz settings beyond __type. The connected channel decides where the message goes.
✓Disable the bot's privacy mode in BotFather if it should read messages in groups (only needed for two-way workflows).

Paperclip and Telegram: frequently asked questions

Short answers to the questions teams ask before letting a Paperclip agent post to Telegram through Postiz.

How do I post to Telegram from Paperclip?

Install the Postiz skill in your agent's environment with npx skills add gitroomhq/postiz-agent, set POSTIZ_API_KEY, add the Postiz bot to your Telegram channel or group, and connect it in Postiz. Then assign a task like "post this update to Telegram at 9am" and the agent schedules it.

Does each Paperclip agent need its own Telegram bot?

No. Postiz owns the bot connection to your channel or group. Every Paperclip agent posts through Postiz with a Postiz API key or postiz auth:login, so you connect Telegram once and any agent in your org can publish there without holding a bot token.

Can Paperclip post to both a Telegram channel and a group?

Yes. Connect each destination as a separate channel in Postiz by adding the bot to it. In the task, name the destination ("the announcements channel" or "the community group") and the agent picks the matching Postiz channel. One task can post to both.

What is the Telegram message length limit through Postiz?

Telegram allows 4,096 characters for a text message and 1,024 characters for a caption on an image, video, or document. If the agent attaches media and writes a long caption, ask it to move the details into a follow-up text message.

Can a Paperclip agent send scheduled Telegram digests?

Yes. Set a heartbeat cadence in Paperclip, have the agent compile the digest (for example from your blog feed or GitHub releases), and schedule it through Postiz for a fixed time. Use a Paperclip approval step if the channel is public and the content needs a human check.