How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/sqrdao/sqrskills --skill list-telegram-chatsBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
List Telegram Chats
Retrieves unique Telegram chat IDs from local session state, categorised into groups (negative IDs) and private chats (positive IDs).
Usage
bash
python3 "$SKILL_DIR/scripts/list_chats.py"
# Skip name resolution (no bot token required, faster):
python3 "$SKILL_DIR/scripts/list_chats.py" --no-names$SKILL_DIR means this skill's installed directory. If your agent does not set it automatically, replace it with the path to this list-telegram-chats directory before running the command.
Output
json
{
"groups": [{"chat_id": -1001234567890, "name": "My Group", "type": "supergroup", "last_updated": "2024-01-15T10:30:00Z"}],
"private_chats": [{"chat_id": 502391728, "name": "Alice Smith", "type": "private"}]
}nameisnullwhen the bot can no longer access the chat.last_updatedis present only for chats sourced from nanobot sessions.
Prerequisites
Session sources (checked in order):
- Nanobot —
~/.nanobot/workspace/sessions/telegram_*.jsonl(configurable viaNANOBOT_SESSIONS_DIRorNANOBOT_WORKSPACE) - OpenClaw —
OPENCLAW_STATE_DIR/agents/main/sessions/sessions.json(default/twin-data/state) - YouAI backend —
YOUAI_API_URL+YOUAI_TWIN_ID(fallback when no local sessions exist)
Bot token for name resolution (tried in order):
TELEGRAM_BOT_TOKENenv varchannels.telegram.tokenin~/.nanobot/config.json(override path withNANOBOT_CONFIG)
Without a token, name is omitted from all entries.
Related Skills
- telegram-send — send a message to one of the discovered chats
