Skip to content
TakoAPI
Back to skills

macos-screenshot-telegram

by hoyin258

Coding Agents & IDEs
480Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Take a screenshot on macOS and send it to Telegram.

Description

What This Skill Does

Captures the macOS screen and sends the screenshot to a Telegram chat via the Bot API. Works around a known OpenClaw bug (#15541) that prevents the built-in message tool from sending media files.

Uses curl directly against the Telegram Bot API instead of OpenClaw's message tool, which silently drops media despite returning success.

When to Use It

  • Sharing a bug report screenshot instantly via Telegram
  • Sending screen captures to a Telegram group without leaving the terminal
  • Remotely documenting what's on screen during a session
  • Quickly sharing UI mockups or error dialogs over Telegram DM
  • Automating screen capture delivery as part of a workflow

Example Workflow

INPUT

User asks: take a screenshot and send it to my Telegram chat ID 987654321 using profile main

AGENT
  1. 1

    Capture screen with /usr/sbin/screencapture -x /tmp/screenshot.png

  2. 2

    Copy file to OpenClaw workspace at ~/.openclaw/workspace-main/screenshot.png

  3. 3

    Read bot token from ~/.openclaw-main/openclaw.json

  4. 4

    Send image via curl POST to https://api.telegram.org/bot{token}/sendPhoto with chat_id and photo fields

OUTPUT

Screenshot delivered to Telegram chat 987654321

Requirements

  • Telegram bot token from @BotFather
  • Telegram chat ID (obtainable via @userinfobot)
  • OpenClaw profile config with telegram.botToken and allowFrom fields set

Installation

clawhub install hoyin258/macos-screenshot-telegram

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links