Telegram
CamelAGI has two types of Telegram bots:
- Admin Bot — manage agents, config, pairing (no AI calls)
- Agent Bots — one per agent, full AI conversation
Admin Bot Commands
| Command | Description |
|---|---|
/help |
List all commands |
/agents |
List agents with status |
/newagent |
Create a new AI agent |
/deleteagent |
Remove an agent |
/cloneagent |
Clone an existing agent |
/config |
View/edit server configuration |
/model |
Switch the default model |
/soul <id> |
Edit an agent’s personality |
/sessions |
Browse saved sessions |
/pairing |
Manage user access requests |
/voice |
Configure voice transcription |
/mcp |
Manage MCP tool servers |
/restart |
Restart all bots |
Creating an Agent
- Send
/newagentto the admin bot - Enter a name (e.g. “Coder”, “Personal Finance”)
- Pick a personality template
- Choose a model (or use default)
- Paste a Telegram bot token (create one via @BotFather)
- Approve the new bot
The agent is now live — message its bot to start chatting.
Agent Bot Commands
| Command | Description |
|---|---|
/help |
List commands |
/clear |
Clear chat history |
/status |
Show model, messages, tokens |
/model <name> |
Switch model for this chat |
/think <level> |
Set thinking (off/low/medium/high) |
/effort <level> |
Set effort (low/medium/high/max) |
/brief |
Toggle short replies |
/usage |
Token usage for this session |
/compact |
Force history compaction |
/export |
Export session as markdown file |
/mcp |
Manage MCP servers |
Voice Messages
Send a voice message to any agent bot. It gets transcribed (via Groq, OpenAI, or Deepgram) and processed as text.
Configure in the admin bot with /voice.
Groups
Add an agent bot to a Telegram group. By default it only responds when mentioned (@botname). Change this with the mentionOnly setting.
Access Control
When a new user messages a bot:
- A pairing request is created
- Admin gets a notification with Approve/Deny buttons
- If approved, user enters a 5-digit OTP code
- User is verified and can chat