telegram-official

Name: telegram-official
Author: uvwt/agentdock

$npx mdskill add uvwt/agentdock/telegram-official

Send Dock notifications via Telegram using Python

Sends formatted event notifications to a configured Telegram chat.
Deploys Python standard library and API.telegram.org for message delivery.
Automatically discovers chat IDs through simplified getUpdates output.
Verifies token and Bot API connectivity with the official Telegram service.

SKILL.md

.github/skills/telegram-officialView on GitHub ↗

---
name: telegram-official
description: Send Dock notifications through Telegram's official Bot API using only Python standard library and api.telegram.org.
version: 0.1.5
---

# Telegram Official Bot API Skill

通过 Telegram 官方 Bot API 给 Dock 发送通知。

## 能力

- `send`：发送普通文本消息。
- `event`：发送格式化的 Dock 事件通知。
- `updates`：读取精简后的 `getUpdates` 输出，用于发现 `chat_id`。
- `health`：调用 `getMe` 验证 token 和官方 API 连通性。

## 安全

- 只访问 `https://api.telegram.org`。
- 不登录 Telegram 个人号，不读取用户私聊历史。
- 不依赖第三方 Telegram SDK、MCP server 或代理服务。
- 不接受 token 作为 action input 或 CLI 参数。
- token 只从 `TELEGRAM_BOT_TOKEN` / `TG_BOT_TOKEN` / `.env` 读取。

## 辅助脚本执行

Skill 本体是本说明文档。确需调用包内辅助脚本时，在 Skill 包根目录使用相对路径执行；运行宿主负责切换到包根目录并把所需变量注入当前子进程。

```bash
printf '%s' '{"skill_action":"<动作>"}' | python3 run.py
```

输入必须是 JSON 对象。写操作仍按本文档中的确认规则执行。

| 动作 | 用途 |
|---|---|
| `send` | Send a text message to the configured Telegram chat. |
| `event` | Send a formatted Dock event notification. |
| `updates` | Read compact getUpdates output to discover chat ids. |
| `health` | Call getMe to verify token and official Bot API connectivity. |

More from uvwt/agentdock

Skill	Description
baidu-netdisk	Use this skill when managing Baidu Netdisk files through the bdpan CLI inside the application data scope.
bark	Send Bark-compatible notifications with Python standard library while keeping the device key in the private Skill data environment.
cloudsaver	Use this skill when calling the local CloudSaver API for status checks, resource search, Douban hot lists, share parsing, or transfer actions.
code-debrief	Explain and teach the core implementation produced by vibecoding from real code, focusing on the main call chain, core code, state and data flow, design reasoning, and transferable engineering knowledge. Use when the user asks to explain, review, learn, debrief, or understand recent code changes, a commit, PR, diff, feature, module, or code path.
codex-usage	Use this skill when checking the current macOS user Codex CLI account state or Codex usage quota.
desktop	macOS desktop automation as an AgentDock Skill workflow.
douban-marks	只读查询豆瓣电影、图书、音乐标记列表和电影条目联想。用于读取用户自己的已看、想看、在看等标记；公开主页可直接读，私密列表需要本机环境或 .env 中的 DOUBAN_COOKIE。禁止用于批量采集、绕登录、写入标记或读取非授权账号。
douyin-hot	获取抖音实时热榜并返回标题、热度和跳转链接。
find-skills-skill	Search and discover OpenClaw skills from various sources. Use when: user wants to find available skills, search for specific functionality, or discover new skills to install.
grok-quota	Query detailed Grok weekly usage, GrokChat/GrokBuild breakdown, plan, monthly credits, and pay-as-you-go state from local xAI OAuth credentials.