1---
2name: telegram-bot-settings
3description: Inspect and change Telegram bot public identity and Bot API account settings from any agent that can run local Python. Works well with Codex, Claude Code, OpenClaw, and similar runtimes.
4---
5 
6# Telegram Bot Settings
7 
8Use the bundled Python CLI to inspect and update Telegram Bot API account-level settings.
9 
10This skill is runtime-neutral: it works from Codex, Claude Code, OpenClaw, or any other agent that can read local files and run `python3`.
11 
12## Quick start
13 
14Run a full snapshot first:
15 
16```bash
17python3 {baseDir}/scripts/telegram_bot_settings.py status
18```
19 
20## Token resolution
21 
22The CLI resolves the bot token in this order:
231. `--token`
242. `TELEGRAM_BOT_TOKEN`, `BOT_TOKEN`, or `TG_BOT_TOKEN`
253. `--token-file`
264. `TELEGRAM_BOT_TOKEN_FILE`, `BOT_TOKEN_FILE`, `TG_BOT_TOKEN_FILE`, or `OPENCLAW_TELEGRAM_TOKEN_FILE`
275. Common secret files and dotenv-style files such as `./secrets/telegram-bot-settings.env`, `./.env.local`, `./.env`, or `~/.config/telegram-bot-settings/bot.token`
28 
29If you want a simple default, store the token in one of those secret locations and run the commands without passing `--token` each time.
30 
31## Common tasks
32 
33### Inspect current settings
34 
35```bash
36python3 {baseDir}/scripts/telegram_bot_settings.py status
37python3 {baseDir}/scripts/telegram_bot_settings.py get-name
38python3 {baseDir}/scripts/telegram_bot_settings.py get-description
39python3 {baseDir}/scripts/telegram_bot_settings.py get-short-description
40```
41 
42### Change public identity
43 
44```bash
45python3 {baseDir}/scripts/telegram_bot_settings.py set-name --text "Northline Utility Bot"
46python3 {baseDir}/scripts/telegram_bot_settings.py set-description --text "Workflow and automation bot for Telegram-based operations."
47python3 {baseDir}/scripts/telegram_bot_settings.py set-short-description --text "Telegram bot settings helper"
48python3 {baseDir}/scripts/telegram_bot_settings.py set-photo ./avatar.png
49python3 {baseDir}/scripts/telegram_bot_settings.py remove-photo
50```
51 
52Notes:
53- `set-photo` auto-converts static non-JPEG images to JPEG when Pillow is available.
54- Add `--animated --main-frame-timestamp 0.0` for MPEG4 animated avatars.
55- Add `--language-code uk` (or another code) for localized name/description fields.
56 
57### Manage commands
58 
59```bash
60python3 {baseDir}/scripts/telegram_bot_settings.py get-commands
61python3 {baseDir}/scripts/telegram_bot_settings.py set-commands --commands @commands.json
62python3 {baseDir}/scripts/telegram_bot_settings.py delete-commands
63```
64 
65### Manage menu button
66 
67```bash
68python3 {baseDir}/scripts/telegram_bot_settings.py get-menu-button
69python3 {baseDir}/scripts/telegram_bot_settings.py set-menu-button --button '{"type":"commands"}'
70```
71 
72### Manage default admin rights
73 
74```bash
75python3 {baseDir}/scripts/telegram_bot_settings.py get-default-admin-rights
76python3 {baseDir}/scripts/telegram_bot_settings.py set-default-admin-rights --rights @rights.json
77python3 {baseDir}/scripts/telegram_bot_settings.py set-default-admin-rights --clear
78```
79 
80## Raw method escape hatch
81 
82Use `raw` when Telegram adds a method before this wrapper is updated:
83 
84```bash
85python3 {baseDir}/scripts/telegram_bot_settings.py raw getMe
86python3 {baseDir}/scripts/telegram_bot_settings.py raw setMyCommands --data @payload.json
87```
88 
89For file uploads, pass `--file field=/path/to/file` and reference it via `attach://field` inside `--data`.
90 
91## Guardrails
92 
93- Run `status` before large edits so you have a clean baseline.
94- Prefer `@file.json` for long payloads instead of fragile shell escaping.
95- Do not assume every BotFather setting exists in Bot API.
96- If the request is about exact method coverage, JSON payload shapes, or what is still BotFather-only, read `references/bot-api-settings.md`.
97