Setup & Installation
openclaw skills install @hoyin258/macos-screenshot-telegram
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install macos-screenshot-telegram
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
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: take a screenshot and send it to my Telegram chat ID 987654321 using profile main
AGENT
- 1Capture screen with /usr/sbin/screencapture -x /tmp/screenshot.png
- 2Copy file to OpenClaw workspace at ~/.openclaw/workspace-main/screenshot.png
- 3Read bot token from ~/.openclaw-main/openclaw.json
- 4Send 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
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
Telegram bot token from @BotFatherTelegram chat ID (obtainable via @userinfobot)OpenClaw profile config with telegram.botToken and allowFrom fields set