FFT Telegram Ops
Use this skill for Telegram onboarding, operations, and safe admin command handling.
When to use this skill
- Use when setting up or repairing Telegram bot routing in FFT_nano.
- Use when claiming/maintaining main chat and admin command boundaries.
- Use when verifying Telegram media intake and command policy behavior.
When not to use this skill
- Do not use for WhatsApp-only flows.
- Do not use for non-chat backend setup tasks unrelated to Telegram routing.
- Do not use to bypass main/admin restrictions for privileged commands.
Guardrails
- Never run destructive git commands unless explicitly requested.
- Preserve unrelated worktree changes.
- Main-chat-only enforcement is mandatory for admin/delegation operations.
Enable Telegram
- Set host env:
TELEGRAM_BOT_TOKEN=...
- Optional for secure main claiming:
TELEGRAM_ADMIN_SECRET=...
- Recommended Telegram-only dev mode:
WHATSAPP_ENABLED=0 ./scripts/start.sh dev telegram-only
Main Chat Setup
- DM the bot and run
/id. - Claim main chat:
/main <secret>(requiresTELEGRAM_ADMIN_SECRET)
- Alternative: set
TELEGRAM_MAIN_CHAT_IDand restart.
Command Policy
Available everywhere:
/help/status/id
Main/admin chat only:
/main <secret>/tasks/task_pause <id>/task_resume <id>/task_cancel <id>/groups/reload/panel/coder <task>/coder-plan <task>
Messaging Behavior
- Main chat responds to all messages.
- Non-main chats require trigger prefix
@<ASSISTANT_NAME>(default@FarmFriend). - Coder delegation is rejected in non-main chats.
Media Intake
- Telegram uploads are persisted under:
groups/<group>/inbox/telegram/
- Agent sees uploaded files as:
/workspace/group/inbox/telegram/...
- Size limit controlled by
TELEGRAM_MEDIA_MAX_MB.
Operational Checks
- Run
/statusin Telegram to confirm runtime and channel state. - Use
/panelin main chat for task/group/coder quick actions. - If polling conflicts occur, stop duplicate FFT_nano instances.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.