AI Shadow Writer

Setup Guide

Use this page to get a new user from zero to a working Telegram publishing workflow with the fewest mistakes possible.

Before you start

Make sure you have a Telegram account, a Telegram channel you control, permission to add the bot as an admin in that channel, and a Groq API key or a way to create one.

Step 1: Start the bot

Open the bot in Telegram and run /start. Then review /help, /setup, and /groq_help.

Step 2: Connect your Groq API key

Run /ai. If you do not already have a Groq API key, open /groq_help. The bot uses a BYOK model, so AI generation runs through the user’s own Groq account.

Step 3: Add the bot to your channel

Before using /connect, add the bot to your Telegram channel as an administrator.

The bot must be an admin in the channel and it must have permission to publish posts. Without those rights, the bot may generate drafts but will not be able to publish them.

Step 4: Connect the channel

Run /connect, then either forward any post from the channel to the bot or send the channel_id manually in the -1001234567890 format.

Step 5: Fill the channel profile

Run /profile. This is strongly recommended because it gives the bot structured context about what the channel is about, who it is for, how the author sounds, and what themes belong in the channel.

Step 6: Teach the bot with real posts

Optional but recommended: use /teach and forward several older posts from the connected channel. This helps the bot learn the real style rather than relying only on abstract profile inputs.

Step 7: Generate your first post

Run /post your idea here. Then use the draft actions to publish, edit the text, regenerate, refresh the photo, or upload your own photo.

Important setup checklist

  • The bot is started
  • A Groq API key is connected
  • The bot is an admin in the Telegram channel
  • The bot has publishing rights
  • The channel is connected
  • The profile is filled in
  • Optional real samples were added through /teach
If one of these steps is missing, the bot may still respond, but the workflow will be incomplete.