macos-screenshot-telegram
Take a screenshot on macOS and send it to Telegram. Use when the user asks to capture their screen, take a screenshot, or send a screen capture to Telegram. Works around OpenClaw's message tool bug (#15541) that fails to send media.
Why use this skill?
Use this OpenClaw skill to bypass media bugs and automatically capture and send macOS screenshots to Telegram via the Bot API. Simple setup and reliable execution.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/hoyin258/macos-screenshot-telegramWhat This Skill Does
The macos-screenshot-telegram skill is a specialized automation tool designed to bridge the gap between macOS desktop activity and the Telegram messaging platform. When OpenClaw's native message tool fails due to technical limitations (specifically bug #15541 regarding media transmission), this skill provides a robust alternative. It automates the entire sequence of capturing a high-resolution screenshot using the system-native screencapture utility, safely staging the file within the OpenClaw workspace directory, and finally transmitting it via the Telegram Bot API using a direct curl request. This ensures that screenshots are delivered reliably regardless of internal application constraints.
Installation
Installation is performed via the OpenClaw CLI. Before executing the installation command, ensure your Telegram bot is registered with @BotFather and you have identified your target Chat ID. To install, run:
clawhub install openclaw/skills/skills/hoyin258/macos-screenshot-telegram
Once installed, you must configure your profile at ~/.openclaw-<profile>/openclaw.json by adding the telegram object containing your unique botToken and allowFrom list. The skill relies on specific directory structures, so ensure your OpenClaw profile naming conventions match the paths defined in the system documentation.
Use Cases
- Remote Monitoring: Capture your screen while away from your desk to check the status of long-running background tasks.
- Quick Collaboration: Share visual bugs or UI designs instantly with a Telegram group without manual file uploading.
- Automation Logging: Automatically document the results of automated scripts by sending a visual confirmation of the terminal state directly to your mobile device.
Example Prompts
- "Take a screenshot of my current screen and send it to my Telegram with the main profile."
- "Please capture my screen now and send the image to my Telegram ID 987654321 using the rescue profile."
- "Hey OpenClaw, take a snapshot of the workspace and forward it to my Telegram bot."
Tips & Limitations
- Security: The skill respects OpenClaw's security restrictions by requiring images to be moved to the workspace folder before transmission. Never share your Bot Token in public repositories.
- Bot Setup: If the bot fails to send the image, ensure the Chat ID is authorized in your
openclaw.jsonconfig. - Stability: Because this skill uses direct
curlcommands, it is significantly more reliable for media handling than the standard internal message tool. However, always ensure your network is active, as the API call requires a live internet connection to communicate with Telegram servers.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-hoyin258-macos-screenshot-telegram": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read, external-api, code-execution