使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/sqrdao/sqrskills --skill list-telegram-chats开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
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
