A utility that captures macOS screenshots and transmits them directly to Telegram chats using the Telegram Bot API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install macos-screenshot-telegram
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install macos-screenshot-telegram using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is macOS Screenshot to Telegram?
This skill provides a high-reliability workflow for macOS users who need to share their visual environment through automated agents. It was specifically engineered to bypass existing media delivery limitations in agent frameworks by using native system commands and direct API calls. By integrating this into your Openclaw Skills library, you gain the ability to trigger screen captures and send them to specific users or groups without manual intervention.
The tool is designed with security in mind, utilizing a dedicated workspace directory for temporary file storage to comply with modern agent security protocols. It effectively bridges the gap between local system operations and cloud messaging, making it an essential addition to any developer's Openclaw Skills toolkit.
macOS Screenshot to Telegram Use Cases
- Reporting visual bugs or UI glitches directly from the terminal to a team chat.
- Automating periodic status updates or dashboard captures for remote monitoring.
- Sharing visual context with an AI agent for real-time troubleshooting.
- Bypassing standard message tool limitations to ensure media is delivered successfully through Openclaw Skills.
How macOS Screenshot to Telegram Works
- The skill invokes the native macOS /usr/sbin/screencapture utility to create a high-quality image of the current screen.
- The resulting file is moved to the secure Openclaw Skills workspace directory to satisfy file access permissions.
- The skill parses the profile-specific configuration file to retrieve the necessary Telegram Bot Token.
- A POST request is dispatched to the Telegram Bot API sendPhoto endpoint via curl, delivering the screenshot to the target Chat ID.
macOS Screenshot to Telegram Setup
To use this with your Openclaw Skills setup, follow these steps:
- Create a bot via @BotFather on Telegram and retrieve your Bot Token.
- Identify your target Chat ID using @userinfobot.
- Add the following credentials to your profile configuration file (usually located at
~/.openclaw-<profile>/openclaw.json):
{
"telegram": {
"botToken": "YOUR_BOT_TOKEN_HERE",
"allowFrom": ["YOUR_CHAT_ID"]
}
}
- Ensure your profile name is correctly identified (e.g., main or rescue) to allow the skill to locate the correct workspace paths.
macOS Screenshot to Telegram Data Schema & Taxonomy
The skill manages data across the following locations and structures:
| Data Type | Path / Format | Description |
|---|---|---|
| Configuration | ~/.openclaw-<profile>/openclaw.json |
Stores the botToken and authorized Chat IDs. |
| Image Storage | ~/.openclaw/workspace-<profile>/screenshot.png |
Temporary staging area for the screenshot before transmission. |
| API Endpoint | https://api.telegram.org/bot<token>/sendPhoto |
The destination for the multipart/form-data payload. |
macOS Screenshot to Telegram Advanced Features
- Profile-agnostic design allows seamless operation across multiple Openclaw Skills environments.
- Direct curl integration provides a fail-safe mechanism against internal messaging tool bugs.
- Automated token extraction using sed/grep for zero-configuration execution after initial setup.
- Security-compliant file handling by strictly using the designated workspace path.
SKILL.md
Loading
Related Openclaw Skills
Markdown Fetch
An optimization skill that reduces AI token consumption by 80% by fetching web content in Markdown format via Cloudflare.
ClawBot Network
A distributed communication layer that connects multiple OpenClaw instances across different devices into a unified, collaborative agent network.
Protico Agent Skill
A bridge for AI agents to engage in real-world human discussions and gather sentiment across a network of partner websites via the Protico community widget.
Skill Audit Guardian
A specialized security tool that automatically audits Openclaw Skills ZIP files for suspicious patterns and risk levels.
MiniMax to Telegram Media Suite
A powerful integration to generate high-quality AI media via MiniMax MCP and automate delivery through Telegram channels.
PocketSmith Skill
A comprehensive interface for programmatically managing PocketSmith transactions, categories, and financial budget data.
Featured*
