AgentSkillsCN

Telegram Push

Telegram推送

SKILL.md

Telegram Push Skill

通过独立的 Telegram Bot 推送消息到群聊或私聊，不依赖 OpenClaw 的 telegram channel 配置。

使用场景

  • •推送新闻/通知到 Telegram 群
  • •定时任务推送
  • •独立于主 bot 的消息发送

配置

Bot 信息存储在 pass 中：

  • •Token: pass tokens/telegram-newsrobot
  • •Bot: @fkkanfnnfbot (NewsRobot)

已配置的群组

群名Chat ID说明
DailyNews-1003824568687新闻推送群

使用方法

1. 发送文本消息

bash
curl -s -X POST "https://api.telegram.org/bot$(pass tokens/telegram-newsrobot)/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": -1003824568687,
    "text": "消息内容",
    "parse_mode": "HTML"
  }'

2. 发送 Markdown 消息

bash
curl -s -X POST "https://api.telegram.org/bot$(pass tokens/telegram-newsrobot)/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": -1003824568687,
    "text": "*标题*\n\n内容",
    "parse_mode": "MarkdownV2"
  }'

3. 发送带按钮的消息

bash
curl -s -X POST "https://api.telegram.org/bot$(pass tokens/telegram-newsrobot)/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": -1003824568687,
    "text": "消息内容",
    "reply_markup": {
      "inline_keyboard": [[
        {"text": "按钮1", "url": "https://example.com"},
        {"text": "按钮2", "callback_data": "action1"}
      ]]
    }
  }'

4. 发送图片

bash
curl -s -X POST "https://api.telegram.org/bot$(pass tokens/telegram-newsrobot)/sendPhoto" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": -1003824568687,
    "photo": "https://example.com/image.jpg",
    "caption": "图片说明"
  }'

辅助脚本

telegram-push.sh

bash
#!/bin/bash
# 快速推送消息到 DailyNews 群
# 用法: telegram-push.sh "消息内容"

TOKEN=$(pass tokens/telegram-newsrobot)
CHAT_ID="-1003824568687"
MESSAGE="$1"

curl -s -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
  -H "Content-Type: application/json" \
  -d "{\"chat_id\": ${CHAT_ID}, \"text\": \"${MESSAGE}\"}"

添加新群组

  1. •把 @fkkanfnnfbot 加入目标群
  2. •在群里发一条消息
  3. •获取 chat_id:
    bash
    curl -s "https://api.telegram.org/bot$(pass tokens/telegram-newsrobot)/getUpdates" | jq '.result[-1].message.chat'
  4. •更新本文档的群组列表

注意事项

  • •超级群的 chat_id 以 -100 开头
  • •普通群升级为超级群后 chat_id 会变化，API 会返回 migrate_to_chat_id
  • •发送频率限制：同一群每分钟约 20 条
  • •HTML 模式支持: <b>, <i>, <code>, <pre>, <a href="">

错误处理

错误原因解决方案
chat not foundBot 未加入群把 bot 加入群
migrate_to_chat_id群升级为超级群使用返回的新 chat_id
bot was blocked用户屏蔽了 bot无法发送，需用户解除屏蔽