Documentation

Everything you need to ship an agent.

Swarmly deploys AI agents to Telegram. No API keys, no servers. This page is an honest tour of what your agent does today, how to deploy and use it, and what is coming next.

01

Quickstart

Four steps to a live agent, under a minute. You bring a Telegram token; we run the agent on our infrastructure and cover the AI costs.

  1. Create a bot. Message @BotFather, run /newbot, and copy the token it gives you.
  2. Choose a template. Open Deploy and pick a starting point, or begin from a blank Custom agent.
  3. Customize and deploy. Name it, write its personality, paste the token, and deploy.
  4. Open and test. You get a link to your agent on Telegram. Save it, because there is no dashboard yet, so that link is how you find your bot. Open it, press Start, and say hi.
@BotFather
you › /newbot
BotFather: Alright. What name should your bot have?
you › Alpha Watcher
BotFather: Good. Now choose a username ending in "bot".
you › alpha_watcher_bot
Done! Use this token to access the HTTP API:
8123456789:AAH-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
02

Bot commands

Every Swarmly bot understands a few built-in commands. Anything else you send is answered by the agent.

/start

Introduces the bot and confirms it is an AI agent. Sent the first time someone opens the chat.

/help

Lists the available commands and what the bot can do.

/reset

Clears the recent conversation so the agent starts fresh.

alpha_watcher_bot · telegram
@alpha_watcher_bot is live
/start
Hi, I'm Alpha Watcher, an AI agent running on Swarmly. Send me a message and I'll do my best to help. Use /help to see what I can do.
explain transformers in two sentences
A transformer is a neural network that…
/reset
Done, I've cleared our recent conversation.
03

Templates

A template is a starting point: a personality tuned for a job. Today the templates differ by their personality and focus; the tools they will use (web search, code, and more) are on the roadmap. Pick the closest one and adjust, or start from Custom.

Researcher

Searches the web, summarizes documents, and monitors topics around the clock.

web_searchsummarizememory

Trader

Tracks prices and on-chain signals, and surfaces market opportunities.

crypto_priceon_chainalerts

Coder

Writes code, reviews pull requests, and explains technical concepts.

code_reviewexplaingithub

Community

Answers questions, moderates conversations, and posts scheduled updates.

broadcastschedulememory

Writer

Drafts threads, posts, and newsletters in your voice.

long_formthreadhumanize
+

Custom

Start from a blank slate. Your skills, your personality, your rules.

pick any skill
04

Personality

The personality is a prompt that shapes how your agent thinks and writes. It is the single biggest lever on how the bot feels, and today it is the main thing that makes one agent different from another. Be specific about its role, its tone, and what it should refuse. You set it when you deploy; in-place editing arrives with accounts.

personality
You are a market analysis agent for crypto and traditional
markets. Track price action, identify trends, and monitor
on-chain signals. Be data-driven, never speculative. State
your confidence level. This is not financial advice.
05

Skills

Today your agent answers using its personality and the recent conversation. A library of skills that let agents act, not just chat, is what we are building next.

On the roadmap

Research & web soon

Search the web, read and summarize pages and documents, monitor topics.

Memory that learns soon

Save and recall facts about people and projects across conversations.

Voice & vision soon

Transcribe voice notes, interpret images, and reply with audio.

Code tools soon

Run and review code, and work with repositories.

Scheduling soon

Run tasks on a schedule, such as a daily 9 a.m. briefing.

Integrations soon

Connect to external services and post to channels and groups.

06

Memory

Your agent follows the recent flow of a conversation so it can answer in context. Use /reset to clear that recent context and start fresh.

Memory is fully isolated per bot, so one agent never reads another agent's data. The agent does not yet learn or save new facts on its own; memory that learns is on the roadmap.

07

AI & reliability

Your agent runs on a managed AI model on our infrastructure, so you never manage a key or a bill. Each agent runs isolated and always on, and restarts on its own if it ever stops.

always on
auto-restart
isolated
per agent
$0
your cost
08

Limits

A few honest things to know about how your agent behaves today.

Context window

Your agent uses the recent messages of a chat for context.

Reply length

Very long answers are split across multiple Telegram messages.

Text only, today

The agent reads and writes text. Voice, images, and files are on the roadmap.

Response time

Most replies arrive in a few seconds. There is no SLA yet.

09

Security

Your token and your data are handled carefully.

Encrypted tokens

Your bot token is encrypted with AES-256-GCM before it is stored and is never shown again.

Sandboxed agents

Each agent is locked to safe, conversational use: no shell, no code execution, no filesystem.

Per-bot isolation

One agent can never read another agent's conversations or data.

Where your data goes

To generate replies, message content is sent to a third-party AI provider. See the Privacy page.

10

Pricing

Free forever. We cover the AI provider costs in full. There is no credit card, no trial period, and no charges later. Deploy as many agents as you need.

11

Troubleshooting

I deployed but the bot does nothing.

Give it a moment to activate, then message it again and press Start. If it still does not respond, recheck the token.

My bot stopped replying.

A token is revoked if you regenerate it in @BotFather. Make sure the token is still valid, and remember you must message the bot first, because bots cannot start a conversation with you.

The token was rejected on deploy.

Copy the token again from @BotFather exactly, with no extra spaces. It looks like 8123456789:AAH….

Can I edit my agent after deploying?

Not in place yet. You set the personality when you deploy; editing and a dashboard arrive with accounts.

How do I stop a bot?

Regenerate or revoke its token in @BotFather and it stops replying. Pause and delete from the app arrive with accounts; to remove a bot and its data now, email us.

Can I run more than one agent?

Yes. Create another bot in @BotFather and deploy again with its token. Each agent is isolated.

Still stuck?

Email hello@swarmlyagent.com and we will help.