Projects Recipe 02
Intermediate45 minutes

Personal Telegram assistant

An agent on your phone with messages, voice, files, and an allowlist that prevents unintended access.

Final outcome
An always-available agent
Project status
Ready to start
0%0 / 5 steps
Saved runbook

Complete a step, test it, then mark it.

Every check is saved locally. Open a step and read its success criterion before marking it complete.

Step 01

Create a separate bot

Use BotFather and keep the token as a secret, never inside a shareable config.

Step 02

Run Gateway setup

Choose Telegram and reference the environment variable on the runtime device.

Step 03

Configure the allowlist first

Add only your account, then verify that another account is rejected.

Step 04

Start with narrow capabilities

Enable text and research first, then add files and voice after testing.

Step 05

Design runtime and recovery

Define restart behavior, logs, and a fast way to stop the gateway.

Definition of done

Acceptance tests

A workflow is not complete because it worked once. Test these cases and record the result.

  • An unauthorized account receives no response.
  • The token is absent from config and logs.
  • Any consequential external action requires explicit approval.
  • Failure produces a clear message and a recovery step.