適用於 Openclaw 的 telegram-notifier

一個輕量級的通知技能,使 AI agents 能夠將結構化報告與即時提醒直接發送到任何 Telegram 對話中。

infectit007
v1.0.0
Apr 14, 2026
0
691
0

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。

npx clawhub@latest install telegram-notifier

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式
~/.openclaw/skills/
工作區
<project>/skills/

優先級:工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。

請幫我使用 Clawhub 安裝 telegram-notifier。如果尚未安裝 Clawhub,請先安裝(npm i -g clawhub)。

想要直接下載?

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 telegram-notifier?

telegram-notifier 是一款專為使用 Openclaw Skills 的開發者與自動化專家設計的專用工具,旨在保持對 agent 活動的即時可視性。透過利用 Telegram Bot API,此技能允許任何 AI agent 將發現結果、安全簡報或任務完成情況直接推送到使用者的行動裝置或桌面端,而無需任何外部第三方中間件。

它以簡單為核心理念,在後端 AI 工作流與個人通訊管道之間提供了一座可靠的橋樑。無論您是在監控長時間執行的研究任務,還是需要即時的系統異常通知,此技能都能確保您的 AI 能夠在您最活躍的地方發出聲音。

telegram-notifier 應用場景

  • 從研究 agents 那裡發送每日晨間簡報與執行摘要。
  • 發送即時安全提醒或基礎設施健康警告。
  • 在複雜的多階段 AI 任務成功完成後通知使用者。
  • 與 cron jobs 整合,透過 Openclaw Skills 提供定時狀態更新。

telegram-notifier 運作原理

  1. AI agent 根據其主要任務產生報告或訊息本體。
  2. telegram-notifier 技能從環境變數中檢索 TELEGRAM_BOT_TOKEN 與 TELEGRAM_CHAT_ID。
  3. 訊息使用純文字或 Markdown 進行格式化,以提高可讀性。
  4. 一個安全的 POST 請求被發送到 Telegram Bot API 端點。
  5. 此技能確認發送成功,或返回一個結構化的錯誤供 agent 處理。

telegram-notifier 設定指南

首先,確保您的環境變數已配置好您的機器人憑證:

export TELEGRAM_BOT_TOKEN="your_bot_token_here"
export TELEGRAM_CHAT_ID="your_chat_id_here"

要在 Openclaw Skills 生態系統中使用此技能自動執行健康檢查,您可以新增一個 cron job:

openclaw cron add \
  --name "telegram-notifier:daily-check" \
  --cron "0 8 * * *" \
  --prompt "Run a system health check and send the results via the telegram-notifier skill."

telegram-notifier 資料結構與分類體系

此技能使用簡單而有效的一種數據結構來進行訊息傳遞:

欄位 類型 描述
chat_id String 目標 Telegram 對話的唯一識別符。
text String 訊息內容(最大 4096 字符)。
parse_mode String 可選格式:"Markdown" 或 "HTML"。
timeout Integer 連接逾時(預設 10s)。

telegram-notifier 進階特性

  • 支援豐富的 Markdown 與 HTML 格式,實現專業級的報告展示。
  • 智慧字符限制處理,確保訊息符合 Telegram 的 4096 字符約束。
  • 自定義 agent 前綴,以識別在多 agent Openclaw Skills 環境中是哪個特定的 agent 在進行通訊。
  • 詳細的錯誤處理與回應解析,可實現到複雜工作流的穩健整合。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Github Stars: 0
forks: 0

精選*