用途：搭建并运行一个私有 Telegram 机器人，让用户从手机与本地编码智能体对话。资料以可执行清单形式给出，按步骤操作即可。
主要能力：检查是否已配置令牌（环境变量 TELEGRAM_BOT_TOKEN 或同目录 .env）；用 npm run setup 校验令牌、以 600 权限写入 .env 并记录机器人用户名；npm run bg 后台启动桥接并打印一次性认领链接与二维码，npm run status 查看状态，npm run stop 停止；首个点击链接者成为 owner，其他人收到“this bot is private”并由 owner 选择 Approve / Guest / Block；可设置 BOT_NAME、BOT_DESCRIPTION、BOT_ABOUT，头像需在 @BotFather 用 /setuserpic 设置，@username 不可更改。
使用方式：若缺少代码，先执行 git clone https://github.com/hec-ovi/telegram-bot-skill && cd telegram-bot-skill。无令牌时在 @BotFather 发送 /newbot 创建，将令牌写入 .env 后运行 npm run setup；已粘贴令牌则用 TELEGRAM_BOT_TOKEN=<token> npm run setup。随后 npm run bg 启动，扫码或点链接并在 Telegram 按 Start。也可改用 MCP：先 npm run stop，再 npm run mcp:http，然后按所用 CLI 的 MCP 添加命令安装，例如 /mcp add telegram http://127.0.0.1:8765/mcp 或 claude mcp add --transport http telegram http://127.0.0.1:8765/mcp，之后用 wait_for_message、send_message、bridge_status、list_users、set_user_tier 交互。
限制：令牌是机密，不可回显或提交，只存于 .env；一个令牌只允许一个轮询器，启动前须停止已有桥接；MCP 为自托管，需用户自行启动；非 owner 目前无法执行智能体，按层级限制工具尚未上线；网络异常时可加 NODE_OPTIONS="--dns-result-order=ipv4first --no-network-family-autoselection"，401 表示令牌无效需重做步骤。可选环境变量包括 STATE_FILE、AGENT_CWD、AGENT_ADAPTER、PI_MODEL、OWNER_ID、TRUSTED_IDS、GUEST_IDS、BLOCKED_IDS。