HOME LIVE DEMO DOCS INSTALL INTEGRATIONS ASK EVOCLAW PLAYGROUND
INTEGRATIONS

EvoClaw on Telegram

& Discord.

Connect your self-evolving agent to Telegram and Discord in minutes. Your users chat. Your agent learns. Zero extra setup.


WHAT YOU GET

One agent. Two platforms.

Deploy EvoClaw on Telegram, Discord, or both. Every conversation feeds the same learning loop.

🧬
Learns from every message

Every conversation feeds the LoRA training loop. More users means faster evolution — zero manual effort.

AUTO TRAINING
Shared brain across platforms

One EvoClaw instance. Both bots point to the same proxy. Skills learned on Telegram improve Discord responses too.

SHARED BRAIN
🔒
Runs on your server

The bot runs on your VPS. Your conversations never leave your infrastructure. Full privacy, full control.

SELF-HOSTED

TELEGRAM

Set up your Telegram bot.

5 steps. Takes about 5 minutes. No coding required.

01
Install EvoClaw and start the proxy

Make sure EvoClaw is installed and running on port 8080 before connecting your bot.

BASH
pip install evoclaw
evoclaw init
evoclaw start
Verify the proxy is running: curl http://localhost:8080/v1/models — should return a JSON response.
02
Create a bot with BotFather

BotFather is Telegram's official bot manager. Open Telegram and follow these steps:

1
Open Telegram → Search @BotFather
Find the verified BotFather account (blue checkmark).
2
Send /newbot
BotFather will ask for a name and username for your bot.
3
Choose a name and username
Example name: EvoClaw Agent — username must end in _bot, e.g. evoclaw_agent_bot
4
Copy the token BotFather gives you
Looks like: 1234567890:ABCdef... — keep it safe, never share publicly.
03
Get the bot script from the repo

The Telegram bot script is included in the EvoClaw repo. Pull the latest version.

BASH
cd ~/evoclaw/repo
git pull origin main
ls evoclaw_telegram.py  # should exist
04
Install dependencies and run the bot

Install the required libraries, then run the bot inside a screen session so it stays alive 24/7 — even after you disconnect from SSH.

BASH
# Install dependencies
pip install python-telegram-bot openai --break-system-packages

# Run in background (stays alive after SSH disconnect)
screen -dmS tg-bot bash -c "cd ~/evoclaw/repo && TELEGRAM_BOT_TOKEN='YOUR_TOKEN' python3 evoclaw_telegram.py"

# Verify it's running
screen -ls
Replace YOUR_TOKEN with the token from BotFather. Never share your token publicly.
05
Test your bot

Open Telegram, search for your bot's username, and send your first message.

Send /start
The bot replies with a welcome message.
Send any message
The agent responds and starts learning from the conversation immediately.
Send /stats
See how many conversations and skills your agent has learned so far.
The agent is learning when you see this in the VPS log: PRM score=0.xx | conv=N | skills=N
TELEGRAM COMMANDS

Available commands.

/start
Welcome message and usage guide
/stats
Show agent stats: skills learned, conversations, Tinker LoRA status
/skills
List all skill categories the agent has learned
/reset
Clear your conversation history and start fresh
/help
Show all commands and how EvoClaw works
Any message
Chat directly with the agent — no prefix needed

DISCORD

Set up your Discord bot.

More features than Telegram — embed cards, slash commands, and per-channel conversation memory.

01
Create an app in Discord Developer Portal

Go to discord.com/developers/applications and create a new application.

1
Click New Application
Give it a name, e.g. EvoClaw
2
Click BotReset Token
Copy the token — store it safely, never share it publicly.
3
Enable Privileged Gateway Intents
Scroll down on the Bot page → turn on MESSAGE CONTENT INTENT and SERVER MEMBERS INTENT → Save Changes.
02
Invite the bot to your Discord server

Generate an invite URL and add the bot to your server.

1
Click OAuth2URL Generator
In the left menu of the Developer Portal.
2
Check Scopes: bot
Check permissions: Send Messages, Read Message History, Use Slash Commands, View Channels.
3
Copy the Generated URL → open in browser
Select your server → click Authorize.
INVITE URL — replace YOUR_CLIENT_ID
https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=277025508352&scope=bot
03
Install dependencies and run the bot

Run inside a screen session so the bot stays alive 24/7.

BASH
# Install dependencies
pip install discord.py openai --break-system-packages

# Run in background
screen -dmS dc-bot bash -c "cd ~/evoclaw/repo && DISCORD_BOT_TOKEN='YOUR_TOKEN' python3 evoclaw_discord.py"

# Verify it's running
screen -ls
Replace YOUR_TOKEN with the token from the Discord Developer Portal. Never share your token.
04
Test the bot in your Discord server

Open your Discord server and try these to confirm the bot is working.

Mention the bot: @EvoClaw hello!
The bot replies instantly with an embed card.
Use a slash command: /ask what is LoRA?
Slash commands work in any channel.
Type !stats
See the agent stats embed card directly in Discord.
DISCORD COMMANDS

Available commands.

@EvoClaw [message]
Mention the bot in any channel — it replies immediately
/ask [question]
Slash command — ask the agent directly
!stats
Show agent stats in an embed card: skills, conversations, Tinker status
!skills
Show all skill categories in an embed card
!reset
Clear conversation history for this channel
!help
Show all commands and how EvoClaw works
/reset
Slash command to clear history (only visible to you)

TROUBLESHOOTING

Something not working?

Quick fixes for the most common issues.

Bot is not responding

Check proxy is running: evoclaw status

Check screen is alive: screen -ls

Make sure your token is correct and not expired.

Proxy connection refused

The proxy is not running. Start it: evoclaw start

Check if port 8080 is already in use: ss -tlnp | grep 8080

Bot stops after SSH disconnect

Always use screen to run the bot in the background. Never run it directly in an SSH terminal.

Command: screen -dmS tg-bot bash -c "..."

Discord "Message Content" error

Enable in Developer Portal: Bot → Privileged Gateway Intents → MESSAGE CONTENT INTENT → ON → Save Changes.

CHECK ALL SERVICES
# List all running screen sessions
screen -ls

# Expected output:
tg-bot         (Detached) ✅  — Telegram bot
dc-bot         (Detached) ✅  — Discord bot
evoclaw-proxy  (Detached) ✅  — EvoClaw proxy
evoclaw-agent  (Detached) ✅  — Agent runner

# Check proxy status
evoclaw status

# View logs for a specific session
screen -r tg-bot

READY?

Deploy your agent now.

Both bots take less than 10 minutes to deploy. Your agent starts learning from the very first message.