SuperAPI AI 工具集

add-telegram

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

用途:为 BastionClaw 添加 Telegram 作为消息频道,可选择完全替代 WhatsApp(TELEGRAM_ONLY=true)、与 WhatsApp 并行、作为仅触发动作的控制频道,或作为接收输出但限制触发的通知频道。

主要能力:实现 Channel 接口(connect、sendMessage、ownsJid、disconnect、setTyping);通过 onMessage 与 onChatMetadata 回调投递入站消息;提供 /chatid 命令获取聊天注册 ID,/ping 检查状态;处理文本及图片、视频、语音、音频、文档、贴纸、位置、联系人等非文本消息占位;发送消息按 Telegram 4096 字符上限自动分段;将 @bot_username 提及转换为 TRIGGER_PATTERN 格式。

使用方式:先运行 npm install grammy;在 Telegram 中通过 @BotFather 发送 /newbot 创建机器人并获取 token;私聊或群聊中发送消息后用 /chatid 获取 ID;群聊需在 BotFather 的 Group Privacy 中关闭隐私以接收全部消息(仅 @提及触发时可省略)。配置 TELEGRAM_BOT_TOKEN 与 TELEGRAM_ONLY,在 src/config.ts 添加导出,新建 src/channels/telegram.ts,并在 src/index.ts 中以 channels 数组接入多频道与路由。

限制与安全:群聊中任何可见成员都能命令机器人,机器人以其 Claude API 凭据运行并可访问工具、记忆与定时任务;建议管理员频道使用私聊,他人使用单独群并设 requiresTrigger: true,勿分享含机器人的群邀请链接。互动须使用 AskUserQuestion 工具而非纯文本提问。