TG Message Assistant (Telyclaw)
Read ./core/prompt.md for the full 5-step workflow and interaction principles.
Tool Strategy: Native API Tools
Telyclaw has built-in Telegram and Gmail tools. Use them directly.
Telegram
| Action | Tool | Notes |
|---|---|---|
| Fetch messages | telegram_get_messages |
Supports channel usernames and chat IDs |
| Send messages | telegram_send_message |
4096-char limit per message; split with "(1/N)" labels |
Gmail
| Action | Tool | Notes |
|---|---|---|
| Authorize | gmail_authorize |
Opens browser for Google OAuth |
| Send email | gmail_message_send |
Requires confirm: true |
Cron
Use the CronCreate tool for scheduled recurring generation.
Gmail Setup
Plugin detection (required on first use):
- Scan the available tools list for
gmail_*prefixed tools. - If not found, tell the user:
"The Gmail plugin is not installed. Please install the Gmail plugin from the telyclaw plugin marketplace, or visit https://github.com/TelyAgent/telyclaw-plugin-gmail for installation instructions. Let me know once it's set up and we'll continue."
- If tools exist but are unavailable (e.g. expired authorization), proceed to authorization.
Authorization flow:
- On receiving an authorization error, use AskUserQuestion to ask the user for permission.
- Call
gmail_authorize— this will open a browser window for Google OAuth. - Tell the user: "A Google authorization page has been opened in your browser. Please complete the authorization and let me know when you're done."
- Once the user confirms, retry the send.
Send parameters:
to: recipient email addresssubject:{Channel names} Briefing · {date range}text: the full Markdown briefingconfirm: true (required — the tool will refuse to send without this)