技能介绍

要解决什么问题

在 Agent 或自动化脚本里直接调用 Telegram Bot API 时，你通常要保管 Bot Token、自己拼 HTTP 请求，还要区分 Webhook 与 getUpdates 轮询两种收消息模式。oo-telegram 把这套能力收敛到 OOMOL 的 telegram 连接器：通过已安装的 oo CLI 发动作，凭证在 OOMOL 侧注入，调用方不接触明文 Token。

技能如何工作

技能面向 已登录 OOMOL 且已连接 Telegram Bot 的环境。执行前应先查看契约（oo connector schema），再按输入 schema 构造 JSON，用 --data 传入；响应形如 { "data": ..., "meta": { "executionId": "..." } }，执行 ID 在 meta.executionId。

共暴露 21 个 action，覆盖常见 Bot 运维与对话操作，例如：

消息：send_message、edit_message_text、delete_message、forward_message
媒体与互动：send_photo、send_document、send_location、send_poll、answer_callback_query
群与成员：get_chat、get_chat_member、get_chat_administrators、get_chat_members_count、create_chat_invite_link
更新与 Webhook：get_updates、get_webhook_info、set_webhook、delete_webhook
其它：get_me、set_my_commands、get_chat_history（需在关闭 Webhook 交付的前提下轮询 getUpdates 并过滤单聊历史）

文档约定：不要主动跑 oo auth login 或打开连接页；在用户已配置的前提下直接执行动作，仅在命令因鉴权或连接失败时再走首次设置。读类操作（get / list / search）可相对直接执行；发送、创建、更新会改变 Bot 状态，删除具有破坏性，执行前应与用户确认 payload 与目标。

适用边界

send_photo / send_document 等仅支持 URL 或已有 file_id，本技能路径下不包含 multipart 本地上传。
get_chat_history 依赖轮询且要求 Webhook 已禁用；生产环境若已 set_webhook，应走 Webhook 而非 get_updates 调试式轮询。
出现 HTTP 402 / OOMOL_INSUFFICIENT_CREDIT 属于 OOMOL 计费侧问题，需在控制台充值后再试。

截图预览

使用场景

运维 Agent 在收到告警后，用 `send_message` 把摘要推到指定群或频道，无需在脚本里配置 Bot Token。
客服机器人需要 `answer_callback_query` 响应内联键盘回调，并 `edit_message_text` 更新同一条提示文案。
上线前用 `get_webhook_info` 核对 Webhook 地址，再用 `set_webhook` 或 `delete_webhook` 切换交付方式。
在关闭 Webhook 的调试环境里，用 `get_chat_history` 拉取单聊历史，核对 Bot 收到的用户消息内容。

适合人员

负责 Telegram 客服或通知 Bot 的后端工程师，希望把发消息、改文案、删消息交给 Agent 且不落盘 Token。
用 OOMOL 编排多连接器工作流的集成开发者，需要在同一账号下调用 telegram 动作的 schema 与 executionId。
社区运营维护带投票与定位的活动群，需 `send_poll`、`send_location` 及 `create_chat_invite_link` 等群管理能力。
Bot 发布负责人要 `set_my_commands` 同步客户端命令列表，并用 `get_me` 校验连接是否仍有效。