b3os-telegram-file-delivery

b3os-telegram-file-delivery is a skill for Claude Code, Codex from b3rys/b3rys-team-os. It costs 56 tokens per session (1,327 once invoked), scanned A, original, Apache-2.0.

A procedure for sending files through Telegram, a messaging service, using its Bot API, the interface that lets software control a bot.

In plain words
What is it for?
Use it to send HTML, PDFs, images, ZIP archives, CSV or JSON data, and other existing files to a Telegram chat after receiving confirmation.
Why use it?
It provides a consistent route when the usual file-attachment tool rejects or cannot send files, while keeping bot credentials out of logs.

Skill for Claude CodeCodex

Which agent this was written for is unclear — built for openclaw. Also seen: built for openclaw.

Good fit Use it to send HTML, PDFs, images, ZIP archives, CSV or JSON data, and other existing files to a Telegram chat after receiving confirmation.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/b3rys/b3rys-team-os/b3os-telegram-file-delivery
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add b3rys/b3rys-team-os --skill b3os-telegram-file-delivery
Clone the repo
git clone --depth 1 https://github.com/b3rys/b3rys-team-os

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for b3os-telegram-file-delivery

README.md
[![agentmods](https://agentmods.dev/badge/skills/b3rys/b3rys-team-os/b3os-telegram-file-delivery/github.svg)](https://agentmods.dev/skills/b3rys/b3rys-team-os/b3os-telegram-file-delivery)
Your own site
<a href="https://agentmods.dev/skills/b3rys/b3rys-team-os/b3os-telegram-file-delivery"><img src="https://agentmods.dev/badge/skills/b3rys/b3rys-team-os/b3os-telegram-file-delivery/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for b3os-telegram-file-delivery

Your own site · 80×15
<a href="https://agentmods.dev/skills/b3rys/b3rys-team-os/b3os-telegram-file-delivery"><img src="https://agentmods.dev/badge/skills/b3rys/b3rys-team-os/b3os-telegram-file-delivery.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 56 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,327 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Data Exfiltration · line 61
    Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.
    Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00056 $0.01327
Opus 5 $0.00028 $0.00664
Sonnet 5 $0.00011 $0.00265
Haiku 4.5 $0.00006 $0.00133

Measured 11d ago against content hash 25ca3c7caf9f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

b3os-telegram-file-delivery scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/send-file.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -sS -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendDocument" \
skills/b3os-telegram-file-delivery/SKILL.md · 94 lines

How it starts

The opening of the file, as written. The whole thing — 94 lines — stays where its author put it; the contents beside it link to each section on GitHub.

b3rys Telegram File Delivery

Telegram으로 파일을 그대로 보내야 할 때 쓰는 스킬이다. 팀에서 반복되는 실수 = "텔레그램에서 파일이 안 보내진다." 원인은 런타임의 message/첨부 도구가 파일 직접 첨부를 보안 제한으로 막거나(특히 OpenClaw/Forin 계열 .html), 첨부 경로/형식이 도구 제약에 안 맞는 것이다. 해법은 일관된다 — Telegram Bot API의 sendDocument를 직접 호출한다. HTML만이 아니라 PDF·이미지·ZIP·CSV·로그 등 모든 파일에 동일하게 적용된다.

언제 쓰나

  • message/reply 도구로 파일 첨부가 막히거나 실패할 때 (가장 흔한 케이스).
  • HTML 산출물을 ZIP으로 우회하지 않고 원본 그대로 보내고 싶을 때.
  • 보고서(PDF/HTML), 스크린샷(PNG/JPG), 데이터(CSV/JSON), 압축본(ZIP) 등 어떤 파일이든 텔레그램으로 보내야 할 때.

원칙

  • 파일 전송이 도구로 막히면 ZIP/링크로 우회하기 전에 이 스킬(sendDocument)을 먼저 쓴다.
  • 외부 전송이므로 the team lead 또는 요청자의 명시 컨펌을 받은 뒤 보낸다.
  • bot token(봇 토큰), chat id(채팅방 ID), credential은 env/profile에서 읽고 stdout에 노출하지 않는다.
  • 성공 여부는 Telegram API 응답의 ok, message_id, 파일명만 보고한다. 토큰·전체 응답·chat id는 불필요하게 출력하지 않는다.

필요한 값

  • TELEGRAM_BOT_TOKEN: 보낼 봇의 token (Hermes profile env, OpenClaw account env 등).
  • TELEGRAM_CHAT_ID: 대상 채팅방 또는 DM id.
  • 파일 경로: 실제 존재하는 파일.
  • 선택 caption: 짧게.

파일 형식별 MIME 타입

document=@경로;type=<mime> 로 명시하면 텔레그램이 올바르게 인식한다. (생략해도 대개 동작하지만 HTML 등은 명시 권장.)

파일 MIME
.html text/html
.pdf application/pdf
.png / .jpg image/png / image/jpeg
.zip application/zip
.csv text/csv
.json application/json
.md / .txt / .log text/plain

절차

  1. 파일 확인

    • 파일이 존재하는지, 비어있지 않은지([ -s 파일 ]) 확인한다.
    • 민감정보·로컬 절대경로·토큰·비공개 데이터가 파일 안에 들어있지 않은지 빠르게 확인한다.
  2. 전송 컨펌

    • 외부 Telegram 전송이므로 보내기 전에 대상·파일명·목적을 말하고 컨펌을 받는다.
    • 사용자가 현재 thread에서 명시적으로 "보내"/"전송"을 지시했다면 그 지시를 컨펌으로 본다.
  3. Bot API 호출

    직접 호출 (형식에 맞는 type 지정):

    curl -sS -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendDocument" \
      -F "chat_id=${TELEGRAM_CHAT_ID}" \
      -F "document=@/absolute/path/to/file.pdf;type=application/pdf" \
      -F "caption=report"
    

    또는 이 스킬의 스크립트 (확장자로 MIME 자동 추정):

    TELEGRAM_BOT_TOKEN=... TELEGRAM_CHAT_ID=... \
      bash skills/b3os-telegram-file-delivery/scripts/send-file.sh \
      /absolute/path/to/file.pdf "caption"
    

Read the full file on GitHub · 94 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 94 lines · 56 tokens per session scan A 25ca3c7caf9f

Subscribe to this mod's changes

b3os-telegram-file-delivery is a skill published in the GitHub repository b3rys/b3rys-team-os (13 stars, last pushed today), licensed Apache-2.0. It adds 56 tokens to every session and 1,327 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.