Telegram
YouClaw can send reminders, notifications, and AI conversation summaries through a Telegram Bot. Once connected, you can receive messages from YouClaw anywhere via Telegram.
Connect a Telegram Bot
Step 1: Create a Telegram Bot
- Search for @BotFather in Telegram and start a conversation
- Send the
/newbotcommand - Follow the prompts to set a name and username for your Bot
- Once created, BotFather will return a Bot Token in this format:
7123456789:AAH4b-some-random-string-here
Save this Token — you will need it for configuration.
Step 2: Get Your Chat ID
- Find the Bot you just created in Telegram and click Start
- Send any message to the Bot (e.g.,
hello) - Open the following URL in your browser (replace with your Token):
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
- Find the
chat.idfield in the returned JSON — this is your Chat ID
Step 3: Configure in YouClaw
Open YouClaw Settings > Channels > Telegram and enter:
Bot Token: 7123456789:AAH4b-some-random-string-here
Chat ID: 123456789Click Test Connection. If you receive a test message in Telegram, the setup is complete.
Supported Features
Scheduled Reminders
Set reminders using natural language. YouClaw sends them via Telegram when the time comes:
User: Remind me to pay rent on the 25th of every month
AI: Got it! I'll remind you via Telegram on the 25th
Task Notifications
When YouClaw finishes a background task (e.g., file processing, data analysis), it notifies you of the result through Telegram.
AI Conversation Forwarding
Forward conversation summaries or key conclusions from YouClaw to Telegram for easy access on the go.
Message Formats
Messages sent from YouClaw to Telegram support the following formats:
| Format | Description | Example |
|---|---|---|
| Plain text | Simple text messages | Reminder: Rent is due today |
| Markdown | Bold, italic, links, etc. | **To-do list** completed 3/5 |
| Images | Charts or screenshots | Data analysis result charts |
Usage Examples
Scheduled Reports
User: Send my to-do list to Telegram every morning at 9 AM
AI: Done! Your to-do summary will be sent via Telegram every day at 09:00.
Event Reminders
User: I have a meeting next Wednesday at 2 PM, remind me 30 minutes before
AI: Sure, I'll send a Telegram reminder at 1:30 PM next Wednesday for your 2:00 PM meeting.
Task Completion Alerts
User: Analyze this CSV file and notify me when it's done
AI: Working on it. I'll notify you via Telegram when the analysis is complete.
FAQ
Not receiving messages?
- Verify that the Bot Token and Chat ID are correct
- Make sure you sent at least one message to the Bot in Telegram (to activate the conversation)
- Click Test Connection in YouClaw settings to check connectivity
- Confirm your network can reach the Telegram API
Can I send messages to a group?
Yes. Add the Bot to the target group, then use the group's Chat ID (usually a negative number) in place of your personal Chat ID.
Is there a message rate limit?
The Telegram Bot API limits messages to 1 per second per chat and 30 per second overall. YouClaw handles rate limiting automatically, so this should not affect normal usage.
How do I stop certain notifications?
Go to YouClaw Settings > Channels > Telegram > Notification Preferences to toggle different notification categories on or off.