SuperAPI AI 工具集

telegram-polling

智能体与模型

查看项目

更新于 10-16 09:47

技能介绍

用途:该技能每 2 分钟通过 CronCreate 轮询 Telegram Bot API,把收到的每条消息路由到命令处理器,并回复最终结果(不发送部分或流式输出)。

主要能力:实现含 10 条命令的机器人。低风险命令 /help、/status、/tasks、/loops 对所有已授权用户开放;中风险 /logs、/memory QUERY 同样开放;高风险 /ask、/deny 与关键级 /spawn TYPE DESC、/approve TASK_ID 仅限所有者。授权分两层:先做白名单检查(TELEGRAM_ALLOWED_USERS 为空或缺失即失效关闭,未授权发送者被静默丢弃,不暴露机器人活跃),再做所有者检查(TELEGRAM_OWNER_ID 仅可访问 /ask、/spawn、/approve、/confirm、/deny,非所有者回 "Unauthorized")。

使用方式:通过 @BotFather 创建机器人获取 token,用 @userinfobot 获取用户 ID,在 .env 设置 TELEGRAM_BOT_TOKEN、TELEGRAM_ALLOWED_USERS(逗号分隔)和 TELEGRAM_OWNER_ID,并用文档给出的 node -e 命令校验。偏移写入 .claude/context/tmp/telegram-offset.json,处理命令前先提交偏移以防重放;所有命令调用均写入 .claude/context/runtime/telegram-audit.jsonl 审计日志。审批采用两步:先 /approve TASK_ID 显示任务详情,须在 60 秒内发送 /confirm TASK_ID。

适用场景:在授权范围内通过 Telegram 查询系统状态、任务列表、心跳循环、日志与记忆,或以所有者身份提问、派生代理任务并审批或拒绝任务。

限制:/ask 的回复限制在 3000 字符内并以纯文本呈现;仅允许 general-assistant、researcher、technical-writer 三类代理通过 /spawn 派生;确认 60 秒过期后需重新发起;数据按要求原样保留,未涉及的功能与收费信息暂未提供。