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

Gmail

Cron

Use the CronCreate tool for scheduled recurring generation.

Gmail Setup

Plugin detection (required on first use):

1. Scan the available tools list for gmail_* prefixed tools.
2. 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."

3. 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 address
• subject: {Channel names} Briefing · {date range}
• text: the full Markdown briefing
• confirm: true (required — the tool will refuse to send without this)